Struct StyleRegistry 

pub struct StyleRegistry {
    pub version: String,
    pub styles: Vec<RegistryEntry>,
}

A registry of citation styles with alias resolution.

Fields

version: String

Version identifier for the registry format.

styles: Vec<RegistryEntry>

List of style entries in the registry.

Implementations

impl StyleRegistry

pub fn resolve(&self, name: &str) -> Option<&RegistryEntry>

Resolve a name or alias to the matching registry entry.

Checks id first, then searches aliases.

pub fn all_ids(&self) -> impl Iterator<Item = &str>

All canonical style IDs in the registry.

pub fn merge_over(&self, base: &StyleRegistry) -> StyleRegistry

Merge another registry over self (self wins on ID conflict).

Entries from base are included first. If an entry in self has the same ID as one in base, the entry from self replaces it. New entries from self are appended.

pub fn from_slices(names: &[&str], aliases: &[(&str, &str)]) -> StyleRegistry

Build a registry from embedded style name and alias slices.

Used to construct the default registry from hardcoded embedded data.

pub fn load_default() -> StyleRegistry

Load the embedded default registry from the compiled-in YAML data.

Panics

Panics only if the embedded YAML is malformed (should never happen in a correctly built binary).

pub fn load_from_file(path: &Path) -> Result<StyleRegistry, Box<dyn Error>>

Load a registry from a YAML file on disk.

Errors

Returns an error if the file cannot be read or if the YAML cannot be parsed. Also returns an error if any entry does not have exactly one of builtin, path, or url.

pub fn validate_sources(&self) -> Result<(), Box<dyn Error>>

Validate that each entry declares exactly one loadable style source.

Errors

Returns an error if any entry has no source or multiple sources.

Trait Implementations

impl Clone for StyleRegistry

fn clone(&self) -> StyleRegistry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StyleRegistry

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for StyleRegistry

fn deserialize<__D>( __deserializer: __D, ) -> Result<StyleRegistry, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for StyleRegistry

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

where __S: Serializer,

Serialize this value into the given Serde serializer.