Struct Catalog 

pub struct Catalog { /* private fields */ }

In-memory representation of one or more parsed XML catalog files.

Construct with load_default to use the libxml2-compatible discovery rules, or with [from_files] / [parse] when you know the catalog locations explicitly.

Implementations

impl Catalog

pub fn resolve<'a>( &'a self, public_id: Option<&str>, system_id: Option<&str>, ) -> Option<Cow<'a, str>>

Look up a (publicId, systemId) pair against the catalog. Resolution follows OASIS § 7: SYSTEM exact → rewriteSystem → delegateSystem → PUBLIC exact (per prefer) → delegatePublic → nextCatalog chains. Returns the catalog’s URI for the entity, or None if no entry matched anywhere in the chain.

The result is a Cow so direct <public> / <system> matches return a borrow into the catalog (zero allocation) while rewrite entries return the synthesised string owned. Callers that need to own the URI past the catalog’s lifetime can call .into_owned().

pub fn resolve_uri<'a>(&'a self, uri: &str) -> Option<Cow<'a, str>>

<uri> lookup — resolve a generic URI alias. Distinct from <system>: the OASIS spec keeps the two namespaces separate. Used by XInclude / XSLT consumers that want a catalog-style mapping without going through DTD’s PUBLIC/SYSTEM mechanism.

As with resolve, the result is a Cow — direct <uri> matches borrow; <rewriteUri> matches own.

pub fn len(&self) -> usize

Number of entries in the catalog. Counts every entry, including rewrite/delegate/next ones. Used in tests and diagnostics.

pub fn is_empty(&self) -> bool

true if no entries were loaded.

pub fn sources(&self) -> &[PathBuf]

Files this catalog instance was loaded from, in order.

pub fn from_files<P>(paths: &[P]) -> Result<Catalog, XmlError>

where P: AsRef<Path>,

Build a catalog by merging the contents of multiple files. Later entries do NOT override earlier ones — first match wins, matching libxml2’s behaviour for catalog chains.

pub fn parse(bytes: &[u8]) -> Result<Catalog, XmlError>

Parse a catalog from raw bytes. Useful for tests or when the catalog isn’t on disk (embedded resources, etc.).

Trait Implementations

impl Clone for Catalog

fn clone(&self) -> Catalog

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Catalog

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

Formats the value using the given formatter.

impl Default for Catalog

fn default() -> Catalog

Returns the “default value” for a type.