python-jsonschema/jsonschema
Jsonschema
本项目是一个 JSON Schema 验证库和框架，用于验证数据实例是否符合声明性定义。它作为一个验证引擎，强制执行结构约束和数据类型，同时也作为一个元验证器，确保模式定义本身在语法上符合官方元模式。
该库专为可扩展性而设计，允许用户通过将模式关键字映射到专门的可调用函数来定义自定义验证逻辑。它包括一个基于注册表的引用解析器，用于管理内部和外部 URI 引用，以便在不同文档间重用子模式。
该系统涵盖了广泛的验证功能，包括数据类型验证、针对电子邮件和 UUID 等类型的字符串格式检查，以及全面的错误报告。诊断工具提供嵌套错误跟踪和启发式过滤，以识别数据结构中最相关的失败。
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.
