On Sun, Feb 6, 2022 at 7:41 AM 'Felix Fontein' via Ansible Project <[email protected]> wrote:
> While technically you are right, the contents of the Ansible PyPi > package are a Python module that depends on the ansible-core Python > module, this is not what users expect if they install it, and not what > we document on our docsite. It is - from our point of view - merely an > implementation detail of how we realize what we are documenting and > want to deliver to our users. If it's merely an implementation detail, why insist on stating it incorrectly? Why not be more technically correct and use the verb "requires" rather than "includes"? Using "requires" would help reduce the likelihood of people installing the quite bulky "ansible" package when all they really need is "ansible-core" and perhaps a few "ansible galaxy" statements. That would reduce burdens on pypi.org, and shrink deployed OS image sizes by roughly 500 MByte, a bit of deployment economy that would be aided by more clear language in the documentation. Right now, I'm hoping to clarify some release language. Documentation language could be next, but if it can be clarified in both, *great*. >> It is a listed requirement in the requirements.txt of the ansible >> package, > (Technical fine print: it is not. There is no requirements.txt file. > The dependencies are specified in setup.py. They might move to setup.cfg > in the future.) Good point, thank you for the correction. I've other thoughts about the way that tarball is assembled, which is a very separate line of discussion. > While you can install the Python module ansible-core 2.11.x with the > Python module ansible 5.x.y, the result will **not** be Ansible 5 (as > documented on https://docs.ansible.com/ansible/5/ or currently also > https://docs.ansible.com/ansible/latest/). This documentation... well, it has other issues. For example, it mentions that to install "ansible" on RHEL based operating systems, you should use EPEL to get current releases. That doesn't work, the EPEL release is ansible-2.9.27 right now, and that release lacks the "ansible" and "ansible-core" split architecture. -- You received this message because you are subscribed to the Google Groups "Ansible Project" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To view this discussion on the web visit https://groups.google.com/d/msgid/ansible-project/CAOCN9ryGFtbtCkLkU0%2BqQPHGrA6s3esQt4bXiCOQJyfhGL_OAw%40mail.gmail.com.
