Crate agnostic 

Agnostic

agnostic is an agnostic abstraction layer for any async runtime.

If you want a light weight crate, see agnostic-lite.

Introduction

agnostic is a comprehensive, runtime-agnostic abstraction layer for async Rust. It provides a unified API for task spawning, networking, DNS resolution, process management, and QUIC protocol support - all working seamlessly with tokio, or smol.

Looking for a lightweight option? Check out agnostic-lite for a minimal, no_std-compatible core.

Features

• Task Management: Spawn tasks globally or locally
• Time Operations: Sleep, intervals, timeouts, and delays
• Networking: TCP listeners/streams and UDP sockets
• DNS Resolution: Multiple transports (DoH, DoT, DoQ, DoH3) with DNSSEC
• Process Management: Spawn and manage subprocesses
• QUIC Support: Quinn protocol integration
• Runtime Agnostic: Switch runtimes with a single feature flag
• Zero-Cost: Compiles to runtime-specific code

Installation

[dependencies]
agnostic = "0.8"

Runtime Selection

Choose one runtime feature:

# For tokio
agnostic = { version = "0.8", features = ["tokio"] }

# For smol
agnostic = { version = "0.8", features = ["smol"] }

Optional Features

# Enable networking
agnostic = { version = "0.8", features = ["tokio", "net"] }

# Enable DNS resolution
agnostic = { version = "0.8", features = ["tokio", "dns"] }

# Enable DNS over HTTPS with rustls
agnostic = { version = "0.8", features = ["tokio", "dns-over-https-rustls"] }

# Enable DNS over QUIC
agnostic = { version = "0.8", features = ["tokio", "dns-over-quic"] }

# Enable DNSSEC
agnostic = { version = "0.8", features = ["tokio", "dnssec-ring"] }

# Enable process management
agnostic = { version = "0.8", features = ["tokio", "process"] }

# Enable Quinn QUIC
agnostic = { version = "0.8", features = ["tokio", "quinn"] }

Feature Flags

Core Features

• std (default): Standard library support
• alloc: Allocation support

Runtime Features (choose one)

• tokio: Tokio runtime support
• smol: Smol runtime support

Component Features

• net: Network abstractions (TCP, UDP)
• dns: DNS resolution support
• process: Process spawning and management
• quinn: Quinn QUIC protocol support
• tokio-io: Tokio I/O trait compatibility

DNS Transport Features

• dns-over-quic: DNS over QUIC (RFC 9250)
• dns-over-h3: DNS over HTTP/3
• dns-over-https-rustls: DNS over HTTPS with rustls
• dns-over-rustls: DNS over TLS with rustls
• dns-over-openssl: DNS over TLS with OpenSSL
• dns-over-native-tls: DNS over TLS with native-tls
• dns-webpki-roots: Use webpki root certificates
• dns-native-certs: Use OS native certificates

DNSSEC Features

• dnssec: Basic DNSSEC support
• dnssec-openssl: DNSSEC with OpenSSL
• dnssec-ring: DNSSEC with ring crypto library

Comparison: agnostic vs agnostic-lite

Feature	agnostic	agnostic-lite
Task spawning	✅	✅
Time operations	✅	✅
Networking	✅	❌
DNS resolution	✅	❌
Process management	✅	❌
QUIC support	✅	❌
no_std support	❌	✅
Alloc-free	❌	✅
No unsafe code	❌	✅

Use agnostic-lite when:

• You need no_std or embedded support
• You want minimal dependencies
• You only need basic async primitives

Use agnostic when:

• You need networking, DNS, or process capabilities
• You’re building standard applications
• You want a batteries-included experience

License

agnostic is under the terms of both the MIT license and the Apache License (Version 2.0).

See LICENSE-APACHE, LICENSE-MIT for details.

Copyright (c) 2025 Al Liu.

Re-exports

pub use agnostic_io as io;

Modules

dnsdns

Agnostic async DNS provider.

netnet

Network related traits

processprocess

Process related traits

quinnquinn

Quinn related traits

smolsmol

smol runtime adapter

time

Time related traits

tokiotokio

tokio runtime adapter

Macros

cfg_linux

Macro to conditionally compile items for linux system

cfg_smol

Macro to conditionally compile items for smol feature

cfg_tokio

Macro to conditionally compile items for tokio feature

cfg_unix

Macro to conditionally compile items for unix system

cfg_windows

Macro to conditionally compile items for windows system

Enums

AfterHandleError

Error of AfterHandle’s output

Traits

AfterHandle

The handle returned by the AsyncAfterSpawner when a after future is spawned.

AsyncAfterSpawner

A spawner trait for spawning futures. Go’s time.AfterFunc equivalent.

AsyncBlockingSpawner

A spawner trait for spawning blocking.

AsyncLocalSpawner

A spawner trait for spawning futures.

AsyncSpawner

A spawner trait for spawning futures.

JoinHandle

Joinhanlde trait

LocalJoinHandle

Joinhanlde trait

Runtime

Runtime trait

RuntimeLite

Runtime trait

Yielder

Yielder hints the runtime to execution back