Crate a3s_lane 

A3S Lane

A priority-based command queue for async task scheduling.

Core (always compiled)

• Priority-based scheduling with per-lane concurrency control
• Command timeout and retry policies (exponential backoff, fixed delay)
• Dead letter queue for permanently failed commands
• Persistent storage (pluggable Storage trait, LocalStorage included)
• Event system for queue lifecycle notifications
• Graceful shutdown with drain support

Feature Flags

Feature	Default	Dependencies	Description
metrics	✅	—	MetricsBackend trait, LocalMetrics, latency histograms
monitoring	✅	metrics	AlertManager, QueueMonitor with depth/latency thresholds
telemetry	✅	opentelemetry, dashmap	OpenTelemetry spans and OtelMetricsBackend
distributed	✅	num_cpus	Partitioning, rate limiting, priority boosting, DistributedQueue

Quick Start

use a3s_lane::{QueueManagerBuilder, EventEmitter, Command, Result};
use async_trait::async_trait;

struct MyCommand { data: String }

#[async_trait]
impl Command for MyCommand {
    async fn execute(&self) -> Result<serde_json::Value> {
        Ok(serde_json::json!({"processed": self.data}))
    }
    fn command_type(&self) -> &str { "my_command" }
}

#[tokio::main]
async fn main() -> Result<()> {
    let manager = QueueManagerBuilder::new(EventEmitter::new(100))
        .with_default_lanes()
        .build()
        .await?;

    manager.start().await?;

    let rx = manager.submit("query", Box::new(MyCommand { data: "hello".into() })).await?;
    let result = rx.await??;
    println!("Result: {}", result);
    Ok(())
}

Re-exports

pub use config::LaneConfig;

pub use dlq::DeadLetter;

pub use dlq::DeadLetterQueue;

pub use error::LaneError;

pub use error::Result;

pub use event::EventEmitter;

pub use event::EventPayload;

pub use event::EventStream;

pub use event::LaneEvent;

pub use job::job_processor_fn;

pub use job::DeduplicationOptions;

pub use job::InMemoryJobQueue;

pub use job::Job;

pub use job::JobContext;

pub use job::JobEvent;

pub use job::JobFinishedResult;

pub use job::JobFlow;

pub use job::JobFlowDependencyCountOptions;

pub use job::JobFlowDependencyCounts;

pub use job::JobFlowDependencyKind;

pub use job::JobFlowDependencyPage;

pub use job::JobFlowDependencyPageCursor;

pub use job::JobFlowDependencyPageItem;

pub use job::JobFlowDependencyPageOptions;

pub use job::JobFlowDependencyPages;

pub use job::JobFlowDependencyPagesOptions;

pub use job::JobFlowDependencySelectedCounts;

pub use job::JobFlowDependencyValues;

pub use job::JobId;

pub use job::JobLeaseRenewal;

pub use job::JobListOptions;

pub use job::JobListPage;

pub use job::JobLockToken;

pub use job::JobLogEntry;

pub use job::JobMetrics;

pub use job::JobMetricsMeta;

pub use job::JobOptions;

pub use job::JobPriority;

pub use job::JobPriorityCount;

pub use job::JobProcessor;

pub use job::JobProcessorFn;

pub use job::JobProcessorRouter;

pub use job::JobQueueBackend;

pub use job::JobQueueSnapshot;

pub use job::JobQueueStats;

pub use job::JobRateLimit;

pub use job::JobRepeatEntry;

pub use job::JobRepeatListOptions;

pub use job::JobRepeatPage;

pub use job::JobRetention;

pub use job::JobRunOutcome;

pub use job::JobSpec;

pub use job::JobState;

pub use job::JobStateCount;

pub use job::JobWorker;

pub use job::JobWorkerConfig;

pub use job::JobWorkerHandle;

pub use job::JobWorkerId;

pub use job::LocalJobQueue;

pub use job::QueueName;

pub use job::RepeatOptions;

pub use job::RepeatSchedule;

pub use job::DEFAULT_JOB_EVENT_RETENTION;

pub use job::DEFAULT_JOB_METRICS_RETENTION;

pub use job::DEFAULT_JOB_PRIORITY;

pub use job::MAX_JOB_PRIORITY;

pub use manager::QueueManager;

pub use manager::QueueManagerBuilder;

pub use priority_queue::PriorityItem;

pub use priority_queue::PriorityQueue;

pub use queue::lane_ids;

pub use queue::priorities;

pub use queue::Command;

pub use queue::CommandId;

pub use queue::CommandQueue;

pub use queue::JsonCommand;

pub use queue::Lane;

pub use queue::LaneId;

pub use queue::LaneStatus;

pub use queue::Priority;

pub use retry::RetryPolicy;

pub use storage::LocalStorage;

pub use storage::Storage;

pub use storage::StoredCommand;

pub use storage::StoredDeadLetter;

pub use alerts::Alert;

pub use alerts::AlertLevel;

pub use alerts::AlertManager;

pub use alerts::LatencyAlertConfig;

pub use alerts::QueueDepthAlertConfig;

pub use boost::PriorityBoostConfig;

pub use boost::PriorityBooster;

pub use distributed::CommandEnvelope;

pub use distributed::CommandResult;

pub use distributed::DistributedQueue;

pub use distributed::LocalDistributedQueue;

pub use distributed::WorkerId;

pub use distributed::WorkerPool;

pub use metrics::metric_names;

pub use metrics::HistogramPercentiles;

pub use metrics::HistogramStats;

pub use metrics::LocalMetrics;

pub use metrics::MetricsBackend;

pub use metrics::MetricsSnapshot;

pub use metrics::QueueMetrics;

pub use monitor::MonitorConfig;

pub use monitor::QueueMonitor;

pub use partition::CustomPartitioner;

pub use partition::HashPartitioner;

pub use partition::PartitionConfig;

pub use partition::PartitionId;

pub use partition::PartitionStrategy;

pub use partition::Partitioner;

pub use partition::RoundRobinPartitioner;

pub use ratelimit::RateLimitConfig;

pub use ratelimit::RateLimiter;

pub use ratelimit::SlidingWindowLimiter;

pub use ratelimit::TokenBucketLimiter;

pub use telemetry::OtelMetricsBackend;

Modules

alerts

Alert system for queue monitoring and notifications.

boost

Priority boosting for deadline-based priority adjustment

config

Lane configuration types

distributed

Distributed queue support for multi-machine parallel processing

dlq

Dead Letter Queue for permanently failed commands

error

Error types for the lane queue system

event

Event system for queue notifications

job

Generic job runtime primitives for distributed priority queues.

manager

Queue manager provides high-level queue management

metrics

Metrics collection and reporting for queue observability.

monitor

Queue monitor for tracking queue metrics and health

partition

Queue partitioning for parallel processing

priority_queue

Stable in-process priority queue for host-owned work items.

queue

Core queue implementation with lanes and priority scheduling

ratelimit

Rate limiting for lanes

retry

Retry policy for failed commands

storage

Persistent storage for queue state

telemetry

OpenTelemetry telemetry for the A3S Lane command queue.

Structs

QueueStats

Queue statistics snapshot