diff options
author | Ned Batchelder <ned@nedbatchelder.com> | 2015-07-23 21:22:30 -0400 |
---|---|---|
committer | Ned Batchelder <ned@nedbatchelder.com> | 2015-07-23 21:22:30 -0400 |
commit | d6a7a11f8c5a8e73a9dfd9a1ce602df775d04586 (patch) | |
tree | 07700ed00c3a0d41013f466952cf0d1ebef7b810 /doc/excluding.rst | |
parent | a22d3cad02f5b0f2f76e5ef6b9f09d421ca99b76 (diff) | |
download | python-coveragepy-d6a7a11f8c5a8e73a9dfd9a1ce602df775d04586.tar.gz |
Refer to the project consistenly as coverage.py. #275
Diffstat (limited to 'doc/excluding.rst')
-rw-r--r-- | doc/excluding.rst | 22 |
1 files changed, 11 insertions, 11 deletions
diff --git a/doc/excluding.rst b/doc/excluding.rst index 44c51f9..c306ad4 100644 --- a/doc/excluding.rst +++ b/doc/excluding.rst @@ -1,8 +1,8 @@ .. _excluding: -============================ -Excluding code from coverage -============================ +=============================== +Excluding code from coverage.py +=============================== .. :history: 20090613T090500, brand new docs. .. :history: 20100224T200900, updated for 3.3. @@ -11,13 +11,13 @@ Excluding code from coverage You may have code in your project that you know won't be executed, and you want -to tell coverage to ignore it. For example, you may have debugging-only code -that won't be executed during your unit tests. You can tell coverage to exclude -this code during reporting so that it doesn't clutter your reports with noise -about code that you don't need to hear about. +to tell coverage.py to ignore it. For example, you may have debugging-only +code that won't be executed during your unit tests. You can tell coverage.py to +exclude this code during reporting so that it doesn't clutter your reports with +noise about code that you don't need to hear about. -Coverage will look for comments marking clauses for exclusion. In this code, -the "if debug" clause is excluded from reporting:: +Coverage.py will look for comments marking clauses for exclusion. In this +code, the "if debug" clause is excluded from reporting:: a = my_function1() if debug: # pragma: no cover @@ -39,7 +39,7 @@ function is not reported as missing:: return "<MyObject>" Excluded code is executed as usual, and its execution is recorded in the -coverage data as usual. When producing reports though, coverage excludes it +coverage data as usual. When producing reports though, coverage.py excludes it from the list of missing code. @@ -64,7 +64,7 @@ line, so it isn't considered a branch at all. Advanced exclusion ------------------ -Coverage identifies exclusions by matching lines against a list of regular +Coverage.py identifies exclusions by matching lines against a list of regular expressions. Using :ref:`configuration files <config>` or the coverage :ref:`API <api>`, you can add to that list. This is useful if you have often-used constructs to exclude that can be matched with a regex. You can |