Struct TimeEntry 

pub struct TimeEntry {
    pub id: String,
    pub duration_minutes: Option<i64>,
    pub date: Option<String>,
    pub author: String,
    pub note: Option<String>,
    pub extensions: TimeEntryExtensions,
}

One current time entry: actual effort recorded against one issue.

The fields are the mission’s confirmed shape (data-model §1, C-002): id is the stable identity that is never reused, duration_minutes the effort at documented minute precision, date an optional calendar date, author the required attribution, note optional free text, and extensions whatever else the file carries. An entry is not an estimate, a status or an ownership value, and no operation on one may change those (C-008).

Eq/Ord are the file’s own notions: equality is field-by-field (with the extensions compared by canonical render) and ordering is order_key — dated entries oldest first, undated last, ties by stable id — with every remaining field compared afterwards so the order is a total order consistent with equality. Surfaces that display entries in a deterministic order (data-model §6) sort by that order.

Fields

id: String

The stable id: identity for edits, deletions and History references.

Required for a valid entry and refused when blank, but default’d on read so an entry a hand edit emptied still parses and is reported instead of failing the issue (see the module docs).

duration_minutes: Option<i64>

The effort, in whole minutes at or above zero.

Option for the same diagnosability reason: a valid entry always carries one, and an absent one is refused by name rather than read as zero minutes.

date: Option<String>

The calendar date the effort belongs to, YYYY-MM-DD.

Optional and skipped when absent, so an entry without a date round-trips without gaining a key, and so an issue that carries no entry at all is unaffected by this field’s existence.

author: String

Who recorded the effort: an identity in the shape an issue’s assignee tolerates (a bare handle, or Name <email>), verbatim.

note: Option<String>

Optional free text, preserved verbatim.

extensions: TimeEntryExtensions

Unknown metadata, preserved verbatim.

Implementations

impl TimeEntry

pub fn new( id: impl Into<String>, duration_minutes: i64, date: Option<String>, author: impl Into<String>, note: Option<String>, ) -> Result<Self, Vec<TimeEntryError>>

Build a valid entry, refusing the same values Self::validate refuses.

Returns every problem at once, in field order, rather than the first: a caller fixing an entry should not have to resubmit it once per field.

pub fn minutes(&self) -> Option<i64>

The duration when it is present and at or above zero.

None is exactly the malformed state Self::problems reports, so a caller that has validated the entry can add this to a total and a caller that has not cannot mistake a missing duration for zero minutes.

pub fn order_key(&self) -> (bool, Option<&str>, &str)

The deterministic display order (data-model §6).

Dated entries oldest first, undated last, ties broken by the stable id. Comparing the whole tuple is how Ord keeps its order consistent with equality.

pub fn problems(&self) -> Vec<TimeEntryError>

Every field-level problem, in field order; empty means valid.

pub fn is_valid(&self) -> bool

Whether the entry has no field-level problems.

pub fn validate(&self) -> Result<(), Vec<TimeEntryError>>

Refuse the entry unless every field is valid.

Err carries all of Self::problems, not just the first, so a diagnostic surface can report the complete field set.

Trait Implementations

impl Clone for TimeEntry

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 TimeEntry

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TimeEntry

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for TimeEntry

impl Ord for TimeEntry

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for TimeEntry

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for TimeEntry

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for TimeEntry

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for TimeEntry