optional-dependencies
Injects optional dependencies using Option<Inject<T>>. Use when a service should work with or without a backend (metrics, telemetry, feature flags) that may not always be registered.
SKILL.mdskills/optional-dependencies/SKILL.md
GitHubOptional Dependencies
Option<Inject<T>> resolves to Some when T is available, None otherwise.
Field pattern
use injectable::prelude::*;
#[injectable]
struct Analytics {
db: Inject<Database>,
#[injectable(inject)]
metrics: Option<Inject<MetricsBackend>>, // None if not registered
}
impl Analytics {
pub fn record(&self, event: &str) {
if let Some(m) = &self.metrics {
m.emit(event);
}
}
}
Registering the optional dep
// Production: register it
let container = Container::builder()
.register(DynProvider::sync(|| Ok(PrometheusMetrics::new())))
.build().await?;
// Test/dev: omit it — Analytics still resolves with metrics = None
let container = Container::builder().build().await?;
Manual extraction
let ctx = container.context();
let maybe: Option<Inject<MetricsBackend>> = ctx.extract().await?;
if let Some(m) = maybe {
m.flush().await;
}
try_resolve — check without fail
// Returns Ok(None) instead of Err(MissingDependency)
let svc: Option<UserService> = container.try_resolve().await?;
let ext: Option<reqwest::Client> = container.try_resolve_external().await?;