File: coverage.rst

package info (click to toggle)
python-fiscalyear 0.4.0-1
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 224 kB
  • sloc: python: 1,362; makefile: 14
file content (42 lines) | stat: -rw-r--r-- 1,555 bytes parent folder | download
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.