summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorNed Batchelder <ned@nedbatchelder.com>2016-01-10 13:01:57 -0500
committerNed Batchelder <ned@nedbatchelder.com>2016-01-10 13:01:57 -0500
commitecc667327b1b89bfde66b426d663d6a487c1f038 (patch)
tree6adbf0cae52507ced62338660ac9f8b259a2d945 /doc
parente658fb3268ca192e5f329314bbb4fb3f62652e30 (diff)
downloadpython-coveragepy-git-ecc667327b1b89bfde66b426d663d6a487c1f038.tar.gz
Prep for 4.1b1
Diffstat (limited to 'doc')
-rw-r--r--doc/changes.rst48
-rw-r--r--doc/conf.py6
-rw-r--r--doc/index.rst9
3 files changed, 56 insertions, 7 deletions
diff --git a/doc/changes.rst b/doc/changes.rst
index 680134b6..9664cc04 100644
--- a/doc/changes.rst
+++ b/doc/changes.rst
@@ -37,6 +37,7 @@ Major change history for coverage.py
.. :history: 20151013T103000, updated for 4.0.1
.. :history: 20151104T050900, updated for 4.0.2
.. :history: 20151124T065800, updated for 4.0.3
+.. :history: 20160110T125800, updated for 4.1b1
These are the major changes for coverage.py. For a more complete change
@@ -46,6 +47,53 @@ history, see the `CHANGES.rst`_ file in the source tree.
.. module:: coverage
+.. _changes_41:
+
+Version 4.1b1 pre-release --- 2016-01-10
+----------------------------------------
+
+- Branch analysis has been rewritten: it used to be based on bytecode, but now
+ uses AST analysis. This has changed a number of things:
+
+ - More code paths are now considered runnable, especially in `try`/`except`
+ structures. This may mean that coverage.py will identify more code paths
+ as uncovered. This could either raise or lower your overall coverage
+ number.
+
+ - Python 3.5's `async` and `await` keywords are properly supported, fixing
+ `issue 434`_.
+
+ - A some long-standing branch coverage bugs were fixed:
+
+ - `issue 129`_: functions with only a docstring for a body would incorrectly
+ report a missing branch on the ``def`` line.
+
+ - `issue 212`_: code in an ``except`` block could be incorrectly marked as
+ a missing branch.
+
+ - `issue 146`_: context managers (``with`` statements) in a loop or ``try``
+ block could confuse the branch measurement, reporting incorrect partial
+ branches.
+
+ - `issue 422`_: in Python 3.5, an actual partial branch could be marked as
+ complete.
+
+- Pragmas to disable coverage measurement can now be used on decorator lines,
+ and they will apply to the entire function or class being decorated. This
+ implements the feature requested in `issue 131`_.
+
+- Multiprocessing support is now available on Windows. Thanks, Rodrigue
+ Cloutier.
+
+.. _issue 129: https://bitbucket.org/ned/coveragepy/issues/129/misleading-branch-coverage-of-empty
+.. _issue 131: https://bitbucket.org/ned/coveragepy/issues/131/pragma-on-a-decorator-line-should-affect
+.. _issue 146: https://bitbucket.org/ned/coveragepy/issues/146/context-managers-confuse-branch-coverage
+.. _issue 212: https://bitbucket.org/ned/coveragepy/issues/212/coverage-erroneously-reports-partial
+.. _issue 422: https://bitbucket.org/ned/coveragepy/issues/422/python35-partial-branch-marked-as-fully
+.. _issue 434: https://bitbucket.org/ned/coveragepy/issues/434/indexerror-in-python-35
+.. _issue 461: https://bitbucket.org/ned/coveragepy/issues/461/multiline-asserts-need-too-many-pragma
+
+
.. _changes_403:
Version 4.0.3 --- 2015-11-24
diff --git a/doc/conf.py b/doc/conf.py
index 0738e72e..cc57d500 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -49,16 +49,16 @@ master_doc = 'index'
# General information about the project.
project = u'Coverage.py'
-copyright = u'2009\N{EN DASH}2015, Ned Batchelder'
+copyright = u'2009\N{EN DASH}2016, Ned Batchelder'
# The version info for the project you're documenting, acts as replacement for
# |version| and |release|, also used in various other places throughout the
# built documents.
#
# The short X.Y version.
-version = '4.0'
+version = '4.1'
# The full version, including alpha/beta/rc tags.
-release = '4.0.3'
+release = '4.1b1'
# The language for content autogenerated by Sphinx. Refer to documentation
# for a list of supported languages.
diff --git a/doc/index.rst b/doc/index.rst
index aea833d9..010db6ec 100644
--- a/doc/index.rst
+++ b/doc/index.rst
@@ -43,6 +43,7 @@ Coverage.py
.. :history: 20151013T103200, Updated for 4.0.1
.. :history: 20151104T050900, updated for 4.0.2
.. :history: 20151124T065900, updated for 4.0.3
+.. :history: 20160110T125900, updated for 4.1b1
Coverage.py is a tool for measuring code coverage of Python programs. It
@@ -55,7 +56,7 @@ not.
.. ifconfig:: not prerelease
- The latest version is coverage.py 4.0.3, released 24 November 2015.
+ The latest version is coverage.py 4.0.3, released November 24th, 2015.
It is supported on:
* Python versions 2.6, 2.7, 3.3, 3.4, and 3.5
@@ -64,11 +65,11 @@ not.
.. ifconfig:: prerelease
- The latest version is coverage.py 4.0b2, released 22 August 2015.
- It is supported on Python versions 2.6, 2.7, 3.3, 3.4, and 3.5c1, as well
+ The latest version is coverage.py 4.1b1, released January 10th, 2016.
+ It is supported on Python versions 2.6, 2.7, 3.3, 3.4, and 3.5, as well
as PyPy 2.4 and 2.6, and PyPy3 2.4.
**This is a pre-release build. The usual warnings about possible bugs apply.**
- The latest stable version is coverage.py 3.7.1, `described here`_.
+ The latest stable version is coverage.py 4.0.3, `described here`_.
.. _described here: http://nedbatchelder.com/code/coverage