Struct Source 

#[non_exhaustive]
pub struct Source {
    pub file: &'static str,
    pub line: u32,
    pub from_library: bool,
}

Recorded source location for an element. Set automatically via #[track_caller] on every constructor.

from_library distinguishes Els constructed inside damascene’s own widget closures (where the closure boundary defeats #[track_caller] and the recorded location lands inside damascene-core instead of at the user’s call site) from Els constructed in user code. The lint pass uses this to gate user-facing findings and to walk blame attribution upward to the nearest user-source ancestor. Set explicitly via crate::tree::El::from_library at the few closure-builder sites that need it.

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.

file: &'static str

Source file path, as reported by Location::file().

line: u32

1-based line number within file.

from_library: bool

True when the El was constructed inside damascene’s own widget closures rather than user code (see the struct-level doc).

Implementations

impl Source

pub fn from_caller(loc: &'static Location<'static>) -> Self

Build a Source from a #[track_caller] location, with from_library set to false.

Trait Implementations

impl Clone for Source

fn clone(&self) -> Source

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Source

impl Debug for Source

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

Formats the value using the given formatter.

impl Default for Source

fn default() -> Source

Returns the “default value” for a type.