contextlib2 is a backport of the standard library’s contextlib module to earlier Python versions.
It also sometimes serves as a real world proving ground for possible future enhancements to the standard library version.
Licensing
As a backport of Python standard library software, the implementation, test suite and other supporting files for this project are distributed under the Python Software License used for the CPython reference implementation.
The one exception is the included type hints file, which comes from the typeshed project, and is hence distributed under the Apache License 2.0.
Development
contextlib2 has no runtime dependencies, but requires setuptools and wheel at build time to generate universal wheel archives.
Local testing is a matter of running:
python3 -m unittest discover -t . -s test
You can test against multiple versions of Python with tox:
pip install tox tox
Versions currently tested in both tox and GitHub Actions are:
CPython 3.6
CPython 3.7
CPython 3.8
CPython 3.9
CPython 3.10
PyPy3
Updating to a new stdlib reference version
As of Python 3.10, 4 files needed to be copied from the CPython reference implementation to contextlib2:
Doc/contextlib.rst -> docs/contextlib2.rst
Lib/contextlib.py -> contextlib2/__init__.py
Lib/test/test_contextlib.py -> test/test_contextlib.py
Lib/test/test_contextlib_async.py -> test/test_contextlib_async.py
The corresponding version of contextlib2/__init__.pyi also needs to be retrieved from the typeshed project:
wget https://raw.githubusercontent.com/python/typeshed/master/stdlib/contextlib.pyi
For the 3.10 sync, the only changes needed to the test files were to import from contextlib2 rather than contextlib. The test directory is laid out so that the test suite’s imports from test.support work the same way they do in the main CPython test suite.
The following patch files are saved in the dev directory:
changes made to contextlib2/__init__.py to get it to run on the older versions (and to add back in the deprecated APIs that never graduated to the standard library version)
changes made to contextlib2/__init__.pyi to make the Python version guards unconditional (since the contextlib2 API is the same on all supported versions)
changes made to docs/contextlib2.rst to use contextlib2 version numbers in the version added/changed notes and to integrate the module documentation with the rest of the project documentation
Release files for contextlib2 21.6.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| contextlib2-21.6.0.tar.gz | 43.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| contextlib2-21.6.0-py2.py3-none-any.whl | Python 2, Python 3 | none | any | Details |
Total release size: 57.1 kB
Release files / contextlib2-21.6.0.tar.gz
| Download URL | contextlib2-21.6.0.tar.gz |
|---|---|
| Size | 43.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ab1e2bfe1d01d968e1b7e8d9023bc51ef3509bba217bb730cee3827e1ee82869
|
|
BLAKE2b-256 checksum How to use checksums |
c71337ea7805ae3057992e96ecb1cffa2fa35c2ef4498543b846f90dd2348d8f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.4.1 importlib_metadata/4.0.1 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.60.0 CPython/3.9.5
|
Release files / contextlib2-21.6.0-py2.py3-none-any.whl
| Download URL | contextlib2-21.6.0-py2.py3-none-any.whl |
|---|---|
| Size | 13.3 kB |
| Tags | Python 2 Python 3 |
|
SHA-256 checksum How to use checksums |
3fbdb64466afd23abaf6c977627b75b6139a5a3e8ce38405c5b413aed7a0471f
|
|
BLAKE2b-256 checksum How to use checksums |
76566d6872f79d14c0cb02f1646cbb4592eef935857c0951a105874b7b62a0c3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.4.1 importlib_metadata/4.0.1 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.60.0 CPython/3.9.5
|
