Enum IriDefect 

pub enum IriDefect {
    NotAbsolute,
    ForbiddenChar,
    Bracket,
    ExtraHash,
    BadPercent,
    Unclassified,
}

Why an IRI is not one — a repair classification, not the validity verdict. iri_content_defect decides validity with an RFC 3987 parser and uses these only to say what, if anything, can be done about it.

The classes are ordered by how they are found, not by severity; IriDefect::NotAbsolute is checked first because it is a property of the whole IRI, and IriDefect::Unclassified last because it is what is left when no other class explains a parser rejection.

Variants

NotAbsolute

No scheme: prefix, so the IRIREF is relative. N-Triples requires an absolute IRI. Not repairable — see the module docs.

ForbiddenChar

A character the IRIREF production excludes outright: U+0000–U+0020 (space and the controls), U+007F, and < > " { } | ^ `. A backslash that opens a well-formed UCHAR (\uXXXX / \UXXXXXXXX) is fine.

Bracket

[ or ] outside an IP-literal host. RFC 3987 reserves the brackets for http://[::1]/…; anywhere else — a path, a query — they must be percent-encoded. The single largest class in the field data (unescaped brackets in harvested PDF URLs).

ExtraHash

More than one #. The first starts the fragment; a # inside a fragment is not a pchar and must be %23.

BadPercent

A % not followed by two hex digits, so it is not a pct-encoded triplet. Often the trace of a broken string template rather than an escaping mistake (%x, %p) — escaping it makes the dump loadable without making the IRI right, which is the publisher’s bug to fix.

Unclassified

The RFC 3987 parser rejected it and no class above explains why. Either the defect is a shape this taxonomy has never seen (https://::1 — an IPv6 literal in the authority without its brackets, the case this bucket was added for), or escaping the shape that was recognised still leaves an IRI the parser refuses.

Not repairable — we do not know what is wrong, so we cannot claim to have fixed it. It is counted and it blocks, which is the whole point: a gap in the taxonomy must never read as a clean bill of health. Adding a class later only moves occurrences out of here; it never turns an invalid IRI into a valid one.

Implementations

impl IriDefect

pub const ALL: [IriDefect; 6]

Every class, in declaration order — the iteration order of a report.

pub fn index(self) -> usize

Index into a report’s per-class counters.

pub fn reason(self) -> &'static str

A short human reason, for a warning line.

These strings are parsed downstream — scripts/export_scholar_nquads.sh matches a stable fragment of each to fill state.tsv. Changing one means changing that parser in the same commit.

pub fn repairable(self) -> bool

Can percent-encoding repair it without inventing information?

Everything except IriDefect::NotAbsolute, which needs a base IRI the file does not carry, and IriDefect::Unclassified, where we do not know what is wrong.

Callers deciding whether a dump may be published must ask this, over every class — never whether a particular class is present. Hardcoding one class is how <https://::1> got through.

Trait Implementations

impl Clone for IriDefect

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for IriDefect

impl Debug for IriDefect

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

Formats the value using the given formatter.

impl Eq for IriDefect

impl Hash for IriDefect

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for IriDefect

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for IriDefect

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for IriDefect

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for IriDefect