feat: make ResourceReference hashable

Closes #1666

This allows `ResourceReference` to be used as a key in dicts,
as well as added to sets by making it hashable. Also adds a
`to_reference` method, while leaving the the `as_reference`
static method in place untouched.

Author: jorwoods

tableauserverclient/models/group_item.py

@@ -1,4 +1,4 @@
-from typing import Callable, Optional, TYPE_CHECKING
+from typing import Callable, Optional, Self, TYPE_CHECKING
 
 from defusedxml.ElementTree import fromstring
 
@@ -157,3 +157,8 @@ def from_response(cls, resp, ns) -> list["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("UserItem must have id to be converted to reference")
+        return ResourceReference(self.id, self.tag_name)

tableauserverclient/models/groupset_item.py

@@ -1,4 +1,4 @@
-from typing import Optional
+from typing import Optional, Self
 import xml.etree.ElementTree as ET
 
 from defusedxml.ElementTree import fromstring
@@ -51,3 +51,8 @@ def get_group(group_xml: ET.Element) -> GroupItem:
     @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("UserItem must have id to be converted to reference")
+        return ResourceReference(self.id, self.tag_name)

tableauserverclient/models/reference_item.py

@@ -1,9 +1,12 @@
+from typing import Self
+
+
 class ResourceReference:
-    def __init__(self, id_, tag_name):
+    def __init__(self, id_: str | None, tag_name: str) -> None:
         self.id = id_
         self.tag_name = tag_name
 
-    def __str__(self):
+    def __str__(self) -> str:
         return f"<ResourceReference id={self._id} tag={self._tag_name}>"
 
     __repr__ = __str__
@@ -13,18 +16,21 @@ def __eq__(self, other: object) -> bool:
             return False
         return (self.id == other.id) and (self.tag_name == other.tag_name)
 
+    def __hash__(self: Self) -> int:
+        return hash((self.id, self.tag_name))
+
     @property
-    def id(self):
+    def id(self) -> str | None:
         return self._id
 
     @id.setter
-    def id(self, value):
+    def id(self, value: str | None) -> None:
         self._id = value
 
     @property
-    def tag_name(self):
+    def tag_name(self) -> str:
         return self._tag_name
 
     @tag_name.setter
-    def tag_name(self, value):
+    def tag_name(self, value: str) -> None:
         self._tag_name = value

tableauserverclient/models/user_item.py

@@ -2,7 +2,7 @@
 import xml.etree.ElementTree as ET
 from datetime import datetime
 from enum import IntEnum
-from typing import Optional, TYPE_CHECKING
+from typing import Optional, TYPE_CHECKING, Self
 
 from defusedxml.ElementTree import fromstring
 
@@ -376,6 +376,11 @@ def _parse_xml(cls, element_name, resp, ns):
     def as_reference(id_) -> ResourceReference:
         return ResourceReference(id_, UserItem.tag_name)
 
+    def to_reference(self: Self) -> ResourceReference:
+        if self.id is None:
+            raise ValueError("UserItem must have id to be converted to reference")
+        return ResourceReference(self.id, self.tag_name)
+
     @staticmethod
     def _parse_element(user_xml, ns):
         id = user_xml.get("id", None)

tableauserverclient/server/request_factory.py

@@ -512,7 +512,10 @@ def add_req(self, rules: Iterable[PermissionsRule]) -> bytes:
         for rule in rules:
             grantee_capabilities_element = ET.SubElement(permissions_element, "granteeCapabilities")
             grantee_element = ET.SubElement(grantee_capabilities_element, rule.grantee.tag_name)
-            grantee_element.attrib["id"] = rule.grantee.id
+            if rule.grantee.id is not None:
+                grantee_element.attrib["id"] = rule.grantee.id
+            else:
+                raise ValueError("Grantee must have an ID")
 
             capabilities_element = ET.SubElement(grantee_capabilities_element, "capabilities")
             self._add_all_capabilities(capabilities_element, rule.capabilities)