Struct WeightBinding 

pub struct WeightBinding { /* private fields */ }

One named checkpoint selection within an atomic resident unit.

Implementations

impl WeightBinding

pub fn new( name: impl Into<String>, checkpoint_key: impl Into<String>, selection: TensorSelection, expected_bytes: u64, ) -> Result<Self, ResidencyDeclarationError>

Creates a direct binding with a stable local name and selected size.

pub fn from_recipe( name: impl Into<String>, recipe: DerivedWeightRecipe, expected_bytes: u64, ) -> Result<Self, ResidencyDeclarationError>

Creates a binding backed by a composable derived-weight recipe.

pub fn alias( name: impl Into<String>, owner: impl Into<String>, expected_bytes: u64, ) -> Result<Self, ResidencyDeclarationError>

Creates one logical destination that shares an already materialized owner binding in the same atomic unit.

pub fn name(&self) -> &str

Returns the stable name used to look up a resident value.

pub fn alias_of(&self) -> Option<&str>

Returns the logical owner when this binding is an alias.

pub const fn is_alias(&self) -> bool

Returns whether this binding reuses another logical binding’s native materialization.

pub fn with_name( self, name: impl Into<String>, ) -> Result<Self, ResidencyDeclarationError>

Replaces the stable name used to address this value inside its resident unit.

pub fn logical_target(&self) -> Option<&str>

Returns the architecture-logical parameter destination.

pub fn with_logical_target( self, target: impl Into<String>, ) -> Result<Self, ResidencyDeclarationError>

Attaches the architecture-logical parameter destination.

pub fn with_quantization_companions( self, scales_binding: impl Into<String>, biases_binding: Option<String>, ) -> Result<Self, ResidencyDeclarationError>

Declares exact local companion names produced by load-time quantization.

pub const fn quantization_companions( &self, ) -> Option<&QuantizationCompanionBindings>

Returns exact local scale and affine-bias bindings for load-time quantization.

pub fn checkpoint_key(&self) -> &str

Returns the first physical checkpoint source.

pub fn selection(&self) -> &TensorSelection

Returns the direct checkpoint selection.

pub const fn recipe(&self) -> Option<&DerivedWeightRecipe>

Returns the derived recipe when this is not a direct binding.

pub fn source_recipe(&self) -> DerivedWeightRecipe

Returns the complete source recipe represented by this binding.

pub fn checkpoint_keys(&self) -> Vec<&str>

Returns every checkpoint key consumed by this binding.

pub const fn expected_bytes(&self) -> u64

Returns the exact logical materialized byte length.

pub fn with_source_recipe( self, recipe: DerivedWeightRecipe, expected_bytes: u64, ) -> Result<Self, ResidencyDeclarationError>

Replaces the physical source with an equivalent validated recipe.

pub fn select_bounded_output<C: RecipeCatalog + ?Sized>( self, catalog: &C, selection: TensorSelection, ) -> Result<Self, WeightBindingSelectionError>

Rewrites one logical output selection into bounded physical sources.

Trait Implementations

impl Clone for WeightBinding

fn clone(&self) -> WeightBinding

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WeightBinding

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

Formats the value using the given formatter.

impl Eq for WeightBinding

impl PartialEq for WeightBinding

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for WeightBinding