Skip to main content

bauplan.exceptions

classApiErrorKindNon-instantiable

A typed API error kind, deserialized from the type and context fields of an error response.

classApiMethodErrorNon-instantiable

Raised on an HTTP 404 response from the API.

classApiRouteErrorNon-instantiable

Raised on an HTTP 405 response from the API.

classBadGatewayErrorNon-instantiable

Raised on an HTTP 502 response from the API.

classBadRequestErrorNon-instantiable

Raised on an HTTP 400 response from the API.

classBauplanError

Base class for all bauplan SDK exceptions.

bauplan.exceptions.BauplanError(
    _args = (),
)

Parameters

Bases:

Exception

classBauplanHTTPError

An HTTP error from the API.

bauplan.exceptions.BauplanHTTPError(
    code: int,
    type: str,
    message: str,
    kind: ApiErrorKind | None = None,
)

Attributes

code:

int

kind:

ApiErrorKind | None

message:

str

type:

str

classBauplanJobErrorNon-instantiable

Base class for errors raised by bauplan job execution.

classBauplanQueryErrorNon-instantiable

Raised when a query job fails.

classBranchExistsErrorNon-instantiable

Raised when creating a bauplan.schema.Branch that already exists.

classBranchHeadChangedErrorNon-instantiable

Raised when the bauplan.schema.Branch head hash has changed since it was last read.

classBranchNotFoundErrorNon-instantiable

Raised when the referenced bauplan.schema.Branch does not exist.

classConflictErrorNon-instantiable

Raised on an HTTP 409 response from the API.

classCreateBranchForbiddenErrorNon-instantiable

Raised when the caller is not permitted to create a bauplan.schema.Branch.

classCreateNamespaceForbiddenErrorNon-instantiable

Raised when the caller is not permitted to create a bauplan.schema.Namespace.

classCreateTagForbiddenErrorNon-instantiable

Raised when the caller is not permitted to create a bauplan.schema.Tag.

classDeleteBranchForbiddenErrorNon-instantiable

Raised when the caller is not permitted to delete a bauplan.schema.Branch.

classDeleteNamespaceForbiddenErrorNon-instantiable

Raised when the caller is not permitted to delete a bauplan.schema.Namespace.

classDeleteTableForbiddenErrorNon-instantiable

Raised when the caller is not permitted to delete tables.

classDeleteTagForbiddenErrorNon-instantiable

Raised when the caller is not permitted to delete a bauplan.schema.Tag.

classForbiddenErrorNon-instantiable

Raised on an HTTP 403 response: the caller is not permitted to perform the action.

classGatewayTimeoutErrorNon-instantiable

Raised on an HTTP 504 response from the API.

classInternalErrorNon-instantiable

Raised on an HTTP 500 response from the API.

classInvalidDataErrorNon-instantiable

Raised on an HTTP 400 response from the API.

classInvalidPlanErrorNon-instantiable

Raised when a pipeline or table-create plan is invalid.

classInvalidRefErrorNon-instantiable

Raised when the provided string is not a valid bauplan.schema.Ref.

classMergeConflictErrorNon-instantiable

Raised when a merge cannot be completed due to conflicting changes.

classMergeForbiddenErrorNon-instantiable

Raised when the caller is not permitted to merge a bauplan.schema.Branch.

classMethodNotAllowedErrorNon-instantiable

Raised on an HTTP 405 response from the API.

classNamespaceExistsErrorNon-instantiable

Raised when creating a bauplan.schema.Namespace that already exists on the target bauplan.schema.Ref.

classNamespaceIsNotEmptyErrorNon-instantiable

Raised when attempting to delete a bauplan.schema.Namespace that still contains tables.

classNamespaceNotFoundErrorNon-instantiable

Raised when the referenced bauplan.schema.Namespace does not exist on the given bauplan.schema.Ref.

classNamespaceUnresolvedErrorNon-instantiable

Raised when a bauplan.schema.Namespace is specified both in the table name (e.g. ns.table) and through an explicit namespace parameter, resulting in an ambiguous reference.

classNoResultsFoundErrorNon-instantiable

Raised when a query returns no results.

classNotABranchRefErrorNon-instantiable

Raised when the provided bauplan.schema.Ref is not of type BRANCH.

classNotATagRefErrorNon-instantiable

Raised when the provided bauplan.schema.Ref is not of type TAG.

classNotAWriteBranchRefErrorNon-instantiable

Raised when a write operation is attempted against a bauplan.schema.Ref that is not of type BRANCH.

classNotFoundErrorNon-instantiable

Raised on an HTTP 404 response from the API.

classRefNotFoundErrorNon-instantiable

Raised when the referenced bauplan.schema.Ref does not exist.

classRenameBranchForbiddenErrorNon-instantiable

Raised when the caller is not permitted to rename a bauplan.schema.Branch.

classRenameTagForbiddenErrorNon-instantiable

Raised when the caller is not permitted to rename a bauplan.schema.Tag.

classResourceNotFoundErrorNon-instantiable

Raised when a requested catalog resource does not exist.

classRevertDestinationTableExistsErrorNon-instantiable

Raised when the destination of a revert operation already exists.

classRevertIdenticalTableErrorNon-instantiable

Raised when the source and destination of a revert point to the same table snapshot.

classRevertTableForbiddenErrorNon-instantiable

Raised when the caller is not permitted to revert tables.

classSameRefErrorNon-instantiable

Raised when the source and destination bauplan.schema.Ref resolve to the same commit hash, making the operation a no-op.

classServiceUnavailableErrorNon-instantiable

Raised on an HTTP 503 response from the API.

classTableCreatePlanApplyStatusError

Raised when a table-create plan apply job finishes in a non-success state.

bauplan.exceptions.TableCreatePlanApplyStatusError(
    message: str,
    state: TableCreatePlanApplyState,
)

Attributes

message:

str

state:

TableCreatePlanApplyState

classTableCreatePlanErrorNon-instantiable

Base class for errors raised during a table-create plan workflow.

Parameters

classTableCreatePlanStatusError

Raised when a table-create plan job finishes in a non-success state.

bauplan.exceptions.TableCreatePlanStatusError(
    message: str,
    state: TableCreatePlanState,
)

Attributes

message:

str

state:

TableCreatePlanState

classTableExistsErrorNon-instantiable

Raised when creating a table that already exists on the target bauplan.schema.Ref.

classTableNotFoundErrorNon-instantiable

Raised when the referenced table does not exist on the given bauplan.schema.Ref.

classTagExistsErrorNon-instantiable

Raised when creating a bauplan.schema.Tag that already exists.

classTagNotFoundErrorNon-instantiable

Raised when the referenced bauplan.schema.Tag does not exist.

classTooManyRequestsErrorNon-instantiable

Raised on an HTTP 429 response from the API.

classUnauthorizedErrorNon-instantiable

Raised on an HTTP 401 response: missing or invalid credentials.

classUpdateConflictErrorNon-instantiable

Raised when an update conflicts with the current catalog state.