Struct UsageData 

pub struct UsageData {
    pub models: UsageResult,
    pub per_provider: PerProviderUsage,
    pub provider_days: ProviderActiveDays,
    pub stored_costs: StoredCosts,
}

Aggregated token usage plus the per-provider active-day counts.

Built only by aggregate_usage_from_home; all fields are public for the display layer to read. Token totals are tracked two ways at once because the two views need different attribution: models merges a shared model (e.g. claude-sonnet-4-6 emitted by both Claude Code and Copilot CLI) into one row, while per_provider keeps the same tokens scoped to the source directory so the footer can attribute them correctly. The shared tokens are merged, not summed, so they are never double-counted across the two maps.

Examples

use vct_core::{aggregate_usage_from_home, TimeRange};

let data = aggregate_usage_from_home(TimeRange::All)?;
// Total distinct days that contributed any usage, across all providers.
println!("active days: {}", data.provider_days.total);

Fields

models: UsageResult

Tokens aggregated across all providers, keyed by model name.

Drives the per-model summary table where, e.g., claude-sonnet-4-6 tokens from Claude Code and Copilot CLI share a single row.

per_provider: PerProviderUsage

Tokens kept separate per source directory, keyed by provider → model.

Drives the per-provider totals in the summary footer. Keeping this split at aggregation time avoids the display layer from having to guess a model’s provider from its name, which broke once Copilot CLI started emitting real (Claude / OpenAI / …) model names.

provider_days: ProviderActiveDays

Count of distinct calendar dates that contributed usage, per provider and overall.

stored_costs: StoredCosts

Provider-authoritative per-model cost (USD), summed from the source.

Implementations

impl UsageData

pub fn provider_usage(&self, provider: Provider) -> Option<&UsageResult>

Returns the per-provider usage slice for provider, or None when the provider has no dedicated bucket (e.g. Provider::Unknown — the display layer’s fallthrough view is fed by the global models map instead).

Trait Implementations

impl Clone for UsageData

fn clone(&self) -> UsageData

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UsageData

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

Formats the value using the given formatter.

impl Serialize for UsageData

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

where __S: Serializer,

Serialize this value into the given Serde serializer.