add mention of setup.py develop

This commit is contained in:
Skylar Downes 2016-09-15 14:10:57 -07:00 committed by GitHub
parent 69f72c6f4b
commit b4fd74c6ff
1 changed files with 10 additions and 7 deletions

View File

@ -45,7 +45,7 @@ Here is the algorithm which finds the rootdir from ``args``:
matched, it becomes the ini-file and its directory becomes the rootdir. matched, it becomes the ini-file and its directory becomes the rootdir.
- if no ini-file was found, use the already determined common ancestor as root - if no ini-file was found, use the already determined common ancestor as root
directory. This allows to work with pytest in structures that are not part of directory. This allows the use of pytest in structures that are not part of
a package and don't have any particular ini-file configuration. a package and don't have any particular ini-file configuration.
If no ``args`` are given, pytest collects test below the current working If no ``args`` are given, pytest collects test below the current working
@ -100,12 +100,15 @@ check for ini-files as follows::
Change which files are added to sys.path Change which files are added to sys.path
----------------------------------------------- -----------------------------------------------
To tell pytest which files you want it to run your tests against If you place a conftest.py file in the root directory of your project
place both your pytest.ini file and a conftest.py file in a directory (as determined by pytest, see above.) pytest will run tests against
above both your test folder and source folder. By having a conftest.py the code below that directory by adding it to your sys.path instead of
in the root directory of your project, you can tell pytest to modify running against your installed code.
your sys.path when it runs to include all submodules below the root of
your project. You may find yourself wanting to do this if you ran `python setup.py install`
to set up your project, as opposed to `python setup.py develop` or any of
the package manager equivalents. Installing with develop in a
virtual environment is recommended over using the conftest.py pattern.
How to change command line options defaults How to change command line options defaults
------------------------------------------------ ------------------------------------------------