Enum PreprocDiagnostic 

pub enum PreprocDiagnostic {
    SelfInclusion {
        file: PathBuf,
    },
    IncludeCycle {
        members: Vec<String>,
    },
    NonUtf8CyclePath {
        path: String,
    },
    NonUtf8IndirectInclude {
        path: String,
    },
    NotPreprocessed {
        file: PathBuf,
    },
}

A non-fatal diagnostic produced while resolving the C/C++ include graph in fix_includes.

Resolution is best-effort: self-inclusions, include cycles, paths that cannot be decoded as UTF-8, and files referenced but never preprocessed are all reported here rather than written to stderr, so an embedder (e.g. bca-web) can capture, suppress, or surface them as it sees fit. The CLI prints them to stderr.

Variants

SelfInclusion

A file’s #include resolved back to the file itself; the self-edge was skipped.

Fields

file: PathBuf

The file that includes itself.

IncludeCycle

A strongly connected component (an include cycle) was collapsed into a single replacement node. Carries the member paths.

Fields

members: Vec<String>

The files participating in the cycle.

NonUtf8CyclePath

A path could not be decoded as UTF-8 and was skipped while collapsing an include cycle.

Fields

path: String

The lossy rendering of the offending path.

NonUtf8IndirectInclude

A path could not be decoded as UTF-8 and was skipped while recording indirect includes.

Fields

path: String

The lossy rendering of the offending path.

NotPreprocessed

A file appears in the include graph but was never preprocessed, so its own macros and includes are unknown.

Fields

file: PathBuf

The file referenced but not preprocessed.

Trait Implementations

impl Clone for PreprocDiagnostic

fn clone(&self) -> PreprocDiagnostic

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PreprocDiagnostic

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PreprocDiagnostic

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for PreprocDiagnostic

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

Formats the value using the given formatter.

impl Eq for PreprocDiagnostic

impl PartialEq for PreprocDiagnostic

fn eq(&self, other: &PreprocDiagnostic) -> 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 Serialize for PreprocDiagnostic

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for PreprocDiagnostic