A collection of helpers to reduce boilerplate with Tableau APIs.
Project description
tableau_helpers
A wrapper for the tableau-server-client and hyper-api which abstracts away boilerplate and in some cases provides a CLI which works without admin privileges. The CLI is in beta, and parameters may change with minor releases.
tableau_helpers.hyper
Create hyperfiles from one or more csvs by providing a source, destination, schema, and optional parameters.
Code integration
See test_hyper.py for some examples in action.
tableau_helpers.publish
Upload datasources from your machine to the tableau server by providing a hyperfile as a source and a project as a destination.
Code integration
See test_server.py for an example.
Development
There are a few steps to set up the development environment.
- Make a copy of .env.sample and save it as .env
- Add your Personal Access Token to .env
- Set the tableau-server url in .env ex:
https://tableau-test.rki.local
- If your SSL cert is self signed, download a copy of your pem and provide the path in .env, otherwise delete the cert entry.
- Install tox either in an environment or for your user.
- Test run tox for unit tests
tox
(note: some integration tests require a connection to your tableau server) - Test run tox to reformat files
tox -e lint
- Test run tox for unit tests
- Make commits using ticket/issue ids as a prefix of the commit message.
Releases
- Clean the build folder
rm build/*
,rm dist/*
- Update the version of the package in tableau_helpers/init.py
- Package the library with
python -m build .
. - Review the contents of the package in the build folder.
- Upload with twine to pypi
twine upload dist/*
.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for tableau-helpers-3.0.0.dev2.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 407a8622dc794f8988d0d9def28ef4a276d3f8ac0759ad5c6e0a4dcbab7ddfa5 |
|
MD5 | fdaa5ddbba288fc4231ee90b45182668 |
|
BLAKE2b-256 | 256f736d3e35620a070edfa959074e94b83a2a9107deb831e015228cf2a5e2e7 |
Hashes for tableau_helpers-3.0.0.dev2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | fddb0de652bae73e0c5e44b2785e3a0c1b6fc3e60e4216df11e5a889a6f121e0 |
|
MD5 | e12525bb711089c9d75f09970ef07ff9 |
|
BLAKE2b-256 | 8bad8274d6396acebda88bcda3934e1def1f0e8f0b13b33dde1443855d5b6e96 |