2016-07-27 14:41:38 +00:00
|
|
|
.. image:: https://jazzband.co/static/img/badge.svg
|
|
|
|
|
:target: https://jazzband.co/
|
|
|
|
|
:alt: Jazzband
|
|
|
|
|
|
2016-01-13 12:43:32 +00:00
|
|
|
.. image:: https://readthedocs.org/projects/contextlib2/badge/?version=latest
|
2016-07-27 14:41:38 +00:00
|
|
|
:target: https://contextlib2.readthedocs.org/
|
|
|
|
|
:alt: Latest Docs
|
2016-01-13 12:43:32 +00:00
|
|
|
|
2016-07-27 14:41:38 +00:00
|
|
|
.. image:: https://img.shields.io/travis/jazzband/contextlib2/master.svg
|
|
|
|
|
:target: http://travis-ci.org/jazzband/contextlib2
|
2016-04-17 09:30:39 +00:00
|
|
|
|
2016-07-27 14:41:38 +00:00
|
|
|
.. image:: https://coveralls.io/repos/github/jazzband/contextlib2/badge.svg?branch=master
|
|
|
|
|
:target: https://coveralls.io/github/jazzband/contextlib2?branch=master
|
2016-04-17 11:05:53 +00:00
|
|
|
|
2016-07-27 14:41:38 +00:00
|
|
|
.. image:: https://landscape.io/github/jazzband/contextlib2/master/landscape.svg
|
|
|
|
|
:target: https://landscape.io/github/jazzband/contextlib2/
|
2016-04-17 09:30:39 +00:00
|
|
|
|
2016-01-13 12:43:32 +00:00
|
|
|
contextlib2 is a backport of the `standard library's contextlib
|
|
|
|
|
module <https://docs.python.org/3.5/library/contextlib.html>`_ to
|
|
|
|
|
earlier Python versions.
|
|
|
|
|
|
|
|
|
|
It also serves as a real world proving ground for possible future
|
|
|
|
|
enhancements to the standard library version.
|
|
|
|
|
|
|
|
|
|
Development
|
|
|
|
|
-----------
|
|
|
|
|
|
2016-05-02 06:50:59 +00:00
|
|
|
contextlib2 has no runtime dependencies, but requires ``unittest2`` for testing
|
2017-04-25 03:07:46 +00:00
|
|
|
on Python 2.x, as well as ``setuptools`` and ``wheel`` to generate universal
|
|
|
|
|
wheel archives.
|
2016-01-13 12:43:32 +00:00
|
|
|
|
2016-05-02 06:50:59 +00:00
|
|
|
Local testing is just a matter of running ``python test_contextlib2.py``.
|
2016-01-13 12:43:32 +00:00
|
|
|
|
2016-04-17 09:30:39 +00:00
|
|
|
You can test against multiple versions of Python with
|
|
|
|
|
`tox <https://tox.testrun.org/>`_::
|
2016-01-13 12:43:32 +00:00
|
|
|
|
|
|
|
|
pip install tox
|
|
|
|
|
tox
|
|
|
|
|
|
2016-04-17 09:30:39 +00:00
|
|
|
Versions currently tested in both tox and Travis CI are:
|
2016-01-13 12:43:32 +00:00
|
|
|
|
2016-04-17 09:30:39 +00:00
|
|
|
* CPython 2.6
|
2016-04-17 07:31:06 +00:00
|
|
|
* CPython 2.7
|
|
|
|
|
* CPython 3.4
|
2016-01-13 12:43:32 +00:00
|
|
|
* CPython 3.5
|
2017-04-25 03:07:46 +00:00
|
|
|
* CPython 3.6
|
|
|
|
|
* CPython 3.7 (CPython development branch)
|
2016-01-13 12:43:32 +00:00
|
|
|
* PyPy
|
2017-04-25 03:19:37 +00:00
|
|
|
|
|
|
|
|
Versions currently tested only in tox are:
|
|
|
|
|
|
2017-04-25 03:07:46 +00:00
|
|
|
* PyPy3
|
2017-04-25 03:19:37 +00:00
|
|
|
|
|
|
|
|
This is due to an exception chaining compatibility bug that was fixed in
|
|
|
|
|
the PyPy3 5.5 alpha release, while the version on Travis CI (as of April 2017)
|
|
|
|
|
is still the older PyPy3 2.4.0 release.
|
