Skip to main content

pypaginate.errors

Exception hierarchy — mirrors the TS package's errors.ts.

Every error carries a structured details mapping for programmatic handling.

PaginateError Objects

class PaginateError(Exception)

Base error for all paginate failures (aliased as PaginationError).

PaginationError

Cross-language alias — pypaginate historically named the base PaginationError.

ConfigurationError Objects

class ConfigurationError(PaginateError)

Invalid pagination configuration.

FilterError Objects

class FilterError(PaginateError)

A filtering operation failed (optionally naming the field).

FilterValidationError Objects

class FilterValidationError(FilterError)

A filter specification failed validation.

SearchError Objects

class SearchError(PaginateError)

A search operation failed.

SearchQueryError Objects

class SearchQueryError(SearchError)

Search query processing failed.

SortError Objects

class SortError(PaginateError)

A sort operation failed.

ValidationError Objects

class ValidationError(PaginateError)

Generic input validation failure (bad page/limit, malformed cursor, ...).

InvalidCursorError Objects

class InvalidCursorError(ValidationError)

A keyset cursor was malformed, truncated, or tampered with.

A subclass of :class:ValidationError, so it is caught by except ValidationError / except PaginateError (mirrors the TS package).