Enum DataError 

pub enum DataError {
    SchemaMismatch {
        reason: String,
    },
    ParseError {
        reason: String,
    },
    EncodingFailure {
        reason: String,
    },
    EmptyInput {
        reason: String,
    },
    InvalidValue {
        reason: String,
    },
    ColumnNotFound {
        name: String,
        role: Option<String>,
        available: Vec<String>,
        similar: Vec<String>,
        tsv_hint: bool,
    },
}

Typed error variants for the data-loading module.

Public entry points continue to return Result<_, String>; this enum is materialized at leaf sites and converted at the boundary via From<DataError> for String so error text remains byte-identical to the previous ad-hoc format!(...) output.

Variants

SchemaMismatch

Schema/column shape disagrees with the file: row width mismatch, requested column missing from headers, schema-declared kind violated by a row, or an unseen categorical level encountered under UnseenCategoryPolicy::Error.

Fields

reason: String

ParseError

Failed to open, decode, or read structural bytes of the source (CSV/TSV row read, parquet metadata, file extension detection, parquet arrow-cast for string columns).

Fields

reason: String

EncodingFailure

Internal encoding bookkeeping failed: a categorical map expected by the schema path was missing, or a level expected to be present in the per-column inference state was not found during fix-up.

Fields

reason: String

EmptyInput

The source has no headers, no rows, or contains an empty / missing field at a row that requires a value.

Fields

reason: String

InvalidValue

A cell value cannot be used as a feature: non-finite float, null in a numeric parquet column, or an unsupported parquet data type for the column.

Fields

reason: String

ColumnNotFound

A formula or call site references a column name that is not present in the input data. Structured so the FFI boundary can raise a typed Python exception (gamfit.ColumnNotFoundError) carrying the missing name, available columns, and similarity suggestions as attributes — not as a parsed-back-out substring of the human display text.

Fields

name: String

The missing column name, exactly as the user wrote it.

role: Option<String>

Optional role label ("response", "entry", "exit", etc.) supplied at the resolution site to disambiguate which slot in the formula referenced the bad name. None for bare term references.

available: Vec<String>

All headers present in the input table at resolution time, sorted.

similar: Vec<String>

Cheap similarity suggestions (case-insensitive substring or shared-prefix length ≥ 3), sorted; empty when no header is close.

tsv_hint: bool

True iff the available set has exactly one entry and that entry contains a literal tab — i.e. the user almost certainly handed gam a TSV file under a .csv filename. Surfaced as a structured boolean rather than re-parsed from prose at the boundary.

Implementations

impl DataError

pub fn column_not_found( col_map: &HashMap<String, usize>, name: &str, role: Option<&str>, ) -> Self

Build a typed ColumnNotFound from the column map of the resolved dataset. Centralises the similarity / TSV-hint heuristics that the legacy missing_column_message helper used to perform inline so all callers — leaf resolve_col* shims and the multi-column requested- columns aggregator — produce identical payloads.

Trait Implementations

impl Clone for DataError

fn clone(&self) -> DataError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DataError

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

Formats the value using the given formatter.

impl Display for DataError

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

Formats the value using the given formatter.

impl Error for DataError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<DataError> for String

fn from(err: DataError) -> String

Converts to this type from the input type.