Skip to main content

A library containing versatile tools to well complement the asyncio framework.

Project description

asyncutils

PyPI - Python Version PyPI version Coverage Build CodeQL Publish GitHub Pages Dependabot pre-commit.ci OpenSSF Best Practices Read the Docs: stable Read the Docs: latest Conda version conda-forge feedstock Contributor Covenant

A Python library abstracting all the common patterns I can think of that somehow always pop up in async code.

Takes pride in:

  • being as fast as can be in terms of import time
  • providing detailed type checking via stub files included in the distribution
  • having a well-equipped command line interface taking many flags and options

Setup

Make sure you have CPython 3.12 or above; even a pre-release of 3.15 will do. GraalPy 25.0 or above is also acceptable. You should have at least one Python package manager you are comfortable with. CPython free-threaded and debug builds are also supported. I have plans to support PyPy, but they are currently lagging behind the releases of the reference implementation and a 3.11 backport would be required, which is not going to happen.

The support for GraalPy is also experimental and I don't think its particular performance benefits would apply to this library, provided that part of asyncio is written in C, and GraalPy's asyncio doesn't support Windows yet.

Discounting the installation, no extra setup is needed. See the installation guide for more.

Usage

This package is very resourceful, containing everything from higher-order error handling functions to network protocols. See the usage guide for some basic examples.

Version

This is asyncutils v1.1.0. For your reference, here are all version tags up to now.

Configuration

Besides using command line arguments to change console settings, the behaviour of this module as a library can be customized as well. See the configuration guide.

Remarks

It is strongly recommended that you read the asyncio docs thoroughly if using event loop and async generator related features, since their behaviours are central points of confusion and have troubled me greatly in the development of this library.

Resources

Here are some resources if you're new to the world of async. They were of great assistance when I was learning async (I still am):

Contributing

If you have suggestions for how asyncutils could be improved, or want to report a bug, do open an issue! All contributions are welcome. For more, check out the contributing guide.

License

MIT © 2026 Jonathan Dung

Badges

GitHub Repo Package Uses Status Tests
GitHub release Project stars PyPI - Implementation Build backend Maintenance Tests
GitHub release date GitHub forks Noarch ruff Issues Welcome Warnings
Commits since last release GitHub watchers PyPI - Downloads ty PRs Welcome Expected failures
GitHub commit activity GitHub PyPI - Format SemVer detect-secrets Duration
GitHub issues GitHub Downloads PyPI - License Sphinx Blazingly fast Skipped
GitHub pull requests Repo creation Language count Sphinx-lint Free-threaded support Last test run
GitHub contributors GitHub repo size Top language CSpell
GitHub last commit Code size Visits Pytest

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

py_asyncutils-1.1.0.tar.gz (213.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

py_asyncutils-1.1.0-py3-none-any.whl (253.6 kB view details)

Uploaded Python 3

File details

Details for the file py_asyncutils-1.1.0.tar.gz.

File metadata

  • Download URL: py_asyncutils-1.1.0.tar.gz
  • Upload date:
  • Size: 213.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.28 {"installer":{"name":"uv","version":"0.11.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for py_asyncutils-1.1.0.tar.gz
Algorithm Hash digest
SHA256 d935866315ca0b9e203806bd487d89faf85d1d990e09de6c9676ba6a5d247a82
MD5 abc08ab4449d04b535a70c103622800c
BLAKE2b-256 3b30b21699a0574df6cd8a0685ba2f692a4780f37c46882d0e19f939159ab187

See more details on using hashes here.

File details

Details for the file py_asyncutils-1.1.0-py3-none-any.whl.

File metadata

  • Download URL: py_asyncutils-1.1.0-py3-none-any.whl
  • Upload date:
  • Size: 253.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.28 {"installer":{"name":"uv","version":"0.11.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for py_asyncutils-1.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 ceb0df0959c498f2a018f34757be1ced0bea4d7b7c82bc74182c83e935306c3d
MD5 9281e1e1e48833dd3a922c5efbb966b4
BLAKE2b-256 5c95a39aa023fe037f9eeac460044d95b0160911a8863b9dd829118ee353ade0

See more details on using hashes here.

Supported by

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