1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42
|
Coverage
========
``fiscalyear`` uses ``pytest-cov`` to determine the percentage of the code base that is covered by unit tests. You will need to install the following packages to run the coverage tests yourself.
* `pytest <https://docs.pytest.org/en/latest/>`_
* `pytest-cov <https://github.com/pytest-dev/pytest-cov>`_
* `pytest-mock <https://github.com/pytest-dev/pytest-mock/>`_
Running coverage tests
----------------------
Once you have the dependencies installed, you can run the coverage tests locally.
.. code-block:: console
$ pytest --cov=fiscalyear
============================ test session starts =============================
platform darwin -- Python 2.7.13, pytest-3.0.5, py-1.4.32, pluggy-0.4.0
rootdir: /Users/Adam/fiscalyear, inifile:
plugins: cov-2.3.1
collected 66 items
test_fiscalyear.py ..................................................................
---------- coverage: platform darwin, python 2.7.13-final-0 ----------
Name Stmts Miss Cover
-----------------------------------
fiscalyear.py 233 0 100%
========================= 66 passed in 0.21 seconds ==========================
``fiscalyear`` always strives for 100% coverage, and won't accept pull requests that aren't covered by unit tests.
Continuous Integration (CI)
---------------------------
In addition to unit tests, GitHub Actions also runs coverage tests. The results of these tests are reported back to `codecov <https://codecov.io/gh>`_ and displayed through a badge on the README.
|