pyheimdall 1.2.2

High End Interoperability Module when Data is ALL over the place

What is this?

Heimdall is a tool for converting more easily one or more databases from one format to another.

Why should I use it?

If, for example, you find yourself in one of the following situations…

• you need access to data, but it is not stored in a format compatible with your favorite software…

• you’d prefer to merge several heterogeneous databases into a single corpus, easier to analyze…

• you’re considering which input format to use for your software or database…

• you want to make your data more accessible and interoperable…

… then Heimdall can offer you an exchange format, and abstract the details of data implementation: yours, but also those of others.

Thanks to Heimdall, you can also switch from one technology to another in a matter of moments, as and when you need to, without ever losing, disorganizing or corrupting your data.

In a nutshell, HEIMDALL is your High End Interoperability Module when Data is ALL over the place. It’s a bridge between scattered islands of data.

How can I use it?

Setup

You can install Heimdall using the pip package manager:

pip install pyheimdall

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

pip install --upgrade pyheimdall
pip uninstall pyheimdall

Usage

import heimdall

config = {
    'format': 'sql:mysql',
    'url': 'mysql://user:password@localhost:3306/database',
}
tree = heimdall.getDatabase(**config)

Is it documented?

Sure! You can read the user manual here, or jump directly to the technical reference here. You can use Python’s build-in help function, too.

Is it tested?

Of course! Here’s the coverage report.

You can run all tests on your machine, too. After having cloned this repository, enter it, setup your dev environment, and then:

pytest

How can I contribute?

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

License

GNU Affero General Public License version 3.0 or later

Acknowledgments

Heimdall would like to thank all its contributors and users for their support and feedback. ʕᵔᴥᵔʔ

rwitz 💡💻✅📝	emichelet 💻💡	abrody 💻	evankote 📝✅
mbenkhalid 💻	mariebizaislillig 💡✅	gporte 💡✅	cplancq 🐛✅
tbrissetsabouraud 💻