Struct SamplerOrder 

pub struct SamplerOrder { /* private fields */ }

A validated sampler chain: the steps ferrox will run, in the order it will run them.

Fixed-capacity and Copy because crate::sampling::SamplingParams is cloned per request and read per token; a Vec here would be an allocation on that path for at most SamplerName::ALL.len() entries.

Implementations

impl SamplerOrder

pub fn steps(&self) -> &[ChainStep]

The steps, in order.

pub fn has_penalties(&self) -> bool

Whether the penalties are part of this chain. false means the caller left penalties out, which llama.cpp reads as “do not penalise”, so ferrox must not penalise either.

pub fn implemented_names() -> Vec<&'static str>

The canonical spellings of every sampler this engine implements, derived from the one table rather than restated.

pub fn from_names<I, S>(names: I) -> Result<Self, SamplerOrderError>

where I: IntoIterator<Item = S>, S: AsRef<str>,

Parse a chain from already-split names.

Each name is trimmed and lowercased first: a spelling is not a semantic, so Top_K cannot mean anything but top_k and refusing it would be a false refusal.

Four things are refused, all BY NAME:

• a name llama.cpp does not define either;
• a real llama.cpp sampler ferrox does not implement;
• the same sampler twice, which llama.cpp tolerates and which here would silently mean “run it once” for the idempotent filters and “square it” for temperature;
• penalties anywhere but first – see SamplerOrderError::PenaltiesNotFirst;
• a chain with no temperature – see SamplerOrderError::TemperatureMissing.

Trait Implementations

impl Clone for SamplerOrder

fn clone(&self) -> SamplerOrder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for SamplerOrder

impl Debug for SamplerOrder

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

Formats the value using the given formatter.

impl Default for SamplerOrder

fn default() -> Self

Returns the “default value” for a type.

impl Display for SamplerOrder

Round-trips through FromStr, so the CLI can print the default it applied and have that string mean the same chain.

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

Formats the value using the given formatter.

impl Eq for SamplerOrder

impl FromStr for SamplerOrder

;-separated, exactly as llama.cpp’s --samplers takes it.

type Err = SamplerOrderError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for SamplerOrder

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for SamplerOrder

Equality and hashing are over the LIVE steps only. The backing array is fixed-capacity, so the slots past len hold filler that two equal chains need not agree about – and the response cache keys on this, where a spurious inequality would just miss and a spurious equality would serve one caller’s answer to another.

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

Equality operator ==.

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

Inequality operator !=.