A Python based Tableau REST API interface.
Project description
A Python based Tableau REST API interface.
Warning: This package is still in a pre-v1 development phase. Breaking changes are likely to occur without warning.
tableaurest
A Python based Tableau REST API interface.
Installation
tableaurest is a Python 3.6+ based package, and can be installed through pip using the following command.
$ python -m pip install tableaurest
Examples
Print count of Workbooks Owned by Login User.
>>> from tableaurest import TableauREST >>> >>> SERVER = 'YOUR_TABLEAU_URL' >>> USERNAME = 'YOUR_TABLEAU_USERNAME' >>> PASSWORD = 'YOUR_TABLEAU_PASSWORD' >>> >>> with TableauREST(SERVER, USERNAME, PASSWORD) as restapi: >>> workbooks = restapi.queryWorkbooksforUser(owner=True) >>> >>> print(f'{USERNAME} owns {len(workbooks)} workbooks on {SERVER}.') 'YOUR_TABLEAU_USERNAME owns 4 workbooks on YOUR_TABLEAU_URL.'
Extras
Contribute
Check/Open Issue for related topics of change
Fork/Clone/Branch repo and make discussed/desired changes
Add tests (¯\_(ツ)_/¯) and document code w/ numpy formatting
Open Pull Request and notify maintainer
Changelog
All notable changes to this project will be documented in this file.
Develop
Unreleased
v0.3.0
Added
All methods added for: Authentication, Sites, Projects, Subscriptions, Server
Changed
Remove excessive (useless) dict.keys() usage from codebase
Allow user to specify ssl verify on TableauREST init (default=True)
Remove auth token from session header on signOut
Update self.site (contenturl) on signIn
Add user impersonation to signIn
Removed
Remove custom logger(s) from submodules
v0.2.3
Changed
Correct queryWorkbookConnections to use GET method
Correct queryDatasourceConnections to use GET method
Add ‘connection’ dict wrapper updateWorkbookConnection details
v0.2.2
Changed
Correct userid/siteid updating on switchSite method
v0.2.1
Changed
Some light cleanup around formatting, logging, & bug fixes
