Enum RefParseError 

#[non_exhaustive]
pub enum RefParseError {
    Empty,
    MissingDoiPrefix,
    MissingDoiSuffixSeparator,
    InvalidDoiRegistrant,
    EmptyDoiSuffix,
    DoiSuffixTooLong {
        len: usize,
        max: usize,
    },
    InvalidDoiSuffixChar {
        ch: char,
    },
    InvalidArxivShape,
    UnrecognisedShape,
}

Reasons a Doi::parse / ArxivId::parse / Ref::parse call can fail.

Each variant maps to one rejection category in docs/SECURITY.md §1.1. All variants funnel to ErrorCode::InvalidRef when surfacing to MCP / CLI; the granular shape is preserved for tests and for future log breadcrumbs. The From<RefParseError> for ErrorCode impl below makes ? propagation collapse to INVALID_REF automatically, satisfying docs/PUBLIC_API.md §4.

Marked #[non_exhaustive] so adding new categories is a non-breaking change. Pattern-match with a wildcard arm.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Empty

Input was empty.

MissingDoiPrefix

Input did not begin with the required 10. literal (after any scheme strip).

MissingDoiSuffixSeparator

Input started with 10. but had no / separator between registrant and suffix.

InvalidDoiRegistrant

Registrant was not 4–9 ASCII digits.

EmptyDoiSuffix

DOI suffix was empty.

DoiSuffixTooLong

DOI suffix exceeded DOI_SUFFIX_MAX_LEN bytes.

Fields

len: usize

Observed suffix length, in bytes.

max: usize

Hard upper bound (always DOI_SUFFIX_MAX_LEN).

InvalidDoiSuffixChar

DOI suffix contained a character outside [A-Za-z0-9._/():-].

Fields

ch: char

The first offending character.

InvalidArxivShape

Input matched neither the new-style nor old-style arXiv shape.

UnrecognisedShape

Input carried no scheme and no 10. prefix, so it could have been either kind of ref, and it was neither.

#477: the fall-through used to report Self::InvalidArxivShape, so someone who mistyped a DOI was told about arXiv. The input names no shape, so neither should the error.

Trait Implementations

impl Clone for RefParseError

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RefParseError

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

Formats the value using the given formatter.

impl Display for RefParseError

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

Formats the value using the given formatter.

impl Eq for RefParseError

impl Error for RefParseError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

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

Provides type-based access to context intended for error reports.

impl From<RefParseError> for FetchError

fn from(source: RefParseError) -> Self

Converts to this type from the input type.

impl From<RefParseError> for ErrorCode

fn from(_: RefParseError) -> Self

Converts to this type from the input type.

impl PartialEq for RefParseError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for RefParseError