Now the title of the HTML report can be set.

3 files changed, 46 insertions, 12 deletions

diff --git a/test/test_cmdline.py b/test/test_cmdline.py
index af46d95..eb7fe0f 100644
--- a/test/test_cmdline.py
+++ b/test/test_cmdline.py
@@ -251,35 +251,35 @@ class ClassicCmdLineTest(CmdLineTest):
     def test_html_report(self):
         # coverage -b -d DIR [-i] [-o DIR,...] [FILE1 FILE2 ...]
         self.cmd_executes("-b", self.INIT_LOAD + """\
-            .html_report(directory=None, ignore_errors=None,
+            .html_report(directory=None, ignore_errors=None, title=None,
                     omit=None, include=None, morfs=[])
             """)
         self.cmd_executes("-b -d dir1", self.INIT_LOAD + """\
-            .html_report(directory="dir1", ignore_errors=None,
+            .html_report(directory="dir1", ignore_errors=None, title=None,
                     omit=None, include=None, morfs=[])
             """)
         self.cmd_executes("-b -i", self.INIT_LOAD + """\
-            .html_report(directory=None, ignore_errors=True,
+            .html_report(directory=None, ignore_errors=True, title=None,
                     omit=None, include=None, morfs=[])
             """)
         self.cmd_executes("-b -o fooey", """\
             .coverage(cover_pylib=None, data_suffix=None, timid=None, branch=None, config_file=True, source=None, include=None, omit=["fooey"])
             .load()
-            .html_report(directory=None, ignore_errors=None,
+            .html_report(directory=None, ignore_errors=None, title=None,
                     omit=["fooey"], include=None, morfs=[])
             """)
         self.cmd_executes("-b -o fooey,booey", """\
             .coverage(cover_pylib=None, data_suffix=None, timid=None, branch=None, config_file=True, source=None, include=None, omit=["fooey", "booey"])
             .load()
-            .html_report(directory=None, ignore_errors=None,
+            .html_report(directory=None, ignore_errors=None, title=None,
                     omit=["fooey", "booey"], include=None, morfs=[])
             """)
         self.cmd_executes("-b mod1", self.INIT_LOAD + """\
-            .html_report(directory=None, ignore_errors=None,
+            .html_report(directory=None, ignore_errors=None, title=None,
                     omit=None, include=None, morfs=["mod1"])
             """)
         self.cmd_executes("-b mod1 mod2 mod3", self.INIT_LOAD + """\
-            .html_report(directory=None, ignore_errors=None,
+            .html_report(directory=None, ignore_errors=None, title=None,
                     omit=None, include=None, morfs=["mod1", "mod2", "mod3"])
             """)
 
@@ -447,6 +447,14 @@ class NewCmdLineTest(CmdLineTest):
         self.cmd_executes_same("html --omit f,b", "-b --omit f,b")
         self.cmd_executes_same("html m1", "-b m1")
         self.cmd_executes_same("html m1 m2 m3", "-b m1 m2 m3")
+        self.cmd_executes("html", self.INIT_LOAD + """\
+            .html_report(ignore_errors=None, omit=None, include=None, morfs=[],
+                    directory=None, title=None)
+            """)
+        self.cmd_executes("html --title=Hello_there", self.INIT_LOAD + """\
+            .html_report(ignore_errors=None, omit=None, include=None, morfs=[],
+                    directory=None, title='Hello_there')
+            """)
 
     def test_report(self):
         self.cmd_executes_same("report", "-r")
diff --git a/test/test_config.py b/test/test_config.py
index 4fc658f..a73ef34 100644
--- a/test/test_config.py
+++ b/test/test_config.py
@@ -139,6 +139,7 @@ class ConfigFileTest(CoverageTest):
 
             directory    =     c:\\tricky\\dir.somewhere
             extra_css=something/extra.css
+            title = My report & stuff # numbers
             [xml]
             output=mycov.xml
 
@@ -177,6 +178,7 @@ class ConfigFileTest(CoverageTest):
         self.assertTrue(cov.config.show_missing)
         self.assertEqual(cov.config.html_dir, r"c:\tricky\dir.somewhere")
         self.assertEqual(cov.config.extra_css, "something/extra.css")
+        self.assertEqual(cov.config.html_title, "My report & stuff # numbers")
 
         self.assertEqual(cov.config.xml_output, "mycov.xml")
 
diff --git a/test/test_html.py b/test/test_html.py
index 1877a30..73e46b2 100644
--- a/test/test_html.py
+++ b/test/test_html.py
@@ -1,3 +1,4 @@
+# -*- coding: utf-8 -*-
 """Tests that HTML generation is awesome."""
 
 import os.path, sys
@@ -38,14 +39,14 @@ class HtmlTest(CoverageTest):
                 print("x is %d" % x)
             """)
 
-    def run_coverage(self, **kwargs):
+    def run_coverage(self, covargs=None, htmlargs=None):
         """Run coverage on main_file.py, and create an HTML report."""
         self.clean_local_file_imports()
-        cov = coverage.coverage(**kwargs)
+        cov = coverage.coverage(**(covargs or {}))
         cov.start()
         self.import_local_file("main_file")
         cov.stop()
-        cov.html_report()
+        cov.html_report(**(htmlargs or {}))
 
     def remove_html_files(self):
         """Remove the HTML files created as part of the HTML report."""
@@ -118,11 +119,11 @@ class HtmlTest(CoverageTest):
         # In this case, everything changes because the coverage settings have
         # changed.
         self.create_initial_files()
-        self.run_coverage(timid=False)
+        self.run_coverage(covargs=dict(timid=False))
         index1 = open("htmlcov/index.html").read()
         self.remove_html_files()
 
-        self.run_coverage(timid=True)
+        self.run_coverage(covargs=dict(timid=True))
 
         # All the files have been reported again.
         self.assert_exists("htmlcov/index.html")
@@ -155,6 +156,29 @@ class HtmlTest(CoverageTest):
         fixed_index2 = index2.replace("XYZZY", self.real_coverage_version)
         self.assertMultiLineEqual(index1, fixed_index2)
 
+    def test_default_title(self):
+        self.create_initial_files()
+        self.run_coverage()
+        index = open("htmlcov/index.html").read()
+        self.assertIn("<title>Coverage report</title>", index)
+        self.assertIn("<h1>Coverage report:", index)
+
+    def test_title_set_in_config_file(self):
+        self.create_initial_files()
+        self.make_file(".coveragerc", "[html]\ntitle = My nüms & stüff!\n")
+        self.run_coverage()
+        index = open("htmlcov/index.html").read()
+        self.assertIn("<title>My n&#252;ms &amp; st&#252;ff!</title>", index)
+        self.assertIn("<h1>My n&#252;ms &amp; st&#252;ff!:", index)
+
+    def test_title_set_in_args(self):
+        self.create_initial_files()
+        self.make_file(".coveragerc", "[html]\ntitle = Good title\n")
+        self.run_coverage(htmlargs=dict(title="My nüms & stüff!"))
+        index = open("htmlcov/index.html").read()
+        self.assertIn("<title>My n&#252;ms &amp; st&#252;ff!</title>", index)
+        self.assertIn("<h1>My n&#252;ms &amp; st&#252;ff!:", index)
+
 
 class HtmlWithUnparsableFilesTest(CoverageTest):
     """Test the behavior when measuring unparsable files."""