* Performance improvements for combining data files, especially
when measuring line coverage. A few different quadratic
behaviors were eliminated. In one extreme case of combining
700+ data files, the time dropped from more than three hours
to seven minutes. Thanks for Kraken Tech for funding the
fix.
* Performance improvements for generating HTML reports, with a
side benefit of reducing memory use, closing issue 1791.
Thanks to Daniel Diniz for helping to diagnose the problem.
* Fix: nested matches of exclude patterns could exclude too
much code, as reported in issue 1779. This is now fixed.
* Changed: previously, coverage.py would consider a module
docstring to be an executable statement if it appeared after
line 1 in the file, but not executable if it was the first
line. Now module docstrings are never counted as executable
statements. This can change coverage.py's count of the
number of statements in a file, which can slightly change the
coverage percentage reported.
* In the HTML report, the filter term and "hide covered"
checkbox settings are remembered between viewings, thanks to
Daniel Diniz.
* Python 3.13.0b1 is supported.
* Fix: parsing error handling is improved to ensure bizarre
source files are handled gracefully, and to unblock oss-fuzz
fuzzing, thanks to Liam DeVoe. Closes issue 1787.
OBS-URL: https://build.opensuse.org/package/show/devel:languages:python/python-coverage?expand=0&rev=131
* Fix: a pragma comment on the continuation lines of a multi-line statement
now excludes the statement and its body, the same as if the pragma is
on the first line.
* Fix: very complex source files could cause a maximum recursion error when
creating an HTML report.
* HTML report improvements:
+ Support files (JavaScript and CSS) referenced by the HTML report now have
hashes added to their names to ensure updated files are used instead of
stale cached copies.
+ Missing branch coverage explanations that said "the condition was never
false" now read "the condition was always true" because it's easier to
understand.
+ Column sort order is remembered better as you move between the index
pages.
* Added initial support for function and class reporting in the HTML report.
* Other HTML report improvements:
+ There is now a "hide covered" checkbox to filter out 100% files.
+ The index page is always sorted by one of its columns, with clearer
indications of the sorting.
+ The "previous file" shortcut key didn't work on the index page, but now
it does.
* The debug output showing which configuration files were tried now shows
absolute paths to help diagnose problems where settings aren't taking
effect, and is renamed from "attempted_config_files" to the more logical
"config_files_attempted."
* Fix: in some cases, even with [run] relative_files=True, a data file
could be created with absolute path names. When combined with other
relative data files, it was random whether the absolute file names would
be made relative or not. If they weren't, then a file would be listed
OBS-URL: https://build.opensuse.org/package/show/devel:languages:python/python-coverage?expand=0&rev=129
* The ``coverage lcov`` command ignored the ``[report]
exclude_lines`` and ``[report] exclude_also`` settings
* Sometimes SQLite will create journal files alongside the
coverage.py database files. These are ephemeral, but could
be mistakenly included when combining data files.
* On Python 3.12+, we now disable SQLite writing journal files,
which should be a little faster.
* The new 3.12 soft keyword ``type`` is properly bolded in HTML
reports.
* Removed the "fullcoverage" feature used by CPython to measure
the coverage of early-imported standard library modules.
OBS-URL: https://build.opensuse.org/package/show/devel:languages:python/python-coverage?expand=0&rev=127
* The semantics of stars in file patterns has been clarified in
the docs. A leading or trailing star matches any number of path
components, like a double star would. This is different than
the behavior of a star in the middle of a pattern.
since 6.4.3.
- Handle cases where python2 is disabled
- add LICENSE.txt
- python3 package added
- minor spec improvement (files section)
OBS-URL: https://build.opensuse.org/package/show/devel:languages:python/python-coverage?expand=0&rev=125
- Update to 7.2.5:
* Fix: html_report() could fail with an AttributeError on isatty if
run in an unusual environment where sys.stdout had been replaced.
This is now fixed.
- 7.2.4:
* Fix: with relative_files = true, specifying a specific file to
include or omit wouldn't work correctly (issue 1604). This is now
fixed, with testing help by Marc Gibbons.
* Fix: the XML report would have an incorrect <source> element when
using relative files and the source option ended with a slash
(issue 1541). This is now fixed, thanks to Kevin Brown-Silva.
* When the HTML report location is printed to the terminal, it's now
a terminal-compatible URL, so that you can click the location to
open the HTML file in your browser. Finishes issue 1523 thanks to
Ricardo Newbery.
* Docs: a new :ref:`Migrating page <migrating>` with details about
how to migrate between major versions of coverage.py. It currently
covers the wildcard changes in 7.x. Thanks, Brian Grohe.
- 7.2.3:
* Fix: the :ref:`config_run_sigterm` setting was meant to capture
data if a process was terminated with a SIGTERM signal, but it
didn't always. This was fixed thanks to Lewis Gaul, closing issue
1599.
* Performance: HTML reports with context information are now much
more compact. File sizes are typically as small as one-third the
previous size, but can be dramatically smaller. This closes issue
1584 thanks to Oleh Krehel.
* Development dependencies no longer use hashed pins, closing issue
1592.
OBS-URL: https://build.opensuse.org/package/show/devel:languages:python/python-coverage?expand=0&rev=116
* Fix: if a virtualenv was created inside a source directory,
and a sourced package was installed inside the virtualenv,
then all of the third-party packages inside the virtualenv
would be measured. This was incorrect, but
has now been fixed: only the specified packages will be
measured.
* Fix: the ``coverage lcov`` command could create a .lcov file
with incorrect LF (lines found) and LH (lines hit) totals
* Fix: the ``coverage xml`` command on Windows could create a
.xml file with duplicate ``<package>`` elements.
OBS-URL: https://build.opensuse.org/package/show/devel:languages:python/python-coverage?expand=0&rev=112
* Fix: the PyPI page had broken links to documentation pages,
but no longer does
* Fix: public members of the coverage module are now properly
indicated so that mypy will find them
* Added a new setting ``[report] exclude_also`` to let you add
more exclusions without overwriting the defaults.
* Added a :meth:`.CoverageData.purge_files` method to remove
recorded data for a particular file.
* Fix: when reporting commands fail, they will no longer
congratulate themselves with messages like "Wrote XML
report to file.xml" before spewing a traceback about
their failure.
* Fix: arguments in the public API that name file paths now
accept pathlib.Path objects. This includes the
``data_file`` and ``config_file`` arguments to
the Coverage constructor and the ``basename`` argument to
CoverageData.
* Fix: In some embedded environments, an IndexError could occur
on stop() when the originating thread exits before completion.
This is now fixed, thanks to
* Added a ``py.typed`` file to announce our type-hintedness.
OBS-URL: https://build.opensuse.org/package/show/devel:languages:python/python-coverage?expand=0&rev=110
* Added: the debug output file can now be specified with ``[run]
debug_file`` in the configuration file. Closes `issue 1319`_.
* Performance: fixed a slowdown with dynamic contexts that's been around
since 6.4.3.
* Typing: all product and test code has type annotations.
* Fix: On Python 3.7, a file with type annotations but no ``from
__future__ import annotations`` would be missing statements in
the coverage report. This is now fixed, closing `issue 1524`_.
* Performance: an internal cache of file names was accidentally disabled,
resulting in sometimes drastic reductions in performance. This is now fixed,
closing `issue 1527`_.
OBS-URL: https://build.opensuse.org/package/show/devel:languages:python/python-coverage?expand=0&rev=108
- Update to 7.0.1
* When checking if a file mapping resolved to a file that exists,
we weren’t considering files in .whl files. This is now fixed,
closing issue 1511.
* File pattern rules were too strict, forbidding plus signs and
curly braces in directory and file names. This is now fixed,
closing issue 1513.
* Unusual Unicode or control characters in source files could
prevent reporting. This is now fixed, closing issue 1512.
* The PyPy wheel now installs on PyPy 3.7, 3.8, and 3.9, closing
issue 1510.
- Release 7.0.0
* Changes to file pattern matching, which might require updating
your configuration:
- Previously, * would incorrectly match directory separators,
making precise matching difficult. This is now fixed, closing
issue 1407.
- Now ** matches any number of nested directories, including
none.
* Improvements to combining data files when using the [run]
relative_files setting, which might require updating your
configuration:
- During coverage combine, relative file paths are implicitly
combined without needing a [paths] configuration setting.
This also fixed issue 991.
- A [paths] setting like */foo will now match foo/bar.py so
that relative file paths can be combined more easily.
- The [run] relative_files setting is properly interpreted in
more places, fixing issue 1280.
* When remapping file paths with [paths], a path will be remapped
OBS-URL: https://build.opensuse.org/request/show/1045381
OBS-URL: https://build.opensuse.org/package/show/devel:languages:python/python-coverage?expand=0&rev=104
- Update to version 6.2
* Feature: Now the --concurrency setting can now have a list of
values, so that threads and another lightweight threading
package can be measured together, such as
--concurrency=gevent,thread. Closes issue 1012 and issue 1082.
* Fix: A module specified as the source setting is imported
during startup, before the user program imports it. This could
cause problems if the rest of the program isn't ready yet. For
example, issue 1203 describes a Django setting that is accessed
before settings have been configured. Now the early import is
wrapped in a try/except so errors then don't stop execution.
* Fix: A colon in a decorator expression would cause an exclusion
to end too early, preventing the exclusion of the decorated
function. This is now fixed.
* Fix: The HTML report now will not overwrite a .gitignore file
that already exists in the HTML output directory (follow-on for
issue 1244).
* API: The exceptions raised by Coverage.py have been
specialized, to provide finer-grained catching of exceptions by
third-party code.
* API: Using suffix=False when constructing a Coverage object
with multiprocessing wouldn't suppress the data file suffix
(issue 989). This is now fixed.
* Debug: The coverage debug data command will now sniff out
combinable data files, and report on all of them.
* Debug: The coverage debug command used to accept a number of
topics at a time, and show all of them, though this was never
documented. This no longer works, to allow for command-line
options in the future.
- Release notes for 6.1.2
* Python 3.11 is supported (tested with 3.11.0a2). One still-open
issue has to do with exits through with-statements.
* Fix: When remapping file paths through the [paths] setting
while combining, the [run] relative_files setting was ignored,
resulting in absolute paths for remapped file names (issue
1147). This is now fixed.
* Fix: Complex conditionals over excluded lines could have
incorrectly reported a missing branch (issue 1271). This is now
fixed.
* Fix: More exceptions are now handled when trying to parse
source files for reporting. Problems that used to terminate
coverage.py can now be handled with [report] ignore_errors.
This helps with plugins failing to read files
(django_coverage_plugin issue 78).
* Fix: Removed another vestige of jQuery from the source tarball
(issue 840).
* Fix: Added a default value for a new-to-6.x argument of an
internal class. This unsupported class is being used by
coveralls (issue 1273). Although I'd rather not "fix"
unsupported interfaces, it's actually nicer with a default
value.
- Release notes for 6.1.1
* Fix: The sticky header on the HTML report didn't work unless
you had branch coverage enabled. This is now fixed: the sticky
header works for everyone. (Do people still use coverage
without branch measurement!? j/k)
* Fix: When using explicitly declared namespace packages, the
"already imported a file that will be measured" warning would
be issued (issue 888). This is now fixed.
- Release notes for 6.1
* Deprecated: The annotate command and the Coverage.annotate
function will be removed in a future version, unless people let
me know that they are using it. Instead, the html command gives
better-looking (and more accurate) output, and the report -m
command will tell you line numbers of missing lines. Please get
in touch if you have a reason to use annotate over those better
options: ned@nedbatchelder.com.
* Feature: Coverage now sets an environment variable,
COVERAGE_RUN when running your code with the coverage run
command. The value is not important, and may change in the
future. Closes issue 553.
* Feature: The HTML report pages for Python source files now have
a sticky header so the file name and controls are always
visible.
* Feature: The xml and json commands now describe what they wrote
where.
* Feature: The html, combine, xml, and json commands all accept a
-q/--quiet option to suppress the messages they write to stdout
about what they are doing (issue 1254).
* Feature: The html command writes a .gitignore file into the
HTML output directory, to prevent the report from being
committed to git. If you want to commit it, you will need to
delete that file. Closes issue 1244.
* Feature: Added support for PyPy 3.8.
* Fix: More generated code is now excluded from measurement. Code
such as attrs boilerplate, or doctest code, was being measured
though the synthetic line numbers meant they were never
reported. Once Cython was involved though, the generated .so
files were parsed as Python, raising syntax errors, as reported
in issue 1160. This is now fixed.
* Fix: When sorting human-readable names, numeric components are
sorted correctly: file10.py will appear after file9.py. This
applies to file names, module names, environment variables, and
test contexts.
* Performance: Branch coverage measurement is faster, though you
might only notice on code that is executed many times, such as
long-running loops.
* Build: jQuery is no longer used or vendored (issue 840 and
issue 1118). Huge thanks to Nils Kattenbeck (septatrix) for the
conversion to vanilla JavaScript in pull request 1248.
- Release notes for 6.0.2
* Namespace packages being measured weren't properly handled by
the new code that ignores third-party packages. If the
namespace package was installed, it was ignored as a
third-party package. That problem (issue 1231) is now fixed.
* Packages named as "source packages" (with source, or
source_pkgs, or pytest-cov's --cov) might have been only
partially measured. Their top-level statements could be marked
as unexecuted, because they were imported by coverage.py before
measurement began (issue 1232). This is now fixed, but the
package will be imported twice, once by coverage.py, then again
by your test suite. This could cause problems if importing the
package has side effects.
* The :meth:`.CoverageData.contexts_by_lineno` method was
documented to return a dict, but was returning a defaultdict.
Now it returns a plain dict. It also no longer returns negative
numbered keys.
- Release notes for 6.0.1
* In 6.0, the coverage.py exceptions moved from coverage.misc to
coverage.exceptions. These exceptions are not part of the
public supported API, CoverageException is. But a number of
other third-party packages were importing the exceptions from
coverage.misc, so they are now available from there again
(issue 1226).
* Changed an internal detail of how tomli is imported, so that
tomli can use coverage.py for their own test suite (issue
1228).
* Defend against an obscure possibility under code obfuscation,
where a function can have an argument called "self", but no
local named "self" (pull request 1210). Thanks, Ben Carlsson.
- Release notes for 6.0
* The coverage html command now prints a message indicating where
the HTML report was written. Fixes issue 1195.
* The coverage combine command now prints messages indicating
each data file being combined. Fixes issue 1105.
* The HTML report now includes a sentence about skipped files due
to skip_covered or skip_empty settings. Fixes issue 1163.
* Unrecognized options in the configuration file are no longer
errors. They are now warnings, to ease the use of coverage
across versions. Fixes issue 1035.
* Fix handling of exceptions through context managers in Python
3.10. A missing exception is no longer considered a missing
branch from the with statement. Fixes issue 1205.
* Fix another rarer instance of "Error binding parameter 0 -
probably unsupported type." (issue 1010).
* Creating a directory for the coverage data file now is safer
against conflicts when two coverage runs happen simultaneously
(pull 1220). Thanks, Clément Pit-Claudel.
- Release notes for Version 6.0b1
* Dropped support for Python 2.7, PyPy 2, and Python 3.5.
* Added support for the Python 3.10 match/case syntax.
* Data collection is now thread-safe. There may have been rare
instances of exceptions raised in multi-threaded programs.
* Plugins (like the Django coverage plugin) were generating
"Already imported a file that will be measured" warnings about
Django itself. These have been fixed, closing issue 1150.
* Warnings generated by coverage.py are now real Python warnings.
* Using --fail-under=100 with coverage near 100% could result in
the self-contradictory message total of 100 is less than
fail-under=100. This bug (issue 1168) is now fixed.
* The COVERAGE_DEBUG_FILE environment variable now accepts stdout
and stderr to write to those destinations.
* TOML parsing now uses the tomli library.
* Some minor changes to usually invisible details of the HTML
report:
* Use a modern hash algorithm when fingerprinting, for
high-security environments (issue 1189). When generating the
HTML report, we save the hash of the data, to avoid
regenerating an unchanged HTML page. We used to use MD5 to
generate the hash, and now use SHA-3-256. This was never a
security concern, but security scanners would notice the MD5
algorithm and raise a false alarm.
* Change how report file names are generated, to avoid leading
underscores (issue 1167), to avoid rare file name collisions
(issue 584), and to avoid file names becoming too long (issue
580).
- Drop patches
* 0001-make-data-collection-operations-thread-safe.patch
* change__file__report-dir.patch
* traced_file_absolute.patch
OBS-URL: https://build.opensuse.org/request/show/938248
OBS-URL: https://build.opensuse.org/package/show/devel:languages:python/python-coverage?expand=0&rev=97
- Switch off test_debug_trace started to avoid failure
(gh#nedbat/coveragepy#1161).
- Update to 5.5:
- coverage combine has a new option, --keep to keep the original data
files after combining them. The default is still to delete the files
after they have been combined. This was requested in issue 1108 and
implemented in pull request 1110. Thanks, Éric Larivière.
- When reporting missing branches in coverage report, branches aren’t
reported that jump to missing lines. This adds to the long-standing
behavior of not reporting branches from missing lines. Now branches
are only reported if both the source and destination lines are
executed. Closes both issue 1065 and issue 955.
- Minor improvements to the HTML report:
- The state of the line visibility selector buttons is saved in
local storage so you don’t have to fiddle with them so often,
fixing issue 1123.
- It has a little more room for line numbers so that 4-digit numbers
work well, fixing issue 1124.
- Improved the error message when combining line and branch data, so
that users will be more likely to understand what’s happening,
closing issue 803.
OBS-URL: https://build.opensuse.org/package/show/devel:languages:python/python-coverage?expand=0&rev=92
- The text report produced by ``coverage report`` now always outputs a TOTAL
line, even if only one Python file is reported. This makes regex parsing
of the output easier. Thanks, Judson Neer. This had been requested a number
of times
- The ``skip_covered`` and ``skip_empty`` settings in the configuration file
can now be specified in the ``[html]`` section, so that text reports and HTML
reports can use separate settings. The HTML report will still use the
``[report]`` settings if there isn't a value in the ``[html]`` section.
- Combining files on Windows across drives how works properly
- Fix an obscure warning from deep in the _decimal module, as reported in
`issue 1084`_.
- Update to support Python 3.10 alphas in progress, including `PEP 626: Precise
line numbers for debugging and other tools <pep626_>`_.
OBS-URL: https://build.opensuse.org/package/show/devel:languages:python/python-coverage?expand=0&rev=90
- When using ``--source`` on a large source tree, v5.x was slower than previous
versions. This performance regression is now fixed, closing `issue 1037`_.
- Mysterious SQLite errors can happen on PyPy, as reported in `issue 1010`_. An
immediate retry seems to fix the problem, although it is an unsatisfying
solution.
- The HTML report now saves the sort order in a more widely supported way,
fixing `issue 986`_. Thanks, Sebastián Ramírez (`pull request 1066`_).
- The HTML report pages now have a :ref:`Sleepy Snake <sleepy>` favicon.
- Wheels are now provided for manylinux2010, and for PyPy3 (pp36 and pp37).
OBS-URL: https://build.opensuse.org/package/show/devel:languages:python/python-coverage?expand=0&rev=88
- update for singlespec
- update to 4.3.4:
- Using the --skip-covered option on an HTML report with 100% coverage would
cause a “No data to report” error, as reported in issue 549. This is now
fixed; thanks, Loïc Dachary.
- If-statements can be optimized away during compilation, for example, if 0:
or if __debug__:. Coverage.py had problems properly understanding these
statements which existed in the source, but not in the compiled bytecode.
This problem, reported in issue 522, is now fixed.
- If you specified --source as a directory, then coverage.py would look for
importable Python files in that directory, and could identify ones that had
never been executed at all. But if you specified it as a package name, that
detection wasn’t performed. Now it is, closing issue 426. Thanks to Loïc
Dachary for the fix.
- If you started and stopped coverage measurement thousands of times in your
process, you could crash Python with a “Fatal Python error: deallocating
None” error. This is now fixed. Thanks to Alex Groce for the bug report.
- On PyPy, measuring coverage in subprocesses could produce a warning: “Trace
function changed, measurement is likely wrong: None”. This was spurious,
and has been suppressed.
- Previously, coverage.py couldn’t start on Jython, due to that
implementation missing the multiprocessing module (issue 551). This problem
has now been fixed. Also, issue 322 about not being able to invoke coverage
conveniently, seems much better: jython -m coverage run myprog.py works
properly.
- Let’s say you ran the HTML report over and over again in the same output
directory, with --skip-covered. And imagine due to your heroic test-writing
efforts, a file just acheived the goal of 100% coverage. With coverage.py
4.3, the old HTML file with the less-than-100% coverage would be left
behind. This file is now properly deleted.
OBS-URL: https://build.opensuse.org/request/show/479281
OBS-URL: https://build.opensuse.org/package/show/devel:languages:python/python-coverage?expand=0&rev=54
- update to Version 4.3.1 — 2016-12-28:
- Some environments couldn’t install 4.3, as described in issue 540. This is
now fixed.
- The check for conflicting --source and --include was too simple in a few
different ways, breaking a few perfectly reasonable use cases, described in
issue 541. The check has been reverted while we re-think the fix for issue 265.
- update to Version 4.3 — 2016-12-27:
Special thanks to Loïc Dachary, who took an extraordinary interest in
coverage.py and contributed a number of improvements in this release.
- The HTML report now supports a --skip-covered option like the other
reporting commands. Thanks, Loïc Dachary for the implementation, closing
issue 433.
- Subprocesses that are measured with automatic subprocess measurement used
to read in any pre-existing data file. This meant data would be incorrectly
carried forward from run to run. Now those files are not read, so each
subprocess only writes its own data. Fixes issue 510.
- Coverage.py wouldn’t execute sys.excepthook when an exception happened in
your program. Now it does, thanks to Andrew Hoos. Closes issue 535.
- The coverage combine command will now fail if there are no data files to
combine. The combine changes in 4.2 meant that multiple combines could lose
data, leaving you with an empty .coverage data file. Fixes issues issue 525,
issue 412, issue 516, and probably issue 511.
- The branch coverage issues described in issue 493, issue 496, and issue 502
are now fixed, thanks to Loïc Dachary.
- Options can now be read from a tox.ini file, if any. Like setup.cfg,
sections are prefixed with “coverage:”, so [run] options will be read from
the [coverage:run] section of tox.ini. Implements part of issue 519. Thanks,
Stephen Finucane.
- Specifying both --source and --include no longer silently ignores the
include setting, instead it fails with a message. Thanks, Nathan Land and
OBS-URL: https://build.opensuse.org/request/show/450363
OBS-URL: https://build.opensuse.org/package/show/devel:languages:python/python-coverage?expand=0&rev=52
- Since ``concurrency=multiprocessing`` uses subprocesses, options specified on
the coverage.py command line will not be communicated down to them. Only
options in the configuration file will apply to the subprocesses.
Previously, the options didn't apply to the subprocesses, but there was no
indication. Now it is an error to use ``--concurrency=multiprocessing`` and
other run-affecting options on the command line. This prevents
failures like those reported in `issue 495`_.
- Filtering the HTML report is now faster, thanks to Ville Skyttä.
OBS-URL: https://build.opensuse.org/package/show/devel:languages:python/python-coverage?expand=0&rev=51
