feat: add has_id_or_name to DomainIdentityMixin

hcloud/core/domain.py

@@ -34,6 +34,24 @@ def id_or_name(self) -> int | str:
             return self.name
         raise ValueError("id or name must be set")
 
+    def has_id_or_name(self, id_or_name: int | str) -> bool:
+        """
+        Return whether this domain has the same id or same name as the other.
+
+        The domain calling this method MUST be a bound domain or be populated, otherwise
+        the the comparison will not work as expected (e.g. the domains are the same but
+        cannot be compared, if one provides only an id and the other only the name).
+        """
+        values: list[int | str] = []
+        if self.id is not None:
+            values.append(self.id)
+        if self.name is not None:
+            values.append(self.name)
+        if not values:
+            raise ValueError("id or name must be set")
+
+        return id_or_name in values
+
 
 class Pagination(BaseDomain):
     __slots__ = (

hcloud/firewalls/domain.py

@@ -4,15 +4,15 @@
 
 from dateutil.parser import isoparse
 
-from ..core import BaseDomain
+from ..core import BaseDomain, DomainIdentityMixin
 
 if TYPE_CHECKING:
     from ..actions import BoundAction
     from ..servers import BoundServer, Server
     from .client import BoundFirewall
 
 
-class Firewall(BaseDomain):
+class Firewall(BaseDomain, DomainIdentityMixin):
     """Firewall Domain
 
     :param id: int

hcloud/floating_ips/domain.py

@@ -4,7 +4,7 @@
 
 from dateutil.parser import isoparse
 
-from ..core import BaseDomain
+from ..core import BaseDomain, DomainIdentityMixin
 
 if TYPE_CHECKING:
     from ..actions import BoundAction
@@ -13,7 +13,7 @@
     from .client import BoundFloatingIP
 
 
-class FloatingIP(BaseDomain):
+class FloatingIP(BaseDomain, DomainIdentityMixin):
     """Floating IP Domain
 
     :param id: int

hcloud/load_balancers/domain.py

@@ -4,7 +4,7 @@
 
 from dateutil.parser import isoparse
 
-from ..core import BaseDomain
+from ..core import BaseDomain, DomainIdentityMixin
 
 if TYPE_CHECKING:
     from ..actions import BoundAction
@@ -17,7 +17,7 @@
     from .client import BoundLoadBalancer
 
 
-class LoadBalancer(BaseDomain):
+class LoadBalancer(BaseDomain, DomainIdentityMixin):
     """LoadBalancer Domain
 
     :param id: int

hcloud/networks/domain.py

@@ -4,15 +4,15 @@
 
 from dateutil.parser import isoparse
 
-from ..core import BaseDomain
+from ..core import BaseDomain, DomainIdentityMixin
 
 if TYPE_CHECKING:
     from ..actions import BoundAction
     from ..servers import BoundServer
     from .client import BoundNetwork
 
 
-class Network(BaseDomain):
+class Network(BaseDomain, DomainIdentityMixin):
     """Network Domain
 
     :param id: int

hcloud/placement_groups/domain.py

@@ -4,14 +4,14 @@
 
 from dateutil.parser import isoparse
 
-from ..core import BaseDomain
+from ..core import BaseDomain, DomainIdentityMixin
 
 if TYPE_CHECKING:
     from ..actions import BoundAction
     from .client import BoundPlacementGroup
 
 
-class PlacementGroup(BaseDomain):
+class PlacementGroup(BaseDomain, DomainIdentityMixin):
     """Placement Group Domain
 
     :param id: int

hcloud/primary_ips/domain.py

@@ -4,15 +4,15 @@
 
 from dateutil.parser import isoparse
 
-from ..core import BaseDomain
+from ..core import BaseDomain, DomainIdentityMixin
 
 if TYPE_CHECKING:
     from ..actions import BoundAction
     from ..datacenters import BoundDatacenter
     from .client import BoundPrimaryIP
 
 
-class PrimaryIP(BaseDomain):
+class PrimaryIP(BaseDomain, DomainIdentityMixin):
     """Primary IP Domain
 
     :param id: int

hcloud/servers/domain.py

@@ -4,7 +4,7 @@
 
 from dateutil.parser import isoparse
 
-from ..core import BaseDomain
+from ..core import BaseDomain, DomainIdentityMixin
 
 if TYPE_CHECKING:
     from ..actions import BoundAction
@@ -22,7 +22,7 @@
     from .client import BoundServer
 
 
-class Server(BaseDomain):
+class Server(BaseDomain, DomainIdentityMixin):
     """Server Domain
 
     :param id: int

tests/unit/core/test_domain.py

@@ -65,10 +65,25 @@ def test_id_or_name_exception(self):
         domain = SomeDomain()
 
         with pytest.raises(ValueError) as exception_info:
-            domain.id_or_name
+            _ = domain.id_or_name
         error = exception_info.value
         assert str(error) == "id or name must be set"
 
+    @pytest.mark.parametrize(
+        "other, expected",
+        [
+            (SomeDomain(id=1), True),
+            (SomeDomain(name="name1"), True),
+            (SomeDomain(id=1, name="name1"), True),
+            (SomeDomain(id=2), False),
+            (SomeDomain(name="name2"), False),
+            (SomeDomain(id=2, name="name2"), False),
+        ],
+    )
+    def test_has_id_or_name_exception(self, other, expected):
+        domain = SomeDomain(id=1, name="name1")
+        assert domain.has_id_or_name(other.id_or_name) == expected
+
 
 class ActionDomain(BaseDomain, DomainIdentityMixin):
     __slots__ = ("id", "name", "started")