Skip to content

Exceptions

Public exceptions for ineepy.

All exception classes raised by the library are available here. Catch :class:IneepyError for any library error, or a specific subclass for finer control.

IneepyError

Bases: Exception

Base class for all ineepy errors.

HTTPError

Bases: IneepyError

HTTP error with a status code and detail message.

Attributes:

Name Type Description
status_code

The HTTP status code returned by the server.

detail

Human-readable error description from the response body.

UnauthorizedError

Bases: HTTPError

Raised when the token is missing, invalid, or expired (HTTP 401).

ForbiddenError

Bases: HTTPError

Raised when the token lacks the required scope (HTTP 403).

NotFoundError

Bases: HTTPError

Raised when the requested resource does not exist (HTTP 404).

ConflictError

Bases: HTTPError

Raised on a resource conflict (HTTP 409).

Common causes: creating a resource that already exists, or attempting to delete a namespace that still contains tables.

PreconditionFailedError

Bases: HTTPError

Raised when an ETag precondition check fails (HTTP 412).

Indicates a concurrent modification: fetch the resource again to get the current ETag, then retry the update.

ValidationError

Bases: HTTPError

Raised when the server rejects the request body (HTTP 422).

JobFailedError

Bases: IneepyError

Raised when an async data job fails on the server.

Attributes:

Name Type Description
job_id

Identifier of the failed job.

error

Server-side error message, if available.

TimeoutError

Bases: IneepyError, TimeoutError

Raised when polling a job exceeds the configured timeout.

Also a subclass of the built-in :class:TimeoutError, so except TimeoutError: using the builtin catches it too.

Attributes:

Name Type Description
job_id

Identifier of the timed-out job.