Skip to content

errors.md

Latest commit

 

History

History
26 lines (18 loc) · 862 Bytes

errors.md

File metadata and controls

26 lines (18 loc) · 862 Bytes
Raw

Error Taxonomy

ToolGlot exposes structured exceptions in toolglot.errors for stable, actionable failure handling.

Exception Hierarchy

  • ToolGlotError (base)
    • UserInputError (TG_INPUT_INVALID, exit code 2)
    • UnsupportedFormatError (TG_FORMAT_UNSUPPORTED, exit code 4)
    • ImporterError (TG_IMPORT_FAILED, exit code 5)
    • ExporterError (TG_EXPORT_FAILED, exit code 5)
    • ProviderPayloadError (TG_PROVIDER_PAYLOAD, exit code 2)

Error Fields

All ToolGlot exceptions include:

  • code (stable machine-readable identifier)
  • message (human-readable summary)
  • category (logical failure group)
  • exit_code (CLI-compatible process code)
  • details (structured metadata dict)

CLI Behavior

CLI commands convert taxonomy errors into deterministic non-zero exits and print structured details for debugging.