Struct FieldSelector 

pub struct FieldSelector {
    pub task_overdue: bool,
    pub task_in_progress: bool,
    pub task_unstarted: bool,
    pub event_span: bool,
    pub created_at: bool,
    pub updated_at: bool,
}

Selects which fields and semantic task conditions to filter on.

When all fields are false (the default) and a period is set, the period is applied to every timestamp field simultaneously (OR — “all-fields” fallback). Setting any field to true disables that fallback so only the selected conditions apply.

Period-field selectors (event_span, created_at, updated_at): restrict period matching to specific timestamp fields. Without a period, a true flag means “the field must be present (set)”.

Semantic task selectors — use the period end as a cutoff where applicable:

• task_overdue: closed_at absent and due ≤ period_end (or due < now).
• task_in_progress: closed_at absent and started_at ≤ period_end (or set).
• task_unstarted: started_at and closed_at both absent; period is not applied.

Fields

task_overdue: bool

task_in_progress: bool

task_unstarted: bool

event_span: bool

created_at: bool

updated_at: bool

Implementations

impl FieldSelector

pub fn is_empty(&self) -> bool

Returns true when no field of any kind is selected.

When this returns true and a period is set, the period is applied to all timestamp fields simultaneously (OR — “all-fields” fallback).

pub fn active() -> Self

Return a selector with all fields enabled — equivalent to the --active CLI flag.

Combines task_overdue, task_in_progress, event_span, created_at, and updated_at. task_unstarted is intentionally excluded because unstarted tasks carry no timestamp relationship to the period.

Trait Implementations

impl Clone for FieldSelector

fn clone(&self) -> FieldSelector

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FieldSelector

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

Formats the value using the given formatter.

impl Default for FieldSelector

fn default() -> FieldSelector

Returns the “default value” for a type.