Exceptions

This section provides an overview of the exceptions used in the EODAG library. Exceptions are used to handle errors and unexpected situations that may occur during the execution of the library’s functionality. Below, you will find the list of exception classes defined in EODAG and their purposes.

Additionally, if you have the eodag-cube extension installed, you will have access to extra exception classes specific to its functionality.

exception eodag.utils.exceptions.AddressNotFound

An error indicating the address of a subdataset was not found

exception eodag.utils.exceptions.AuthenticationError

An error indicating that an authentication plugin did not succeeded authenticating a user

exception eodag.utils.exceptions.DownloadError

An error indicating something wrong with the download process

exception eodag.utils.exceptions.EodagError

General EODAG error

exception eodag.utils.exceptions.InvalidDataError

Raised when data is invalid, malformed, or corrupt and cannot be processed as expected.

exception eodag.utils.exceptions.MisconfiguredError

An error indicating a Search Plugin that is not well configured

exception eodag.utils.exceptions.NoMatchingProductType

An error indicating that eodag was unable to derive a product type from a set of search parameters

exception eodag.utils.exceptions.NotAvailableError

An error indicating that the product is not available for download

exception eodag.utils.exceptions.PluginImplementationError

Error when a plugin does not behave as expected

exception eodag.utils.exceptions.PluginNotFoundError

Error when looking for a plugin class that was not defined

exception eodag.utils.exceptions.RequestError

An error indicating that a request has failed. Usually eodag functions and methods should catch and skip this

classmethod from_error(error, msg=None)

Generate a RequestError from an Exception

Parameters:

• error (Exception)

• msg (str | None, default: None)

Return type:

Self

exception eodag.utils.exceptions.STACOpenerError

An error indicating that a STAC file could not be opened

exception eodag.utils.exceptions.TimeOutError(exception=None, timeout=None)

An error indicating that a timeout has occurred

Parameters:

• exception (Exception | None, default: None)

• timeout (float | None, default: None)

exception eodag.utils.exceptions.UnsupportedDatasetAddressScheme

An error indicating that eodag does not yet support an address scheme for accessing raster subdatasets

exception eodag.utils.exceptions.UnsupportedProductType(product_type)

An error indicating that eodag does not support a product type

Parameters:

product_type (str)

exception eodag.utils.exceptions.UnsupportedProvider

An error indicating that eodag does not support a provider

exception eodag.utils.exceptions.ValidationError(message, parameters={})

Error validating data

Parameters:

• message (str)

• parameters (set[str], default: set())

classmethod from_error(error, msg=None)

Override parent from_error to handle ValidationError specificities.

Parameters:

• error (Exception)

• msg (str | None, default: None)

Return type:

Self

Warning

The following classes will only be available with eodag-cube installed.

exception eodag_cube.utils.exceptions.DatasetCreationError

An error indicating that xarray.Dataset or eodag_cube.types.XarrayDict could not be created