python-jsonschema/jsonschema
Jsonschema
Este proyecto es una biblioteca y framework de validación de JSON Schema utilizado para verificar que las instancias de datos se ajusten a definiciones declarativas. Funciona como un motor de validación que aplica restricciones estructurales y tipos de datos, al tiempo que sirve como un meta-validador para garantizar que las definiciones de esquema en sí sean sintácticamente correctas frente a meta-esquemas oficiales.
La biblioteca está diseñada para la extensibilidad, permitiendo a los usuarios definir lógica de validación personalizada mapeando palabras clave de esquema a funciones invocables especializadas. Incluye un resolvedor de referencias basado en registro para gestionar referencias URI internas y externas para reutilizar subesquemas en diferentes documentos.
El sistema cubre una amplia gama de capacidades de validación, incluyendo la verificación de tipos de datos, verificación de formato de cadena para tipos como correos electrónicos y UUIDs, e informes de errores completos. Las herramientas de diagnóstico proporcionan seguimiento de errores anidados y filtrado heurístico para identificar los fallos más relevantes dentro de una estructura de datos.
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.
