asynkio - README

Tokio-like functionality for Python

Table of contents

• Introduction
• Installation & Usage
• Components
• Examples
• Project Information
  • Where to get help
  • Contribution guidelines
  • Dependencies
    • Runtime Dependencies (aka "Normal Dependencies")
    • Efferent (fan-out)
      • Development Dependencies
    • Afferent (fan-in)
  • Related projects
  • License

Introduction

asynkio - a portmanteau of asyncio and Tokio, pronounced "ay sink ee-oh" - is a small, simple Python library that provides some of the features of the Rust Tokio library's features, such as Duration, Instant, and Interval.

Installation & Usage

Install via pip or pip3, as in:

$ pip3 install asynkio

Use via import:

from asynkio import (
    Duration,
    Instant,
    Interval,
    MissedTickBehaviour,
)

or:

from asynkio.time import (
    Duration,
    Instant,
    Interval,
    MissedTickBehaviour,
)

MissedTickBehavior (US spelling) is also exported as an alias for MissedTickBehaviour.

Components

Examples

Examples are provided in the examples/ directory. See EXAMPLES.md for a summary of each script.

Run a script with, for example:

$ uv sync
$ uv run python examples/interval_skip.py

Project Information

Where to get help

GitHub Page

Contribution guidelines

Defect reports, feature requests, and pull requests are welcome on https://github.com/synesissoftware/asynkio.

Dependencies

Runtime Dependencies (aka "Normal Dependencies")

asynkio depends on:

• Diagnosticism.Python for duration string formatting;
• the Python standard library (asyncio) for async timers;

Efferent (fan-out)

Libraries upon which asynkio depends:

• diagnosticism (>= 0.16.0) — Duration string formatting via nanoseconds_to_string();

Development Dependencies

• aiofiles — development and demonstration tooling;
• black — code formatter;
• diagnosticism — example scripts under examples/;
• pyclasp — development and demonstration tooling;
• pytest — unit-test runner;
• ruff — linter;

Afferent (fan-in)

Projects that depend on asynkio:

None (currently).

Related projects

• Tokio (Rust) — the library whose time types asynkio emulates;
• Diagnosticism.Python — used in examples/ scripts;

License

asynkio is released under the 3-clause BSD license. See LICENSE for details.