API Reference — Overview

On this page

This section documents every public class, function, and type exported by output_parser.

Public exports (__init__.py)

Python · 17 lines
from output_parser import (
    # Orchestrator
    OutputParser, ParseError,
    create_answer_parser, create_json_parser, create_tool_call_parser,
    # Schemas & types
    AnswerSchema, FieldSchema, FixStrategy, OutputFormat, ParseMode,
    ParseResult, ParseTrace, RankedAnswersSchema, RetrievalResultSchema,
    ToolCallSchema, ValidationResult, ValidationStatus,
    # Format detection
    FormatCandidate, FormatDetector,
    # Validation
    OutputValidator, ValidationRule, build_answer_validator,
    # Fault tolerance
    OutputFixer, build_answer_fixer,
    # Retry
    RetryHandler, RetryResult, RetryStrategy, graceful_fallback,
)

API summary table

APITypeModuleDescription
OutputParserclassparser.pyMain orchestrator: detect → parse → fix → retry → validate pipeline.
ParseErrorexceptionparser.pyRaised in STRICT mode when all recovery attempts fail.
create_answer_parserfunctionparser.pyFactory for a parser pre-configured for AnswerSchema.
create_tool_call_parserfunctionparser.pyFactory for a parser pre-configured for tool/function calls.
create_json_parserfunctionparser.pyFactory for a JSON-only parser with optional schema.
OutputFormatenumschema.pyDetected/expected output shape.
ParseModeenumschema.pyStrictness/fallback behavior.
ValidationStatusenumschema.pyResult status of a validation check.
FixStrategyenumschema.pyRepair strategy applied by OutputFixer.
ValidationResultdataclassschema.pyResult of one validation check.
ParseTracedataclassschema.pyFull audit trail for a parse operation.
ParseResultdataclassschema.pyFinal result returned to callers.
FieldSchemadataclassschema.pyDeclares one expected output field.
AnswerSchemaPydantic model / dataclassschema.pyStandard RAG answer schema.
ToolCallSchemaPydantic model / dataclassschema.pyTool/function call schema.
RetrievalResultSchemaPydantic model / dataclassschema.pySingle retrieved document schema.
RankedAnswersSchemaPydantic model / dataclassschema.pyMultiple candidate answers with scores.
FormatDetectorclassformat_detector.pyMulti-signal format detection.
FormatCandidatedataclassformat_detector.pyA detected format + confidence + evidence.
OutputValidatorclassvalidator.pyFour-layer output validation.
ValidationRuleclassvalidator.pyA named validation predicate.
build_answer_validatorfunctionvalidator.pyPre-configured validator for AnswerSchema.
OutputFixerclassfixer.pyFour-strategy repair engine.
build_answer_fixerfunctionfixer.pyPre-configured fixer for AnswerSchema.
RetryHandlerclassretry_handler.pyLLM re-prompt/retry engine.
RetryResultdataclassretry_handler.pyOutcome of a retry run.
RetryStrategyenumretry_handler.pyRetry escalation strategy.
graceful_fallbackfunctionretry_handler.pyLast-resort safe fallback payload.
BaseOutputParserABCbase_parser.pyAbstract interface for single-format parsers.
ParsingErrorexceptionbase_parser.pyRaised by single-format parsers on failure.
AutoFixingParserclassbase_parser.pyWraps a parser with retry + fixer callback.
ChainedParserclassbase_parser.pyTries multiple parsers in order.
JSONOutputParserclassjson_parser.pyStandalone JSON parser.
YAMLOutputParserclassyaml_parser.pyStandalone YAML parser.
CSVOutputParserclasscsv_parser.pyStandalone CSV parser.
ListOutputParserclasslist_parser.pyStandalone list parser.
StructuredOutputParserclassstructured_parser.pyNamed key-value field extractor.
ResponseSchemaclassstructured_parser.pyField declaration for StructuredOutputParser.
PydanticOutputParserclasspydantic_parser.pyJSON → validated Pydantic model.

Continue to OutputParser, the main entry point.

Related pages