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.dev0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1208d81e11aa29bfd078fab86e427eca990af99f85465f56c22172bbf7279955 |
|
MD5 | 30b2232e7e93625dd6ea892109537891 |
|
BLAKE2b-256 | 0c54b0807200e53f7f3f7ea16921c5ed046791d708688b062f96047772f48838 |
Hashes for tableau_helpers-3.0.0.dev0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 104015a1334fb797e243c822871c74144d323c86d1ba2a276458e171c59884ef |
|
MD5 | c00f67b87f97ecff5a8387891e03dbb2 |
|
BLAKE2b-256 | 66971c43c283ea8a0d3dbb78d0b62b6937b9775da78dec18de9c76cbed5dbbc8 |