Skip to main content

Crate amq_protocol

Crate amq_protocol 

Source
Expand description

AMQP 0-9-1 protocol codec for Rust.

This crate is the main entry point for the amq-protocol workspace. It re-exports the tcp, types, and uri sub-crates and provides the code-generated protocol module (produced from the RabbitMQ spec), plus auth helpers and frame serialisation/deserialisation utilities.

§Feature flags

§Async runtime (pick exactly one)

FlagNotes
tokio (default)Requires a running Tokio runtime
smolUses the smol executor
async-global-executorUses async-global-executor

§TLS backend (pick at most one; rustls is the default)

FlagNotes
rustls (default)TLS via rustls
native-tlsTLS via the platform’s native library
opensslTLS via OpenSSL

§Rustls certificate store (only when rustls is active)

FlagNotes
rustls-platform-verifier (default)Uses the platform trust store
rustls-native-certsLoads native root certificates
rustls-webpki-roots-certsUses the webpki bundled root set

§Rustls crypto provider (at least one must be enabled)

FlagNotes
rustls--aws_lc_rs (default)Uses aws-lc-rs
rustls--ringUses ring (more portable)

§Miscellaneous

FlagNotes
codegenForce protocol code regeneration at build time
verbose-errorsMore detailed AMQP parser error messages
hickory-dnsUse hickory-dns for name resolution

Re-exports§

pub use amq_protocol_tcp as tcp;
pub use amq_protocol_types as types;
pub use amq_protocol_uri as uri;

Modules§

auth
SASL authentication helpers for AMQP connections.
frame
AMQP frame serialisation and deserialisation.
protocol
Code-generated AMQP 0-9-1 method and property types derived from the RabbitMQ spec.