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
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