Mastertables
A Python package to interact with Mastertables.
This package provides a very simple way of getting data from your mastertables through the public Rest API.
Installation
Install from PyPI (recommended)
Just run the command below from the CLI:
pip install mastertablesTo add the package to your local requirements.txt run:
pip freeze > requirements.txtInstall from repo
You can install Mastertables from the Github repo:
pip install git+https://github.com/athento/mastertablesInstall from source
Alternatively, you can even install it from the sources:
git clone https://github.com/athento/mastertables
cd mastertables
pip install .Updating
Update from PyPI
pip install mastertables --upgradeUpdate from repo
pip install git+https://github.com/athento/mastertables --upgradeUpdate from source
cd /path/to/mastertables/repo
git pull
pip install . --upgradeAPI reference
# module
from mastertables import mastertables
# mastertables client instantiation
# usage:
# mastertables.MasterTablesClient("<team_api_key>")
mt = mastertables.MasterTablesClient("OAIV9839AF893H923ONWAN3IGNAWNAUNEGIU")
# get vocabulary
# usage:
# mastertables.MasterTablesClient.get_vocabulary("<vocabulary_uuid>" [, category="<category>"])
# output:
# {u'foo': u'bar', u'asdf': u'qwer'}
print(mt.get_vocabulary("1234abcd-12ab-34cd-56ef-12345678abcd"))
# get vocabulary reverse (value:key, instead of key:value)
# usage:
# mastertables.MasterTablesClient.get_vocabulary_reverse("<vocabulary_uuid>" [, category="<category>"])
# output:
# {u'bar': u'foo', u'qwer': u'asdf'}
print(mt.get_vocabulary_reverse("1234abcd-12ab-34cd-56ef-12345678abcd"))
# get vocabulary values
# usage:
# mastertables.MasterTablesClient.get_values("<vocabulary_uuid>")
# output:
# [u'foo', u'asdf']
print(mt.get_values("1234abcd-12ab-34cd-56ef-12345678abcd"))
# get vocabulary entity value
# usage:
# mastertables.MasterTablesClient.get_value("<vocabulary_uuid>", "<entity_key>" [, index=<index>])
# output:
# u'bar'
print(mt.get_value("1234abcd-12ab-34cd-56ef-12345678abcd", "foo", 0))Packaging and distributing
Click on this link to read the manual on how to package and upload mastertables to PyPI.
