jiuyuan
/
test_ok1
2
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Mention PYTHONPATH semantics in goodpractices.rst 

Fix #4625
This commit is contained in:
Bruno Oliveira 2019-01-09 22:42:18 -02:00
parent a0ab5a7cd8
commit 9f6d9efc1d
1 changed files with 12 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
doc/en/goodpractices.rst
View File

@ -72,8 +72,18 @@ to keep tests separate from actual application code (often a good idea)::
test_view.py test_view.py
... ...
This way your tests can run easily against an installed version This has the following benefits:
of ``mypkg``.
* Your tests can run against an installed version after executing ``pip install .``.
* Your tests can run against the local copy with an editable install after executing ``pip install --editable .``.
* If you don't have a ``setup.py`` file and are relying on the fact that Python by default puts the current
directory in ``sys.path`` to import your package, you can execute ``python -m pytest`` to execute the tests against the
local copy directly, without using ``pip``.
.. note::
See :ref:`pythonpath` for more information about the difference between calling ``pytest`` and
``python -m pytest``.
Note that using this scheme your test files must have **unique names**, because Note that using this scheme your test files must have **unique names**, because
``pytest`` will import them as *top-level* modules since there are no packages ``pytest`` will import them as *top-level* modules since there are no packages