Source code for codegen.errors

"""User-facing error hierarchy for the codegen CLI.

Exceptions that inherit from :class:`CLIError` are caught at the
CLI entry point (:func:`codegen.cli.cli_main`) and rendered as
``{prefix}: {message}`` with exit code 1.  Anything else
propagates with a traceback, because it signals a bug rather than
bad user input.
"""




[docs]
class CLIError(Exception):
    """Base class for errors the CLI should render cleanly.

    Subclasses set :attr:`~codegen.errors.CLIError.prefix` to
    control how the error is labelled when rendered at the CLI
    boundary.
    """

    prefix: str = "Error"






[docs]
class ConfigError(CLIError):
    """Raised when a config file can't be loaded or is invalid."""

    prefix = "Error loading config"






[docs]
class GenerationError(CLIError):
    """Raised when file generation fails due to bad config semantics."""

    prefix = "Error"