Skip to main content

A simple future-based async library for python.

Project description

duet

NOTE: duet-async has been renamed duet. Please use that instead.

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-async

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-async-0.1.3.tar.gz (20.5 kB view details)

Uploaded Source

Built Distribution

duet_async-0.1.3-py3-none-any.whl (24.9 kB view details)

Uploaded Python 3

File details

Details for the file duet-async-0.1.3.tar.gz.

File metadata

  • Download URL: duet-async-0.1.3.tar.gz
  • Upload date:
  • Size: 20.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/44.1.1 requests-toolbelt/0.9.1 tqdm/4.60.0 CPython/3.9.2

File hashes

Hashes for duet-async-0.1.3.tar.gz
Algorithm Hash digest
SHA256 4772ca9dd4ccb313f02807c083e71791402498d43f28f50116480010c16121f0
MD5 1f2498441fd7c027c5c5bcfa76c96310
BLAKE2b-256 7b815c00c65901c2d96f790d9b7d87cac434703516d54cc184698b4b7bef9a91

See more details on using hashes here.

File details

Details for the file duet_async-0.1.3-py3-none-any.whl.

File metadata

  • Download URL: duet_async-0.1.3-py3-none-any.whl
  • Upload date:
  • Size: 24.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/44.1.1 requests-toolbelt/0.9.1 tqdm/4.60.0 CPython/3.9.2

File hashes

Hashes for duet_async-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 3cd39a6aa312ffc944cb8ee5da88cd11d3f17e6302a81c5d326fa1062093ddeb
MD5 8513d67f8d1bed4d56ccd182e16f3205
BLAKE2b-256 5fafe0d9f9e79f873c259ea3e93b7129aa32a06e79392431a45f6a780c402c55

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