-
-
Notifications
You must be signed in to change notification settings - Fork 2.6k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Wish documentation was clearer on recommended way to structure tests and fixtures across files #1505
Comments
Thanks for taking the time to write this! Answering your question, to share fixtures in a project the recommended way is using conftest files. I agree the documentation could be more clear on how to structure the tests, and trade-offs between having |
Thanks for the answer and pointer to the documentation. I think this topic really deserves its own section in the documentation (as a bullet point under the "scales from simple unit to complex functional testing" heading in the home page), instead of being scattered throughout multiple other documentation sections. Also, two quick notes. I've searched, and I wasn't able to find a dedicated section on conftest files. When searching for "pytest conftest" on Google, the first hit (for me at least) is to the "Installing and Using Plugins" page for the documentation of the latest version (which doesn't talk at all about the other things you can do with conftest files). And the second hit is to "Working with plugins and conftest files" for version 2.2.4 of the pytest doc... which is a bit old. Since this is an important feature of pytest (when using it for more than a few simple tests), it would be really helpful if there was a dedicated page of documentation that talked about conftest files and all their features. Also, for the link you gave me, if you look just a bit below, at the "tests file structure" of the "Override a fixture on a folder (conftest) level" section, there is a top-level (Let me know if you'd prefer separate issues filed for those two small things.) |
Excellent suggestions, thanks!
We have #1112 which is related, but keeping them separate for now is OK I guess. 😁 Btw, PRs on docs are really welcome! |
@chrish42 if you have a bullet point in mind, I can edit the documentation - or if you'd like to commit it yourself, see @lwm's suggestion. |
It seems a section about I can do the part about sharing fixtures via conftest.py, but what about "how to share test data" in the OP - what is the best practice there? Load the test data via a fixture and provide that way? Is there even another way to get at that reusably? So far I have mostly put the datafiles into the tests folder and loaded in the test files directly, and this worked, but my setups were not too complex. |
also relevant: #1770 (intro docs for conftest.py), could probably kill two birds with one stone, here. |
If you can load the data into a fixture, then that is a good way to do it because of the automatic caching (even using Adding the data files in the tests folder as you mention is also a very good approach and I use it extensively. We might even mention a few plugins which help in this regard: |
Ok, thanks, I'll take a shot at this. |
Also reorganize conftest-related content a bit. Closes pytest-dev#1505, closes pytest-dev#1770.
Also reorganize conftest-related content a bit. Closes pytest-dev#1505, closes pytest-dev#1770.
I've been (re-)learning pytest (used it last in the days where you had to get a snapshot of "py") and really like the new pytest, its documentation, and especially fixtures. However, there's one aspect of the documentation that I personally found lacking and really wish was clearer: how to reuse tests and fixtures across multiple test_*.py files. Other than the recommendation not to create a
__init__.py
file in the root directory of the tests, there's little else (at least that I could find) on how to share test data and fixtures across python files.Does pytest always add the root of the tests directory to sys.path (so we can use imports to pull in test data, etc. from a common module)? Should we put stuff in conftest.py instead? Googling these questions produces some hits, but they are sometimes unclear and/or contradictory. I wish there was some kind of official recommendation about this in the doc. I think it would be helpful.
The text was updated successfully, but these errors were encountered: