Struct Diagnostic 

pub struct Diagnostic {
    pub severity: Severity,
    pub code: DiagnosticCode,
    pub message: String,
    pub file: PathBuf,
    pub line: usize,
    pub span: Option<Span>,
    pub suggestion: Option<String>,
    pub verbosity: DiagnosticVerbosity,
}

A single located diagnostic.

Fields

severity: Severity

code: DiagnosticCode

message: String

file: PathBuf

line: usize

1-based line number; 0 means “no specific line”.

span: Option<Span>

suggestion: Option<String>

verbosity: DiagnosticVerbosity

Verbosity gating (T13.5), set per diagnostic at emission — see DiagnosticVerbosity. Defaults to DiagnosticVerbosity::AlwaysOn; the few reference-zic -v-gated warnings (e.g. the “fewer than 3 characters” abbreviation case) set DiagnosticVerbosity::VerboseOnly via Diagnostic::verbose_only. (No filter is applied yet — zic-rs surfaces everything; the default-vs-verbose split is T13.6. This field records the gating so it isn’t lost.)

Implementations

impl Diagnostic

pub fn error( code: DiagnosticCode, message: impl Into<String>, file: &Path, line: usize, ) -> Self

Construct an error-severity diagnostic.

pub fn warning( code: DiagnosticCode, message: impl Into<String>, file: &Path, line: usize, ) -> Self

Construct a warning-severity diagnostic.

pub fn with_span(self, start: usize, end: usize) -> Self

Attach a column span (builder style).

pub fn with_suggestion(self, s: impl Into<String>) -> Self

Attach a suggestion (builder style).

pub fn verbose_only(self) -> Self

Mark this diagnostic as verbose-only (T13.5) — surfaced only in a future -v/verbose mode, mirroring reference zic’s noise-gated warnings (e.g. the “fewer than 3 characters” abbreviation case). Builder style; default is DiagnosticVerbosity::AlwaysOn.

Trait Implementations

impl Clone for Diagnostic

fn clone(&self) -> Diagnostic

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Diagnostic

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

Formats the value using the given formatter.

impl Display for Diagnostic

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

Formats the value using the given formatter.

impl From<Diagnostic> for Error

fn from(d: Diagnostic) -> Self

Converts to this type from the input type.