Struct Diagnostic 

pub struct Diagnostic {
    pub severity: Severity,
    pub message: String,
    pub file: Option<String>,
    pub line: Option<u32>,
    pub column: Option<u32>,
    pub category: Option<String>,
    pub fix_its: Vec<String>,
    pub snippet: Option<String>,
    pub note: Option<String>,
    pub help: Option<String>,
}

A structured diagnostic extracted from the C parser (clang-sys).

Contains source location, code snippet, categorized explanation, and actionable fix suggestion, formatted in rustc-style output.

Fields

severity: Severity

Severity: Note, Warning, Error, Fatal

message: String

Error message from clang (e.g. “expected ‘)’”)

file: Option<String>

Source file path

line: Option<u32>

1-based line number

column: Option<u32>

1-based column number

category: Option<String>

Clang diagnostic category (e.g. “Parse Issue”)

fix_its: Vec<String>

Suggested fixes from clang fix-its

snippet: Option<String>

3-line code snippet with caret indicator

note: Option<String>

Explanatory note (WHY it failed)

help: Option<String>

Actionable help (HOW to fix)

Implementations

impl Diagnostic

pub fn new(severity: Severity, message: impl Into<String>) -> Self

Create a new diagnostic with the given severity and message.

pub fn error_category(&self) -> ErrorCategory

Infer the error category from the clang category or message content.

pub fn build_snippet( source: &str, line: u32, column: Option<u32>, ) -> Option<String>

Build a 3-line code snippet with a caret pointing at the error column.

pub fn infer_note_and_help(&mut self)

Populate note and help based on common C error patterns.

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.