Struct LayerCatalog 

pub struct LayerCatalog {
    pub version: u32,
    pub entries: HashMap<String, CatalogEntry>,
}

Maps conda package builds to their reproducible OCI layer digest.

Key format: “name==version-build” (e.g. “openssl==3.3.0-h69704a7_0”).

Because bv-builder produces bit-identical compressed layer blobs for the same package triple (SOURCE_DATE_EPOCH + sorted entries + zstd level 19), the digest here is not a cache hint — it is a stable identity. Any future build of the same package will produce the same bytes and therefore the same blob on the registry. Docker/OCI registries deduplicate by content digest, so two images that both contain “openssl==3.3.0” share exactly one copy of that layer on disk and on the wire.

The catalog is stored in the registry repo at layers/catalog.json and grows incrementally as new tools are published via bv publish --spec. It replaces the batch-computed popularity.json for user-side publishing: instead of requiring a full scan of all registry specs, each new tool greedily adds its solo layers to the catalog, and future builds inherit the benefit automatically.

Fields

version: u32

entries: HashMap<String, CatalogEntry>

Implementations

impl LayerCatalog

pub fn new() -> Self

pub fn key(name: &str, version: &str, build: &str) -> String

pub fn get( &self, name: &str, version: &str, build: &str, ) -> Option<&CatalogEntry>

pub fn contains(&self, name: &str, version: &str, build: &str) -> bool

pub fn record(&mut self, name: &str, version: &str, build: &str, digest: &str)

Record a solo layer for this package. If the entry already exists the count is incremented and the digest is updated (same package triple always produces the same digest, so the update is a no-op in practice).

pub fn load(path: &Path) -> Result<Self>

pub fn save(&self, path: &Path) -> Result<()>

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

Trait Implementations

impl Clone for LayerCatalog

fn clone(&self) -> LayerCatalog

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LayerCatalog

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

Formats the value using the given formatter.

impl Default for LayerCatalog

fn default() -> LayerCatalog

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for LayerCatalog

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for LayerCatalog

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

where __S: Serializer,

Serialize this value into the given Serde serializer.