Struct DaemonContext 

pub struct DaemonContext {
    pub daemon_name: String,
    pub instance_id: Uuid,
    /* private fields */
}

Context available to daemon handlers.

Fields

daemon_name: String

Daemon name.

instance_id: Uuid

Unique instance ID for this daemon execution.

Implementations

impl DaemonContext

pub fn new( daemon_name: String, instance_id: Uuid, db_pool: PgPool, http_client: Client, shutdown_rx: Receiver<bool>, ) -> Self

Create a new daemon context.

pub fn with_env_provider(self, provider: Arc<dyn EnvProvider>) -> Self

Set environment provider.

pub fn db(&self) -> &PgPool

pub fn http(&self) -> &Client

pub fn is_shutdown_requested(&self) -> bool

Check if shutdown has been requested.

pub async fn shutdown_signal(&self)

Wait for shutdown signal.

Use this in a tokio::select! to handle graceful shutdown:

tokio::select! {
    _ = tokio::time::sleep(Duration::from_secs(60)) => {}
    _ = ctx.shutdown_signal() => break,
}

pub async fn heartbeat(&self) -> Result<()>

Send heartbeat to indicate daemon is alive.

pub fn trace_id(&self) -> String

Get the trace ID for this daemon execution.

Returns the instance_id as a correlation ID.

pub fn span(&self) -> &Span

Get the parent span for trace propagation.

Use this to create child spans within daemon handlers.

Trait Implementations

impl EnvAccess for DaemonContext

fn env_provider(&self) -> &dyn EnvProvider

Get the environment provider.

fn env(&self, key: &str) -> Option<String>

Get an environment variable.

fn env_or(&self, key: &str, default: &str) -> String

Get an environment variable with a default value.

fn env_require(&self, key: &str) -> Result<String>

Get a required environment variable.

fn env_parse<T: FromStr>(&self, key: &str) -> Result<T>

where T::Err: Display,

Get an environment variable and parse it to the specified type.

fn env_parse_or<T: FromStr>(&self, key: &str, default: T) -> Result<T>

where T::Err: Display,

Get an environment variable and parse it, with a default.

fn env_contains(&self, key: &str) -> bool

Check if an environment variable is set.