Metadata-Version: 1.1
Name: backports-abc
Version: 0.4
Summary: A backport of recent additions to the 'collections.abc' module.
Home-page: https://github.com/cython/backports_abc
Author: Stefan Behnel et al.
Author-email: cython-devel@python.org
License: UNKNOWN
Description: =============
        ABC-Backports
        =============
        
        Usage:
        
        .. code-block:: python
        
            try:
                # ABCs live in "collections.abc" in Python >= 3.3
                from collections.abc import Coroutine, Generator
            except ImportError:
                # fall back to import from "backports_abc"
                from backports_abc import Coroutine, Generator
        
        You can also install the ABCs into the stdlib by calling the ``patch()``
        function:
        
        .. code-block:: python
        
            import backports_abc
            backports_abc.patch()
        
            try:
                # ABCs live in "collections.abc" in Python >= 3.3
                from collections.abc import Coroutine, Generator
            except ImportError:
                # fall back to import from "collections" in Python <= 3.2
                from backports_abc import Coroutine, Generator
        
        Currently, ``patch()`` provides the following names if missing:
        
        * ``collections.abc.Generator``
        * ``collections.abc.Awaitable``
        * ``collections.abc.Coroutine``
        * ``inspect.isawaitable(obj)``
        
        All of them are also available directly from the ``backports_abc``
        module namespace.
        
        In Python 2.x and Python 3.2, it patches the ``collections`` module
        instead of the ``collections.abc`` module.  Any names that are already
        available when importing this module will not be overwritten.
        
        The names that were previously patched by ``patch()`` can be queried
        through the mapping in ``backports_abc.PATCHED``.
        
        Changelog
        =========
        
        0.4 (2015-09-14)
        ----------------
        
        * direct wheel building support
        
        * make all names available at the module level instead of requiring patching
        
        
        0.3 (2015-07-03)
        ----------------
        
        * removed patching of ``inspect.iscoroutine()`` as it is not ABC based
        
        
        0.2 (2015-07-03)
        ----------------
        
        * require explicit ``backports_abc.patch()`` call to do the patching
          (avoids side-effects on import and allows future configuration)
        
        * provide access to patched names through global ``PATCHED`` dict
        
        * add ABC based implementations of inspect.iscoroutine() and
          inspect.isawaitable()
        
        
        0.1 (2015-06-24)
        ----------------
        
        * initial public release
        
        * provided ABCs: Generator, Coroutine, Awaitable
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Python Software Foundation License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
