Skip to content

jonathandung/asyncutils

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

asyncutils

PyPI - Python Version PyPI version Coverage Build CodeQL Publish GitHub Pages Dependabot pre-commit.ci OpenSSF Best Practices Read the docs stable build Read the Docs latest build 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.

Includes a wide range of submodules tailored for specific usages, though concrete low-level implementations are lacking.

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 v0.9.14.

This library is currently in the beta stage, meaning the public API is subject to change even between patch versions, and changes made may be backward-incompatible. See the compatibility page.

See 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

Regarding .markdownlint.json, even though there is no longer a pre-commit or workflow step requiring it, it contains the most basic ignores suitable for this project's files and should be respected. Relevant IDE extensions will automatically take it into consideration. This allows running the linter locally.

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 on my async journey:

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 Contributions Welcome Warnings
Commits since last release GitHub watchers PyPI - Downloads ty PRs Welcome Expected failures
GitHub commit activity GitHub PyPI - Format SemVer Beta 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 detect-secrets
GitHub last commit Code size Pytest