Struct ExecutionContext 

pub struct ExecutionContext {
    pub duration_ms: u64,
    pub affected_rows: usize,
    pub process_id: u32,
}

Represents the structured diagnostic context for a successful operation.

This struct is intended to be used as the generic metadata context C within a CodexOkRaw instance. It provides standard fields for tracking common performance and identity metrics across your application.

Fields

• duration_ms - The time taken for the operation to complete, in milliseconds.
• affected_rows - The number of database rows, file records, or entities modified.
• process_id - The unique identifier of the process or worker thread that performed the task.

Fields

duration_ms: u64

The time taken for the operation to complete, in milliseconds.

affected_rows: usize

The number of database rows, file records, or entities modified.

process_id: u32

The unique identifier of the process or worker thread that performed the task.

Implementations

impl ExecutionContext

pub fn new() -> Self

Creates a new ExecutionContext with default values.

This is the canonical way to create a default context when the default method is not directly accessible or for explicit clarity.

Examples found in repository

examples/basic_usage.rs (line 28)

pub fn example_typed_metadata() {
  println!("\n--- Typed Metadata Example ---");

  let ctx = ExecutionContext::new()
    .with_duration(150)
    .with_affected_rows(12)
    .with_process_id(9982);

  // Provide explicit type here so the compiler knows C is ExecutionContext
  let result: CodexOkRaw<String, ExecutionContext> = CodexOkRaw {
    value: "Batch processing completed".to_string(),
    location: std::panic::Location::caller(),
    execution_meta: ctx,
  };

  println!("{result}");

  #[cfg(feature = "serde")]
  log_codex_ok(&result);
}

pub const fn with_duration(self, duration_ms: u64) -> Self

Sets the duration of the operation.

Examples found in repository

examples/basic_usage.rs (line 29)

pub fn example_typed_metadata() {
  println!("\n--- Typed Metadata Example ---");

  let ctx = ExecutionContext::new()
    .with_duration(150)
    .with_affected_rows(12)
    .with_process_id(9982);

  // Provide explicit type here so the compiler knows C is ExecutionContext
  let result: CodexOkRaw<String, ExecutionContext> = CodexOkRaw {
    value: "Batch processing completed".to_string(),
    location: std::panic::Location::caller(),
    execution_meta: ctx,
  };

  println!("{result}");

  #[cfg(feature = "serde")]
  log_codex_ok(&result);
}

pub const fn with_affected_rows(self, affected_rows: usize) -> Self

Sets the number of affected rows.

Examples found in repository

examples/basic_usage.rs (line 30)

pub fn example_typed_metadata() {
  println!("\n--- Typed Metadata Example ---");

  let ctx = ExecutionContext::new()
    .with_duration(150)
    .with_affected_rows(12)
    .with_process_id(9982);

  // Provide explicit type here so the compiler knows C is ExecutionContext
  let result: CodexOkRaw<String, ExecutionContext> = CodexOkRaw {
    value: "Batch processing completed".to_string(),
    location: std::panic::Location::caller(),
    execution_meta: ctx,
  };

  println!("{result}");

  #[cfg(feature = "serde")]
  log_codex_ok(&result);
}

pub const fn with_process_id(self, process_id: u32) -> Self

Sets the process ID.

Examples found in repository

examples/basic_usage.rs (line 31)

pub fn example_typed_metadata() {
  println!("\n--- Typed Metadata Example ---");

  let ctx = ExecutionContext::new()
    .with_duration(150)
    .with_affected_rows(12)
    .with_process_id(9982);

  // Provide explicit type here so the compiler knows C is ExecutionContext
  let result: CodexOkRaw<String, ExecutionContext> = CodexOkRaw {
    value: "Batch processing completed".to_string(),
    location: std::panic::Location::caller(),
    execution_meta: ctx,
  };

  println!("{result}");

  #[cfg(feature = "serde")]
  log_codex_ok(&result);
}

Trait Implementations

impl Debug for ExecutionContext

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

Formats the value using the given formatter.

impl Default for ExecutionContext

fn default() -> ExecutionContext

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ExecutionContext

where ExecutionContext: Default,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ExecutionContext

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.