| Index: tools/telemetry/third_party/coverage/tests/test_api.py
|
| diff --git a/tools/telemetry/third_party/coverage/tests/test_api.py b/tools/telemetry/third_party/coverage/tests/test_api.py
|
| new file mode 100644
|
| index 0000000000000000000000000000000000000000..92d3cbc9fd9470500002b881659a7e123af5c429
|
| --- /dev/null
|
| +++ b/tools/telemetry/third_party/coverage/tests/test_api.py
|
| @@ -0,0 +1,515 @@
|
| +# Licensed under the Apache License: http://www.apache.org/licenses/LICENSE-2.0
|
| +# For details: https://bitbucket.org/ned/coveragepy/src/default/NOTICE.txt
|
| +
|
| +"""Tests for coverage.py's API."""
|
| +
|
| +import fnmatch
|
| +import os
|
| +import sys
|
| +import textwrap
|
| +
|
| +import coverage
|
| +from coverage.backward import StringIO
|
| +from coverage.misc import CoverageException
|
| +
|
| +from tests.coveragetest import CoverageTest
|
| +
|
| +
|
| +class ApiTest(CoverageTest):
|
| + """Api-oriented tests for coverage.py."""
|
| +
|
| + def clean_files(self, files, pats):
|
| + """Remove names matching `pats` from `files`, a list of file names."""
|
| + good = []
|
| + for f in files:
|
| + for pat in pats:
|
| + if fnmatch.fnmatch(f, pat):
|
| + break
|
| + else:
|
| + good.append(f)
|
| + return good
|
| +
|
| + def assertFiles(self, files):
|
| + """Assert that the files here are `files`, ignoring the usual junk."""
|
| + here = os.listdir(".")
|
| + here = self.clean_files(here, ["*.pyc", "__pycache__"])
|
| + self.assertCountEqual(here, files)
|
| +
|
| + def test_unexecuted_file(self):
|
| + cov = coverage.Coverage()
|
| +
|
| + self.make_file("mycode.py", """\
|
| + a = 1
|
| + b = 2
|
| + if b == 3:
|
| + c = 4
|
| + d = 5
|
| + """)
|
| +
|
| + self.make_file("not_run.py", """\
|
| + fooey = 17
|
| + """)
|
| +
|
| + # Import the Python file, executing it.
|
| + self.start_import_stop(cov, "mycode")
|
| +
|
| + _, statements, missing, _ = cov.analysis("not_run.py")
|
| + self.assertEqual(statements, [1])
|
| + self.assertEqual(missing, [1])
|
| +
|
| + def test_filenames(self):
|
| +
|
| + self.make_file("mymain.py", """\
|
| + import mymod
|
| + a = 1
|
| + """)
|
| +
|
| + self.make_file("mymod.py", """\
|
| + fooey = 17
|
| + """)
|
| +
|
| + # Import the Python file, executing it.
|
| + cov = coverage.Coverage()
|
| + self.start_import_stop(cov, "mymain")
|
| +
|
| + filename, _, _, _ = cov.analysis("mymain.py")
|
| + self.assertEqual(os.path.basename(filename), "mymain.py")
|
| + filename, _, _, _ = cov.analysis("mymod.py")
|
| + self.assertEqual(os.path.basename(filename), "mymod.py")
|
| +
|
| + filename, _, _, _ = cov.analysis(sys.modules["mymain"])
|
| + self.assertEqual(os.path.basename(filename), "mymain.py")
|
| + filename, _, _, _ = cov.analysis(sys.modules["mymod"])
|
| + self.assertEqual(os.path.basename(filename), "mymod.py")
|
| +
|
| + # Import the Python file, executing it again, once it's been compiled
|
| + # already.
|
| + cov = coverage.Coverage()
|
| + self.start_import_stop(cov, "mymain")
|
| +
|
| + filename, _, _, _ = cov.analysis("mymain.py")
|
| + self.assertEqual(os.path.basename(filename), "mymain.py")
|
| + filename, _, _, _ = cov.analysis("mymod.py")
|
| + self.assertEqual(os.path.basename(filename), "mymod.py")
|
| +
|
| + filename, _, _, _ = cov.analysis(sys.modules["mymain"])
|
| + self.assertEqual(os.path.basename(filename), "mymain.py")
|
| + filename, _, _, _ = cov.analysis(sys.modules["mymod"])
|
| + self.assertEqual(os.path.basename(filename), "mymod.py")
|
| +
|
| + def test_ignore_stdlib(self):
|
| + self.make_file("mymain.py", """\
|
| + import colorsys
|
| + a = 1
|
| + hls = colorsys.rgb_to_hls(1.0, 0.5, 0.0)
|
| + """)
|
| +
|
| + # Measure without the stdlib.
|
| + cov1 = coverage.Coverage()
|
| + self.assertEqual(cov1.config.cover_pylib, False)
|
| + self.start_import_stop(cov1, "mymain")
|
| +
|
| + # some statements were marked executed in mymain.py
|
| + _, statements, missing, _ = cov1.analysis("mymain.py")
|
| + self.assertNotEqual(statements, missing)
|
| + # but none were in colorsys.py
|
| + _, statements, missing, _ = cov1.analysis("colorsys.py")
|
| + self.assertEqual(statements, missing)
|
| +
|
| + # Measure with the stdlib.
|
| + cov2 = coverage.Coverage(cover_pylib=True)
|
| + self.start_import_stop(cov2, "mymain")
|
| +
|
| + # some statements were marked executed in mymain.py
|
| + _, statements, missing, _ = cov2.analysis("mymain.py")
|
| + self.assertNotEqual(statements, missing)
|
| + # and some were marked executed in colorsys.py
|
| + _, statements, missing, _ = cov2.analysis("colorsys.py")
|
| + self.assertNotEqual(statements, missing)
|
| +
|
| + def test_include_can_measure_stdlib(self):
|
| + self.make_file("mymain.py", """\
|
| + import colorsys, random
|
| + a = 1
|
| + r, g, b = [random.random() for _ in range(3)]
|
| + hls = colorsys.rgb_to_hls(r, g, b)
|
| + """)
|
| +
|
| + # Measure without the stdlib, but include colorsys.
|
| + cov1 = coverage.Coverage(cover_pylib=False, include=["*/colorsys.py"])
|
| + self.start_import_stop(cov1, "mymain")
|
| +
|
| + # some statements were marked executed in colorsys.py
|
| + _, statements, missing, _ = cov1.analysis("colorsys.py")
|
| + self.assertNotEqual(statements, missing)
|
| + # but none were in random.py
|
| + _, statements, missing, _ = cov1.analysis("random.py")
|
| + self.assertEqual(statements, missing)
|
| +
|
| + def test_exclude_list(self):
|
| + cov = coverage.Coverage()
|
| + cov.clear_exclude()
|
| + self.assertEqual(cov.get_exclude_list(), [])
|
| + cov.exclude("foo")
|
| + self.assertEqual(cov.get_exclude_list(), ["foo"])
|
| + cov.exclude("bar")
|
| + self.assertEqual(cov.get_exclude_list(), ["foo", "bar"])
|
| + self.assertEqual(cov._exclude_regex('exclude'), "(?:foo)|(?:bar)")
|
| + cov.clear_exclude()
|
| + self.assertEqual(cov.get_exclude_list(), [])
|
| +
|
| + def test_exclude_partial_list(self):
|
| + cov = coverage.Coverage()
|
| + cov.clear_exclude(which='partial')
|
| + self.assertEqual(cov.get_exclude_list(which='partial'), [])
|
| + cov.exclude("foo", which='partial')
|
| + self.assertEqual(cov.get_exclude_list(which='partial'), ["foo"])
|
| + cov.exclude("bar", which='partial')
|
| + self.assertEqual(cov.get_exclude_list(which='partial'), ["foo", "bar"])
|
| + self.assertEqual(
|
| + cov._exclude_regex(which='partial'), "(?:foo)|(?:bar)"
|
| + )
|
| + cov.clear_exclude(which='partial')
|
| + self.assertEqual(cov.get_exclude_list(which='partial'), [])
|
| +
|
| + def test_exclude_and_partial_are_separate_lists(self):
|
| + cov = coverage.Coverage()
|
| + cov.clear_exclude(which='partial')
|
| + cov.clear_exclude(which='exclude')
|
| + cov.exclude("foo", which='partial')
|
| + self.assertEqual(cov.get_exclude_list(which='partial'), ['foo'])
|
| + self.assertEqual(cov.get_exclude_list(which='exclude'), [])
|
| + cov.exclude("bar", which='exclude')
|
| + self.assertEqual(cov.get_exclude_list(which='partial'), ['foo'])
|
| + self.assertEqual(cov.get_exclude_list(which='exclude'), ['bar'])
|
| + cov.exclude("p2", which='partial')
|
| + cov.exclude("e2", which='exclude')
|
| + self.assertEqual(cov.get_exclude_list(which='partial'), ['foo', 'p2'])
|
| + self.assertEqual(cov.get_exclude_list(which='exclude'), ['bar', 'e2'])
|
| + cov.clear_exclude(which='partial')
|
| + self.assertEqual(cov.get_exclude_list(which='partial'), [])
|
| + self.assertEqual(cov.get_exclude_list(which='exclude'), ['bar', 'e2'])
|
| + cov.clear_exclude(which='exclude')
|
| + self.assertEqual(cov.get_exclude_list(which='partial'), [])
|
| + self.assertEqual(cov.get_exclude_list(which='exclude'), [])
|
| +
|
| + def test_datafile_default(self):
|
| + # Default data file behavior: it's .coverage
|
| + self.make_file("datatest1.py", """\
|
| + fooey = 17
|
| + """)
|
| +
|
| + self.assertFiles(["datatest1.py"])
|
| + cov = coverage.Coverage()
|
| + self.start_import_stop(cov, "datatest1")
|
| + cov.save()
|
| + self.assertFiles(["datatest1.py", ".coverage"])
|
| +
|
| + def test_datafile_specified(self):
|
| + # You can specify the data file name.
|
| + self.make_file("datatest2.py", """\
|
| + fooey = 17
|
| + """)
|
| +
|
| + self.assertFiles(["datatest2.py"])
|
| + cov = coverage.Coverage(data_file="cov.data")
|
| + self.start_import_stop(cov, "datatest2")
|
| + cov.save()
|
| + self.assertFiles(["datatest2.py", "cov.data"])
|
| +
|
| + def test_datafile_and_suffix_specified(self):
|
| + # You can specify the data file name and suffix.
|
| + self.make_file("datatest3.py", """\
|
| + fooey = 17
|
| + """)
|
| +
|
| + self.assertFiles(["datatest3.py"])
|
| + cov = coverage.Coverage(data_file="cov.data", data_suffix="14")
|
| + self.start_import_stop(cov, "datatest3")
|
| + cov.save()
|
| + self.assertFiles(["datatest3.py", "cov.data.14"])
|
| +
|
| + def test_datafile_from_rcfile(self):
|
| + # You can specify the data file name in the .coveragerc file
|
| + self.make_file("datatest4.py", """\
|
| + fooey = 17
|
| + """)
|
| + self.make_file(".coveragerc", """\
|
| + [run]
|
| + data_file = mydata.dat
|
| + """)
|
| +
|
| + self.assertFiles(["datatest4.py", ".coveragerc"])
|
| + cov = coverage.Coverage()
|
| + self.start_import_stop(cov, "datatest4")
|
| + cov.save()
|
| + self.assertFiles(["datatest4.py", ".coveragerc", "mydata.dat"])
|
| +
|
| + def test_empty_reporting(self):
|
| + # empty summary reports raise exception, just like the xml report
|
| + cov = coverage.Coverage()
|
| + cov.erase()
|
| + self.assertRaises(CoverageException, cov.report)
|
| +
|
| + def test_start_stop_start_stop(self):
|
| + self.make_file("code1.py", """\
|
| + code1 = 1
|
| + """)
|
| + self.make_file("code2.py", """\
|
| + code2 = 1
|
| + code2 = 2
|
| + """)
|
| + cov = coverage.Coverage()
|
| + self.start_import_stop(cov, "code1")
|
| + cov.save()
|
| + self.start_import_stop(cov, "code2")
|
| + _, statements, missing, _ = cov.analysis("code1.py")
|
| + self.assertEqual(statements, [1])
|
| + self.assertEqual(missing, [])
|
| + _, statements, missing, _ = cov.analysis("code2.py")
|
| + self.assertEqual(statements, [1, 2])
|
| + self.assertEqual(missing, [])
|
| +
|
| + if 0: # expected failure
|
| + # for https://bitbucket.org/ned/coveragepy/issue/79
|
| + def test_start_save_stop(self):
|
| + self.make_file("code1.py", """\
|
| + code1 = 1
|
| + """)
|
| + self.make_file("code2.py", """\
|
| + code2 = 1
|
| + code2 = 2
|
| + """)
|
| + cov = coverage.Coverage()
|
| + cov.start()
|
| + self.import_local_file("code1")
|
| + cov.save()
|
| + self.import_local_file("code2")
|
| + cov.stop()
|
| +
|
| + _, statements, missing, _ = cov.analysis("code1.py")
|
| + self.assertEqual(statements, [1])
|
| + self.assertEqual(missing, [])
|
| + _, statements, missing, _ = cov.analysis("code2.py")
|
| + self.assertEqual(statements, [1, 2])
|
| + self.assertEqual(missing, [])
|
| +
|
| +
|
| +
|
| +class UsingModulesMixin(object):
|
| + """A mixin for importing modules from test/modules and test/moremodules."""
|
| +
|
| + run_in_temp_dir = False
|
| +
|
| + def setUp(self):
|
| + super(UsingModulesMixin, self).setUp()
|
| +
|
| + old_dir = os.getcwd()
|
| + os.chdir(self.nice_file(os.path.dirname(__file__), 'modules'))
|
| + self.addCleanup(os.chdir, old_dir)
|
| +
|
| + # Parent class saves and restores sys.path, we can just modify it.
|
| + sys.path.append(".")
|
| + sys.path.append("../moremodules")
|
| +
|
| +
|
| +class OmitIncludeTestsMixin(UsingModulesMixin):
|
| + """Test methods for coverage methods taking include and omit."""
|
| +
|
| + def filenames_in(self, summary, filenames):
|
| + """Assert the `filenames` are in the keys of `summary`."""
|
| + for filename in filenames.split():
|
| + self.assertIn(filename, summary)
|
| +
|
| + def filenames_not_in(self, summary, filenames):
|
| + """Assert the `filenames` are not in the keys of `summary`."""
|
| + for filename in filenames.split():
|
| + self.assertNotIn(filename, summary)
|
| +
|
| + def test_nothing_specified(self):
|
| + result = self.coverage_usepkgs()
|
| + self.filenames_in(result, "p1a p1b p2a p2b othera otherb osa osb")
|
| + self.filenames_not_in(result, "p1c")
|
| + # Because there was no source= specified, we don't search for
|
| + # unexecuted files.
|
| +
|
| + def test_include(self):
|
| + result = self.coverage_usepkgs(include=["*/p1a.py"])
|
| + self.filenames_in(result, "p1a")
|
| + self.filenames_not_in(result, "p1b p1c p2a p2b othera otherb osa osb")
|
| +
|
| + def test_include_2(self):
|
| + result = self.coverage_usepkgs(include=["*a.py"])
|
| + self.filenames_in(result, "p1a p2a othera osa")
|
| + self.filenames_not_in(result, "p1b p1c p2b otherb osb")
|
| +
|
| + def test_include_as_string(self):
|
| + result = self.coverage_usepkgs(include="*a.py")
|
| + self.filenames_in(result, "p1a p2a othera osa")
|
| + self.filenames_not_in(result, "p1b p1c p2b otherb osb")
|
| +
|
| + def test_omit(self):
|
| + result = self.coverage_usepkgs(omit=["*/p1a.py"])
|
| + self.filenames_in(result, "p1b p2a p2b")
|
| + self.filenames_not_in(result, "p1a p1c")
|
| +
|
| + def test_omit_2(self):
|
| + result = self.coverage_usepkgs(omit=["*a.py"])
|
| + self.filenames_in(result, "p1b p2b otherb osb")
|
| + self.filenames_not_in(result, "p1a p1c p2a othera osa")
|
| +
|
| + def test_omit_as_string(self):
|
| + result = self.coverage_usepkgs(omit="*a.py")
|
| + self.filenames_in(result, "p1b p2b otherb osb")
|
| + self.filenames_not_in(result, "p1a p1c p2a othera osa")
|
| +
|
| + def test_omit_and_include(self):
|
| + result = self.coverage_usepkgs(include=["*/p1*"], omit=["*/p1a.py"])
|
| + self.filenames_in(result, "p1b")
|
| + self.filenames_not_in(result, "p1a p1c p2a p2b")
|
| +
|
| +
|
| +class SourceOmitIncludeTest(OmitIncludeTestsMixin, CoverageTest):
|
| + """Test using `source`, `omit` and `include` when measuring code."""
|
| +
|
| + def coverage_usepkgs(self, **kwargs):
|
| + """Run coverage on usepkgs and return the line summary.
|
| +
|
| + Arguments are passed to the `coverage.Coverage` constructor.
|
| +
|
| + """
|
| + cov = coverage.Coverage(**kwargs)
|
| + cov.start()
|
| + import usepkgs # pragma: nested # pylint: disable=import-error,unused-variable
|
| + cov.stop() # pragma: nested
|
| + data = cov.get_data()
|
| + summary = data.line_counts()
|
| + for k, v in list(summary.items()):
|
| + assert k.endswith(".py")
|
| + summary[k[:-3]] = v
|
| + return summary
|
| +
|
| + def test_source_package(self):
|
| + lines = self.coverage_usepkgs(source=["pkg1"])
|
| + self.filenames_in(lines, "p1a p1b")
|
| + self.filenames_not_in(lines, "p2a p2b othera otherb osa osb")
|
| + # Because source= was specified, we do search for unexecuted files.
|
| + self.assertEqual(lines['p1c'], 0)
|
| +
|
| + def test_source_package_dotted(self):
|
| + lines = self.coverage_usepkgs(source=["pkg1.p1b"])
|
| + self.filenames_in(lines, "p1b")
|
| + self.filenames_not_in(lines, "p1a p1c p2a p2b othera otherb osa osb")
|
| +
|
| + def test_source_package_part_omitted(self):
|
| + # https://bitbucket.org/ned/coveragepy/issue/218
|
| + # Used to be if you omitted something executed and inside the source,
|
| + # then after it was executed but not recorded, it would be found in
|
| + # the search for unexecuted files, and given a score of 0%.
|
| + lines = self.coverage_usepkgs(source=["pkg1"], omit=["pkg1/p1b.py"])
|
| + self.filenames_in(lines, "p1a")
|
| + self.filenames_not_in(lines, "p1b")
|
| + self.assertEqual(lines['p1c'], 0)
|
| +
|
| +
|
| +class ReportIncludeOmitTest(OmitIncludeTestsMixin, CoverageTest):
|
| + """Tests of the report include/omit functionality."""
|
| +
|
| + def coverage_usepkgs(self, **kwargs):
|
| + """Try coverage.report()."""
|
| + cov = coverage.Coverage()
|
| + cov.start()
|
| + import usepkgs # pragma: nested # pylint: disable=import-error,unused-variable
|
| + cov.stop() # pragma: nested
|
| + report = StringIO()
|
| + cov.report(file=report, **kwargs)
|
| + return report.getvalue()
|
| +
|
| +
|
| +class XmlIncludeOmitTest(OmitIncludeTestsMixin, CoverageTest):
|
| + """Tests of the XML include/omit functionality.
|
| +
|
| + This also takes care of the HTML and annotate include/omit, by virtue
|
| + of the structure of the code.
|
| +
|
| + """
|
| +
|
| + def coverage_usepkgs(self, **kwargs):
|
| + """Try coverage.xml_report()."""
|
| + cov = coverage.Coverage()
|
| + cov.start()
|
| + import usepkgs # pragma: nested # pylint: disable=import-error,unused-variable
|
| + cov.stop() # pragma: nested
|
| + cov.xml_report(outfile="-", **kwargs)
|
| + return self.stdout()
|
| +
|
| +
|
| +class AnalysisTest(CoverageTest):
|
| + """Test the numerical analysis of results."""
|
| + def test_many_missing_branches(self):
|
| + cov = coverage.Coverage(branch=True)
|
| +
|
| + self.make_file("missing.py", """\
|
| + def fun1(x):
|
| + if x == 1:
|
| + print("one")
|
| + else:
|
| + print("not one")
|
| + print("done") # pragma: nocover
|
| +
|
| + def fun2(x):
|
| + print("x")
|
| +
|
| + fun2(3)
|
| + """)
|
| +
|
| + # Import the Python file, executing it.
|
| + self.start_import_stop(cov, "missing")
|
| +
|
| + nums = cov._analyze("missing.py").numbers
|
| + self.assertEqual(nums.n_files, 1)
|
| + self.assertEqual(nums.n_statements, 7)
|
| + self.assertEqual(nums.n_excluded, 1)
|
| + self.assertEqual(nums.n_missing, 3)
|
| + self.assertEqual(nums.n_branches, 2)
|
| + self.assertEqual(nums.n_partial_branches, 0)
|
| + self.assertEqual(nums.n_missing_branches, 2)
|
| +
|
| +
|
| +class PluginTest(CoverageTest):
|
| + """Test that the API works properly the way the plugins call it.
|
| +
|
| + We don't actually use the plugins, but these tests call the API the same
|
| + way they do.
|
| +
|
| + """
|
| + def pretend_to_be_nose_with_cover(self, erase):
|
| + """This is what the nose --with-cover plugin does."""
|
| + cov = coverage.Coverage()
|
| +
|
| + self.make_file("no_biggie.py", """\
|
| + a = 1
|
| + b = 2
|
| + if b == 1:
|
| + c = 4
|
| + """)
|
| +
|
| + if erase:
|
| + cov.combine()
|
| + cov.erase()
|
| + cov.load()
|
| + self.start_import_stop(cov, "no_biggie")
|
| + cov.combine()
|
| + cov.save()
|
| + cov.report(["no_biggie.py"])
|
| + self.assertEqual(self.stdout(), textwrap.dedent("""\
|
| + Name Stmts Miss Cover Missing
|
| + --------------------------------------------
|
| + no_biggie.py 4 1 75% 4
|
| + """))
|
| +
|
| + def test_nose_plugin(self):
|
| + self.pretend_to_be_nose_with_cover(erase=False)
|
| +
|
| + def test_nose_plugin_with_erase(self):
|
| + self.pretend_to_be_nose_with_cover(erase=True)
|
|
|