Function _extract_one

explainshell/extraction/runner.py:116–146

Run extractor on a single file. Returns an ``ExtractionResult`` for all expected outcomes. Raises ``FatalExtractionError`` for both explicit fatal errors from the extractor and unexpected exceptions (wrapped with traceback logged).

(extractor: Extractor, gz_path: str)

def _extract_one(extractor: Extractor, gz_path: str) -> ExtractionResult:
    """Run extractor on a single file.

    Returns an ``ExtractionResult`` for all expected outcomes.  Raises
    ``FatalExtractionError`` for both explicit fatal errors from the
    extractor and unexpected exceptions (wrapped with traceback logged).
    """
    try:
        return extractor.extract(gz_path)
    # Order matters: FatalExtractionError and SkippedExtraction both inherit
    # from ExtractionError, so they must be handled before the generic branch.
    except FatalExtractionError:
        raise
    except SkippedExtraction as e:
        return ExtractionResult(
            gz_path=gz_path,
            outcome=ExtractionOutcome.SKIPPED,
            stats=e.stats,
            error=e.reason,
            reason_class=e.reason_class,
        )
    except ExtractionError as e:
        return ExtractionResult(
            gz_path=gz_path,
            outcome=ExtractionOutcome.FAILED,
            error=str(e),
            reason_class=e.reason_class,
        )
    except Exception as e:
        logger.exception("fatal unexpected exception while extracting %s", gz_path)
        raise FatalExtractionError(str(e)) from e


def run_sequential(