Struct TimeEntryExtensions 

pub struct TimeEntryExtensions(/* private fields */);

Unknown metadata carried by one TimeEntry, preserved verbatim.

The rule this exists for (C-007, T005): a key a newer tix adds must survive an edit-and-save round trip instead of being dropped. Values are held as parsed YAML values rather than strings so a sequence, a mapping or a number written by another build is preserved as what it is, not rejected for not being a string. A BTreeMap keeps the render order deterministic, so a file that did not change does not gain a diff.

Equality is by canonical render rather than by the derived comparison, because serde_yaml::Value is not Eq (floats are not), while an entry — and therefore the Issue that holds a list of them — must stay Eq. Two extension maps are equal exactly when they render identically, which is also what round-trip stability means here.

Implementations

impl TimeEntryExtensions

pub fn is_empty(&self) -> bool

Whether no unknown metadata is present.

pub fn len(&self) -> usize

The number of preserved keys.

pub fn get(&self, key: &str) -> Option<&Value>

Look up a preserved key.

pub fn keys(&self) -> impl Iterator<Item = &str>

The preserved keys, in canonical (sorted) order.

pub fn iter(&self) -> impl Iterator<Item = (&str, &Value)>

Iterate the preserved (key, value) pairs in canonical order.

pub fn as_map(&self) -> &BTreeMap<String, Value>

The underlying map, for a caller that must serialize or splice it whole.

pub fn insert(&mut self, key: impl Into<String>, value: Value) -> Option<Value>

Preserve one (key, value) pair, returning the previous value if any.

pub fn canonical_yaml(&self) -> String

The canonical YAML render, used for equality and for the tie-break of TimeEntry’s ordering.

Trait Implementations

impl Clone for TimeEntryExtensions

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 TimeEntryExtensions

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

Formats the value using the given formatter.

impl Default for TimeEntryExtensions

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for TimeEntryExtensions

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for TimeEntryExtensions

impl From<BTreeMap<String, Value>> for TimeEntryExtensions

fn from(map: BTreeMap<String, Value>) -> Self

Converts to this type from the input type.

impl PartialEq for TimeEntryExtensions

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for TimeEntryExtensions

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

where __S: Serializer,

Serialize this value into the given Serde serializer.