python-jsonschema/jsonschema
Jsonschema
هذا المشروع هو مكتبة وإطار عمل للتحقق من JSON Schema يستخدم للتحقق من أن حالات البيانات تتوافق مع التعريفات التصريحية. يعمل كمحرك تحقق يفرض قيوداً هيكلية وأنواع بيانات، بينما يعمل أيضاً كمدقق وصفي لضمان أن تعريفات المخطط نفسها صحيحة نحوياً مقابل المخططات الوصفية الرسمية.
تم تصميم المكتبة لتكون قابلة للتوسيع، مما يسمح للمستخدمين بتعريف منطق تحقق مخصص عن طريق تعيين كلمات مفتاحية للمخطط إلى وظائف قابلة للاستدعاء متخصصة. يتضمن محلل مرجع يعتمد على السجل لإدارة مراجع URI الداخلية والخارجية لإعادة استخدام المخططات الفرعية عبر مستندات مختلفة.
يغطي النظام مجموعة واسعة من قدرات التحقق، بما في ذلك التحقق من نوع البيانات، وفحص تنسيق السلسلة لأنواع مثل رسائل البريد الإلكتروني وUUIDs، وتقارير أخطاء شاملة. توفر الأدوات التشخيصية تتبعاً متداخلاً للأخطاء وتصفية استدلالية لتحديد الإخفاقات الأكثر صلة داخل هيكل البيانات.
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.
