Struct ModelName 

pub struct ModelName(/* private fields */);

A validated embedding-model name, and therefore a safe SQL identifier.

Per-model tables (D-005) mean the model name reaches SQL as part of a table name — embeddings_nomic_v1 — and SQLite cannot bind an identifier as a parameter, so the name is necessarily spliced into the statement text. That splice is only safe if the name cannot contain anything but identifier characters, which is what this type establishes once, at the boundary, instead of at each of the several call sites that build a statement.

Before this existed, search_vector built its table name with format!("embeddings_{model}") from an unvalidated &str argument.

The rule is deliberately narrower than SQLite’s: lowercase ASCII, digits and underscore, first character a letter, 48 characters at most. Rejecting nomic-v1 rather than quietly rewriting it to nomic_v1 is the same principle §4.1 applies to timestamps — a silent repair here becomes two models sharing one table later, which is precisely the outcome per-model tables exist to prevent.

Implementations

impl ModelName

pub fn new(raw: impl AsRef<str>) -> Result<Self>

Validate raw as a model name, or explain why it is not one.

pub fn as_str(&self) -> &str

pub fn table(&self) -> String

The per-model embedding table, embeddings_<model>.

pub fn index(&self) -> String

The DiskANN index over that table’s vector column.

Named, and named predictably, because vector_top_k takes the index by name as a string argument rather than resolving one from the query plan.

Trait Implementations

impl Clone for ModelName

fn clone(&self) -> ModelName

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ModelName

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

Formats the value using the given formatter.

impl Display for ModelName

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

Formats the value using the given formatter.

impl Eq for ModelName

impl Hash for ModelName

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 Ord for ModelName

fn cmp(&self, other: &ModelName) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for ModelName

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for ModelName

fn partial_cmp(&self, other: &ModelName) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for ModelName