html report --skip-covered with branches #433issue-433-2

Add a test because the code path is significantly different.

Also document --skip-covered with the coverage html command.

close #433

2 files changed, 20 insertions, 0 deletions

diff --git a/doc/cmd.rst b/doc/cmd.rst
index bbeff18..8b97ce3 100644
--- a/doc/cmd.rst
+++ b/doc/cmd.rst
@@ -366,6 +366,8 @@ is a data file that is used to speed up reporting the next time.  If you
 generate a new report into the same directory, coverage.py will skip
 generating unchanged pages, making the process faster.
 
+The ``--skip-covered`` switch will leave out any file with 100% coverage,
+letting you focus on the files that still need attention.
 
 .. _cmd_annotation:
 
diff --git a/tests/test_html.py b/tests/test_html.py
index b981362..bf47301 100644
--- a/tests/test_html.py
+++ b/tests/test_html.py
@@ -465,6 +465,24 @@ class HtmlTest(HtmlTestHelpers, CoverageTest):
         self.assert_doesnt_exist("htmlcov/main_py.html")
         self.assert_exists("htmlcov/not_covered_py.html")
 
+    def test_report_skip_covered_branches(self):
+        self.make_file("main.py", """
+            import not_covered
+
+            def normal():
+                print("z")
+            normal()
+        """)
+        self.make_file("not_covered.py", """
+            def not_covered():
+                print("n")
+        """)
+        self.run_command("coverage run --branch main.py")
+        self.run_command("coverage html --skip-covered")
+        self.assert_exists("htmlcov/index.html")
+        self.assert_doesnt_exist("htmlcov/main_py.html")
+        self.assert_exists("htmlcov/not_covered_py.html")
+
 
 class HtmlStaticFileTest(CoverageTest):
     """Tests of the static file copying for the HTML report."""