tableauserverclient 0.38__py3-none-any.whl → 0.40__py3-none-any.whl

_version.py

@@ -0,0 +1,21 @@
+
+# This file was generated by 'versioneer.py' (0.29) from
+# revision-control system data, or from the parent directory name of an
+# unpacked source archive. Distribution tarballs contain a pre-generated copy
+# of this file.
+
+import json
+
+version_json = '''
+{
+ "date": "2026-02-03T12:18:13-0800",
+ "dirty": false,
+ "error": null,
+ "full-revisionid": "d4b27f42d897883f8b8d0cb5b7edb558df2cbfb6",
+ "version": "0.40"
+}
+'''  # END VERSION_JSON
+
+
+def get_versions():
+    return json.loads(version_json)

tableauserverclient/__init__.py

@@ -2,6 +2,7 @@ from tableauserverclient.bin._version import get_versions
 from tableauserverclient.namespace import NEW_NAMESPACE as DEFAULT_NAMESPACE
 from tableauserverclient.models import (
     BackgroundJobItem,
+    CollectionItem,
     ColumnItem,
     ConnectionCredentials,
     ConnectionItem,
@@ -12,6 +13,8 @@ from tableauserverclient.models import (
     DatabaseItem,
     DataFreshnessPolicyItem,
     DatasourceItem,
+    ExtensionsServer,
+    ExtensionsSiteSettings,
     FavoriteItem,
     FlowItem,
     FlowRunItem,
@@ -35,8 +38,10 @@ from tableauserverclient.models import (
     ProjectItem,
     Resource,
     RevisionItem,
+    SafeExtension,
     ScheduleItem,
     SiteAuthConfiguration,
+    SiteOIDCConfiguration,
     SiteItem,
     ServerInfoItem,
     SubscriptionItem,
@@ -72,7 +77,7 @@ from tableauserverclient.server import (
 
 __all__ = [
     "BackgroundJobItem",
-    "BackgroundJobItem",
+    "CollectionItem",
     "ColumnItem",
     "ConnectionCredentials",
     "ConnectionItem",
@@ -86,6 +91,8 @@ __all__ = [
     "DEFAULT_NAMESPACE",
     "DQWItem",
     "ExcelRequestOptions",
+    "ExtensionsServer",
+    "ExtensionsSiteSettings",
     "FailedSignInError",
     "FavoriteItem",
     "FileuploadItem",
@@ -119,12 +126,14 @@ __all__ = [
     "RequestOptions",
     "Resource",
     "RevisionItem",
+    "SafeExtension",
     "ScheduleItem",
     "Server",
     "ServerInfoItem",
     "ServerResponseError",
     "SiteItem",
     "SiteAuthConfiguration",
+    "SiteOIDCConfiguration",
     "Sort",
     "SubscriptionItem",
     "TableauAuth",
@@ -139,7 +148,3 @@ __all__ = [
     "WeeklyInterval",
     "WorkbookItem",
 ]
-
-from .bin import _version
-
-__version__ = _version.get_versions()["version"]

tableauserverclient/bin/__init__.py

@@ -0,0 +1,3 @@
+# generated during initial setup of versioneer
+from . import _version
+__version__ = _version.get_versions()['version']

tableauserverclient/bin/_version.py

@@ -8,11 +8,11 @@ import json
 
 version_json = '''
 {
- "date": "2025-05-15T14:21:50-0700",
+ "date": "2026-02-03T12:18:13-0800",
  "dirty": false,
  "error": null,
- "full-revisionid": "cda018b684c98200f3f9de11e379ba2ca3b1b3fe",
- "version": "0.38"
+ "full-revisionid": "d4b27f42d897883f8b8d0cb5b7edb558df2cbfb6",
+ "version": "0.40"
 }
 '''  # END VERSION_JSON
 

tableauserverclient/models/__init__.py

@@ -1,3 +1,4 @@
+from tableauserverclient.models.collection_item import CollectionItem
 from tableauserverclient.models.column_item import ColumnItem
 from tableauserverclient.models.connection_credentials import ConnectionCredentials
 from tableauserverclient.models.connection_item import ConnectionItem
@@ -9,6 +10,7 @@ from tableauserverclient.models.data_freshness_policy_item import DataFreshnessP
 from tableauserverclient.models.datasource_item import DatasourceItem
 from tableauserverclient.models.dqw_item import DQWItem
 from tableauserverclient.models.exceptions import UnpopulatedPropertyError
+from tableauserverclient.models.extensions_item import ExtensionsServer, ExtensionsSiteSettings, SafeExtension
 from tableauserverclient.models.favorites_item import FavoriteItem
 from tableauserverclient.models.fileupload_item import FileuploadItem
 from tableauserverclient.models.flow_item import FlowItem
@@ -30,6 +32,7 @@ from tableauserverclient.models.linked_tasks_item import (
 )
 from tableauserverclient.models.location_item import LocationItem
 from tableauserverclient.models.metric_item import MetricItem
+from tableauserverclient.models.oidc_item import SiteOIDCConfiguration
 from tableauserverclient.models.pagination_item import PaginationItem
 from tableauserverclient.models.permissions_item import PermissionsRule, Permission
 from tableauserverclient.models.project_item import ProjectItem
@@ -52,6 +55,7 @@ from tableauserverclient.models.workbook_item import WorkbookItem
 from tableauserverclient.models.extract_item import ExtractItem
 
 __all__ = [
+    "CollectionItem",
     "ColumnItem",
     "ConnectionCredentials",
     "ConnectionItem",
@@ -79,6 +83,7 @@ __all__ = [
     "BackgroundJobItem",
     "LocationItem",
     "MetricItem",
+    "SiteOIDCConfiguration",
     "PaginationItem",
     "Permission",
     "PermissionsRule",
@@ -88,6 +93,7 @@ __all__ = [
     "ServerInfoItem",
     "SiteAuthConfiguration",
     "SiteItem",
+    "SiteOIDCConfiguration",
     "SubscriptionItem",
     "TableItem",
     "TableauAuth",
@@ -108,4 +114,7 @@ __all__ = [
     "LinkedTaskStepItem",
     "LinkedTaskFlowRunItem",
     "ExtractItem",
+    "ExtensionsServer",
+    "ExtensionsSiteSettings",
+    "SafeExtension",
 ]

tableauserverclient/models/collection_item.py

@@ -0,0 +1,52 @@
+from datetime import datetime
+from typing import Optional
+from xml.etree.ElementTree import Element
+
+from defusedxml.ElementTree import fromstring
+from typing_extensions import Self
+
+from tableauserverclient.datetime_helpers import parse_datetime
+from tableauserverclient.models.user_item import UserItem
+
+
+class CollectionItem:
+    def __init__(self) -> None:
+        self.id: Optional[str] = None
+        self.name: Optional[str] = None
+        self.description: Optional[str] = None
+        self.created_at: Optional[datetime] = None
+        self.updated_at: Optional[datetime] = None
+        self.owner: Optional[UserItem] = None
+        self.total_item_count: Optional[int] = None
+        self.permissioned_item_count: Optional[int] = None
+        self.visibility: Optional[str] = None  # Assuming visibility is a string, adjust as necessary
+
+    @classmethod
+    def from_response(cls, response: bytes, ns) -> list[Self]:
+        parsed_response = fromstring(response)
+
+        collection_elements = parsed_response.findall(".//t:collection", namespaces=ns)
+        if not collection_elements:
+            raise ValueError("No collection element found in the response")
+
+        collections = [cls.from_xml(c, ns) for c in collection_elements]
+        return collections
+
+    @classmethod
+    def from_xml(cls, xml: Element, ns) -> Self:
+        collection_item = cls()
+        collection_item.id = xml.get("id")
+        collection_item.name = xml.get("name")
+        collection_item.description = xml.get("description")
+        collection_item.created_at = parse_datetime(xml.get("createdAt"))
+        collection_item.updated_at = parse_datetime(xml.get("updatedAt"))
+        owner_element = xml.find(".//t:owner", namespaces=ns)
+        if owner_element is not None:
+            collection_item.owner = UserItem.from_xml(owner_element, ns)
+        else:
+            collection_item.owner = None
+        collection_item.total_item_count = int(xml.get("totalItemCount", 0))
+        collection_item.permissioned_item_count = int(xml.get("permissionedItemCount", 0))
+        collection_item.visibility = xml.get("visibility")
+
+        return collection_item

tableauserverclient/models/connection_item.py

@@ -41,6 +41,9 @@ class ConnectionItem:
     server_port: str
         The port used for the connection.
 
+    auth_type: str
+        Specifies the type of authentication used by the connection.
+
     connection_credentials: ConnectionCredentials
         The Connection Credentials object containing authentication details for
         the connection. Replaces username/password/embed_password when
@@ -59,6 +62,7 @@ class ConnectionItem:
         self.username: Optional[str] = None
         self.connection_credentials: Optional[ConnectionCredentials] = None
         self._query_tagging: Optional[bool] = None
+        self._auth_type: Optional[str] = None
 
     @property
     def datasource_id(self) -> Optional[str]:
@@ -91,8 +95,16 @@ class ConnectionItem:
             return
         self._query_tagging = value
 
+    @property
+    def auth_type(self) -> Optional[str]:
+        return self._auth_type
+
+    @auth_type.setter
+    def auth_type(self, value: Optional[str]):
+        self._auth_type = value
+
     def __repr__(self):
-        return "<ConnectionItem#{_id} embed={embed_password} type={_connection_type} username={username}>".format(
+        return "<ConnectionItem#{_id} embed={embed_password} type={_connection_type} auth={_auth_type} username={username}>".format(
             **self.__dict__
         )
 
@@ -108,10 +120,11 @@ class ConnectionItem:
             connection_item.embed_password = string_to_bool(connection_xml.get("embedPassword", ""))
             connection_item.server_address = connection_xml.get("serverAddress", connection_xml.get("server", None))
             connection_item.server_port = connection_xml.get("serverPort", connection_xml.get("port", None))
-            connection_item.username = connection_xml.get("userName", None)
+            connection_item.username = connection_xml.get("userName", connection_xml.get("username", None))
             connection_item._query_tagging = (
                 string_to_bool(s) if (s := connection_xml.get("queryTagging", None)) else None
             )
+            connection_item._auth_type = connection_xml.get("authenticationType", 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)
@@ -139,6 +152,7 @@ class ConnectionItem:
 
             connection_item.server_address = connection_xml.get("serverAddress", None)
             connection_item.server_port = connection_xml.get("serverPort", None)
+            connection_item._auth_type = connection_xml.get("authenticationType", None)
 
             connection_credentials = connection_xml.find(".//t:connectionCredentials", namespaces=ns)
 

tableauserverclient/models/custom_view_item.py

@@ -158,10 +158,18 @@ class CustomViewItem:
     def workbook(self) -> Optional[WorkbookItem]:
         return self._workbook
 
+    @workbook.setter
+    def workbook(self, value: WorkbookItem) -> None:
+        self._workbook = value
+
     @property
     def view(self) -> Optional[ViewItem]:
         return self._view
 
+    @view.setter
+    def view(self, value: ViewItem) -> None:
+        self._view = value
+
     @classmethod
     def from_response(cls, resp, ns, workbook_id="") -> Optional["CustomViewItem"]:
         item = cls.list_from_response(resp, ns, workbook_id)

tableauserverclient/models/data_freshness_policy_item.py

@@ -66,7 +66,7 @@ class DataFreshnessPolicyItem:
             return self._interval_item
 
         @interval_item.setter
-        def interval_item(self, value: list[str]):
+        def interval_item(self, value: Optional[list[str]]):
             self._interval_item = value
 
         @property
@@ -127,7 +127,7 @@ class DataFreshnessPolicyItem:
         return self._fresh_every_schedule
 
     @fresh_every_schedule.setter
-    def fresh_every_schedule(self, value: FreshEvery):
+    def fresh_every_schedule(self, value: Optional[FreshEvery]):
         self._fresh_every_schedule = value
 
     @property
@@ -135,7 +135,7 @@ class DataFreshnessPolicyItem:
         return self._fresh_at_schedule
 
     @fresh_at_schedule.setter
-    def fresh_at_schedule(self, value: FreshAt):
+    def fresh_at_schedule(self, value: Optional[FreshAt]):
         self._fresh_at_schedule = value
 
     @classmethod

tableauserverclient/models/datasource_item.py

@@ -490,7 +490,7 @@ class DatasourceItem:
             self._owner = owner
 
     @classmethod
-    def from_response(cls, resp: str, ns: dict) -> list["DatasourceItem"]:
+    def from_response(cls, resp: bytes, ns: dict) -> list["DatasourceItem"]:
         all_datasource_items = list()
         parsed_response = fromstring(resp)
         all_datasource_xml = parsed_response.findall(".//t:datasource", namespaces=ns)
@@ -535,6 +535,7 @@ class DatasourceItem:
 
         project_id = None
         project_name = None
+        project = None
         project_elem = datasource_xml.find(".//t:project", namespaces=ns)
         if project_elem is not None:
             project = ProjectItem.from_xml(project_elem, ns)
@@ -542,6 +543,7 @@ class DatasourceItem:
             project_name = project_elem.get("name", None)
 
         owner_id = None
+        owner = None
         owner_elem = datasource_xml.find(".//t:owner", namespaces=ns)
         if owner_elem is not None:
             owner = UserItem.from_xml(owner_elem, ns)

tableauserverclient/models/extensions_item.py

@@ -0,0 +1,186 @@
+from typing import overload
+from typing_extensions import Self
+
+from defusedxml.ElementTree import fromstring
+
+from tableauserverclient.models.property_decorators import property_is_boolean
+
+
+class ExtensionsServer:
+    def __init__(self) -> None:
+        self._enabled: bool | None = None
+        self._block_list: list[str] | None = None
+
+    @property
+    def enabled(self) -> bool | None:
+        """Indicates whether the extensions server is enabled."""
+        return self._enabled
+
+    @enabled.setter
+    @property_is_boolean
+    def enabled(self, value: bool | None) -> None:
+        self._enabled = value
+
+    @property
+    def block_list(self) -> list[str] | None:
+        """List of blocked extensions."""
+        return self._block_list
+
+    @block_list.setter
+    def block_list(self, value: list[str] | None) -> None:
+        self._block_list = value
+
+    @classmethod
+    def from_response(cls: type[Self], response, ns) -> Self:
+        xml = fromstring(response)
+        obj = cls()
+        element = xml.find(".//t:extensionsServerSettings", namespaces=ns)
+        if element is None:
+            raise ValueError("Missing extensionsServerSettings element in response")
+
+        if (enabled_element := element.find("./t:extensionsGloballyEnabled", namespaces=ns)) is not None:
+            obj.enabled = string_to_bool(enabled_element.text)
+        obj.block_list = [e.text for e in element.findall("./t:blockList", namespaces=ns) if e.text is not None]
+
+        return obj
+
+
+class SafeExtension:
+    def __init__(
+        self, url: str | None = None, full_data_allowed: bool | None = None, prompt_needed: bool | None = None
+    ) -> None:
+        self.url = url
+        self._full_data_allowed = full_data_allowed
+        self._prompt_needed = prompt_needed
+
+    @property
+    def full_data_allowed(self) -> bool | None:
+        return self._full_data_allowed
+
+    @full_data_allowed.setter
+    @property_is_boolean
+    def full_data_allowed(self, value: bool | None) -> None:
+        self._full_data_allowed = value
+
+    @property
+    def prompt_needed(self) -> bool | None:
+        return self._prompt_needed
+
+    @prompt_needed.setter
+    @property_is_boolean
+    def prompt_needed(self, value: bool | None) -> None:
+        self._prompt_needed = value
+
+
+class ExtensionsSiteSettings:
+    def __init__(self) -> None:
+        self._enabled: bool | None = None
+        self._use_default_setting: bool | None = None
+        self.safe_list: list[SafeExtension] | None = None
+        self._allow_trusted: bool | None = None
+        self._include_tableau_built: bool | None = None
+        self._include_partner_built: bool | None = None
+        self._include_sandboxed: bool | None = None
+
+    @property
+    def enabled(self) -> bool | None:
+        return self._enabled
+
+    @enabled.setter
+    @property_is_boolean
+    def enabled(self, value: bool | None) -> None:
+        self._enabled = value
+
+    @property
+    def use_default_setting(self) -> bool | None:
+        return self._use_default_setting
+
+    @use_default_setting.setter
+    @property_is_boolean
+    def use_default_setting(self, value: bool | None) -> None:
+        self._use_default_setting = value
+
+    @property
+    def allow_trusted(self) -> bool | None:
+        return self._allow_trusted
+
+    @allow_trusted.setter
+    @property_is_boolean
+    def allow_trusted(self, value: bool | None) -> None:
+        self._allow_trusted = value
+
+    @property
+    def include_tableau_built(self) -> bool | None:
+        return self._include_tableau_built
+
+    @include_tableau_built.setter
+    @property_is_boolean
+    def include_tableau_built(self, value: bool | None) -> None:
+        self._include_tableau_built = value
+
+    @property
+    def include_partner_built(self) -> bool | None:
+        return self._include_partner_built
+
+    @include_partner_built.setter
+    @property_is_boolean
+    def include_partner_built(self, value: bool | None) -> None:
+        self._include_partner_built = value
+
+    @property
+    def include_sandboxed(self) -> bool | None:
+        return self._include_sandboxed
+
+    @include_sandboxed.setter
+    @property_is_boolean
+    def include_sandboxed(self, value: bool | None) -> None:
+        self._include_sandboxed = value
+
+    @classmethod
+    def from_response(cls: type[Self], response, ns) -> Self:
+        xml = fromstring(response)
+        element = xml.find(".//t:extensionsSiteSettings", namespaces=ns)
+        obj = cls()
+        if element is None:
+            raise ValueError("Missing extensionsSiteSettings element in response")
+
+        if (enabled_element := element.find("./t:extensionsEnabled", namespaces=ns)) is not None:
+            obj.enabled = string_to_bool(enabled_element.text)
+        if (default_settings_element := element.find("./t:useDefaultSetting", namespaces=ns)) is not None:
+            obj.use_default_setting = string_to_bool(default_settings_element.text)
+        if (allow_trusted_element := element.find("./t:allowTrusted", namespaces=ns)) is not None:
+            obj.allow_trusted = string_to_bool(allow_trusted_element.text)
+        if (include_tableau_built_element := element.find("./t:includeTableauBuilt", namespaces=ns)) is not None:
+            obj.include_tableau_built = string_to_bool(include_tableau_built_element.text)
+        if (include_partner_built_element := element.find("./t:includePartnerBuilt", namespaces=ns)) is not None:
+            obj.include_partner_built = string_to_bool(include_partner_built_element.text)
+        if (include_sandboxed_element := element.find("./t:includeSandboxed", namespaces=ns)) is not None:
+            obj.include_sandboxed = string_to_bool(include_sandboxed_element.text)
+
+        safe_list = []
+        for safe_extension_element in element.findall("./t:safeList", namespaces=ns):
+            url = safe_extension_element.find("./t:url", namespaces=ns)
+            full_data_allowed = safe_extension_element.find("./t:fullDataAllowed", namespaces=ns)
+            prompt_needed = safe_extension_element.find("./t:promptNeeded", namespaces=ns)
+
+            safe_extension = SafeExtension(
+                url=url.text if url is not None else None,
+                full_data_allowed=string_to_bool(full_data_allowed.text) if full_data_allowed is not None else None,
+                prompt_needed=string_to_bool(prompt_needed.text) if prompt_needed is not None else None,
+            )
+            safe_list.append(safe_extension)
+
+        obj.safe_list = safe_list
+        return obj
+
+
+@overload
+def string_to_bool(s: str) -> bool: ...
+
+
+@overload
+def string_to_bool(s: None) -> None: ...
+
+
+def string_to_bool(s):
+    return s.lower() == "true" if s is not None else None

tableauserverclient/models/favorites_item.py

@@ -1,9 +1,8 @@
 import logging
 
-from typing import Union
+from typing import TypedDict, Union
 from defusedxml.ElementTree import fromstring
-
-from tableauserverclient.models.tableau_types import TableauItem
+from tableauserverclient.models.collection_item import CollectionItem
 from tableauserverclient.models.datasource_item import DatasourceItem
 from tableauserverclient.models.flow_item import FlowItem
 from tableauserverclient.models.project_item import ProjectItem
@@ -13,16 +12,22 @@ from tableauserverclient.models.workbook_item import WorkbookItem
 
 from tableauserverclient.helpers.logging import logger
 
-FavoriteType = dict[
-    str,
-    list[TableauItem],
-]
+
+class FavoriteType(TypedDict):
+    collections: list[CollectionItem]
+    datasources: list[DatasourceItem]
+    flows: list[FlowItem]
+    projects: list[ProjectItem]
+    metrics: list[MetricItem]
+    views: list[ViewItem]
+    workbooks: list[WorkbookItem]
 
 
 class FavoriteItem:
     @classmethod
     def from_response(cls, xml: Union[str, bytes], namespace: dict) -> FavoriteType:
         favorites: FavoriteType = {
+            "collections": [],
             "datasources": [],
             "flows": [],
             "projects": [],
@@ -32,6 +37,7 @@ class FavoriteItem:
         }
         parsed_response = fromstring(xml)
 
+        collections_xml = parsed_response.findall(".//t:favorite/t:collection", namespace)
         datasources_xml = parsed_response.findall(".//t:favorite/t:datasource", namespace)
         flows_xml = parsed_response.findall(".//t:favorite/t:flow", namespace)
         metrics_xml = parsed_response.findall(".//t:favorite/t:metric", namespace)
@@ -40,13 +46,14 @@ class FavoriteItem:
         workbooks_xml = parsed_response.findall(".//t:favorite/t:workbook", namespace)
 
         logger.debug(
-            "ds: {}, flows: {}, metrics: {}, projects: {}, views: {}, wbs: {}".format(
+            "ds: {}, flows: {}, metrics: {}, projects: {}, views: {}, wbs: {}, collections: {}".format(
                 len(datasources_xml),
                 len(flows_xml),
                 len(metrics_xml),
                 len(projects_xml),
                 len(views_xml),
                 len(workbooks_xml),
+                len(collections_xml),
             )
         )
         for datasource in datasources_xml:
@@ -85,5 +92,11 @@ class FavoriteItem:
                 logger.debug(fav_workbook)
                 favorites["workbooks"].append(fav_workbook)
 
+        for collection in collections_xml:
+            fav_collection = CollectionItem.from_xml(collection, namespace)
+            if fav_collection:
+                logger.debug(fav_collection)
+                favorites["collections"].append(fav_collection)
+
         logger.debug(favorites)
         return favorites

tableauserverclient/models/flow_item.py

@@ -129,7 +129,7 @@ class FlowItem:
         return self._description
 
     @description.setter
-    def description(self, value: str) -> None:
+    def description(self, value: Optional[str]) -> None:
         self._description = value
 
     @property

tableauserverclient/models/group_item.py

@@ -1,6 +1,7 @@
 from typing import Callable, Optional, TYPE_CHECKING
 
 from defusedxml.ElementTree import fromstring
+from typing_extensions import Self
 
 from .exceptions import UnpopulatedPropertyError
 from .property_decorators import property_not_empty, property_is_enum
@@ -92,7 +93,7 @@ class GroupItem:
         return self._name
 
     @name.setter
-    def name(self, value: str) -> None:
+    def name(self, value: Optional[str]) -> None:
         self._name = value
 
     @property
@@ -157,3 +158,8 @@ class GroupItem:
     @staticmethod
     def as_reference(id_: str) -> ResourceReference:
         return ResourceReference(id_, GroupItem.tag_name)
+
+    def to_reference(self: Self) -> ResourceReference:
+        if self.id is None:
+            raise ValueError(f"{self.__class__.__qualname__} must have id to be converted to reference")
+        return ResourceReference(self.id, self.tag_name)

tableauserverclient/models/groupset_item.py

@@ -2,6 +2,7 @@ from typing import Optional
 import xml.etree.ElementTree as ET
 
 from defusedxml.ElementTree import fromstring
+from typing_extensions import Self
 
 from tableauserverclient.models.group_item import GroupItem
 from tableauserverclient.models.reference_item import ResourceReference
@@ -24,6 +25,14 @@ class GroupSetItem:
     def __repr__(self) -> str:
         return self.__str__()
 
+    @property
+    def name(self) -> Optional[str]:
+        return self._name
+
+    @name.setter
+    def name(self, value: Optional[str]) -> None:
+        self._name = value
+
     @classmethod
     def from_response(cls, response: bytes, ns: dict[str, str]) -> list["GroupSetItem"]:
         parsed_response = fromstring(response)
@@ -51,3 +60,8 @@ class GroupSetItem:
     @staticmethod
     def as_reference(id_: str) -> ResourceReference:
         return ResourceReference(id_, GroupSetItem.tag_name)
+
+    def to_reference(self: Self) -> ResourceReference:
+        if self.id is None:
+            raise ValueError(f"{self.__class__.__qualname__} must have id to be converted to reference")
+        return ResourceReference(self.id, self.tag_name)