Source code for gamesheet_sdk.common.exceptions

# Copyright (c) 2026 bdperkin
# SPDX-License-Identifier: MIT

"""Exceptions raised by gamesheet_sdk.

The hierarchy is intentionally small: a single base class so callers can ``except GameSheetError`` to catch
anything this SDK raises. More specific subclasses will be added as concrete failure modes appear.
"""

from __future__ import annotations



[docs]
class GameSheetError(Exception):
    """Base class for every exception raised by ``gamesheet_sdk``."""




[docs]
class AuthenticationError(GameSheetError):
    """Raised when authentication against the GameSheet WebUI fails.

    Covers both missing/incomplete credentials and active server-side rejection (the submit form does not
    redirect off the sign-in page within the allotted timeout).
    """