Struct AppState 

pub struct AppState {
    pub config: Arc<Config>,
    pub db: DbPool,
    pub http: Client,
    pub identity: Arc<IdentityResolver>,
    pub extensions: Arc<Extensions>,
}

Shared application state passed to every Axum handler.

This is the central state object that every route handler receives via axum::extract::State<AppState>. It holds the parsed configuration, database connection pool, and a shared HTTP client for outbound requests.

AppState is cheaply cloneable — all inner fields are either Arc-wrapped or already use internal reference counting (e.g. sqlx pools, reqwest::Client).

Fields

config: Arc<Config>

Parsed configuration from atrg.toml.

db: DbPool

Database connection pool. May be SQLite or PostgreSQL depending on the [database] url scheme in atrg.toml (and which features are compiled in to atrg-db).

http: Client

Shared HTTP client for outbound requests.

identity: Arc<IdentityResolver>

DID/handle resolver with TTL-backed in-memory cache.

extensions: Arc<Extensions>

Type-erased container for app-specific state (S3 clients, SMTP config, domain-specific services, etc.). Access via AppState::extension or AppState::try_extension.

Implementations

impl AppState

pub fn extension<T: Send + Sync + 'static>(&self) -> &T

Retrieve a reference to an app-specific extension by type.

Panics

Panics if the extension has not been registered. Use try_extension for a non-panicking variant.

Examples

struct MyService { url: String }

// In a handler:
async fn my_handler(State(state): State<AppState>) -> impl IntoResponse {
    let svc = state.extension::<MyService>();
    Json(json!({ "url": svc.url }))
}

pub fn try_extension<T: Send + Sync + 'static>(&self) -> Option<&T>

Retrieve a reference to an app-specific extension by type, returning None if the type was never registered.

Examples

if let Some(metrics) = state.try_extension::<MetricsCollector>() {
    metrics.record_request();
}

pub fn has_extension<T: Send + Sync + 'static>(&self) -> bool

Returns true if an extension of type T has been registered.

Trait Implementations

impl Clone for AppState

fn clone(&self) -> AppState

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl FromRef<AppState> for Arc<Config>

fn from_ref(state: &AppState) -> Self

Converts to this type from a reference to the input type.

impl FromRef<AppState> for Arc<Extensions>

fn from_ref(state: &AppState) -> Self

Converts to this type from a reference to the input type.

impl FromRef<AppState> for Arc<IdentityResolver>

fn from_ref(state: &AppState) -> Self

Converts to this type from a reference to the input type.

impl FromRef<AppState> for DbPool

fn from_ref(state: &AppState) -> Self

Converts to this type from a reference to the input type.