Enum DatasetError 

pub enum DatasetError {
    DownloadError(Error),
    ValidationError(String),
    UnzipError(ZipError),
    IoError(Error),
    DataFormatError(DataFormatErrorKind),
}

Error type used by dataset loading utilities.

Variants

• DownloadError - The download step failed (network, invalid URL, or downloader configuration).
• ValidationError - Downloaded file content failed integrity validation (SHA256 mismatch).
• UnzipError - Extracting a zip archive failed.
• IoError - A standard I/O operation failed (reading directories, opening/removing files, etc.).
• DataFormatError - The dataset content was not in the expected format.

Variants

DownloadError(Error)

ValidationError(String)

UnzipError(ZipError)

IoError(Error)

DataFormatError(DataFormatErrorKind)

Implementations

impl DatasetError

pub fn sha256_validation_failed(dataset_name: &str, file_name: &str) -> Self

Creates a standard SHA256 validation failure error message for a file.

Parameters

• dataset_name - The dataset identifier used in the error prefix.
• file_name - The dataset file name that failed checksum validation.

Returns

• DatasetError::ValidationError - A variant of DatasetError that contains the unified SHA256 failure message.

pub fn csv_read_error(dataset_name: &str, error: impl Display) -> Self

Creates a CSV read error.

Parameters

• dataset_name - The dataset identifier.
• error - The underlying CSV error.

Returns

• DatasetError::DataFormatError(DataFormatErrorKind::CsvReadError) - A variant of DatasetError describing the CSV read error.

pub fn invalid_column_count( dataset_name: &str, expected: usize, actual: usize, line_num: usize, line: &str, ) -> Self

Creates a unified invalid-column-count data format error.

Parameters

• dataset_name - The dataset identifier used in the error prefix.
• expected - The expected number of columns.
• actual - The actual number of columns found.
• line_num - The line number (1-based) where the error occurred.
• line - The original input line that failed validation.

Returns

• DatasetError::DataFormatError(DataFormatErrorKind::InvalidColumnCount) - A variant of DatasetError describing the column count mismatch.

pub fn parse_failed( dataset_name: &str, field_name: &str, line_num: usize, line: &str, err: impl Display, ) -> Self

Creates a unified parse failure data format error.

Parameters

• dataset_name - The dataset identifier.
• field_name - The logical field name that failed to parse.
• line_num - The line number (1-based) where the error occurred.
• line - The original input line where parsing failed.
• err - The underlying parser error detail.

Returns

• DatasetError::DataFormatError(DataFormatErrorKind::ParseFailed) - A variant of DatasetError describing the parse failure.

pub fn invalid_value( dataset_name: &str, field_name: &str, value: &str, line_num: usize, line: &str, ) -> Self

Creates a unified invalid-field-value data format error.

Parameters

• dataset_name - The dataset identifier.
• field_name - The logical field name with an invalid value.
• value - The invalid raw value.
• line_num - The line number (1-based) where the error occurred.
• line - The original input line where the invalid value was found.

Returns

• DatasetError::DataFormatError(DataFormatErrorKind::InvalidValue) - A variant of DatasetError describing the invalid value.

pub fn length_mismatch( dataset_name: &str, field_name: &str, expected: usize, actual: usize, ) -> Self

Creates a unified vector/row length mismatch data format error.

Parameters

• dataset_name - The dataset identifier.
• field_name - The logical field name whose length is being validated.
• expected - The expected length.
• actual - The actual length.

Returns

• DatasetError::DataFormatError(DataFormatErrorKind::LengthMismatch) - A variant of DatasetError describing the length mismatch.

pub fn array_shape_error( dataset_name: &str, array_name: &str, err: impl Display, ) -> Self

Creates a unified ndarray shape construction data format error.

Parameters

• dataset_name - The dataset identifier.
• array_name - The logical array name that failed to build.
• err - The underlying ndarray shape construction error detail.

Returns

• DatasetError::DataFormatError(DataFormatErrorKind::ArrayShapeError) - A variant of DatasetError describing the array shape failure.

pub fn empty_dataset(dataset_name: &str) -> Self

Creates an empty dataset error.

Parameters

• dataset_name - The dataset identifier.

Returns

• DatasetError::DataFormatError(DataFormatErrorKind::EmptyDataset) - A variant of DatasetError indicating the dataset is empty.

Trait Implementations

impl Debug for DatasetError

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

Formats the value using the given formatter.

impl Display for DatasetError

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

Formats the value using the given formatter.

impl Error for DatasetError

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<DataFormatErrorKind> for DatasetError

fn from(source: DataFormatErrorKind) -> Self

Converts to this type from the input type.

impl From<Error> for DatasetError

fn from(source: UreqError) -> Self

Converts to this type from the input type.

impl From<Error> for DatasetError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<ZipError> for DatasetError

fn from(source: ZipError) -> Self

Converts to this type from the input type.