voxpupuli/json-schema
Json Schema
هذه المكتبة هي محرك تحقق قائم على Ruby مصمم للتحقق من هياكل بيانات JSON مقابل مواصفات المخطط الرسمية. تضمن سلامة البيانات من خلال التأكد من أن الكائنات والسلاسل والملفات تتوافق مع القيود الهيكلية المحددة، مع التحقق أيضاً من سلامة تعريفات المخطط نفسها مقابل معايير المخطط الوصفي (metaschema) الرسمية.
يتميز المشروع ببنية نمطية للغاية تسمح بتخصيص عميق. يمكن للمستخدمين تسجيل قواعد تحقق مخصصة ومعالجات تنسيق لفرض منطق أعمال خاص بالمشروع يمتد إلى ما وراء المواصفات القياسية. علاوة على ذلك، يتميز النظام بطبقة تحليل قابلة للتوصيل، مما يتيح اختيار محركات أساسية مختلفة لتحسين الأداء أو ضمان التوافق مع بيئات تطبيق محددة.
يدير المحقق هياكل البيانات المعقدة من خلال الاجتياز العودي ويحافظ على سياق ذي حالة لتقديم تقارير أخطاء مفصلة، بما في ذلك مسارات الخصائص المحددة للانتهاكات المكتشفة. يتم معالجة الأمان من خلال طبقة دقة قابلة للتكوين تدير كيفية جلب مراجع المخطط الخارجية، مما يسمح للمطورين بتقييد الوصول إلى الشبكة أو نظام الملفات حسب الحاجة.
Features
- JSON Schema Validation - Validates JSON data structures against official schema specifications to ensure data integrity and structural compliance.
- Data Validation Libraries - Ensures data integrity within Ruby applications by enforcing structural constraints defined in standard schema formats.
- Schema Extensions - Supports extending schema rules to accommodate non-standard data structures and business logic.
- Field-Scoped Validation Contexts - Maintains a stateful context during validation to track error paths and violation details.
- Data Validation Layers - Verifies schema definitions against official metaschema standards to ensure structural integrity.
- Networked Schema Resolvers - Manages remote schema resolution to restrict network access and improve security.
- Remote Resolvers - Manages external schema references through a configurable fetching layer for security and performance.
- Custom Format Validators - Provides mechanisms to register custom format handlers for specific data validation needs.
- External Schema Resolution - Provides configurable resolution layers to securely fetch and process external schema references while restricting network or file system access.
- Data Validation Schemas - Allows adding custom validation logic to existing schema specifications.
- Domain-Specific Validation Rules - Implements project-specific business rules and custom format handlers for complex data.
- Validation Error Reporters - Reports detailed validation errors with specific property paths to assist in debugging data structures.
- Extension Registries - Provides a registry-based pattern for dynamically registering custom validation rules and format handlers.
- Data Structure Traversers - Recursively traverses nested data structures to apply validation constraints at every level.
- Meta-Schema Validations - Verifies that schema definitions conform to official metaschema standards.
- Specification Validation Schemas - Enables registration of custom validation rules and format handlers for project-specific requirements.
- Pluggable Parsers - Supports pluggable parsing backends to optimize performance and ensure environment compatibility.
- Schema Compliance Engines - Verifies JSON objects against official draft specifications while supporting custom format handlers and remote reference management.
