Metadata-Version: 1.2
Name: async-exit-stack
Version: 1.0.1
Summary: AsyncExitStack backport for Python 3.5+
Home-page: https://github.com/sorcio/async_exit_stack
Author: Davide Rizzo
Author-email: sorcio@gmail.com
License: Python Software Foundation License
Description: .. role:: python(code)
           :language: python
        
        .. image:: https://img.shields.io/pypi/v/async_exit_stack.svg
                :target: https://pypi.python.org/pypi/async_exit_stack
        
        .. image:: https://img.shields.io/travis/sorcio/async_exit_stack.svg
                :target: https://travis-ci.org/sorcio/async_exit_stack
        
        
        =======================================
        AsyncExitStack backport for Python 3.5+
        =======================================
        
        
        * Free software: PSF license
        * Documentation: https://docs.python.org/3.7/library/contextlib.html#contextlib.AsyncExitStack
        
        This package contains code from the CPython project.
        
        
        Install
        -------
        
        ::
        
           pip install async_exit_stack
        
        
        
        Usage example
        -------------
        
        .. code:: python
        
            from async_exit_stack import AsyncExitStack
        
            async def some_async_function():
                async with AsyncExitStack() as stack:
                    connections = [await stack.enter_async_context(get_connection())
                        for i in range(5)]
                    # All opened connections will automatically be released at the end of
                    # the async with statement, even if attempts to open a connection
                    # later in the list raise an exception.
        
        
        Reference
        ---------
        
        Refer to `Python 3.7 contextlib documentation
        <https://docs.python.org/3.7/library/contextlib.html#contextlib.AsyncExitStack>`_
        for a complete reference and more context.
        
        `class AsyncExitStack`:python:
          An asynchronous context manager, similar to ExitStack, that supports combining
          both synchronous and asynchronous context managers, as well as having
          coroutines for cleanup logic.
        
          The close() method is not implemented, aclose() must be used instead.
        
          `enter_async_context(cm)`:python:
            Similar to enter_context() but expects an asynchronous context manager.
        
          `push_async_exit(exit)`:python:
            Similar to push() but expects either an asynchronous context manager or a coroutine.
        
          `push_async_callback(callback, *args, **kwds)`:python:
            Similar to callback() but expects a coroutine.
        
          `aclose()`:python:
            Similar to close() but properly handles awaitables.
        
        
        =======
        History
        =======
        
        1.0.0 (2018-05-07)
        ------------------
        
        * First release based on Python 3.7b4.
        
Keywords: async_exit_stack
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Python Software Foundation License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Requires-Python: >=3.5
