Skip to content

Latest commit

 

History

68 Commits

Folders and files

Repository files navigation

asyncutils

PyPI - Python Version PyPI version Coverage Build CodeQL Publish GitHub Pages Dependabot prek AI ticket management AI PR management OpenSSF Best Practices Read the Docs: stable Read the Docs: latest conda version conda-forge feedstock Contributor Covenant

A Python library abstracting many common async patterns.

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
  • ease of bug reporting in the form of an optionally interactive subcommand

Setup

Make sure you have CPython 3.12 or above. GraalPy 25.0 or above is also acceptable. CPython free-threaded and debug builds are also supported. No setup is needed after installation. 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.3.2.

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 zizmor Maintenance Tests
GitHub release date GitHub forks Noarch ruff markdownlint Issues Welcome Warnings
Commits since last release GitHub watchers PyPI - Downloads ty shellcheck PRs Welcome Expected failures
GitHub commit activity GitHub PyPI - Format SemVer shfmt Free-threaded support Duration
GitHub issues GitHub Downloads PyPI - License Sphinx betterleaks Blazingly fast Skipped
GitHub pull requests Repo creation Language count sphinx-lint Last test run
GitHub contributors GitHub repo size Top language CSpell
GitHub last commit Code size Visits Pytest

Packages

Used by

Contributors

Languages