blob: d8f4ef5687324c1d764d97fa068fb9e558a2ef18 (
plain)
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
43
44
45
46
47
48
49
50
51
52
53
|
.. _plugins:
=======
Plugins
=======
.. :history: 20150124T143000, new page.
Coverage.py's behavior can be extended by writing plugins. A plugin is a
separately installed Python class that you register in your .coveragerc.
Plugins can be used to implement coverage measurement for non-Python files.
Using plugins
-------------
To use a coverage.py plugin, you install it, and configure it. For this
example, let's say you want to use one called fred_plugin.
#. Install the plugin as you would any other Python package::
pip install fred_plugin
#. Configure coverage.py to use the plugin. You do this by editing (or
creating) your .coveragerc file, as described in :ref:`config`. The
``plugins`` setting indicates your plugin::
[run]
plugins =
fred_plugin
#. Run your tests as you usually would. NOTE: You will see a warning when
coverage starts::
Coverage.py warning: Setting timid=True to support plugins.
This means that coverage will run slower than it usually would. This
limitation is part of the initial alpha release, it will be gone in the
final version.
Plugin API
----------
.. module:: coverage.plugin
.. autoclass:: CoveragePlugin
:members:
.. autoclass:: FileTracer
:members:
.. autoclass:: FileReporter
:members:
|
