Struct AppContext 

pub struct AppContext { /* private fields */ }

Application-wide runtime container shared across the HTTP server, the scheduler, and CLI commands.

Every field is an Arc (or an Arc-internal handle such as DbPool), so clone is a reference-count bump rather than a deep copy; the type is designed to be cloned freely into request handlers, jobs, and spawned tasks. Construct it via AppContext::builder (or AppContext::new for the default build); AppContext::from_parts bypasses the bootstrap and is intended for tests and embedders that assemble the parts themselves.

Some handles are optional: geoip_reader, content_config, fingerprint_repo, and user_service are None when the corresponding resource is absent or failed to initialise, and callers must degrade gracefully rather than assume presence.

Implementations

impl AppContext

pub async fn new() -> RuntimeResult<Self>

Builds a context with default settings: schema installation off, extensions discovered via inventory, and the inventory-registered marketplace filter. Equivalent to Self::builder().build().await.

pub fn builder() -> AppContextBuilder

pub fn from_parts(parts: AppContextParts) -> Self

Assembles a context directly from pre-built parts, bypassing the AppContextBuilder bootstrap. Intended for tests and embedders that own the construction of the individual handles.

pub fn load_geoip_database( config: &Config, show_warnings: bool, ) -> Option<GeoIpReader>

pub fn load_content_config( config: &Config, app_paths: &AppPaths, ) -> Option<Arc<ContentConfigRaw>>

pub fn config(&self) -> &Config

pub fn content_config(&self) -> Option<&ContentConfigRaw>

pub fn content_routing(&self) -> Option<Arc<dyn ContentRouting>>

pub const fn db_pool(&self) -> &DbPool

pub const fn database(&self) -> &DbPool

pub fn api_registry(&self) -> &ModuleApiRegistry

pub fn extension_registry(&self) -> &ExtensionRegistry

pub fn server_address(&self) -> String

pub const fn geoip_reader(&self) -> Option<&GeoIpReader>

pub const fn analytics_service(&self) -> &Arc<AnalyticsService>

pub const fn route_classifier(&self) -> &Arc<RouteClassifier>

pub fn app_paths(&self) -> &AppPaths

pub const fn app_paths_arc(&self) -> &Arc<AppPaths>

pub fn marketplace_filter(&self) -> &Arc<dyn MarketplaceFilter>

pub const fn event_bridge(&self) -> &Arc<OnceLock<JoinHandle<()>>>

pub fn system_admin(&self) -> &SystemAdmin

pub const fn mcp_registry(&self) -> &RegistryService

pub const fn authz_hook(&self) -> &SharedAuthzHook

Trait Implementations

impl AppContext for AppContext

fn config(&self) -> Arc<dyn ConfigProvider>

fn database_handle(&self) -> Arc<dyn DatabaseHandle>

fn analytics_provider(&self) -> Option<Arc<dyn AnalyticsProvider>>

fn fingerprint_provider(&self) -> Option<Arc<dyn FingerprintProvider>>

fn user_provider(&self) -> Option<Arc<dyn UserProvider>>

impl Clone for AppContext

fn clone(&self) -> AppContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AppContext

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl ExtensionContext for AppContext

fn config(&self) -> Arc<dyn ConfigProvider>

fn database(&self) -> Arc<dyn DatabaseHandle>

fn get_extension(&self, id: &str) -> Option<Arc<dyn Extension>>

fn has_extension(&self, id: &str) -> bool

impl HasAnalytics for AppContext

type Analytics = Arc<AnalyticsService>

fn analytics(&self) -> &Self::Analytics

impl HasFingerprint for AppContext

type Fingerprint = Arc<FingerprintRepository>

fn fingerprint(&self) -> Option<&Self::Fingerprint>

impl HasRouteClassifier for AppContext

type RouteClassifier = Arc<RouteClassifier>

fn route_classifier(&self) -> &Self::RouteClassifier

impl HasUserService for AppContext

type UserService = Arc<UserService>

fn user_service(&self) -> Option<&Self::UserService>