Enum TermBuilderError 

pub enum TermBuilderError {
    MissingColumn {
        reason: String,
    },
    ColumnNotFound {
        name: String,
        role: Option<String>,
        available: Vec<String>,
        similar: Vec<String>,
        tsv_hint: bool,
    },
    IncompatibleConfig {
        reason: String,
    },
    InvalidOption {
        reason: String,
    },
    UnsupportedFeature {
        reason: String,
    },
    DegenerateData {
        reason: String,
    },
    MalformedFormula {
        reason: String,
    },
}

Typed errors emitted by term-builder helpers. Display reproduces the exact pre-refactor format!(...) text byte-for-byte, so callers that string-match on the message (tests, log assertions) keep working unchanged. Public-API functions still return Result<_, String> and use .to_string() shims at their boundary to stay compatible with callers in protected modules.

Variants

MissingColumn

Column-resolution / column-kind lookup failures whose context is purely internal (column-kind table out-of-sync, alias map missing an entry, etc.). User-facing “this formula references a column that doesn’t exist” diagnostics use the dedicated ColumnNotFound variant so the FFI boundary can lift the structured payload into a Python ColumnNotFoundError without parsing prose.

Fields

reason: String

ColumnNotFound

A formula referenced a column that is not present in the input data. Mirrors DataError::ColumnNotFound field-for-field so the conversion across module boundaries is a pure data move (no re-derivation, no string re-parsing). Public callers see byte-identical Display output to the legacy missing_column_message text.

Fields

name: String

role: Option<String>

available: Vec<String>

similar: Vec<String>

tsv_hint: bool

IncompatibleConfig

User-specified configuration is internally inconsistent (e.g. too few variables for a smooth type, conflicting size options, requested basis dimension below the polynomial nullspace).

Fields

reason: String

InvalidOption

Option parsing failure: malformed numeric expression, unknown option key, out-of-range integer, list-length mismatch, etc.

Fields

reason: String

UnsupportedFeature

User requested a feature that is intentionally not supported (unknown smooth type / method / kernel / identifiability, non-zero anchor, internal-only token, etc.).

Fields

reason: String

DegenerateData

Input data is degenerate for the requested term (constant column, non-finite categorical entries, …).

Fields

reason: String

MalformedFormula

Term-collection-stage formula error — a node that the caller was supposed to resolve upstream reached the builder.

Fields

reason: String

Trait Implementations

impl Clone for TermBuilderError

fn clone(&self) -> TermBuilderError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TermBuilderError

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

Formats the value using the given formatter.

impl Display for TermBuilderError

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

Formats the value using the given formatter.

impl From<DataError> for TermBuilderError

Typed lift from data-layer errors. DataError::ColumnNotFound becomes TermBuilderError::ColumnNotFound field-for-field — no stringification, no information loss — so the FFI boundary downstream can dispatch on the typed variant. Other DataError variants degrade into MissingColumn since they describe column-resolution-time failures without a dedicated structured destination.

fn from(err: DataError) -> Self

Converts to this type from the input type.

impl From<String> for TermBuilderError

Catchall lift for the term-builder’s internal Result<_, String> helpers (numeric expression parsing, option lookup, boundary-condition parsing, …) that flow into build_termspec via ?. Maps to IncompatibleConfig, which is the most appropriate generic bucket for option/config-style failures — leaf sites that emit structured payloads (From<DataError> for column-not-found) bypass this fallback.

fn from(reason: String) -> Self

Converts to this type from the input type.

impl From<TermBuilderError> for String

fn from(err: TermBuilderError) -> String

Converts to this type from the input type.