diff options
| author | Ned Batchelder <ned@nedbatchelder.com> | 2021-03-18 06:16:02 -0400 |
|---|---|---|
| committer | Ned Batchelder <ned@nedbatchelder.com> | 2021-03-18 06:16:02 -0400 |
| commit | 1307eaa36ecfa908c13df2c3dbad0a0dc67027b4 (patch) | |
| tree | f18aaaeb6d513671bd33164b8ce5f0cae6eecec1 /doc | |
| parent | 82bca5a760c43fc178123d93fc8998fe20f2b92e (diff) | |
| download | python-coveragepy-git-1307eaa36ecfa908c13df2c3dbad0a0dc67027b4.tar.gz | |
docs: clarify the --source values
On the Test & Code podcast (https://testandcode.com/148) Brian Okken
explained why the old wording was confusing. I hope this makes it
clearer.
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/source.rst | 6 |
1 files changed, 4 insertions, 2 deletions
diff --git a/doc/source.rst b/doc/source.rst index 241c3d96..9ca544ab 100644 --- a/doc/source.rst +++ b/doc/source.rst @@ -27,8 +27,10 @@ all code, unless it is part of the Python standard library. You can specify source to measure with the ``--source`` command-line switch, or the ``[run] source`` configuration value. The value is a comma- or -newline-separated list of directories or package names. If specified, only -source inside these directories or packages will be measured. Specifying the +newline-separated list of directories or importable names (packages or modules). + +If the source option is specified, only +code those locations will be measured. Specifying the source option also enables coverage.py to report on unexecuted files, since it can search the source tree for files that haven't been measured at all. Only importable files (ones at the root of the tree, or in directories with a |