martinblech/xmltodict
Xmltodict
xmltodict هي مكتبة Python توفر تسلسلاً ثنائي الاتجاه بين مستندات XML والقواميس (dictionaries). تعمل كمحلل (parser) يحول المدخلات المرمزة إلى أزواج مفتاح-قيمة، وأداة تسلسل تحول القواميس مرة أخرى إلى مستندات XML مهيكلة.
يتضمن المشروع معالج تدفق تزايدي يستخدم استدعاءات تعتمد على العمق للتعامل مع ملفات XML الكبيرة مع الحفاظ على استهلاك ثابت للذاكرة. يتميز بمدير مساحات أسماء (namespace manager) لتعيين البادئات والإعلانات، بالإضافة إلى مطهر أمني (security sanitizer) يحظر توسيع الكيانات الخارجية ويتحقق من صحة أسماء العناصر لمنع هجمات الحقن.
توفر المكتبة إمكانيات لفرض أنواع البيانات، مثل إجبار عناصر معينة على أن تُمثل كقوائم بغض النظر عن عدد العناصر الفرعية. كما تدعم معالجة البيانات اللاحقة من خلال استدعاءات يحددها المستخدم، وتوفر عناصر تحكم قابلة للتكوين لتوسيع أو طي أو تخطي مساحات الأسماء أثناء عملية التحويل.
Features
- XML Serialization - Transforms Python dictionaries back into structured, well-formed XML documents with support for namespaces and formatting.
- XML to Dictionary Mappers - Parses XML trees into nested Python dictionaries by mapping tags to keys and text nodes to values.
- XML Parsing - Converts marked-up documents into dictionaries using configurable rules for prefixes and whitespace.
- Stream-Based Parsing - Implements an event-driven streaming parser to handle large XML files with constant memory usage.
- Stream Processors - Provides an incremental stream processor that handles large XML files with constant memory usage.
- Large Scale XML Processing - Processes massive XML files incrementally using streaming callbacks to maintain low memory usage.
- XML Serialization Formats - Generates structured XML files by transforming Python dictionaries into formatted markup.
- Object-to-XML Mapping - Transforms Python dictionaries into structured XML documents with formatting and list expansion options.
- XML to JSON Converters - Converts XML documents into nested Python dictionaries, enabling JSON-like manipulation of marked-up data.
- XML Namespace Management - Manages complex XML namespaces by mapping prefixes and controlling their appearance in converted data.
- XML Namespace Declarations - Maps XML namespaces to prefixes or collapses them into simplified keys based on configurable rules.
- Incremental Parsing - Processes large XML files incrementally using callbacks to maintain constant memory usage.
- Type Enforcement - Enforces specific data types, such as wrapping elements in lists, during the XML parsing process.
- List Type Enforcement - Forces specific XML elements to be treated as lists even if only a single child exists.
- XML External Entity Prevention - Blocks the resolution of external entities during parsing to prevent resource exhaustion and injection attacks.
- XML Processing Security - Implements security measures including external entity blocking and element name validation to prevent XML injection attacks.
- Data Value Transformations - Provides user-defined callbacks to transform XML values or attributes on the fly during conversion.
- Namespace Representation Controls - Provides controls to expand, collapse, or skip namespaces during the parsing process.
- Symmetric Input-Output Mappings - Uses shared transformation rules to enable consistent bidirectional conversion between dictionaries and XML.
- Data Loading Extraction - Makes XML feel like working with JSON.
- Documentation and Processing - Tool for converting XML to Python dictionaries.
- HTML and XML Processing - Handling XML data with JSON-like syntax.
