tableaurest 0.3.0

A Python based Tableau REST API interface.

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

1. Check/Open Issue for related topics of change
2. Fork/Clone/Branch repo and make discussed/desired changes
3. Add tests (¯\_(ツ)_/¯) and document code w/ numpy formatting
4. 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