Struct UsageEvent 

pub struct UsageEvent {
    pub timestamp: DateTime<Utc>,
    pub source: SourceKind,
    pub model: String,
    pub session: String,
    pub project: Option<String>,
    pub file_path: String,
    pub usage: UsageAccumulator,
}

A single parsed token usage event from a log file.

Each event represents one API request/response pair recorded by an AI coding assistant. Events carry the timestamp, model name, session identifier, and per-category token counts.

Example

use tokenusage::Config;

let events = tokenusage::load_events(Config::default()).await?;
for e in &events {
    println!("[{}] {}: {} in + {} out = {} total (${:.6})",
        e.timestamp.format("%Y-%m-%d %H:%M"),
        e.model,
        e.usage.input_tokens,
        e.usage.output_tokens,
        e.usage.total_tokens(),
        e.usage.cost_usd,
    );
}

Fields

timestamp: DateTime<Utc>

When the API call was made (UTC).

source: SourceKind

Which tool produced this event.

model: String

Model identifier (e.g. "claude-sonnet-4-20250514").

session: String

Session or conversation identifier.

project: Option<String>

Project name, if detectable from the log path.

file_path: String

Absolute path to the source log file.

usage: UsageAccumulator

Token counts and estimated cost for this single event.

Trait Implementations

impl Clone for UsageEvent

fn clone(&self) -> UsageEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UsageEvent

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

Formats the value using the given formatter.