python-jsonschema/jsonschema
Jsonschema
Dieses Projekt ist eine JSON-Schema-Validierungsbibliothek und ein Framework, das verwendet wird, um zu verifizieren, dass Dateninstanzen deklarativen Definitionen entsprechen. Es fungiert als Validierungs-Engine, die strukturelle Einschränkungen und Datentypen erzwingt, während es gleichzeitig als Meta-Validator dient, um sicherzustellen, dass Schemadefinitionen selbst syntaktisch korrekt gegenüber offiziellen Meta-Schemas sind.
Die Bibliothek ist auf Erweiterbarkeit ausgelegt und erlaubt es Nutzern, benutzerdefinierte Validierungslogik durch das Mapping von Schema-Schlüsselwörtern auf spezialisierte aufrufbare Funktionen zu definieren. Sie enthält einen registry-basierten Referenz-Resolver zur Verwaltung interner und externer URI-Referenzen, um Subschemas über verschiedene Dokumente hinweg wiederzuverwenden.
Das System deckt ein breites Spektrum an Validierungsfunktionen ab, einschließlich Datentypverifizierung, String-Formatprüfung für Typen wie E-Mails und UUIDs sowie umfassende Fehlerberichterstattung. Diagnosetools bieten verschachteltes Fehler-Tracking und heuristische Filterung, um die relevantesten Fehler innerhalb einer Datenstruktur zu identifizieren.
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.
