tableauserverclient 0.32__tar.gz → 0.33__tar.gz

tableauserverclient-0.33/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.33}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: tableauserverclient
-Version: 0.32
+Version: 0.33
 Summary: A Python module for working with the Tableau Server REST API.
 Author-email: Tableau <github@tableau.com>
 License: The MIT License (MIT)
@@ -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.33}/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.33/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.33}/tableauserverclient/__init__.py

@@ -17,10 +17,14 @@ from tableauserverclient.models import (
     FlowRunItem,
     FileuploadItem,
     GroupItem,
+    GroupSetItem,
     HourlyInterval,
     IntervalItem,
     JobItem,
     JWTAuth,
+    LinkedTaskItem,
+    LinkedTaskStepItem,
+    LinkedTaskFlowRunItem,
     MetricItem,
     MonthlyInterval,
     PaginationItem,
@@ -39,6 +43,7 @@ from tableauserverclient.models import (
     TaskItem,
     UserItem,
     ViewItem,
+    VirtualConnectionItem,
     WebhookItem,
     WeeklyInterval,
     WorkbookItem,
@@ -79,6 +84,7 @@ __all__ = [
     "FlowRunItem",
     "FileuploadItem",
     "GroupItem",
+    "GroupSetItem",
     "HourlyInterval",
     "IntervalItem",
     "JobItem",
@@ -116,4 +122,8 @@ __all__ = [
     "Pager",
     "Server",
     "Sort",
+    "LinkedTaskItem",
+    "LinkedTaskStepItem",
+    "LinkedTaskFlowRunItem",
+    "VirtualConnectionItem",
 ]

{tableauserverclient-0.32 → tableauserverclient-0.33}/tableauserverclient/_version.py

@@ -8,11 +8,11 @@ import json
 
 version_json = '''
 {
- "date": "2024-07-27T15:44:04-0700",
+ "date": "2024-09-17T16:51:07-0700",
  "dirty": false,
  "error": null,
- "full-revisionid": "257cf616f35cc36b24a73e9e102886a52ead1853",
- "version": "0.32"
+ "full-revisionid": "4259316ef2e2656531b0c65c71d043708b37b4a9",
+ "version": "0.33"
 }
 '''  # END VERSION_JSON
 

tableauserverclient-0.33/tableauserverclient/config.py

@@ -0,0 +1,25 @@
+import os
+
+ALLOWED_FILE_EXTENSIONS = ["tds", "tdsx", "tde", "hyper", "parquet"]
+
+BYTES_PER_MB = 1024 * 1024
+
+DELAY_SLEEP_SECONDS = 0.1
+
+# The maximum size of a file that can be published in a single request is 64MB
+FILESIZE_LIMIT_MB = 64
+
+
+class Config:
+    # For when a datasource is over 64MB, break it into 5MB(standard chunk size) chunks
+    @property
+    def CHUNK_SIZE_MB(self):
+        return int(os.getenv("TSC_CHUNK_SIZE_MB", 5 * 10))  # 5MB felt too slow, upped it to 50
+
+    # Default page size
+    @property
+    def PAGE_SIZE(self):
+        return int(os.getenv("TSC_PAGE_SIZE", 100))
+
+
+config = Config()

{tableauserverclient-0.32 → tableauserverclient-0.33}/tableauserverclient/models/__init__.py

@@ -14,6 +14,7 @@ from tableauserverclient.models.fileupload_item import FileuploadItem
 from tableauserverclient.models.flow_item import FlowItem
 from tableauserverclient.models.flow_run_item import FlowRunItem
 from tableauserverclient.models.group_item import GroupItem
+from tableauserverclient.models.groupset_item import GroupSetItem
 from tableauserverclient.models.interval_item import (
     IntervalItem,
     DailyInterval,
@@ -22,6 +23,11 @@ from tableauserverclient.models.interval_item import (
     HourlyInterval,
 )
 from tableauserverclient.models.job_item import JobItem, BackgroundJobItem
+from tableauserverclient.models.linked_tasks_item import (
+    LinkedTaskItem,
+    LinkedTaskStepItem,
+    LinkedTaskFlowRunItem,
+)
 from tableauserverclient.models.metric_item import MetricItem
 from tableauserverclient.models.pagination_item import PaginationItem
 from tableauserverclient.models.permissions_item import PermissionsRule, Permission
@@ -39,6 +45,7 @@ from tableauserverclient.models.target import Target
 from tableauserverclient.models.task_item import TaskItem
 from tableauserverclient.models.user_item import UserItem
 from tableauserverclient.models.view_item import ViewItem
+from tableauserverclient.models.virtual_connection_item import VirtualConnectionItem
 from tableauserverclient.models.webhook_item import WebhookItem
 from tableauserverclient.models.workbook_item import WorkbookItem
 
@@ -60,6 +67,7 @@ __all__ = [
     "FlowItem",
     "FlowRunItem",
     "GroupItem",
+    "GroupSetItem",
     "IntervalItem",
     "JobItem",
     "DailyInterval",
@@ -89,6 +97,10 @@ __all__ = [
     "TaskItem",
     "UserItem",
     "ViewItem",
+    "VirtualConnectionItem",
     "WebhookItem",
     "WorkbookItem",
+    "LinkedTaskItem",
+    "LinkedTaskStepItem",
+    "LinkedTaskFlowRunItem",
 ]

{tableauserverclient-0.32 → tableauserverclient-0.33}/tableauserverclient/models/connection_item.py

@@ -66,12 +66,14 @@ class ConnectionItem(object):
         for connection_xml in all_connection_xml:
             connection_item = cls()
             connection_item._id = connection_xml.get("id", None)
-            connection_item._connection_type = connection_xml.get("type", None)
+            connection_item._connection_type = connection_xml.get("type", connection_xml.get("dbClass", None))
             connection_item.embed_password = string_to_bool(connection_xml.get("embedPassword", ""))
             connection_item.server_address = connection_xml.get("serverAddress", None)
             connection_item.server_port = connection_xml.get("serverPort", None)
             connection_item.username = connection_xml.get("userName", None)
-            connection_item._query_tagging = string_to_bool(connection_xml.get("queryTaggingEnabled", None))
+            connection_item._query_tagging = (
+                string_to_bool(s) if (s := connection_xml.get("queryTagging", None)) else None
+            )
             datasource_elem = connection_xml.find(".//t:datasource", namespaces=ns)
             if datasource_elem is not None:
                 connection_item._datasource_id = datasource_elem.get("id", None)

{tableauserverclient-0.32 → tableauserverclient-0.33}/tableauserverclient/models/database_item.py

@@ -44,6 +44,12 @@ class DatabaseItem(object):
 
         self._tables = None  # Not implemented yet
 
+    def __str__(self):
+        return "<Database {0} '{1}'>".format(self._id, self.name)
+
+    def __repr__(self):
+        return self.__str__() + "  { " + ", ".join(" % s: % s" % item for item in vars(self).items()) + "}"
+
     @property
     def dqws(self):
         if self._data_quality_warnings is None:

{tableauserverclient-0.32 → tableauserverclient-0.33}/tableauserverclient/models/flow_item.py

@@ -6,12 +6,12 @@ from typing import List, Optional, Set
 from defusedxml.ElementTree import fromstring
 
 from tableauserverclient.datetime_helpers import parse_datetime
-from .connection_item import ConnectionItem
-from .dqw_item import DQWItem
-from .exceptions import UnpopulatedPropertyError
-from .permissions_item import Permission
-from .property_decorators import property_not_nullable
-from .tag_item import TagItem
+from tableauserverclient.models.connection_item import ConnectionItem
+from tableauserverclient.models.dqw_item import DQWItem
+from tableauserverclient.models.exceptions import UnpopulatedPropertyError
+from tableauserverclient.models.permissions_item import Permission
+from tableauserverclient.models.property_decorators import property_not_nullable
+from tableauserverclient.models.tag_item import TagItem
 
 
 class FlowItem(object):

tableauserverclient-0.33/tableauserverclient/models/groupset_item.py

@@ -0,0 +1,53 @@
+from typing import Dict, List, Optional
+import xml.etree.ElementTree as ET
+
+from defusedxml.ElementTree import fromstring
+
+from tableauserverclient.models.group_item import GroupItem
+from tableauserverclient.models.reference_item import ResourceReference
+
+
+class GroupSetItem:
+    tag_name: str = "groupSet"
+
+    def __init__(self, name: Optional[str] = None) -> None:
+        self.name = name
+        self.id: Optional[str] = None
+        self.groups: List["GroupItem"] = []
+        self.group_count: int = 0
+
+    def __str__(self) -> str:
+        name = self.name
+        id = self.id
+        return f"<{self.__class__.__qualname__}({name=}, {id=})>"
+
+    def __repr__(self) -> str:
+        return self.__str__()
+
+    @classmethod
+    def from_response(cls, response: bytes, ns: Dict[str, str]) -> List["GroupSetItem"]:
+        parsed_response = fromstring(response)
+        all_groupset_xml = parsed_response.findall(".//t:groupSet", namespaces=ns)
+        return [cls.from_xml(xml, ns) for xml in all_groupset_xml]
+
+    @classmethod
+    def from_xml(cls, groupset_xml: ET.Element, ns: Dict[str, str]) -> "GroupSetItem":
+        def get_group(group_xml: ET.Element) -> GroupItem:
+            group_item = GroupItem()
+            group_item._id = group_xml.get("id")
+            group_item.name = group_xml.get("name")
+            return group_item
+
+        group_set_item = cls()
+        group_set_item.name = groupset_xml.get("name")
+        group_set_item.id = groupset_xml.get("id")
+        group_set_item.group_count = int(count) if (count := groupset_xml.get("groupCount")) else 0
+        group_set_item.groups = [
+            get_group(group_xml) for group_xml in groupset_xml.findall(".//t:group", namespaces=ns)
+        ]
+
+        return group_set_item
+
+    @staticmethod
+    def as_reference(id_: str) -> ResourceReference:
+        return ResourceReference(id_, GroupSetItem.tag_name)

{tableauserverclient-0.32 → tableauserverclient-0.33}/tableauserverclient/models/interval_item.py

@@ -246,21 +246,34 @@ class MonthlyInterval(object):
 
     @interval.setter
     def interval(self, interval_values):
-        # This is weird because the value could be a str or an int
-        # The only valid str is 'LastDay' so we check that first. If that's not it
-        # try to convert it to an int, if that fails because it's an incorrect string
-        # like 'badstring' we catch and re-raise. Otherwise we convert to int and check
-        # that it's in range 1-31
+        # Valid monthly intervals strings can contain any of the following
+        #   day numbers (1-31) (integer or string)
+        #   relative day within the month (First, Second, ... Last)
+        #   week days (Sunday, Monday, ... LastDay)
+        VALID_INTERVALS = [
+            "Sunday",
+            "Monday",
+            "Tuesday",
+            "Wednesday",
+            "Thursday",
+            "Friday",
+            "Saturday",
+            "LastDay",
+            "First",
+            "Second",
+            "Third",
+            "Fourth",
+            "Fifth",
+            "Last",
+        ]
+        for value in range(1, 32):
+            VALID_INTERVALS.append(str(value))
+            VALID_INTERVALS.append(value)
+
         for interval_value in interval_values:
-            error = "Invalid interval value for a monthly frequency: {}.".format(interval_value)
-
-            if interval_value != "LastDay":
-                try:
-                    if not (1 <= int(interval_value) <= 31):
-                        raise ValueError(error)
-                except ValueError:
-                    if interval_value != "LastDay":
-                        raise ValueError(error)
+            if interval_value not in VALID_INTERVALS:
+                error = f"Invalid monthly interval: {interval_value}"
+                raise ValueError(error)
 
         self._interval = interval_values
 

{tableauserverclient-0.32 → tableauserverclient-0.33}/tableauserverclient/models/job_item.py

@@ -4,7 +4,7 @@ from typing import List, Optional
 from defusedxml.ElementTree import fromstring
 
 from tableauserverclient.datetime_helpers import parse_datetime
-from .flow_run_item import FlowRunItem
+from tableauserverclient.models.flow_run_item import FlowRunItem
 
 
 class JobItem(object):
@@ -33,6 +33,8 @@ class JobItem(object):
         datasource_id: Optional[str] = None,
         flow_run: Optional[FlowRunItem] = None,
         updated_at: Optional[datetime.datetime] = None,
+        workbook_name: Optional[str] = None,
+        datasource_name: Optional[str] = None,
     ):
         self._id = id_
         self._type = job_type
@@ -47,6 +49,8 @@ class JobItem(object):
         self._datasource_id = datasource_id
         self._flow_run = flow_run
         self._updated_at = updated_at
+        self._workbook_name = workbook_name
+        self._datasource_name = datasource_name
 
     @property
     def id(self) -> str:
@@ -117,6 +121,14 @@ class JobItem(object):
     def updated_at(self) -> Optional[datetime.datetime]:
         return self._updated_at
 
+    @property
+    def workbook_name(self) -> Optional[str]:
+        return self._workbook_name
+
+    @property
+    def datasource_name(self) -> Optional[str]:
+        return self._datasource_name
+
     def __str__(self):
         return (
             "<Job#{_id} {_type} created_at({_created_at}) started_at({_started_at}) updated_at({_updated_at}) completed_at({_completed_at})"
@@ -148,8 +160,10 @@ class JobItem(object):
         mode = element.get("mode", None)
         workbook = element.find(".//t:workbook[@id]", namespaces=ns)
         workbook_id = workbook.get("id") if workbook is not None else None
+        workbook_name = workbook.get("name") if workbook is not None else None
         datasource = element.find(".//t:datasource[@id]", namespaces=ns)
         datasource_id = datasource.get("id") if datasource is not None else None
+        datasource_name = datasource.get("name") if datasource is not None else None
         flow_run = None
         updated_at = parse_datetime(element.get("updatedAt", None))
         for flow_job in element.findall(".//t:runFlowJobType", namespaces=ns):
@@ -172,6 +186,8 @@ class JobItem(object):
             datasource_id,
             flow_run,
             updated_at,
+            workbook_name,
+            datasource_name,
         )
 
 
@@ -206,7 +222,7 @@ class BackgroundJobItem(object):
         self._subtitle = subtitle
 
     def __str__(self):
-        return f"<{self.__class__.name} {self._id} {self._type}>"
+        return f"<{self.__class__.__qualname__} {self._id} {self._type}>"
 
     def __repr__(self):
         return self.__str__() + "  { " + ", ".join(" % s: % s" % item for item in vars(self).items()) + "}"

tableauserverclient-0.33/tableauserverclient/models/linked_tasks_item.py

@@ -0,0 +1,102 @@
+import datetime as dt
+from typing import List, Optional
+
+from defusedxml.ElementTree import fromstring
+
+from tableauserverclient.datetime_helpers import parse_datetime
+from tableauserverclient.models.schedule_item import ScheduleItem
+
+
+class LinkedTaskItem:
+    def __init__(self) -> None:
+        self.id: Optional[str] = None
+        self.num_steps: Optional[int] = None
+        self.schedule: Optional[ScheduleItem] = None
+
+    @classmethod
+    def from_response(cls, resp: bytes, namespace) -> List["LinkedTaskItem"]:
+        parsed_response = fromstring(resp)
+        return [
+            cls._parse_element(x, namespace)
+            for x in parsed_response.findall(".//t:linkedTasks[@id]", namespaces=namespace)
+        ]
+
+    @classmethod
+    def _parse_element(cls, xml, namespace) -> "LinkedTaskItem":
+        task = cls()
+        task.id = xml.get("id")
+        task.num_steps = int(xml.get("numSteps"))
+        task.schedule = ScheduleItem.from_element(xml, namespace)[0]
+        return task
+
+
+class LinkedTaskStepItem:
+    def __init__(self) -> None:
+        self.id: Optional[str] = None
+        self.step_number: Optional[int] = None
+        self.stop_downstream_on_failure: Optional[bool] = None
+        self.task_details: List[LinkedTaskFlowRunItem] = []
+
+    @classmethod
+    def from_task_xml(cls, xml, namespace) -> List["LinkedTaskStepItem"]:
+        return [cls._parse_element(x, namespace) for x in xml.findall(".//t:linkedTaskSteps[@id]", namespace)]
+
+    @classmethod
+    def _parse_element(cls, xml, namespace) -> "LinkedTaskStepItem":
+        step = cls()
+        step.id = xml.get("id")
+        step.step_number = int(xml.get("stepNumber"))
+        step.stop_downstream_on_failure = string_to_bool(xml.get("stopDownstreamTasksOnFailure"))
+        step.task_details = LinkedTaskFlowRunItem._parse_element(xml, namespace)
+        return step
+
+
+class LinkedTaskFlowRunItem:
+    def __init__(self) -> None:
+        self.flow_run_id: Optional[str] = None
+        self.flow_run_priority: Optional[int] = None
+        self.flow_run_consecutive_failed_count: Optional[int] = None
+        self.flow_run_task_type: Optional[str] = None
+        self.flow_id: Optional[str] = None
+        self.flow_name: Optional[str] = None
+
+    @classmethod
+    def _parse_element(cls, xml, namespace) -> List["LinkedTaskFlowRunItem"]:
+        all_tasks = []
+        for flow_run in xml.findall(".//t:flowRun[@id]", namespace):
+            task = cls()
+            task.flow_run_id = flow_run.get("id")
+            task.flow_run_priority = int(flow_run.get("priority"))
+            task.flow_run_consecutive_failed_count = int(flow_run.get("consecutiveFailedCount"))
+            task.flow_run_task_type = flow_run.get("type")
+            flow = flow_run.find(".//t:flow[@id]", namespace)
+            task.flow_id = flow.get("id")
+            task.flow_name = flow.get("name")
+            all_tasks.append(task)
+
+        return all_tasks
+
+
+class LinkedTaskJobItem:
+    def __init__(self) -> None:
+        self.id: Optional[str] = None
+        self.linked_task_id: Optional[str] = None
+        self.status: Optional[str] = None
+        self.created_at: Optional[dt.datetime] = None
+
+    @classmethod
+    def from_response(cls, resp: bytes, namespace) -> "LinkedTaskJobItem":
+        parsed_response = fromstring(resp)
+        job = cls()
+        job_xml = parsed_response.find(".//t:linkedTaskJob[@id]", namespaces=namespace)
+        if job_xml is None:
+            raise ValueError("No linked task job found in response")
+        job.id = job_xml.get("id")
+        job.linked_task_id = job_xml.get("linkedTaskId")
+        job.status = job_xml.get("status")
+        job.created_at = parse_datetime(job_xml.get("createdAt"))
+        return job
+
+
+def string_to_bool(s: str) -> bool:
+    return s.lower() == "true"

{tableauserverclient-0.32 → tableauserverclient-0.33}/tableauserverclient/models/permissions_item.py

@@ -3,10 +3,11 @@ from typing import Dict, List, Optional
 
 from defusedxml.ElementTree import fromstring
 
-from .exceptions import UnknownGranteeTypeError, UnpopulatedPropertyError
-from .group_item import GroupItem
-from .reference_item import ResourceReference
-from .user_item import UserItem
+from tableauserverclient.models.exceptions import UnknownGranteeTypeError, UnpopulatedPropertyError
+from tableauserverclient.models.group_item import GroupItem
+from tableauserverclient.models.groupset_item import GroupSetItem
+from tableauserverclient.models.reference_item import ResourceReference
+from tableauserverclient.models.user_item import UserItem
 
 from tableauserverclient.helpers.logging import logger
 
@@ -142,6 +143,8 @@ class PermissionsRule:
             grantee = UserItem.as_reference(grantee_id)
         elif grantee_type == "group":
             grantee = GroupItem.as_reference(grantee_id)
+        elif grantee_type == "groupSet":
+            grantee = GroupSetItem.as_reference(grantee_id)
         else:
             raise UnknownGranteeTypeError("No support for grantee type of {}".format(grantee_type))