Skip to content

Commit ea4fda4

Browse files
authored
Revise "Next Steps" for app dependency management (pypa#496)
* Revise "Next Steps" for app dependency management - move the link to the next tutorial above the list of alternatives - explicitly mention `pipenv install -e <path>` for apps that define their own Python packages - significantly revise the reference to poetry * Simplify paragraph
1 parent 1a194ea commit ea4fda4

File tree

1 file changed

+17
-8
lines changed

1 file changed

+17
-8
lines changed

source/tutorials/managing-dependencies.rst

Lines changed: 17 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -163,17 +163,26 @@ Next steps
163163
Congratulations, you now know how to effectively manage dependencies and
164164
development environments on a collaborative Python project! ✨ 🍰 ✨
165165

166-
If you find this particular approach isn't working well for you or your use
167-
case, you may want to explore these other approaches:
166+
If you're interested in creating and distributing your own Python packages, see
167+
the :ref:`tutorial on packaging and distributing packages <distributing-packages>`.
168+
169+
Note that when your application includes definitions of Python source packages,
170+
they (and their dependencies) can be added to your ``pipenv`` environment with
171+
``pipenv install -e <relative-path-to-source-directory>`` (e.g.
172+
``pipenv install -e .`` or ``pipenv install -e src``).
173+
174+
If you find this particular approach to managing application dependencies isn't
175+
working well for you or your use case, you may want to explore these other tools
176+
and techniques to see if one of them is a better fit:
168177

169178
* `pip-tools <https://github.com/jazzband/pip-tools>`_ to build your own
170179
custom workflow from lower level pieces like ``pip-compile`` and ``pip-sync``
171-
* `poetry <https://github.com/sdispater/poetry>`_ for ``pip``-installable
172-
Python libraries that are also usable as standalone applications (most
173-
``pipenv`` based applications are not expected to be ``pip``-installable)
174180
* `hatch <https://github.com/ofek/hatch>`_ for opinionated coverage of even
175181
more steps in the project management workflow (such as incrementing versions,
176182
tagging releases, and creating new skeleton projects from project templates)
177-
178-
If you're interesting in creating and distributing your own Python packages, see
179-
the :ref:`tutorial on packaging and distributing packages <distributing-packages>`.
183+
* `poetry <https://github.com/sdispater/poetry>`_ for Python developer focused
184+
components that are designed primarily for publication to a Python package index
185+
(``pipenv`` deliberately avoids making the assumption that the application
186+
being worked on will support distribution as a ``pip``-installable Python package,
187+
while ``poetry`` based applications rely explicitly on their Python packaging
188+
metadata to describe their application structure and dependencies)

0 commit comments

Comments
 (0)