Struct ReferenceCatalog 

pub struct ReferenceCatalog {
    pub references: Vec<KnownReference>,
    pub md5_to_refs: HashMap<String, Vec<usize>>,
    pub name_length_to_refs: HashMap<(String, u64), Vec<usize>>,
    pub alias_length_to_refs: HashMap<(String, u64), Vec<usize>>,
    /* private fields */
}

The main reference catalog with indexes

Fields

references: Vec<KnownReference>

All known references

md5_to_refs: HashMap<String, Vec<usize>>

Index: MD5 -> indices of references containing this MD5

name_length_to_refs: HashMap<(String, u64), Vec<usize>>

Index: (exact_name, length) -> indices of references

alias_length_to_refs: HashMap<(String, u64), Vec<usize>>

Index: (alias, length) -> indices of references Separate from name_length_to_refs to distinguish primary names from aliases

Implementations

impl ReferenceCatalog

pub fn new() -> Self

Create an empty catalog

pub fn load_embedded() -> Result<Self, CatalogError>

Load the embedded default catalog

Errors

Returns CatalogError::Json if the embedded catalog is invalid.

pub fn load_from_file(path: &Path) -> Result<Self, CatalogError>

Load catalog from a JSON file

Errors

Returns CatalogError::Io if the file cannot be read, or CatalogError::Json if parsing fails.

pub fn from_json(json: &str) -> Result<Self, CatalogError>

Parse catalog from JSON string

Errors

Returns CatalogError::Json if the JSON is invalid.

pub fn add_reference(&mut self, reference: KnownReference)

Add a reference to the catalog

pub fn get(&self, id: &ReferenceId) -> Option<&KnownReference>

Get a reference by ID

pub fn find_by_signature(&self, signature: &str) -> Option<&KnownReference>

Find exact match by signature

pub fn to_json(&self) -> Result<String, CatalogError>

Export catalog to JSON

Errors

Returns CatalogError::Json if serialization fails.

pub fn len(&self) -> usize

Number of references in catalog

pub fn is_empty(&self) -> bool

Check if catalog is empty

Trait Implementations

impl Debug for ReferenceCatalog

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

Formats the value using the given formatter.

impl Default for ReferenceCatalog

fn default() -> Self

Returns the “default value” for a type.