A simple future-based async library for python.
Project description
This is a development version of Duet and may be unstable.
For the latest stable release see https://pypi.org/project/duet/.
duet
A simple future-based async library for python
Duet takes inspiration from the amazing trio library and the structured concurrency approach to async programming that it uses. However, duet differs from trio in two major ways:
-
Instead of a full-blown implementation of asynchronous IO, duet relies on the
Future
interface for parallelism, and provides a way to run async/await coroutines around thoseFuture
s. This is useful if you are using an API that returns futures, such as RPC libraries like gRPC. The standardFuture
interface does not implement__await__
directly, soFuture
instances must be wrapped induet.AwaitableFuture
. -
duet is re-entrant. At the top level, you run async code by calling
duet.run(foo)
. Insidefoo
suppose you call a function that has not yet been fully refactored to be asynchronous, but itself callsduet.run(bar)
. Most async libraries, includingtrio
andasyncio
, will raise an exception if you try to "re-enter" the event loop in this way, but duet allows it. We have found that this can simplify the process of refactoring code to be asynchronous because you don't have to completely separate the sync and async parts of your codebase all at once.
Installation
Install from pypi:
pip install duet
Note
duet is not an official Google project.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file duet-0.3.0.dev20240320150209.tar.gz
.
File metadata
- Download URL: duet-0.3.0.dev20240320150209.tar.gz
- Upload date:
- Size: 28.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.3.0 pkginfo/1.9.6 requests/2.31.0 setuptools/65.5.0 requests-toolbelt/1.0.0 tqdm/4.65.0 CPython/3.10.10
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | ba0da922844974045b61408aad110f385bbafb80d6799fd41dfb9e8203ee76d1 |
|
MD5 | e35b73b9af904f6a1da3a4d09eed8d40 |
|
BLAKE2b-256 | f867935bdc83e00b2ec196119c0ce1d1fc286a56c757f07d89b5fb8b32752e0b |
File details
Details for the file duet-0.3.0.dev20240320150209-py3-none-any.whl
.
File metadata
- Download URL: duet-0.3.0.dev20240320150209-py3-none-any.whl
- Upload date:
- Size: 29.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.3.0 pkginfo/1.9.6 requests/2.31.0 setuptools/65.5.0 requests-toolbelt/1.0.0 tqdm/4.65.0 CPython/3.10.10
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | e03a80d8ec1fcff56253059d705387a721744e8c6495eca829e9fe0b83f000b3 |
|
MD5 | c13d866d9b9bcc65c1b2cff3172dfe12 |
|
BLAKE2b-256 | a676aafb8e7b0ee32b2d629a525f047a665d51be4ef8e8b2de533eade8c49b24 |