pyHeimdall

Digital Object Identifier (DOI) de pyHeimdall

pyHeimdall est une implementation de Heimdall en langage Python.

Voir aussi

Il existe un autre implémentation de Heimdall en language XQuery : xHeimdall. Si vous avez besoin d’utiliser Heimdall depuis un environnement BaseX par exemple, xHeimdall peut être plus appropriée.

Installation

PyPI - Python Version
Ce logiciel est disponible en tant que paquet PyPI.
Il peut donc être installé via le gestionnaire de paquets pip :
pip install pyheimdall

Démarrage

Pour utiliser Heimdall au sein d’un programme Python, il est nécessaire de l’importer. Le module principal se nomme heimdall.

import heimdall

Lire une base de données au format format se trouvant à l’adresse url se fait par un simple appel à la fonction heimdall.getDatabase() :

tree = heimdall.getDatabase(format=format, url=url)

À l’inverse, convertir une base de données tree vers le format format et l’enregistrer à l’adresse url se fait par un simple appel à la fonction heimdall.createDatabase() :

heimdall.createDatabase(tree, format=format, url=url)

Par exemple, le programme suivant importe une base de données XML, puis l’exporte sous forme d’une liste de directives SQL :

import heimdall

MENAGERIE_XML = 'https://gitlab.huma-num.fr/datasphere/heimdall/python/-/raw/main/tests/examples/menagerie/hera.xml'
tree = heimdall.getDatabase(format='hera:xml', url=MENAGERIE_XML)
heimdall.createDatabase(tree, format='sql:mariadb', url='menagerie.sql')

Aller plus loin

Pour découvrir toutes les fonctionnalités de pyHeimdall, vous pouvez suivre ce tutoriel pas à pas, ou parcourir directement la référence (en anglais), et en particulier les modules principaux heimdall et heimdall.util