# Exceptions

Exceptions that may be raised by ESMValCore.

**Exceptions:**

| [`ESMValCoreDeprecationWarning`](#esmvalcore.exceptions.ESMValCoreDeprecationWarning)   | Custom deprecation warning.                                     |
|---------------------------------------------------------------------------------|-----------------------------------------------------------------|
| [`ESMValCoreLoadWarning`](#esmvalcore.exceptions.ESMValCoreLoadWarning)          | Custom load warning.                                            |
| [`ESMValCorePreprocessorWarning`](#esmvalcore.exceptions.ESMValCorePreprocessorWarning)  | Custom preprocessor warning.                                    |
| [`ESMValCoreUserWarning`](#esmvalcore.exceptions.ESMValCoreUserWarning)          | Base class from which other warnings are derived.               |
| [`Error`](#esmvalcore.exceptions.Error)                          | Base class from which other exceptions are derived.             |
| [`InputFilesNotFound`](#esmvalcore.exceptions.InputFilesNotFound)(msg)        | Files that are required to run the recipe have not been found.  |
| [`InvalidConfigParameter`](#esmvalcore.exceptions.InvalidConfigParameter)         | Config parameter is invalid.                                    |
| [`MissingConfigParameter`](#esmvalcore.exceptions.MissingConfigParameter)         | Config parameter is missing.                                    |
| [`RecipeError`](#esmvalcore.exceptions.RecipeError)(msg)               | Recipe contains an error.                                       |
| [`SuppressedError`](#esmvalcore.exceptions.SuppressedError)                | Errors subclassed from SuppressedError hide the full traceback. |

### *exception* esmvalcore.exceptions.ESMValCoreDeprecationWarning

Bases: [`ESMValCoreUserWarning`](#esmvalcore.exceptions.ESMValCoreUserWarning)

Custom deprecation warning.

### *exception* esmvalcore.exceptions.ESMValCoreLoadWarning

Bases: [`ESMValCorePreprocessorWarning`](#esmvalcore.exceptions.ESMValCorePreprocessorWarning)

Custom load warning.

### *exception* esmvalcore.exceptions.ESMValCorePreprocessorWarning

Bases: [`ESMValCoreUserWarning`](#esmvalcore.exceptions.ESMValCoreUserWarning)

Custom preprocessor warning.

### *exception* esmvalcore.exceptions.ESMValCoreUserWarning

Bases: [`UserWarning`](https://docs.python.org/3/builtins/exceptions.html#UserWarning)

Base class from which other warnings are derived.

### *exception* esmvalcore.exceptions.Error

Bases: [`Exception`](https://docs.python.org/3/builtins/exceptions.html#Exception)

Base class from which other exceptions are derived.

### *exception* esmvalcore.exceptions.InputFilesNotFound(msg: [str](https://docs.python.org/3/builtins/stdtypes.html#str))

Bases: [`RecipeError`](#esmvalcore.exceptions.RecipeError)

Files that are required to run the recipe have not been found.

* **Parameters:**
  **msg** ([*str*](https://docs.python.org/3/builtins/stdtypes.html#str))
* **Return type:**
  None

### *exception* esmvalcore.exceptions.InvalidConfigParameter

Bases: [`Error`](#esmvalcore.exceptions.Error), [`SuppressedError`](#esmvalcore.exceptions.SuppressedError)

Config parameter is invalid.

### *exception* esmvalcore.exceptions.MissingConfigParameter

Bases: [`ESMValCoreUserWarning`](#esmvalcore.exceptions.ESMValCoreUserWarning)

Config parameter is missing.

### *exception* esmvalcore.exceptions.RecipeError(msg: [str](https://docs.python.org/3/builtins/stdtypes.html#str))

Bases: [`Error`](#esmvalcore.exceptions.Error), [`SuppressedError`](#esmvalcore.exceptions.SuppressedError)

Recipe contains an error.

* **Parameters:**
  **msg** ([*str*](https://docs.python.org/3/builtins/stdtypes.html#str))
* **Return type:**
  None

### *exception* esmvalcore.exceptions.SuppressedError

Bases: [`Exception`](https://docs.python.org/3/builtins/exceptions.html#Exception)

Errors subclassed from SuppressedError hide the full traceback.

This can be used for simple user-facing errors that do not need the
full traceback.