Struct Period 

pub struct Period {
    pub start: Option<String>,
    pub end: Option<String>,
}

The inclusive calendar period a series covers (data-model.md §1).

Both bounds are caller-supplied YYYY-MM-DD strings — this module reads no clock — and each is optional because a cycle need not declare its dates: an absent bound is “unbounded on that side”, which is coverage, not a guess. The bounds come from existing planning data ([cycle_scope]/[milestone_scope]), never from an assumption about when work started.

Comparison is &str comparison, which is chronological for that fixed-width shape and needs no date arithmetic.

Fields

start: Option<String>

Inclusive start, or None for “unbounded from the beginning”.

end: Option<String>

Inclusive end, or None for “still open”.

Implementations

impl Period

pub fn new(start: Option<String>, end: Option<String>) -> Result<Self>

A validated period: each present bound must be a canonical calendar date and start <= end must hold.

A malformed bound is refused here rather than silently dropped, because a period that quietly lost an end date would turn a closed series into an open one — the one thing C-006 forbids.

pub fn unbounded() -> Self

A period with neither bound.

pub fn is_bounded(&self) -> bool

Whether the period constrains anything at all.

pub fn contains(&self, date: &str) -> bool

Whether a canonical YYYY-MM-DD date falls inside the period, both bounds inclusive.

A date that is not a canonical calendar date is not contained: the caller reports the unreadable day as coverage rather than placing it somewhere.

Trait Implementations

impl Clone for Period

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Period

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

Formats the value using the given formatter.

impl Default for Period

fn default() -> Self

Returns the “default value” for a type.

impl Eq for Period

impl PartialEq for Period

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Period