Struct KvpPrefixSampler 

pub struct KvpPrefixSampler { /* private fields */ }

Samples key-value “meta” prefixes with optional dropout.

Implementations

impl KvpPrefixSampler

pub fn new(dropout: f32) -> Self

Create a new sampler that emits prefixes with the provided probability.

pub fn add_variant<K, V, I>(&mut self, fields: I)

where I: IntoIterator<Item = (K, V)>, K: Into<String>, V: Into<String>,

Register another variant using simple key-value pairs (single rendering per key).

pub fn add_variant_fields<I>(&mut self, fields: I)

where I: IntoIterator<Item = KvpField>,

Register another variant that may contain multi-valued fields.

pub fn sample<R: Rng + ?Sized>(&self, rng: &mut R) -> Option<String>

Sample a formatted prefix using the configured dropout rate and variants.

pub fn all_metadata(&self) -> HashMap<String, Vec<String>>

Returns all metadata keys and all their possible values across every variant.

This method does not involve any RNG, presence rolls, or dropout — it simply collects every key and every value defined on the sampler. Use the result to populate RecordChunk::kvp_meta for downstream inspection/debugging.

Trait Implementations

impl Clone for KvpPrefixSampler

fn clone(&self) -> KvpPrefixSampler

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for KvpPrefixSampler

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for KvpPrefixSampler

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for KvpPrefixSampler

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

where __S: Serializer,

Serialize this value into the given Serde serializer.