python-jsonschema/jsonschema
Jsonschema
This project is a JSON Schema validation library and framework used to verify that data instances conform to declarative definitions. It functions as a validation engine that enforces structural constraints and data types, while also serving as a meta-validator to ensure schema definitions themselves are syntactically correct against official meta-schemas.
The library is designed for extensibility, allowing users to define custom validation logic by mapping schema keywords to specialized callable functions. It includes a registry-based reference resolver for managing internal and external URI references to reuse subschemas across different documents.
The system covers a broad range of validation capabilities, including data type verification, string format checking for types like emails and UUIDs, and comprehensive error reporting. Diagnostic tools provide nested error tracking and heuristic filtering to identify the most relevant failures within a data structure.
Features
- JSON Schema Implementations - Implements the full JSON Schema specification for evaluating data instances against declarative definitions.
- JSON Schema Validation - Verifies that JSON data instances conform to declarative schema definitions and reports structural mismatches.
- Schema Reference Resolution - Resolves internal and external pointers within schema definitions using a registry-based system.
- Data Type Validation - Verifies that data instances conform to recognized schema types.
- Data Validation Frameworks - Provides an extensible framework for enforcing structural constraints and data types on JSON documents.
- Validation Error Reporters - Iteratively reports all validation mismatches instead of stopping at the first failure.
- Keyword Validation Mappings - Implements a mapping system that associates schema keywords with specific executable functions for custom validation logic.
- Meta-Schema Validations - Verifies that a schema definition conforms to the official JSON Schema meta-specification.
- Specification Conformance Validation - Verifies if a data object conforms to a declarative JSON Schema definition.
- Format Validators - Enforces compliance for primitive types against formats like email or UUID using a hook system.
- Significance-Based Filtering - Identifies the most significant validation failures by analyzing data depth and keyword importance.
- JSON Schema Reference Resolvers - Resolves internal and external URI references using a registry to enable subschema reuse across documents.
- Schema Keyword Functions - Enables mapping schema keywords to custom callable functions and configuring specialized type and format checkers.
- Custom Format Validators - Allows the registration of domain-specific data formats to extend the standard validation logic.
- Recursive Path Tracking - Tracks the precise location within nested data structures to report accurate error paths.
- Pluggable Format Checkers - Provides an extensible registry of functions to verify that strings match predefined formats like email or UUID.
- Primary Error Identification - Heuristically identifies the most significant error from a set of failures based on data hierarchy and keyword importance.
- Specification Draft Implementations - Implements dedicated validator classes to maintain compatibility across different versions of the JSON Schema specification.
- Extended Format Dependencies - Uses optional extended dependencies to provide enhanced validation for specialized string formats.
- Data Validation - Implementation of JSON Schema.
- Data Validation - Implementation of the JSON Schema specification.
