summaryrefslogtreecommitdiff
path: root/doc/cmd.rst
diff options
context:
space:
mode:
authorNed Batchelder <ned@nedbatchelder.com>2012-11-03 22:17:35 -0400
committerNed Batchelder <ned@nedbatchelder.com>2012-11-03 22:17:35 -0400
commit99a352c787ad1b214b601b7cbc7c5c82fd9b84fe (patch)
treefaf43834ede0a0ca505a7da5f1b0029da30bb418 /doc/cmd.rst
parent69e0a37098edba20e24fe8fa80e6960c53e2c3c7 (diff)
downloadpython-coveragepy-git-99a352c787ad1b214b601b7cbc7c5c82fd9b84fe.tar.gz
Issue #139: Now the report, html, and xml commands take a --fail-under=MIN switch, and exit with 2 if the coverage is less than MIN.
Diffstat (limited to 'doc/cmd.rst')
-rw-r--r--doc/cmd.rst5
1 files changed, 5 insertions, 0 deletions
diff --git a/doc/cmd.rst b/doc/cmd.rst
index 45552089..c15857cf 100644
--- a/doc/cmd.rst
+++ b/doc/cmd.rst
@@ -204,6 +204,11 @@ encountered trying to find source files to report on. This can be useful if
some files are missing, or if your Python execution is tricky enough that file
names are synthesized without real source files.
+If you provide a ``--fail-under`` value, the total percentage covered will be
+compared to that value. If it is less, the command will exit with a status
+code of 2, indicating that the total coverage was less than your target. This
+can be used as part of a pass/fail condition, for example in a continuous
+integration server. This option isn't available for **annotate**.
.. _cmd_summary: