arxjit.errors

arxjit.errors

Source: packages/arxjit/src/arxjit/errors.py

title: Public exception hierarchy for arxjit.
summary: >-
  Define the single error hierarchy arxjit raises to callers: ArxJitError as
  the base, with SourceExtractionError for functions whose source cannot be
  retrieved and parsed, and UnsupportedSyntaxError for functions using Python
  constructs outside the supported subset. Each error carries a list of
  structured Diagnostic records so callers can inspect failures
  programmatically instead of scraping message text.

Classes

ArxJitError(Exception)

title: Base class for every error raised by arxjit.
attributes:
  diagnostics:
    type: list[Diagnostic]
    description: Structured diagnostics describing the failure.

SourceExtractionError(ArxJitError)

title: Raised when a decorated function's source cannot be extracted.
summary: >-
  Covers the whole extraction stage, functions whose source cannot be
  retrieved or cannot be parsed as a standalone function definition, such
  as ones defined in the REPL, built with exec, implemented in C, or
  lambdas. Constructs rejected after successful extraction raise
  UnsupportedSyntaxError instead.
attributes:
  diagnostics:
    type: list[Diagnostic]

UnsupportedSyntaxError(ArxJitError)

title: Raised when a function uses Python outside the supported subset.
summary: >-
  Carries one diagnostic per rejected construct, each pointing at the
  offending source line, so a function with several unsupported constructs
  reports all of them at once.
attributes:
  diagnostics:
    type: list[Diagnostic]