metacatalog
CI | Status |
---|---|
Unit tests | |
Documentation | |
Deployment |
Management tool for the V-FOR-WaTer metadata database application. Although developed in and for the V-FOR-WaTer project, metacatalog is a standalone database application, that can be used on its own.
Docs
The full documentation is available at: https://vforwater.github.io/metacatalog
Installation description is given at: https://vforwater.github.io/metacatalog/home/install.html
Quickstart
Install metacatalog:
pip install metacatalog
With a Postgis database called metacatalog
installed at localhost:5432
you can store a default connection like:
Be aware that any password saved along with the default connection is saved in clear-text!!
metacatalog connection --save postgresql://postgres:<masterpassword>@localhost:5432/metacatalog
Refer to the connection documentation to learn about all possibilities to connect to a database.
The database table can be installed and populated like:
metacatalog init -C postgresql://postgres:<password>@localhost:5432/metacatalog
And now you can use the database via:
- the CLI
- the Python API
- or directly interface to the database model classes
Using metacatalog on Windows
On one of my Windows systems the setuptools scripts does not get recognized properly and thus the CLI does not work properly if not called by full path. Therefore with version 0.1.4 the CLI is implemented the module main entrypoint. Wherever the docs call the metacatalog script, you can use the module, like:
Instead of:
metacatalog [options] <commad>
you can use:
python -m metacatalog [options] <command>
This should work cross-platform. Tested on Ubuntu 18, debian 9, Windows 7 and Windows 10.