Skip to main content

Timeout context manager for asyncio programs

Project description

async-timeout

https://travis-ci.com/aio-libs/async-timeout.svg?branch=master https://codecov.io/gh/aio-libs/async-timeout/branch/master/graph/badge.svg https://img.shields.io/pypi/v/async-timeout.svg Chat on Gitter

asyncio-compatible timeout context manager.

Usage example

The context manager is useful in cases when you want to apply timeout logic around block of code or in cases when asyncio.wait_for() is not suitable. Also it’s much faster than asyncio.wait_for() because timeout doesn’t create a new task.

The timeout(delay, *, loop=None) call returns a context manager that cancels a block on timeout expiring:

async with timeout(1.5):
    await inner()
  1. If inner() is executed faster than in 1.5 seconds nothing happens.

  2. Otherwise inner() is cancelled internally by sending asyncio.CancelledError into but asyncio.TimeoutError is raised outside of context manager scope.

timeout parameter could be None for skipping timeout functionality.

Alternatively, timeout_at(when) can be used for scheduling at the absolute time:

loop = asyncio.get_event_loop()
now = loop.time()

async with timeout_at(now + 1.5):
    await inner()

Please note: it is not POSIX time but a time with undefined starting base, e.g. the time of the system power on.

Context manager has .expired property for check if timeout happens exactly in context manager:

async with timeout(1.5) as cm:
    await inner()
print(cm.expired)

The property is True if inner() execution is cancelled by timeout context manager.

If inner() call explicitly raises TimeoutError cm.expired is False.

The scheduled deadline time is available as .deadline property:

async with timeout(1.5) as cm:
    cm.deadline

Not finished yet timeout can be rescheduled by shift_by() or shift_to() methods:

async with timeout(1.5) as cm:
    cm.shift(1)  # add another second on waiting
    cm.update(loop.time() + 5)  # reschedule to now+5 seconds

Rescheduling is forbidden if the timeout is expired or after exit from async with code block.

Installation

$ pip install async-timeout

The library is Python 3 only!

Authors and License

The module is written by Andrew Svetlov.

It’s Apache 2 licensed and freely available.

CHANGES

4.0.0 (2021-11-01)

  • Implemented timeout_at(deadline) (#117)

  • Supported timeout.deadline and timeout.expired properties.

  • Drooped timeout.remaining property: it can be calculated as timeout.deadline - loop.time()

  • Dropped timeout.timeout property that returns a relative timeout based on the timeout object creation time; the absolute timeout.deadline should be used instead.

  • Added the deadline modification methods: timeout.reject(), timeout.shift(delay), timeout.update(deadline).

  • Deprecated synchronous context manager usage

3.0.1 (2018-10-09)

  • More aggressive typing (#48)

3.0.0 (2018-05-05)

  • Drop Python 3.4, the minimal supported version is Python 3.5.3

  • Provide type annotations

2.0.1 (2018-03-13)

  • Fix PendingDeprecationWarning on Python 3.7 (#33)

2.0.0 (2017-10-09)

  • Changed timeout <= 0 behaviour

    • Backward incompatibility change, prior this version 0 was shortcut for None

    • when timeout <= 0 TimeoutError raised faster

1.4.0 (2017-09-09)

  • Implement remaining property (#20)

    • If timeout is not started yet or started unconstrained: remaining is None

    • If timeout is expired: remaining is 0.0

    • All others: roughly amount of time before TimeoutError is triggered

1.3.0 (2017-08-23)

  • Don’t suppress nested exception on timeout. Exception context points on cancelled line with suspended await (#13)

  • Introduce .timeout property (#16)

  • Add methods for using as async context manager (#9)

1.2.1 (2017-05-02)

  • Support unpublished event loop’s “current_task” api.

1.2.0 (2017-03-11)

  • Extra check on context manager exit

  • 0 is no-op timeout

1.1.0 (2016-10-20)

  • Rename to async-timeout

1.0.0 (2016-09-09)

  • The first release.

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

async-timeout-4.0.0.tar.gz (8.3 kB view details)

Uploaded Source

Built Distribution

async_timeout-4.0.0-py3-none-any.whl (6.1 kB view details)

Uploaded Python 3

File details

Details for the file async-timeout-4.0.0.tar.gz.

File metadata

  • Download URL: async-timeout-4.0.0.tar.gz
  • Upload date:
  • Size: 8.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.8.12

File hashes

Hashes for async-timeout-4.0.0.tar.gz
Algorithm Hash digest
SHA256 7d87a4e8adba8ededb52e579ce6bc8276985888913620c935094c2276fd83382
MD5 2871f3853060ac7e76e6278b85dfb3c9
BLAKE2b-256 280c1cd218ea84964f0740a3ab6152dfa99661174abdd8e4053e06c0285ac42a

See more details on using hashes here.

Provenance

File details

Details for the file async_timeout-4.0.0-py3-none-any.whl.

File metadata

  • Download URL: async_timeout-4.0.0-py3-none-any.whl
  • Upload date:
  • Size: 6.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.8.12

File hashes

Hashes for async_timeout-4.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 f3303dddf6cafa748a92747ab6c2ecf60e0aeca769aee4c151adfce243a05d9b
MD5 93144bd33ea48eaa81de652538ad9cc2
BLAKE2b-256 53a9cd484af830e5c525553da1a585ff4fe6f1d91a12f0131c736a3ef0d99cce

See more details on using hashes here.

Provenance

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