Skip to content

Source Errors

Translate source retrieval failures into sanitized multimodal errors.

raise_source_read_error(source, error, *, input_kind, component, status_code=None)

Raise the typed, redacted error for a failed source read.

Parameters:

Name Type Description Default
source str

The source being read; messages use a sanitized label.

required
error Exception

The original low-level read error.

required
input_kind str

Resolver input kind, such as http_url or s3_uri.

required
component str

Source backend that failed, such as HTTP or S3.

required
status_code int | None

HTTP or provider response status, when available.

None

Raises:

Type Description
MediaSourceNotFoundError

The source was not found.

MediaSourceAccessDeniedError

The source denied access.

MediaSourceReadTimeoutError

The read timed out.

MediaSourceReadError

Another source read failure occurred.