Enum PackingStrategy 

pub enum PackingStrategy {
    OnePerPackage,
    PopularityBased {
        max_layers: usize,
    },
    CatalogAware {
        max_layers: usize,
    },
}

Strategy for grouping packages into OCI layers.

Layer order: most-stable (lowest in dependency graph) at index 0, most-volatile (entrypoint) at the top. Docker pulls layers in manifest order so stable-first minimises re-downloads across tool upgrades.

Variants

OnePerPackage

Each package gets its own layer (default for small tool sets).

PopularityBased

Popularity-based packing when max_layers is exceeded.

Requires a pre-computed PopularityMap from bv-builder pack. The most popular packages (by co-occurrence across all registry specs) get solo layers; the long tail is bundled into one layer.

Fields

max_layers: usize

CatalogAware

Catalog-aware greedy packing.

Packages that already have an entry in the LayerCatalog (meaning a matching blob is already on the registry from a previous build) are sorted by their catalog count descending and given priority for solo layers. Cache-miss packages fill the remaining solo slots; any overflow goes into a single long-tail layer.

This is the preferred strategy for bv publish --spec because it requires no pre-computation: the catalog grows incrementally and each new publish greedily populates it.

Fields

max_layers: usize

Trait Implementations

impl Clone for PackingStrategy

fn clone(&self) -> PackingStrategy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PackingStrategy

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

Formats the value using the given formatter.

impl Default for PackingStrategy

fn default() -> PackingStrategy

Returns the “default value” for a type.

impl Eq for PackingStrategy

impl PartialEq for PackingStrategy

fn eq(&self, other: &PackingStrategy) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for PackingStrategy