urban-json-xml

Français · English

Plugin urban-json : lecture de fichiers XML dans les templates, via la fonction loadxml. Suit les conventions XML↔JSON du XmlNodeConverter (.NET/Newtonsoft).

Installation

pip install urban-json-xml      # tire urban-json et defusedxml en dépendances

urban-json découvre le plugin automatiquement via les entry points (urban_json.functions) : loadxml devient utilisable dans les templates.

Utilisation

from urban_json import JsltTemplate

# catalog.xml :
#   <catalog>
#     <book id="1"><title>A</title></book>
#     <book id="2"><title>B</title></book>
#   </catalog>
tpl = JsltTemplate.parse('[ { "$source": select(loadxml("catalog.xml"), $.catalog.book), "t": $.title } ]')
tpl.transform({})
# -> [{'t': 'A'}, {'t': 'B'}]

loadxml renvoie un objet ; on navigue dedans avec select/selectmany (fonctions du cœur) avant d'alimenter une boucle $source, un filtre ?(...), etc.

Conventions de conversion (Newtonsoft)

• Attributs → propriétés préfixées par @.
• Texte d'un élément mixte → clé #text.
• Les valeurs restent des chaînes (comme Newtonsoft, pas de coercition).

Signature

loadxml(source_path, attribute_prefix="@", text_key="#text", strip_namespaces=true)

Sécurité

Le XML est analysé avec defusedxml : entités externes et expansion d'entités désactivées (protection XXE / « billion laughs »).

Licence

Apache-2.0.