Skip to main content
Version: main

Errors and warnings

TypeSubclass ofMeaning
SdvplotWarningUserWarningSomething was skipped or degraded (an unresolved team, a stale cache), but the call still returned.
SdvplotDeprecationWarningSdvplotWarning, FutureWarningA deprecated sdvplot name or argument: it still works, and the message names its replacement and the release that removes it. A FutureWarning, so it shows by default.
SdvplotErrorExceptionThe base of sdvplot's errors: an unresolved team, a failed or refused download, a missing extra, an unsupported target, and the shared argument checks (InputError). A check specific to one helper (an axis name, a column, a chart setting) raises a plain ValueError or TypeError.
InputErrorSdvplotError, ValueErrorAn argument sdvplot cannot use: an unknown league, id system, color slot, mark type or variant, a color slot such as "secondary" passed as a team, a season that is not a year or is outside the ones sdvplot knows, or a height, alpha, image size or candidate count out of range.
UnresolvedTeamErrorSdvplotError, ValueErrorA team value did not resolve and strict=True was set.
OfflineErrorSdvplotError, RuntimeErrorA download failed and no cached copy exists.
DownloadErrorOfflineError, OSErrorA download got an HTTP error status (a 4xx or 5xx response) and no cached copy exists. Also an OSError, so except OSError catches it.
IntegrityErrorDownloadErrorA download is not the file the manifest promises: its sha256 differs (it is not cached), or the archived file is not an image PIL can decode.
OptionalDependencyErrorSdvplotError, ModuleNotFoundErrorA feature needs an optional extra that is not installed: an adapter submodule imported without its library (import sdvplot.plotly without plotly), an SVG mark without the svg extra. The message names the extra to install.
UnsupportedTargetErrorSdvplotError, TypeErrorsdvplot cannot draw on this object: no adapter takes its kind of plot or table, or the adapter does not support the verb (axis logos on a map, a table, Bokeh, HoloViews or pygal).
UnsafeDownloadErrorSdvplotError, OSErrorA download was refused: too large, too slow, or redirected away from https.
UnsafeCachePathErrorSdvplotError, ValueErrorA manifest value (sha256, ext) or cache path would reach outside the sdvplot cache directory.