Struct SegmentDefaults 

#[non_exhaustive]
pub struct SegmentDefaults {
    pub priority: u8,
    pub width: Option<WidthBounds>,
    pub truncatable: bool,
}

Layout intent declared by a segment; user config may override each field.

Under width pressure the engine drops segments in descending priority order: 255 drops first, 0 never drops. Default 128. Ties break by position: the right-most segment drops first.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

priority: u8

width: Option<WidthBounds>

truncatable: bool

May the layout engine shrink this segment under width pressure before dropping it? Default false — only prose-like segments (workspace name, branch name) opt in. Numeric or structured segments leave this false: a half-cut percentage reads as the wrong number, which is worse than no number. See docs/specs/segment-system.md §Layout algorithm.

Implementations

impl SegmentDefaults

pub fn with_priority(priority: u8) -> Self

Constructor shorthand for the common case of “default layout intent with a specific priority.” Chainable with Self::with_width and Self::with_truncatable.

pub fn with_width(self, bounds: WidthBounds) -> Self

Chainable setter for width bounds.

pub fn with_truncatable(self, truncatable: bool) -> Self

Chainable setter for the truncate-before-drop opt-in.

Trait Implementations

impl Clone for SegmentDefaults

fn clone(&self) -> SegmentDefaults

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SegmentDefaults

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

Formats the value using the given formatter.

impl Default for SegmentDefaults

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for SegmentDefaults

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for SegmentDefaults

impl Eq for SegmentDefaults

impl StructuralPartialEq for SegmentDefaults