Is it possible exclude test directories from coverage.py reports?
PythonTestingSoftware QualityCode Coveragecoverage.pyPython Problem Overview
I'm kind of a rookie with python unit testing, and particularly coverage.py. Is it desirable to have coverage reports include the coverage of your actual test files?
Here's a screenshot of my HTML report as an example.
You can see that the report includes tests/test_credit_card
. At first I was trying to omit the tests/
directory from the reports, like so:
coverage html --omit=tests/ -d tests/coverage
I tried several variations of that command but I could not for the life of me get the tests/ excluded. After accepting defeat, I began to wonder if maybe the test files are supposed to be included in the report.
Can anyone shed some light on this?
Python Solutions
Solution 1 - Python
coverage html --omit="*/test*" -d tests/coverage
Solution 2 - Python
Create .coveragerc
file in your project root folder, and include the following:
[run]
omit = *tests*
Solution 3 - Python
Leaving this here in case if any Django developer needs a .coveragerc for his project.
[run]
source = .
omit = ./venv/*,*tests*,*apps.py,*manage.py,*__init__.py,*migrations*,*asgi*,*wsgi*,*admin.py,*urls.py
[report]
omit = ./venv/*,*tests*,*apps.py,*manage.py,*__init__.py,*migrations*,*asgi*,*wsgi*,*admin.py,*urls.py
Create a file named .coveragerc on your projects root directory, paste the above code and then just run the command:
coverage run manage.py test
In addition, if you want the tests to execute faster run this command instead.
coverage run manage.py test --keepdb --parallel
This will preserve the test DB and will run the tests in parallel.
Solution 4 - Python
You can specify the directories you want to exclude by creating a .coveragerc
in the project root.
It supports wildcards (which you can use to exclude virtual environment) and comments (very useful for effective tracking).
The below code block shows how omit
can be used (taken from the latest documentation) with multiple files and directories.
[run]
omit =
# omit anything in a .local directory anywhere
*/.local/*
# omit everything in /usr
/usr/*
# omit this single file
utils/tirefire.py
In your case, you could have the following in your .coveragerc
:
[run]
omit =
# ignore all test cases in tests/
tests/*
For your question on coverage reports, you can think about testing and coverage in the following manner:
-
When you run
pytest
orunittest
, all the test cases for your source code are executed -
When you run
coverage
, it shows the part of the source code that isn't being used. -
When you run pytest with coverage (something like
pytest -v --cov
), it runs all test cases and shows the part of the source code that isn't being used.
Extra:
- You can also specify the location of your HTML report in the configuration file like:
[html]
directory = tests/coverage/html_report/
This is going to create html, js, css, etc. inside tests/coverage/html_report/
everytime you run coverage
or pytest -v --cov
Solution 5 - Python
You can also explicitly specify which directory has the code you want coverage on instead of saying which things to omit. In a .coveragerc
file, if the directory of interest is called demo
, this looks like
[run]
source = demo