Struct TimestamperBuilder 

pub struct TimestamperBuilder { /* private fields */ }

Builder for Timestamper. Every chain method is #[must_use] so silent misuse is caught at compile time. build() performs post-configuration validation and returns the same typed errors the CLI’s post-parse validation produces (e.g., Error::InvalidUtcWithNamedTz for FR-020 mirrored at the library layer).

Example

use rusty_ts::{TimestamperBuilder, Format, TimezoneSource};

// Configure via the structured `utc()` / `tz_name()` methods that mirror
// the CLI `-u` and `--tz=<IANA>` flags.
let ts = TimestamperBuilder::new()
    .format(Format::Strftime("%Y-%m-%d %H:%M:%S".into()))
    .utc(true)
    .build()
    .expect("valid configuration");

// Conflicting configuration is caught at build() per FR-020.
let result = TimestamperBuilder::new()
    .utc(true)
    .tz_name("Asia/Tokyo")
    .build();
assert!(result.is_err());

Implementations

impl TimestamperBuilder

pub fn new() -> Self

Start a new builder with all-default configuration.

pub fn format(self, format: Format) -> Self

Set the strftime format selector.

pub fn utc(self, utc: bool) -> Self

Request UTC rendering (mirrors the CLI -u / --utc flag). Conflicts with tz_name; combined use causes build() to return Error::InvalidUtcWithNamedTz per FR-020.

pub fn tz_name(self, name: impl Into<String>) -> Self

Request rendering in a named IANA timezone (mirrors the CLI --tz=<IANA> flag). Conflicts with utc(true). The name is resolved at build() time; an unrecognised name produces Error::InvalidIanaName.

pub fn timezone(self, tz: TimezoneSource) -> Self

Low-level escape hatch: set the timezone source directly. When set, overrides utc() and tz_name() configuration. Most callers should prefer the structured utc() / tz_name() methods, which mirror the CLI flag surface and provide the FR-020 mutex enforcement.

pub fn compat(self, mode: CompatibilityMode) -> Self

Set the compatibility mode. Default is CompatibilityMode::Default.

pub fn elapsed(self, anchor: ElapsedAnchor) -> Self

Set the elapsed-time anchor. Default is Absolute.

pub fn build(self) -> Result<Timestamper, Error>

Finalize the builder. Returns a configured Timestamper or an Error if the configuration is invalid.

Validation:

• utc(true) + tz_name(...) together → Error::InvalidUtcWithNamedTz (library-layer mirror of FR-020).
• tz_name("...") with unrecognised IANA name → Error::InvalidIanaName.
• timezone(...) low-level override bypasses the above and uses whatever variant was supplied directly.

Trait Implementations

impl Clone for TimestamperBuilder

fn clone(&self) -> TimestamperBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TimestamperBuilder

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

Formats the value using the given formatter.

impl Default for TimestamperBuilder

fn default() -> TimestamperBuilder

Returns the “default value” for a type.