Crate photonio

An efficient runtime for asynchronous applications.

There are two implementations of this runtime:

• The photonio-uring crate provides an implementation for Linux based on io_uring.
• The photonio-tokio crate provides an implementation for other platforms based on tokio.

By default, this crate uses the photonio-uring implementation on Linux and the photonio-tokio implementation on other platforms. To use the photonio-tokio implementation on all platforms, enable the tokio feature.

Examples

use photonio::{
    fs::File,
    io::{Write, WriteAt},
};

#[photonio::main]
async fn main() -> std::io::Result<()> {
    let mut file = File::create("hello.txt").await?;
    file.write(b"hello").await?;
    file.write_at(b"world", 5).await?;
    Ok(())
}

Limitations

• Dropping an unfinished future for asynchronous filesystem or networking operations will result in a panic. However, this behavior might be change in the future.
• The current multi-thread runtime uses a naive round-robin fashion to schedule tasks. A work-stealing scheduler will be added in the future.

Modules

fs

Primitives for asynchronous filesystem operations.

io

Primitives for asynchronous I/O.

net

Primitives for asynchronous networking operations.

runtime

The PhotonIO runtime.

task

Primitives for asynchronous tasks.

Attribute Macros

main

Marks a function to be run on a runtime.

test

This is similar to main, but for tests.