Struct CrateNames 

pub struct CrateNames(/* private fields */);

Reader for the names artifact (names-v1.tsv.zst): every crate name with its default version and download rank.

Implementations

impl CrateNames

pub fn from_zstd(bytes: &[u8]) -> Result<Self, Error>

Parse a zstd-compressed names artifact.

pub fn from_tsv(text: String) -> Result<Self, Error>

Parse an already-decompressed names artifact.

pub fn len(&self) -> usize

Number of crates in the artifact.

pub fn is_empty(&self) -> bool

Whether the artifact contains no crates.

pub fn get(&self, name: &str) -> Option<Entry<'_>>

Name lookup, folded: case-insensitive, and - and _ are the same character. get("Tokio_Util") finds tokio-util, because crates.io would not have let a second crate claim that name.

pub fn entry_at(&self, index: usize) -> Option<Entry<'_>>

The entry at line index (0-based, in the artifact’s folded-name sort order), or None if out of range. Paired with len this is the stable handle a caller needs to build a side index that refers back into the artifact by position rather than copying names.

pub fn prefix_indices(&self, prefix: &str) -> Range<usize>

The half-open range of line indices whose folded name starts with prefix (folded as in get) — the same range count measures, exposed as positions so a caller can pair whole-name-prefix hits with entry_at.

pub fn count(&self, prefix: &str) -> usize

How many crate names start with prefix, folded as in get. Two binary searches — no enumeration — so this is as cheap for "s" as for "trillium-".

pub fn prefix(&self, prefix: &str) -> impl Iterator<Item = Entry<'_>>

All crates whose name starts with prefix, folded as in get, in artifact order.

pub fn typeahead(&self, prefix: &str, limit: usize) -> Vec<Entry<'_>>

The limit highest-ranked crates whose name starts with prefix (folded as in get), ties broken by name.

Trait Implementations

impl Debug for CrateNames

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

Formats the value using the given formatter.