Struct NumberScheme 

pub struct NumberScheme { /* private fields */ }

A numbering scheme for generated item numbers, e.g. {PROJECT}-{TYPE}-{YYYY}-{SEQ:4} → ROVER-PRT-2026-0007.

Placeholders: {PROJECT} (project code), {TYPE} (PRT, ASM, DOC, SW, SIM, AB), {YYYY}, {YY}, {MM} (creation date, UTC) and exactly one {SEQ:n} (sequence, zero-padded to n digits; {SEQ} pads nothing). Everything else is literal text from the item-number alphabet A–Z 0–9 . _ -.

Each distinct expansion of the scheme without the sequence counts on its own: {PROJECT}-{SEQ:4} counts per project group, a scheme with {YYYY} starts at 1 every year, a scheme without {TYPE} shares one sequence between all item types.

Implementations

impl NumberScheme

pub fn parse(raw: &str) -> Result<NumberScheme, AppError>

Parses and validates a scheme; placeholders are case-insensitive and the literal text is upper-cased like item numbers.

pub fn default_scheme() -> NumberScheme

The built-in scheme {TYPE}-{SEQ:6}.

pub fn of_project(stored: Option<&str>) -> Result<NumberScheme, AppError>

The stored scheme of a project group, or the default.

pub fn as_string(&self) -> String

The scheme in its canonical spelling (upper case, {SEQ:n}).

pub fn counter_key(&self, ctx: &NumberContext<'_>) -> String

Name of the counter that numbers this expansion: everything but the sequence filled in, e.g. num:ROVER-PRT-2026-{SEQ}. The padding width is not part of it, so widening {SEQ:4} to {SEQ:6} keeps counting.

pub fn format(&self, ctx: &NumberContext<'_>, seq: i64) -> String

The item number for sequence value seq.

pub fn around_seq(&self, ctx: &NumberContext<'_>) -> (String, String)

The expansion before and after the sequence, e.g. ROVER-PRT-2026- and `` for {PROJECT}-{TYPE}-{YYYY}-{SEQ:4}.

pub fn seq_of(&self, ctx: &NumberContext<'_>, number: &str) -> Option<i64>

The sequence value of number if this expansion can produce it (any width), e.g. 12 for ROVER-PRT-2026-0012 or ROVER-PRT-2026-12.

Trait Implementations

impl Clone for NumberScheme

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 NumberScheme

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

Formats the value using the given formatter.

impl Eq for NumberScheme

impl PartialEq for NumberScheme

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for NumberScheme