tableauserverclient 0.32__tar.gz → 0.34__tar.gz

tableauserverclient-0.34/CONTRIBUTORS.md

@@ -0,0 +1,82 @@
+This project wouldn't be possible without our amazing contributors.
+
+The following people have contributed to this project to make it possible, and we thank them for their contributions!
+
+## Contributors
+
+* [jacalata](https://github.com/jacalata)
+* [jorwoods](https://github.com/jorwoods)
+* [t8y8](https://github.com/t8y8)
+* [bcantoni](https://github.com/bcantoni)
+* [shinchris](https://github.com/shinchris)
+* [vogelsgesang](https://github.com/vogelsgesang)
+* [lbrendanl](https://github.com/lbrendanl)
+* [LGraber](https://github.com/LGraber)
+* [gaoang2148](https://github.com/gaoang2148)
+* [benlower](https://github.com/benlower)
+* [liu-rebecca](https://github.com/liu-rebecca)
+* [guodah](https://github.com/guodah)
+* [jdomingu](https://github.com/jdomingu)
+* [kykrueger](https://github.com/kykrueger)
+* [jz-huang](https://github.com/jz-huang)
+* [opus-42](https://github.com/opus-42)
+* [markm-io](https://github.com/markm-io)
+* [graysonarts](https://github.com/graysonarts)
+* [d45](https://github.com/d45)
+* [preguraman](https://github.com/preguraman)
+* [sotnich](https://github.com/sotnich)
+* [mmuttreja-tableau](https://github.com/mmuttreja-tableau)
+* [dependabot[bot]](https://github.com/apps/dependabot)
+* [scuml](https://github.com/scuml)
+* [ovinis](https://github.com/ovinis)
+* [FFMMM](https://github.com/FFMMM)
+* [martinbpeters](https://github.com/martinbpeters)
+* [talvalin](https://github.com/talvalin)
+* [dzucker-tab](https://github.com/dzucker-tab)
+* [a-torres-2](https://github.com/a-torres-2)
+* [nnevalainen](https://github.com/nnevalainen)
+* [mbren](https://github.com/mbren)
+* [wolkiewiczk](https://github.com/wolkiewiczk)
+* [jacobj10](https://github.com/jacobj10)
+* [hugoboos](https://github.com/hugoboos)
+* [grbritz](https://github.com/grbritz)
+* [fpagliar](https://github.com/fpagliar)
+* [bskim45](https://github.com/bskim45)
+* [baixin137](https://github.com/baixin137)
+* [jessicachen79](https://github.com/jessicachen79)
+* [gconklin](https://github.com/gconklin)
+* [geordielad](https://github.com/geordielad)
+* [fossabot](https://github.com/fossabot)
+* [daniel1608](https://github.com/daniel1608)
+* [annematronic](https://github.com/annematronic)
+* [rshide](https://github.com/rshide)
+* [VathsalaAchar](https://github.com/VathsalaAchar)
+* [TrimPeachu](https://github.com/TrimPeachu)
+* [ajbosco](https://github.com/ajbosco)
+* [jimbodriven](https://github.com/jimbodriven)
+* [ltiffanydev](https://github.com/ltiffanydev)
+* [martydertz](https://github.com/martydertz)
+* [r-richmond](https://github.com/r-richmond)
+* [sfarr15](https://github.com/sfarr15)
+* [tagyoureit](https://github.com/tagyoureit)
+* [tjones-commits](https://github.com/tjones-commits)
+* [yoshichan5](https://github.com/yoshichan5)
+* [wlodi83](https://github.com/wlodi83)
+* [anipmehta](https://github.com/anipmehta)
+* [cmtoomey](https://github.com/cmtoomey)
+* [pes-magic](https://github.com/pes-magic)
+* [illonage](https://github.com/illonage)
+* [jayvdb](https://github.com/jayvdb)
+* [jorgeFons](https://github.com/jorgeFons)
+* [Kovner](https://github.com/Kovner)
+* [LarsBreddemann](https://github.com/LarsBreddemann)
+* [lboynton](https://github.com/lboynton)
+* [maddy-at-leisure](https://github.com/maddy-at-leisure)
+* [narcolino-tableau](https://github.com/narcolino-tableau)
+* [PatrickfBraz](https://github.com/PatrickfBraz)
+* [paulvic](https://github.com/paulvic)
+* [shrmnk](https://github.com/shrmnk)
+* [TableauKyle](https://github.com/TableauKyle)
+* [bossenti](https://github.com/bossenti)
+* [ma7tcsp](https://github.com/ma7tcsp)
+* [toomyem](https://github.com/toomyem)

{tableauserverclient-0.32 → tableauserverclient-0.34}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: tableauserverclient
-Version: 0.32
+Version: 0.34
 Summary: A Python module for working with the Tableau Server REST API.
 Author-email: Tableau <github@tableau.com>
 License: The MIT License (MIT)
@@ -28,22 +28,22 @@ License: The MIT License (MIT)
 Project-URL: repository, https://github.com/tableau/server-client-python
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
-Requires-Python: >=3.7
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 License-File: LICENSE.versioneer
 Requires-Dist: defusedxml>=0.7.1
 Requires-Dist: packaging>=23.1
-Requires-Dist: requests>=2.31
-Requires-Dist: urllib3==2.2.2
+Requires-Dist: requests>=2.32
+Requires-Dist: urllib3<3,>=2.2.2
 Requires-Dist: typing_extensions>=4.0.1
 Provides-Extra: test
-Requires-Dist: black==23.7; extra == "test"
+Requires-Dist: black==24.8; extra == "test"
 Requires-Dist: build; extra == "test"
 Requires-Dist: mypy==1.4; extra == "test"
 Requires-Dist: pytest>=7.0; extra == "test"
@@ -62,14 +62,14 @@ Use the Tableau Server Client (TSC) library to increase your productivity as you
 * Create users and groups.
 * Query projects, sites, and more.
 
-This repository contains Python source code for the library and sample files showing how to use it. As of May 2022, Python versions 3.7 and up are supported.
+This repository contains Python source code for the library and sample files showing how to use it. As of September 2024, support for Python 3.7 and 3.8 will be dropped - support for older versions of Python aims to match https://devguide.python.org/versions/
 
 To see sample code that works directly with the REST API (in Java, Python, or Postman), visit the [REST API Samples](https://github.com/tableau/rest-api-samples) repo.
 
 For more information on installing and using TSC, see the documentation:
 <https://tableau.github.io/server-client-python/docs/>
  
-
+To contribute, see our [Developer Guide](https://tableau.github.io/server-client-python/docs/dev-guide). A list of all our contributors to date is in [CONTRIBUTORS.md].
 
 ## License
 [![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Ftableau%2Fserver-client-python.svg?type=large)](https://app.fossa.com/projects/git%2Bgithub.com%2Ftableau%2Fserver-client-python?ref=badge_large)

{tableauserverclient-0.32 → tableauserverclient-0.34}/README.md

@@ -9,14 +9,14 @@ Use the Tableau Server Client (TSC) library to increase your productivity as you
 * Create users and groups.
 * Query projects, sites, and more.
 
-This repository contains Python source code for the library and sample files showing how to use it. As of May 2022, Python versions 3.7 and up are supported.
+This repository contains Python source code for the library and sample files showing how to use it. As of September 2024, support for Python 3.7 and 3.8 will be dropped - support for older versions of Python aims to match https://devguide.python.org/versions/
 
 To see sample code that works directly with the REST API (in Java, Python, or Postman), visit the [REST API Samples](https://github.com/tableau/rest-api-samples) repo.
 
 For more information on installing and using TSC, see the documentation:
 <https://tableau.github.io/server-client-python/docs/>
  
-
+To contribute, see our [Developer Guide](https://tableau.github.io/server-client-python/docs/dev-guide). A list of all our contributors to date is in [CONTRIBUTORS.md].
 
 ## License
 [![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Ftableau%2Fserver-client-python.svg?type=large)](https://app.fossa.com/projects/git%2Bgithub.com%2Ftableau%2Fserver-client-python?ref=badge_large)

tableauserverclient-0.34/contributing.md

@@ -0,0 +1,25 @@
+# Contributing
+
+We welcome contributions to this project!
+
+Contribution can include, but are not limited to, any of the following:
+
+* File an Issue
+* Request a Feature
+* Implement a Requested Feature
+* Fix an Issue/Bug
+* Add/Fix documentation
+
+## Issues and Feature Requests
+
+To submit an issue/bug report, or to request a feature, please submit a [GitHub issue](https://github.com/tableau/server-client-python/issues) to the repo.
+
+If you are submitting a bug report, please provide as much information as you can, including clear and concise repro steps, attaching any necessary
+files to assist in the repro.  **Be sure to scrub the files of any potentially sensitive information.  Issues are public.**
+
+For a feature request, please try to describe the scenario you are trying to accomplish that requires the feature.  This will help us understand
+the limitations that you are running into, and provide us with a use case to know if we've satisfied your request.
+
+### Making Contributions
+
+Refer to the [Developer Guide](https://tableau.github.io/server-client-python/docs/dev-guide) which explains how to make contributions to the TSC project.

{tableauserverclient-0.32 → tableauserverclient-0.34}/pyproject.toml

@@ -14,42 +14,42 @@ readme = "README.md"
 dependencies = [
     'defusedxml>=0.7.1',  # latest as at 7/31/23
     'packaging>=23.1',   # latest as at 7/31/23
-    'requests>=2.31',  # latest as at 7/31/23
-    'urllib3==2.2.2',  # dependabot
+    'requests>=2.32',  # latest as at 7/31/23
+    'urllib3>=2.2.2,<3',
     'typing_extensions>=4.0.1',
 ]
-requires-python = ">=3.7"
+requires-python = ">=3.9"
 classifiers = [
   "Programming Language :: Python",
   "Programming Language :: Python :: 3",
-  "Programming Language :: Python :: 3.8",
   "Programming Language :: Python :: 3.9",
   "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
-  "Programming Language :: Python :: 3.12"
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13"
 ]
 [project.urls]
 repository = "https://github.com/tableau/server-client-python"
 
 [project.optional-dependencies]
-test = ["black==23.7", "build", "mypy==1.4", "pytest>=7.0", "pytest-cov", "pytest-subtests",
+test = ["black==24.8", "build", "mypy==1.4", "pytest>=7.0", "pytest-cov", "pytest-subtests",
     "requests-mock>=1.0,<2.0"]
 
 [tool.black]
 line-length = 120
-target-version = ['py37', 'py38', 'py39', 'py310', 'py311', 'py312']
+target-version = ['py39', 'py310', 'py311', 'py312', 'py313']
 
 [tool.mypy]
 check_untyped_defs = false
 disable_error_code = [
     'misc',
-    # tableauserverclient\server\endpoint\datasources_endpoint.py:48: error: Cannot assign multiple types to name "FilePath" without an explicit "Type[...]" annotation  [misc]
     'annotation-unchecked'  # can be removed when check_untyped_defs = true
 ]
-files = ["tableauserverclient", "test"]
+files = ["tableauserverclient", "test", "samples"]
 show_error_codes = true
 ignore_missing_imports = true  # defusedxml library has no types
 no_implicit_reexport = true
+implicit_optional = true
 
 [tool.pytest.ini_options]
 testpaths = ["test"]

{tableauserverclient-0.32 → tableauserverclient-0.34}/samples/add_default_permission.py

@@ -63,10 +63,10 @@ def main():
             for permission in new_default_permissions:
                 grantee = permission.grantee
                 capabilities = permission.capabilities
-                print("\nCapabilities for {0} {1}:".format(grantee.tag_name, grantee.id))
+                print(f"\nCapabilities for {grantee.tag_name} {grantee.id}:")
 
                 for capability in capabilities:
-                    print("\t{0} - {1}".format(capability, capabilities[capability]))
+                    print(f"\t{capability} - {capabilities[capability]}")
 
         # Uncomment lines below to DELETE the new capability and the new project
         # rules_to_delete = TSC.PermissionsRule(

{tableauserverclient-0.32 → tableauserverclient-0.34}/samples/create_group.py

@@ -11,7 +11,6 @@ import logging
 import os
 
 from datetime import time
-from typing import List
 
 import tableauserverclient as TSC
 from tableauserverclient import ServerResponseError
@@ -63,23 +62,23 @@ def main():
 
         if args.file:
             filepath = os.path.abspath(args.file)
-            print("Add users to site from file {}:".format(filepath))
-            added: List[TSC.UserItem]
-            failed: List[TSC.UserItem, TSC.ServerResponseError]
+            print(f"Add users to site from file {filepath}:")
+            added: list[TSC.UserItem]
+            failed: list[TSC.UserItem, TSC.ServerResponseError]
             added, failed = server.users.create_from_file(filepath)
             for user, error in failed:
                 print(user, error.code)
                 if error.code == "409017":
                     user = server.users.filter(name=user.name)[0]
                     added.append(user)
-            print("Adding users to group:{}".format(added))
+            print(f"Adding users to group:{added}")
             for user in added:
-                print("Adding user {}".format(user))
+                print(f"Adding user {user}")
                 try:
                     server.groups.add_user(group, user.id)
                 except ServerResponseError as serverError:
                     if serverError.code == "409011":
-                        print("user {} is already a member of group {}".format(user.name, group.name))
+                        print(f"user {user.name} is already a member of group {group.name}")
                     else:
                         raise rError
 

{tableauserverclient-0.32 → tableauserverclient-0.34}/samples/create_project.py

@@ -84,7 +84,7 @@ def main():
         server.projects.populate_datasource_default_permissions(changed_project),
         server.projects.populate_permissions(changed_project)
         # Projects have default permissions set for the object types they contain
-        print("Permissions from project {}:".format(changed_project.id))
+        print(f"Permissions from project {changed_project.id}:")
         print(changed_project.permissions)
         print(
             changed_project.default_workbook_permissions,

{tableauserverclient-0.32 → tableauserverclient-0.34}/samples/create_schedules.py

@@ -55,7 +55,7 @@ def main():
         )
         try:
             hourly_schedule = server.schedules.create(hourly_schedule)
-            print("Hourly schedule created (ID: {}).".format(hourly_schedule.id))
+            print(f"Hourly schedule created (ID: {hourly_schedule.id}).")
         except Exception as e:
             print(e)
 
@@ -71,7 +71,7 @@ def main():
         )
         try:
             daily_schedule = server.schedules.create(daily_schedule)
-            print("Daily schedule created (ID: {}).".format(daily_schedule.id))
+            print(f"Daily schedule created (ID: {daily_schedule.id}).")
         except Exception as e:
             print(e)
 
@@ -89,7 +89,7 @@ def main():
         )
         try:
             weekly_schedule = server.schedules.create(weekly_schedule)
-            print("Weekly schedule created (ID: {}).".format(weekly_schedule.id))
+            print(f"Weekly schedule created (ID: {weekly_schedule.id}).")
         except Exception as e:
             print(e)
             options = TSC.RequestOptions()
@@ -112,7 +112,7 @@ def main():
         )
         try:
             monthly_schedule = server.schedules.create(monthly_schedule)
-            print("Monthly schedule created (ID: {}).".format(monthly_schedule.id))
+            print(f"Monthly schedule created (ID: {monthly_schedule.id}).")
         except Exception as e:
             print(e)
 

{tableauserverclient-0.32 → tableauserverclient-0.34}/samples/explore_datasource.py

@@ -51,16 +51,17 @@ def main():
         if args.publish:
             if default_project is not None:
                 new_datasource = TSC.DatasourceItem(default_project.id)
+                new_datasource.description = "Published with a description"
                 new_datasource = server.datasources.publish(
                     new_datasource, args.publish, TSC.Server.PublishMode.Overwrite
                 )
-                print("Datasource published. ID: {}".format(new_datasource.id))
+                print(f"Datasource published. ID: {new_datasource.id}")
             else:
                 print("Publish failed. Could not find the default project.")
 
         # Gets all datasource items
         all_datasources, pagination_item = server.datasources.get()
-        print("\nThere are {} datasources on site: ".format(pagination_item.total_available))
+        print(f"\nThere are {pagination_item.total_available} datasources on site: ")
         print([datasource.name for datasource in all_datasources])
 
         if all_datasources:
@@ -69,20 +70,19 @@ def main():
 
             # Populate connections
             server.datasources.populate_connections(sample_datasource)
-            print("\nConnections for {}: ".format(sample_datasource.name))
-            print(
-                [
-                    "{0}({1})".format(connection.id, connection.datasource_name)
-                    for connection in sample_datasource.connections
-                ]
-            )
+            print(f"\nConnections for {sample_datasource.name}: ")
+            print([f"{connection.id}({connection.datasource_name})" for connection in sample_datasource.connections])
+
+            # Demonstrate that description is editable
+            sample_datasource.description = "Description updated by TSC"
+            server.datasources.update(sample_datasource)
 
             # Add some tags to the datasource
             original_tag_set = set(sample_datasource.tags)
             sample_datasource.tags.update("a", "b", "c", "d")
             server.datasources.update(sample_datasource)
-            print("\nOld tag set: {}".format(original_tag_set))
-            print("New tag set: {}".format(sample_datasource.tags))
+            print(f"\nOld tag set: {original_tag_set}")
+            print(f"New tag set: {sample_datasource.tags}")
 
             # Delete all tags that were added by setting tags to original
             sample_datasource.tags = original_tag_set

{tableauserverclient-0.32 → tableauserverclient-0.34}/samples/explore_favorites.py

@@ -3,7 +3,7 @@
 import argparse
 import logging
 import tableauserverclient as TSC
-from tableauserverclient import Resource
+from tableauserverclient.models import Resource
 
 
 def main():
@@ -39,15 +39,15 @@ def main():
         # get all favorites on site for the logged on user
         user: TSC.UserItem = TSC.UserItem()
         user.id = server.user_id
-        print("Favorites for user: {}".format(user.id))
+        print(f"Favorites for user: {user.id}")
         server.favorites.get(user)
         print(user.favorites)
 
         # get list of workbooks
         all_workbook_items, pagination_item = server.workbooks.get()
         if all_workbook_items is not None and len(all_workbook_items) > 0:
-            my_workbook: TSC.WorkbookItem = all_workbook_items[0]
-            server.favorites.add_favorite(server, user, Resource.Workbook.name(), all_workbook_items[0])
+            my_workbook = all_workbook_items[0]
+            server.favorites.add_favorite(user, Resource.Workbook, all_workbook_items[0])
             print(
                 "Workbook added to favorites. Workbook Name: {}, Workbook ID: {}".format(
                     my_workbook.name, my_workbook.id
@@ -57,7 +57,7 @@ def main():
             if views is not None and len(views) > 0:
                 my_view = views[0]
                 server.favorites.add_favorite_view(user, my_view)
-                print("View added to favorites. View Name: {}, View ID: {}".format(my_view.name, my_view.id))
+                print(f"View added to favorites. View Name: {my_view.name}, View ID: {my_view.id}")
 
         all_datasource_items, pagination_item = server.datasources.get()
         if all_datasource_items:
@@ -70,12 +70,10 @@ def main():
         )
 
     server.favorites.delete_favorite_workbook(user, my_workbook)
-    print(
-        "Workbook deleted from favorites. Workbook Name: {}, Workbook ID: {}".format(my_workbook.name, my_workbook.id)
-    )
+    print(f"Workbook deleted from favorites. Workbook Name: {my_workbook.name}, Workbook ID: {my_workbook.id}")
 
     server.favorites.delete_favorite_view(user, my_view)
-    print("View deleted from favorites. View Name: {}, View ID: {}".format(my_view.name, my_view.id))
+    print(f"View deleted from favorites. View Name: {my_view.name}, View ID: {my_view.id}")
 
     server.favorites.delete_favorite_datasource(user, my_datasource)
     print(

{tableauserverclient-0.32 → tableauserverclient-0.34}/samples/explore_site.py

@@ -49,7 +49,7 @@ def main():
 
         if args.delete:
             print("You can only delete the site you are currently in")
-            print("Delete site `{}`?".format(current_site.name))
+            print(f"Delete site `{current_site.name}`?")
             # server.sites.delete(server.site_id)
 
         elif args.create:

{tableauserverclient-0.32 → tableauserverclient-0.34}/samples/explore_webhooks.py

@@ -52,11 +52,11 @@ def main():
             new_webhook.event = "datasource-created"
             print(new_webhook)
             new_webhook = server.webhooks.create(new_webhook)
-            print("Webhook created. ID: {}".format(new_webhook.id))
+            print(f"Webhook created. ID: {new_webhook.id}")
 
         # Gets all webhook items
         all_webhooks, pagination_item = server.webhooks.get()
-        print("\nThere are {} webhooks on site: ".format(pagination_item.total_available))
+        print(f"\nThere are {pagination_item.total_available} webhooks on site: ")
         print([webhook.name for webhook in all_webhooks])
 
         if all_webhooks:

{tableauserverclient-0.32 → tableauserverclient-0.34}/samples/explore_workbook.py

@@ -59,13 +59,13 @@ def main():
             if default_project is not None:
                 new_workbook = TSC.WorkbookItem(default_project.id)
                 new_workbook = server.workbooks.publish(new_workbook, args.publish, overwrite_true)
-                print("Workbook published. ID: {}".format(new_workbook.id))
+                print(f"Workbook published. ID: {new_workbook.id}")
             else:
                 print("Publish failed. Could not find the default project.")
 
         # Gets all workbook items
         all_workbooks, pagination_item = server.workbooks.get()
-        print("\nThere are {} workbooks on site: ".format(pagination_item.total_available))
+        print(f"\nThere are {pagination_item.total_available} workbooks on site: ")
         print([workbook.name for workbook in all_workbooks])
 
         if all_workbooks:
@@ -78,27 +78,22 @@ def main():
 
             # Populate views
             server.workbooks.populate_views(sample_workbook)
-            print("\nName of views in {}: ".format(sample_workbook.name))
+            print(f"\nName of views in {sample_workbook.name}: ")
             print([view.name for view in sample_workbook.views])
 
             # Populate connections
             server.workbooks.populate_connections(sample_workbook)
-            print("\nConnections for {}: ".format(sample_workbook.name))
-            print(
-                [
-                    "{0}({1})".format(connection.id, connection.datasource_name)
-                    for connection in sample_workbook.connections
-                ]
-            )
+            print(f"\nConnections for {sample_workbook.name}: ")
+            print([f"{connection.id}({connection.datasource_name})" for connection in sample_workbook.connections])
 
             # Update tags and show_tabs flag
             original_tag_set = set(sample_workbook.tags)
             sample_workbook.tags.update("a", "b", "c", "d")
             sample_workbook.show_tabs = True
             server.workbooks.update(sample_workbook)
-            print("\nWorkbook's old tag set: {}".format(original_tag_set))
-            print("Workbook's new tag set: {}".format(sample_workbook.tags))
-            print("Workbook tabbed: {}".format(sample_workbook.show_tabs))
+            print(f"\nWorkbook's old tag set: {original_tag_set}")
+            print(f"Workbook's new tag set: {sample_workbook.tags}")
+            print(f"Workbook tabbed: {sample_workbook.show_tabs}")
 
             # Delete all tags that were added by setting tags to original
             sample_workbook.tags = original_tag_set
@@ -109,8 +104,8 @@ def main():
             original_tag_set = set(sample_view.tags)
             sample_view.tags.add("view_tag")
             server.views.update(sample_view)
-            print("\nView's old tag set: {}".format(original_tag_set))
-            print("View's new tag set: {}".format(sample_view.tags))
+            print(f"\nView's old tag set: {original_tag_set}")
+            print(f"View's new tag set: {sample_view.tags}")
 
             # Delete tag from just one view
             sample_view.tags = original_tag_set
@@ -119,14 +114,14 @@ def main():
             if args.download:
                 # Download
                 path = server.workbooks.download(sample_workbook.id, args.download)
-                print("\nDownloaded workbook to {}".format(path))
+                print(f"\nDownloaded workbook to {path}")
 
             if args.preview_image:
                 # Populate workbook preview image
                 server.workbooks.populate_preview_image(sample_workbook)
                 with open(args.preview_image, "wb") as f:
                     f.write(sample_workbook.preview_image)
-                print("\nDownloaded preview image of workbook to {}".format(os.path.abspath(args.preview_image)))
+                print(f"\nDownloaded preview image of workbook to {os.path.abspath(args.preview_image)}")
 
             # get custom views
             cvs, _ = server.custom_views.get()
@@ -153,10 +148,10 @@ def main():
                 server.workbooks.populate_powerpoint(sample_workbook)
                 with open(args.powerpoint, "wb") as f:
                     f.write(sample_workbook.powerpoint)
-                print("\nDownloaded powerpoint of workbook to {}".format(os.path.abspath(args.powerpoint)))
+                print(f"\nDownloaded powerpoint of workbook to {os.path.abspath(args.powerpoint)}")
 
             if args.delete:
-                print("deleting {}".format(c.id))
+                print(f"deleting {c.id}")
                 unlucky = TSC.CustomViewItem(c.id)
                 server.custom_views.delete(unlucky.id)
 

{tableauserverclient-0.32 → tableauserverclient-0.34}/samples/export.py

@@ -37,8 +37,11 @@ def main():
         "--csv", dest="type", action="store_const", const=("populate_csv", "CSVRequestOptions", "csv", "csv")
     )
     # other options shown in explore_workbooks: workbook.download, workbook.preview_image
-
+    parser.add_argument(
+        "--language", help="Text such as 'Average' will appear in this language. Use values like fr, de, es, en"
+    )
     parser.add_argument("--workbook", action="store_true")
+    parser.add_argument("--custom_view", action="store_true")
 
     parser.add_argument("--file", "-f", help="filename to store the exported data")
     parser.add_argument("--filter", "-vf", metavar="COLUMN:VALUE", help="View filter to apply to the view")
@@ -56,14 +59,16 @@ def main():
         print("Connected")
         if args.workbook:
             item = server.workbooks.get_by_id(args.resource_id)
+        elif args.custom_view:
+            item = server.custom_views.get_by_id(args.resource_id)
         else:
             item = server.views.get_by_id(args.resource_id)
 
         if not item:
-            print("No item found for id {}".format(args.resource_id))
+            print(f"No item found for id {args.resource_id}")
             exit(1)
 
-        print("Item found: {}".format(item.name))
+        print(f"Item found: {item.name}")
         # We have a number of different types and functions for each different export type.
         # We encode that information above in the const=(...) parameter to the add_argument function to make
         # the code automatically adapt for the type of export the user is doing.
@@ -72,18 +77,22 @@ def main():
         populate = getattr(server.views, populate_func_name)
         if args.workbook:
             populate = getattr(server.workbooks, populate_func_name)
+        elif args.custom_view:
+            populate = getattr(server.custom_views, populate_func_name)
 
         option_factory = getattr(TSC, option_factory_name)
+        options: TSC.PDFRequestOptions = option_factory()
 
         if args.filter:
-            options = option_factory().vf(*args.filter.split(":"))
-        else:
-            options = None
+            options = options.vf(*args.filter.split(":"))
+
+        if args.language:
+            options.language = args.language
 
         if args.file:
             filename = args.file
         else:
-            filename = "out.{}".format(extension)
+            filename = f"out-{options.language}.{extension}"
 
         populate(item, options)
         with open(filename, "wb") as f:

{tableauserverclient-0.32 → tableauserverclient-0.34}/samples/extracts.py

@@ -1,13 +1,7 @@
 ####
-# This script demonstrates how to use the Tableau Server Client
-# to interact with workbooks. It explores the different
-# functions that the Server API supports on workbooks.
-#
-# With no flags set, this sample will query all workbooks,
-# pick one workbook and populate its connections/views, and update
-# the workbook. Adding flags will demonstrate the specific feature
-# on top of the general operations.
-####
+# This script demonstrates how to use the Tableau Server Client to interact with extracts.
+# It explores the different functions that the REST API supports on extracts.
+#####
 
 import argparse
 import logging
@@ -47,7 +41,7 @@ def main():
     with server.auth.sign_in(tableau_auth):
         # Gets all workbook items
         all_workbooks, pagination_item = server.workbooks.get()
-        print("\nThere are {} workbooks on site: ".format(pagination_item.total_available))
+        print(f"\nThere are {pagination_item.total_available} workbooks on site: ")
         print([workbook.name for workbook in all_workbooks])
 
         if all_workbooks: