pyheimdall-mariadb 1.1.0

MariaDB connector for pyHeimdall

What is this?

pyHeimdall is a tool for converting more easily one or more databases from one format to another. It leverages modules called “connectors”, responsible for conversion of data between specific databases schemas and the HERA format.

This repository implements a connector to retrieve data from a MariaDB database. The implementation doesn’t need any intervention on pyHeimdall proper.

How can I use it?

Setup

This MariaDB pyHeimdall connector is available as a PyPI package named pyheimdall-mariadb. You can install it using the pip package manager:

pip install pyheimdall-mariadb

You can use pip to either upgrade or uninstall this connector, too:

pip install --upgrade pyheimdall-mariadb
pip uninstall pyheimdall-mariadb

Usage

import heimdall

tree = heimdall.getDatabase(
        format='sql:mariadb',
        url='mariadb://myusername:mypassword@myhost:myport/mydatabase',
        entities=('mytable', 'myothertable', ),
        )
heimdall.createDatabase(tree, format='hera:xml', url='mydatabase.xml')

Please note that you don’t need to use pyheimdall-mariadb functions directly. As long as the package is installed on your system, pyHeimdall will automatically discover its features and allow you to use them as long as any other default or external connector.

Is it tested?

Of course! Here’s the coverage report.

How can I contribute?

This project welcomes any feedback or proposal. Details can be accessed here

License

GNU Affero General Public License version 3.0 or later