From 9d4c3df01273f77d0c39c3fd716eb9ec63328c84 Mon Sep 17 00:00:00 2001 From: Janina Szkut Date: Thu, 6 Apr 2017 18:57:07 -0400 Subject: [PATCH] Update development mode documentation to mention that order of local packages matters (#208) --- source/distributing.rst | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/source/distributing.rst b/source/distributing.rst index 29e47706c..99aa23371 100644 --- a/source/distributing.rst +++ b/source/distributing.rst @@ -554,7 +554,14 @@ requirements file like so:: The first line says to install your project and any dependencies. The second line overrides the "bar" dependency, such that it's fulfilled from vcs, not -PyPI. For more on requirements files, see the :ref:`Requirements File +PyPI. + +If, however, you want "bar" installed from a local directory in editable mode, the requirements file should look like this, with the local paths at the top of the file:: + + -e /path/to/project/bar + -e . + +Otherwise, the dependency will be fulfilled from PyPI, due to the installation order of the requirements file. For more on requirements files, see the :ref:`Requirements File ` section in the pip docs. For more on vcs installs, see the :ref:`VCS Support ` section of the pip docs.