Custom Errors

Custom error exceptions implemented by pwfdf-api.

Web Connection

exception pwfdf_api.errors.ScienceBaseConnectTimeout

Bases: requests.ConnectTimeout

When the connection to ScienceBase times out.

ScienceBase

exception pwfdf_api.errors.ScienceBaseError

Bases: Exception

Errors originating from the ScienceBase API.

exception pwfdf_api.errors.InvalidItemError

Bases: ScienceBaseError, requests.HTTPError

When a ScienceBase item does not exist.

exception pwfdf_api.errors.ScienceBaseReadTimeout

Bases: ScienceBaseError, requests.ReadTimeout

When ScienceBase fails to return data in the allocated time.

exception pwfdf_api.errors.ScienceBaseHTTPError

Bases: ScienceBaseError, requests.HTTPError

When ScienceBase returns an HTTP error status code.

exception pwfdf_api.errors.ScienceBaseJSONError

Bases: ScienceBaseError, json.JSONDecodeError

When ScienceBase fails to return valid JSON.

exception pwfdf_api.errors.ScienceBaseQueryError

Bases: ScienceBaseError

When ScienceBase reports an error in a JSON response.

Resource Limits

exception pwfdf_api.errors.LimitError

Bases: Exception

When a routine would exceed a resource limit.

exception pwfdf_api.errors.TooManyQueriesError

Bases: LimitError

When there are too many product records in the search results.

exception pwfdf_api.errors.TooManyProductsError

Bases: LimitError

When a routine would require too many API queries.

exception pwfdf_api.errors.TooManyFiresError

Bases: LimitError

When a routine would return results for too many fire events.

exception pwfdf_api.errors.TooManyAssessmentsError

Bases: LimitError

When a routine would return results for too many hazard assessments.

Metadata

exception pwfdf_api.errors.MetadataWarning

Bases: UserWarning

When an assessment is skipped because of a problem extracting metadata.json info.

exception pwfdf_api.errors.MetadataError

Bases: Exception

When a problem occurs with extracting metadata.json info.

Downloads

exception pwfdf_api.errors.DownloadWarning

Bases: UserWarning

When an assessment is skipped because of a problem downloading files.

exception pwfdf_api.errors.DownloadError

Bases: Exception

When a problem occurs with a download.

exception pwfdf_api.errors.DownloadTooLargeError

Bases: DownloadError, LimitError

When the size of downloaded files would exceed the allowed limit.

Geometries

exception pwfdf_api.errors.GeometryError

Bases: Exception

When a geometry is not valid.

exception pwfdf_api.errors.InvalidGeometryFile

Bases: GeometryError

When a geometry file is not valid.

exception pwfdf_api.errors.GeometryTooLongError

Bases: GeometryError

When a geometry contains too many coordinate points.