boson (uf-boson on crates.io)

Main crate — re-exports core types, runtime, optional backends, and the #[task] macro.

The crates.io package is uf-boson (boson is already taken). With [lib] name = "boson", imports stay use boson::….

Source of truth: cargo doc -p uf-boson --features mem,axum --open — guided get-started with Mode 1 (embedded) and Mode 2 (remote worker). Published docs: https://docs.rs/uf-boson

Role

• task — #[task] macro and typed send_with
• Boson / BosonBuilder — worker boot
• Feature-gated backends: mem, sqlite, postgres, axum, telemetry-console
• Fleet backends: boson-backend-redis, boson-backend-nats
• prelude — common re-exports

Cargo features

This crate ships with no default features (default = []).

Boot a worker (Mode 1)

[dependencies]
boson = { package = "uf-boson", version = "0.1.1", features = ["mem"] }
tokio = { version = "1", features = ["rt-multi-thread", "macros"] }

use std::sync::Arc;

use boson::{configure, task, Boson, ExecutionContext, JsonExecutionContextFactory, MemQueueBackend};

#[task(name = "my_task")]
async fn my_task(ctx: Box<dyn ExecutionContext>) -> boson_core::Result<()> {
    let _ = ctx;
    Ok(())
}

let boson = Boson::builder()
    .queue_backend(Arc::new(MemQueueBackend::new()))
    .execution_context_factory(JsonExecutionContextFactory)
    .auto_registry()
    .build()?;
configure(boson);

With HTTP admin: features = ["mem", "axum"]. Full walkthrough: crate rustdoc Getting started and task_macro.

Mode 2 (enqueue host + worker): remote_enqueue / remote_worker examples (--features sqlite).

Define handlers and enqueue

After boot, add handlers with #[task] and enqueue with <TaskName>::send_with(...). See boson-macros for policy attributes.

Configuration precedence

Related crates

• boson-macros — #[boson::task] proc macro
• boson-runtime — worker runtime and builder
• boson-core — shared types and QueueBackend trait
• boson-axum — HTTP admin API