Exceptions

matchbox.common.exceptions

Custom exceptions for Matchbox.

Classes:

• MatchboxClientSettingsException –

  Incorrect configuration provided to client.

• MatchboxUnparsedClientRequest –

  The API could not parse the content of the client request.

• MatchboxUnhandledServerResponse –

  The API sent an unexpected response.

• MatchboxSourceFieldError –

  Specified fields diverge with the warehouse.

• MatchboxSourceCredentialsError –

  Location credentials must be set.

• MatchboxSourceExtractTransformError –

  Invalid ETL logic detected.

• MatchboxSourceTableError –

  Tables not found in your source data warehouse.

• MatchboxServerFileError –

  There was a problem with file upload.

• MatchboxResolutionNotFoundError –

  Resolution not found.

• MatchboxSourceNotFoundError –

  SourceConfig not found on the server.

• MatchboxDataNotFound –

  Data doesn’t exist in the Matchbox source table.

• MatchboxClientFileError –

  There was a problem with file download.

• MatchboxConnectionError –

  Connection to Matchbox’s backend database failed.

• MatchboxDeletionNotConfirmed –

  Deletion must be confirmed: if certain, rerun with certain=True.

• MatchboxResolutionAlreadyExists –

  Resolution already exists.

• MatchboxDatabaseWriteError –

  Could not be written to the backend DB, likely due to a constraint violation.

MatchboxClientSettingsException

Bases: Exception

Incorrect configuration provided to client.

MatchboxUnparsedClientRequest

MatchboxUnparsedClientRequest(message: str | None = None)

Bases: Exception

The API could not parse the content of the client request.

MatchboxUnhandledServerResponse

MatchboxUnhandledServerResponse(message: str | None = None)

Bases: Exception

The API sent an unexpected response.

MatchboxSourceFieldError

Bases: Exception

Specified fields diverge with the warehouse.

MatchboxSourceCredentialsError

Bases: Exception

Location credentials must be set.

MatchboxSourceExtractTransformError

MatchboxSourceExtractTransformError(
    logic: str | None = None,
)

Bases: Exception

Invalid ETL logic detected.

MatchboxSourceTableError

MatchboxSourceTableError(
    message: str | None = None,
    table_name: str | None = None,
)

Bases: Exception

Tables not found in your source data warehouse.

Attributes:

• table_name –

table_name instance-attribute

table_name = table_name

MatchboxServerFileError

MatchboxServerFileError(message: str | None = None)

Bases: Exception

There was a problem with file upload.

MatchboxResolutionNotFoundError

MatchboxResolutionNotFoundError(
    message: str | None = None,
    name: ResolutionName | None = None,
)

Bases: Exception

Resolution not found.

Attributes:

• name –

name instance-attribute

name = name

MatchboxSourceNotFoundError

MatchboxSourceNotFoundError(
    message: str = None, address: str | None = None
)

Bases: Exception

SourceConfig not found on the server.

Attributes:

• address –

address instance-attribute

address = address

MatchboxDataNotFound

MatchboxDataNotFound(
    message: str | None = None,
    table: str | None = None,
    data: Any | None = None,
)

Bases: Exception

Data doesn’t exist in the Matchbox source table.

Attributes:

• table –
• data –

table instance-attribute

table = table

data instance-attribute

data = data

MatchboxClientFileError

MatchboxClientFileError(message: str | None = None)

Bases: Exception

There was a problem with file download.

MatchboxConnectionError

Bases: Exception

Connection to Matchbox’s backend database failed.

MatchboxDeletionNotConfirmed

MatchboxDeletionNotConfirmed(
    message: str | None = None,
    children: list[ResolutionName] | None = None,
)

Bases: Exception

Deletion must be confirmed: if certain, rerun with certain=True.

MatchboxResolutionAlreadyExists

Bases: Exception

Resolution already exists.

MatchboxDatabaseWriteError

Bases: Exception

Could not be written to the backend DB, likely due to a constraint violation.