Exceptions

All domain errors inherit from FeatherStoreException. Category bases allow catching related errors together (for example, ColumnError for any column-related failure).

Argument validation (invalid types, missing required arguments) still raises built-in exceptions such as TypeError, ValueError, and AttributeError.

Hierarchy

• FeatherStoreException

  • TableError

    • TableNotFoundError

    • TableAlreadyExistsError

    • ForbiddenTableNameError

    • CannotDropAllRowsError

    • CannotDropAllColumnsError

    • PartitionCountMismatchError

  • StoreError

    • StoreNotFoundError

    • StoreAlreadyExistsError

    • ForbiddenStoreNameError

    • StoreNotEmptyError

  • ColumnError

    • ColumnNotFoundError

    • ColumnAlreadyExistsError

    • ColumnMismatchError

    • ColumnDtypeMismatchError

    • DuplicateColumnNamesError

    • ColumnLengthMismatchError

    • MultiTypeColumnError

  • RowError

    • RowNotFoundError

    • RowAlreadyExistsError

    • AppendIndexError

  • IndexSchemaError

    • IndexTypeMismatchError

    • IndexNameMismatchError

    • IndexNameInColumnsError

    • IndexNotInColumnsError

    • DuplicateIndexValuesError

    • UnsupportedIndexTypeError

    • IndexMismatchError

    • MissingIndexError

  • DatabaseConnectionError

    • NotConnectedError

    • NotADatabaseError

    • PopulatedDirectoryError

  • SnapshotError

    • SnapshotNotFoundError

    • InvalidSnapshotError

    • SnapshotTargetNotFoundError

  • PathError

    • UnsafeDeletePathError

Exception reference

FeatherStore exception hierarchy.

See the API reference for the full hierarchy and per-class documentation.

exception featherstore.exceptions.FeatherStoreException

Bases: Exception

Base class for all FeatherStore domain errors.

exception featherstore.exceptions.TableError

Bases: FeatherStoreException

Base class for table-related errors.

exception featherstore.exceptions.TableNotFoundError

Bases: TableError

Raised when a requested table does not exist.

exception featherstore.exceptions.TableAlreadyExistsError

Bases: TableError

Raised when creating or restoring a table that already exists.

exception featherstore.exceptions.ForbiddenTableNameError

Bases: TableError

Raised when a table name is reserved.

exception featherstore.exceptions.CannotDropAllRowsError

Bases: TableError

Raised when a drop operation would remove every row.

exception featherstore.exceptions.CannotDropAllColumnsError

Bases: TableError

Raised when a drop operation would remove every column.

exception featherstore.exceptions.PartitionCountMismatchError

Bases: TableError

Raised when partition count does not match partition names.

exception featherstore.exceptions.StoreError

Bases: FeatherStoreException

Base class for store-related errors.

exception featherstore.exceptions.StoreNotFoundError

Bases: StoreError

Raised when a requested store does not exist.

exception featherstore.exceptions.StoreAlreadyExistsError

Bases: StoreError

Raised when creating or restoring a store that already exists.

exception featherstore.exceptions.ForbiddenStoreNameError

Bases: StoreError

Raised when a store name is reserved.

exception featherstore.exceptions.StoreNotEmptyError

Bases: StoreError

Raised when deleting a store that still contains tables.

exception featherstore.exceptions.ColumnError

Bases: FeatherStoreException

Base class for column-related errors.

exception featherstore.exceptions.ColumnNotFoundError

Bases: ColumnError

Raised when requested columns are not in the table.

exception featherstore.exceptions.ColumnAlreadyExistsError

Bases: ColumnError

Raised when inserting columns whose names already exist.

exception featherstore.exceptions.ColumnMismatchError

Bases: ColumnError

Raised when column names do not match the stored table.

exception featherstore.exceptions.ColumnDtypeMismatchError

Bases: ColumnError

Raised when column dtypes are incompatible.

exception featherstore.exceptions.DuplicateColumnNamesError

Bases: ColumnError

Raised when column names are not unique.

exception featherstore.exceptions.ColumnLengthMismatchError

Bases: ColumnError

Raised when new column length does not match stored row count.

exception featherstore.exceptions.MultiTypeColumnError

Bases: ColumnError

Raised when a column contains multiple dtypes.

exception featherstore.exceptions.RowError

Bases: FeatherStoreException

Base class for row-related errors.

exception featherstore.exceptions.RowNotFoundError

Bases: RowError

Raised when requested rows are not in the table.

exception featherstore.exceptions.RowAlreadyExistsError

Bases: RowError

Raised when inserting rows that already exist.

exception featherstore.exceptions.AppendIndexError

Bases: RowError

Raised when append index is not strictly after stored data.

exception featherstore.exceptions.IndexSchemaError

Bases: FeatherStoreException

Base class for index schema errors.

exception featherstore.exceptions.IndexTypeMismatchError

Bases: IndexSchemaError

Raised when index or row types do not match the stored index.

exception featherstore.exceptions.IndexNameMismatchError

Bases: IndexSchemaError

Raised when index names do not match the stored table.

exception featherstore.exceptions.IndexNameInColumnsError

Bases: IndexSchemaError

Raised when the index name appears among column names.

exception featherstore.exceptions.IndexNotInColumnsError

Bases: IndexSchemaError

Raised when a specified index column is not in the data.

exception featherstore.exceptions.DuplicateIndexValuesError

Bases: IndexSchemaError

Raised when index values are not unique.

exception featherstore.exceptions.UnsupportedIndexTypeError

Bases: IndexSchemaError

Raised when the index type is not supported.

exception featherstore.exceptions.IndexMismatchError

Bases: IndexSchemaError

Raised when indices do not match between old and new data.

exception featherstore.exceptions.MissingIndexError

Bases: IndexSchemaError

Raised when an index is required but not provided.

exception featherstore.exceptions.DatabaseConnectionError

Bases: FeatherStoreException

Base class for database connection errors.

exception featherstore.exceptions.NotConnectedError

Bases: DatabaseConnectionError

Raised when FeatherStore is not connected to a database.

exception featherstore.exceptions.NotADatabaseError

Bases: DatabaseConnectionError

Raised when connecting to a path that is not a database.

exception featherstore.exceptions.PopulatedDirectoryError

Bases: DatabaseConnectionError

Raised when creating a database in a non-empty directory.

exception featherstore.exceptions.SnapshotError

Bases: FeatherStoreException

Base class for snapshot errors.

exception featherstore.exceptions.SnapshotNotFoundError

Bases: SnapshotError

Raised when a snapshot file does not exist.

exception featherstore.exceptions.InvalidSnapshotError

Bases: SnapshotError

Raised when a file is not a valid snapshot of the expected type.

exception featherstore.exceptions.SnapshotTargetNotFoundError

Bases: SnapshotError

Raised when the snapshot source path does not exist.

exception featherstore.exceptions.PathError

Bases: FeatherStoreException

Base class for path safety errors.

exception featherstore.exceptions.UnsafeDeletePathError

Bases: PathError

Raised when attempting to delete files outside the database.