Struct OfficialIndex 

pub struct OfficialIndex {
    pub pkgs: Vec<OfficialPackage>,
    pub name_to_idx: HashMap<String, usize>,
}

What: Represent the full collection of official packages maintained in memory.

Inputs:

• Populated by fetch and enrichment routines before being persisted or queried.

Output:

• Exposed through API helpers that clone or iterate the package list.

Details:

• Serializable via Serde to allow saving and restoring across sessions.
• The name_to_idx field is derived from pkgs and skipped during serialization.
• Provides O(1) lookup via find_package_by_name() when name_to_idx is populated.

Fields

pkgs: Vec<OfficialPackage>

All known official packages in the index.

name_to_idx: HashMap<String, usize>

Index mapping lowercase package names to their position in pkgs for O(1) lookups. Skipped during serialization; rebuilt after deserialization via rebuild_name_index().

Implementations

impl OfficialIndex

pub fn rebuild_name_index(&mut self)

What: Rebuild the name_to_idx HashMap from the current pkgs Vec.

Inputs:

• None (operates on self.pkgs)

Output:

• Populates self.name_to_idx with lowercase package names mapped to indices.

Details:

• Should be called after deserialization or when pkgs is modified.
• Uses lowercase names for case-insensitive lookups.
• Clears existing index before rebuilding to ensure consistency.

pub fn find_package_by_name(&self, name: &str) -> Option<&OfficialPackage>

What: Find a package by name in the official index using O(1) lookup.

Inputs:

• name: Package name to search for (case-insensitive)

Output:

• Some(&OfficialPackage) if the package is found, None otherwise.

Details:

• Uses the name_to_idx HashMap for O(1) lookup by lowercase name.
• Falls back to linear scan if HashMap is empty (e.g., before rebuild).
• Case-insensitive matching is performed.

Trait Implementations

impl Clone for OfficialIndex

fn clone(&self) -> OfficialIndex

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OfficialIndex

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

Formats the value using the given formatter.

impl Default for OfficialIndex

fn default() -> OfficialIndex

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for OfficialIndex

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for OfficialIndex

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

where __S: Serializer,

Serialize this value into the given Serde serializer.