Skip to main content

Useful utilities for working with asyncio.

Project description

asyncio_tools

Useful utilities for working with asyncio.

gather

Provides a convenient wrapper around asyncio.gather.

from asyncio_tools import gather, CompoundException


async def good():
    return 'OK'


async def bad():
    raise ValueError()


async def main():
    response = await gather(
        good(),
        bad(),
        good()
    )

    # Check if a particular exception was raised.
    ValueError in response.exception_types
    # >>> True

    # To get all exceptions:
    print(response.exceptions)
    # >>> [ValueError()]

    # To get all instances of a particular exception:
    response.exceptions_of_type(ValueError)
    # >>> [ValueError()]

    # To get the number of exceptions:
    print(response.exception_count)
    # >>> 1

    # You can still access all of the results:
    print(response.all)
    # >>> ['OK', ValueError(), 'OK']

    # And can access all successes (i.e. non-exceptions):
    print(response.successes)
    # >>> ['OK', 'OK']

    # To get the number of successes:
    print(response.success_count)
    # >>> 2

    try:
        # To combines all of the exceptions into a single one, which merges the
        # messages.
        raise response.compound_exception()
    except CompoundException as compound_exception:
        print("Caught it")

        if ValueError in compound_exception.exception_types:
            print("Caught a ValueError")

Read some background on why gather is useful:

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

asyncio_tools-1.0.0.tar.gz (3.7 kB view details)

Uploaded Source

Built Distribution

asyncio_tools-1.0.0-py3-none-any.whl (4.0 kB view details)

Uploaded Python 3

File details

Details for the file asyncio_tools-1.0.0.tar.gz.

File metadata

  • Download URL: asyncio_tools-1.0.0.tar.gz
  • Upload date:
  • Size: 3.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.10.7

File hashes

Hashes for asyncio_tools-1.0.0.tar.gz
Algorithm Hash digest
SHA256 21bde808c149c74b3178d407ac31cf2bad00e7fad33d12230115e9874763133e
MD5 833f3aaa493565f522244505ff4615c7
BLAKE2b-256 9680dd6ace29eb652273439fa50f8dba4d8900f4f36ab99cf2a29b6fa7bf1857

See more details on using hashes here.

File details

Details for the file asyncio_tools-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: asyncio_tools-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 4.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.10.7

File hashes

Hashes for asyncio_tools-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 54f5033699df063b393d99bb744895cf9fad28062ff83717f9b2f54344f89c97
MD5 2a31f935d7f78b1d6bdbb8ceb683ee6e
BLAKE2b-256 167cb0fde3dc52ce369a485767472d9b17301714522976b1f82efaf43ff5d49a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page