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.dev3.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | fbaa01b54970e993d7f7c36732413138fa96123f02bf03677a21637abe0eebf3 |
|
MD5 | 489af871843016de36c7eb33719d71f3 |
|
BLAKE2b-256 | 28094cc543d630d85934824d1ae65aac2b18df7013ed40b0b7c8d576f9c38981 |
Hashes for tableau_helpers-3.0.0.dev3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 849e2ce2a00fe51aa8fbdeeca9dc0f75dfc33f11e7ea385716967117b08e2f31 |
|
MD5 | 844d1d495402ff289dbcc8e73bca45c9 |
|
BLAKE2b-256 | 578fc021cfb2bce7db31658966701275a0824c045439b2cc8620e74cebf4d962 |