Skip to main content

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-hypernode.com/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 those Futures. This is useful if you are using an API that returns futures, such as RPC libraries like gRPC. The standard Future interface does not implement __await__ directly, so Future instances must be wrapped in duet.AwaitableFuture.

  • duet is re-entrant. At the top level, you run async code by calling duet.run(foo). Inside foo suppose you call a function that has not yet been fully refactored to be asynchronous, but itself calls duet.run(bar). Most async libraries, including trio and asyncio, 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


Download files

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

Source Distribution

duet-0.2.8.dev20221107153910.tar.gz (28.1 kB view details)

Uploaded Source

Built Distribution

duet-0.2.8.dev20221107153910-py3-none-any.whl (29.3 kB view details)

Uploaded Python 3

File details

Details for the file duet-0.2.8.dev20221107153910.tar.gz.

File metadata

  • Download URL: duet-0.2.8.dev20221107153910.tar.gz
  • Upload date:
  • Size: 28.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.7.1 importlib_metadata/4.11.3 pkginfo/1.8.2 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.63.1 CPython/3.9.13

File hashes

Hashes for duet-0.2.8.dev20221107153910.tar.gz
Algorithm Hash digest
SHA256 4135e4b774507089b1638a38d2474b5c2fe3e7ce0295de098a96f69d12f04a3a
MD5 e6a244b8da7b675ea60489c9e48d6ac1
BLAKE2b-256 1a931ab14b013bedbb27c638d0c4a7c9425b1ff1e81af3aad48951e53752913a

See more details on using hashes here.

File details

Details for the file duet-0.2.8.dev20221107153910-py3-none-any.whl.

File metadata

  • Download URL: duet-0.2.8.dev20221107153910-py3-none-any.whl
  • Upload date:
  • Size: 29.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.7.1 importlib_metadata/4.11.3 pkginfo/1.8.2 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.63.1 CPython/3.9.13

File hashes

Hashes for duet-0.2.8.dev20221107153910-py3-none-any.whl
Algorithm Hash digest
SHA256 bc42bad11feec08aa84ca1574f895af8de85bd971b9d80bd0c10eac9a5f0f4b8
MD5 120ff8924e7da093830eff5a54c94688
BLAKE2b-256 0ad747e769b111f6b47fdd40e0e2598e7e15e006490ce7d40ed7a8bf6a5e6a33

See more details on using hashes here.

Supported by

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