# Exceptions and warnings

Catch `CleverlyError` subclasses when an application can recover from invalid data, configuration,
or lifecycle use. Treat warnings as requests to inspect convergence, overlap, or weighting.

```{eval-rst}
.. autosummary::
   :nosignatures:

   cleverly.CleverlyError
   cleverly.CapabilityError
   cleverly.DataError
   cleverly.MethodConfigurationError
   cleverly.NotFittedError
   cleverly.ConvergenceWarning
   cleverly.MonteCarloWarning
   cleverly.ParameterSpaceWarning
   cleverly.PositivityWarning
   cleverly.SparseInfluenceWarning
   cleverly.VersionMismatchWarning
   cleverly.WeightingWarning
   cleverly.exceptions.RefusalReason
   cleverly.exceptions.Refusal
```

Each `CleverlyError` carries its refusal in `error.refusal`. A `Refusal` holds a `RefusalReason` code,
the failed condition, an alternative, and a roadmap id.

## Package version

The installed version is available as `cleverly.__version__`.