Class FailureReason

explainshell/errors.py:16–47

Classification of why an extraction skipped or failed. Set at the throw site so analysis tools (e.g. report.json consumers) don't have to regex error messages. String-valued so the value lands in JSON as a stable identifier.

class FailureReason(str, enum.Enum):
    """Classification of why an extraction skipped or failed.

    Set at the throw site so analysis tools (e.g. report.json consumers)
    don't have to regex error messages.  String-valued so the value lands
    in JSON as a stable identifier.
    """

    # Skips
    BLACKLISTED = "blacklisted"
    MANPAGE_TOO_LARGE = "manpage_too_large"

    # Pre-LLM failures
    TOO_MANY_CHUNKS = "too_many_chunks"
    MANDOC_FAILED = "mandoc_failed"
    CANCELLED = "cancelled"

    # LLM response failures
    INVALID_RESPONSE = "invalid_response"
    INVALID_JSON = "invalid_json"
    INVALID_SCHEMA = "invalid_schema"

    # Provider failures
    CONTENT_FILTER = "content_filter"
    PROVIDER_ERROR = "provider_error"
    PROVIDER_BATCH_ERROR = "provider_batch_error"

    # Post-processing failures
    LINE_SPAN_COVERAGE = "line_span_coverage"

    # Fallback
    UNEXPECTED = "unexpected"


class ExtractionError(Exception):