Skip to content

Commit f3e1dd5

Browse files
Update the "Application dependency management" recommendations (pypa#1055)
* Update the "Application dependency management" recommendations This is a more detailed recommendation that breaks up the recommendation into multiple parts, to reflect that multiple tools need to be used in workflows today to maximise compatibility with existing platforms. It also recommends that deployed applications be isolated from the system packages, as was implied but not explicitly noted. The move away from Pipenv as the primary recommendation is a reflection of the change that application development workflows have a greater diversity in mature tooling available for them. Co-authored-by: Brian Rutledge <[email protected]> * Normalize commas and hyphens Co-authored-by: Pradyun Gedam <[email protected]> Co-authored-by: Brian Rutledge <[email protected]> Co-authored-by: Brian Rutledge <[email protected]>
1 parent 7a529c6 commit f3e1dd5

File tree

1 file changed

+11
-10
lines changed

1 file changed

+11
-10
lines changed

source/guides/tool-recommendations.rst

Lines changed: 11 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -11,17 +11,18 @@ what tools are currently recommended, then here it is.
1111
Application dependency management
1212
=================================
1313

14-
Use :ref:`pipenv` to manage library dependencies when developing Python
15-
applications. See :doc:`../tutorials/managing-dependencies` for more details
16-
on using ``pipenv``.
14+
* Use :ref:`pip` in a `secure manner`_ to install a Python application and its
15+
dependencies during deployment.
1716

18-
When ``pipenv`` does not meet your use case, consider other tools like:
17+
* Use :ref:`virtualenv` or :doc:`venv <python:library/venv>` to isolate
18+
application-specific dependencies from a shared Python installation. [4]_
1919

20-
* :ref:`pip`
20+
* Use `pip-tools`_, :ref:`pipenv`, or `poetry`_ to generate the fully-specified
21+
application-specific dependencies, when developing Python applications.
2122

22-
* `pip-tools <https://github.com/jazzband/pip-tools>`_
23-
24-
* `Poetry <https://python-poetry.org/>`_
23+
.. _secure manner: https://pip.pypa.io/en/latest/topics/secure-installs/
24+
.. _pip-tools: https://github.com/jazzband/pip-tools
25+
.. _Poetry: https://python-poetry.org/
2526

2627
Installation tool recommendations
2728
=================================
@@ -31,8 +32,8 @@ Installation tool recommendations
3132
is installed, you may need to also install :ref:`wheel` to get the benefit
3233
of wheel caching. [3]_
3334

34-
* Use :ref:`virtualenv`, or :doc:`venv <python:library/venv>` to isolate application
35-
specific dependencies from a shared Python installation. [4]_
35+
* Use :ref:`virtualenv` or :doc:`venv <python:library/venv>` to isolate
36+
application-specific dependencies from a shared Python installation. [4]_
3637

3738
* If you're looking for management of fully integrated cross-platform software
3839
stacks, consider:

0 commit comments

Comments
 (0)