Utils function for snowflake worker and process ids, with increment

discord/abc.py

@@ -837,6 +837,21 @@ def created_at(self) -> datetime:
         """:class:`datetime.datetime`: Returns the channel's creation time in UTC."""
         return utils.snowflake_time(self.id)
 
+    @property
+    def worker_id(self) -> int:
+        """:class:`int`: Returns the channel's snowflake worker ID."""
+        return utils.snowflake_worker_id(self.id)
+
+    @property
+    def process_id(self) -> int:
+        """:class:`int`: Returns the channel's snowflake process ID."""
+        return utils.snowflake_process_id(self.id)
+
+    @property
+    def increment(self) -> int:
+        """:class:`int`: Returns the channel's snowflake increment."""
+        return utils.snowflake_increment(self.id)
+
     @property
     def jump_url(self) -> str:
         """:class:`str`: Returns a URL that allows the client to jump to the channel.

discord/application.py

@@ -1987,6 +1987,21 @@ def created_at(self) -> datetime:
         """
         return utils.snowflake_time(self.id)
 
+    @property
+    def worker_id(self) -> int:
+        """:class:`int`: Returns the application's snowflake worker ID."""
+        return utils.snowflake_worker_id(self.id)
+
+    @property
+    def process_id(self) -> int:
+        """:class:`int`: Returns the application's snowflake process ID."""
+        return utils.snowflake_process_id(self.id)
+
+    @property
+    def increment(self) -> int:
+        """:class:`int`: Returns the application's snowflake increment."""
+        return utils.snowflake_increment(self.id)
+
     @property
     def icon(self) -> Optional[Asset]:
         """Optional[:class:`Asset`]: Retrieves the application's icon asset, if any."""
@@ -3755,6 +3770,21 @@ def created_at(self) -> datetime:
         """
         return utils.snowflake_time(self.id)
 
+    @property
+    def worker_id(self) -> int:
+        """:class:`int`: Returns the application's snowflake worker ID."""
+        return utils.snowflake_worker_id(self.id)
+
+    @property
+    def process_id(self) -> int:
+        """:class:`int`: Returns the application's snowflake process ID."""
+        return utils.snowflake_process_id(self.id)
+
+    @property
+    def increment(self) -> int:
+        """:class:`int`: Returns the application's snowflake increment."""
+        return utils.snowflake_increment(self.id)
+
     @property
     def icon(self) -> Optional[Asset]:
         """Optional[:class:`Asset`]: Retrieves the application's icon asset, if any."""

discord/audit_logs.py

@@ -715,6 +715,21 @@ def created_at(self) -> datetime.datetime:
         """:class:`datetime.datetime`: Returns the entry's creation time in UTC."""
         return utils.snowflake_time(self.id)
 
+    @utils.cached_property
+    def worker_id(self) -> int:
+        """:class:`int`: Returns the entry's snowflake worker ID."""
+        return utils.snowflake_worker_id(self.id)
+
+    @utils.cached_property
+    def process_id(self) -> int:
+        """:class:`int`: Returns the entry's snowflake process ID."""
+        return utils.snowflake_process_id(self.id)
+
+    @utils.cached_property
+    def increment(self) -> int:
+        """:class:`int`: Returns the entry's snowflake increment."""
+        return utils.snowflake_increment(self.id)
+
     @utils.cached_property
     def target(self) -> TargetType:
         if self.action.target_type is None:

discord/channel.py

@@ -3639,6 +3639,21 @@ def created_at(self) -> datetime.datetime:
         """:class:`datetime.datetime`: Returns the direct message channel's creation time in UTC."""
         return utils.snowflake_time(self.id)
 
+    @property
+    def worker_id(self) -> int:
+        """:class:`int`: Returns the direct message channel's snowflake worker ID."""
+        return utils.snowflake_worker_id(self.id)
+
+    @property
+    def process_id(self) -> int:
+        """:class:`int`: Returns the direct message channel's snowflake process ID."""
+        return utils.snowflake_process_id(self.id)
+
+    @property
+    def increment(self) -> int:
+        """:class:`int`: Returns the direct message channel's snowflake increment."""
+        return utils.snowflake_increment(self.id)
+
     @property
     def guild(self) -> Optional[Guild]:
         """Optional[:class:`Guild`]: The guild this DM channel belongs to. Always ``None``.
@@ -4115,6 +4130,21 @@ def created_at(self) -> datetime.datetime:
         """:class:`datetime.datetime`: Returns the channel's creation time in UTC."""
         return utils.snowflake_time(self.id)
 
+    @property
+    def worker_id(self) -> int:
+        """:class:`int`: Returns the channel's snowflake worker ID."""
+        return utils.snowflake_worker_id(self.id)
+
+    @property
+    def process_id(self) -> int:
+        """:class:`int`: Returns the channel's snowflake process ID."""
+        return utils.snowflake_process_id(self.id)
+
+    @property
+    def increment(self) -> int:
+        """:class:`int`: Returns the channel's snowflake increment."""
+        return utils.snowflake_increment(self.id)
+
     @property
     def jump_url(self) -> str:
         """:class:`str`: Returns a URL that allows the client to jump to the channel.
@@ -4564,6 +4594,21 @@ def created_at(self) -> datetime.datetime:
         """:class:`datetime.datetime`: Returns the channel's creation time in UTC."""
         return utils.snowflake_time(self.id)
 
+    @property
+    def worker_id(self) -> int:
+        """:class:`int`: Returns the channel's snowflake worker ID."""
+        return utils.snowflake_worker_id(self.id)
+
+    @property
+    def process_id(self) -> int:
+        """:class:`int`: Returns the channel's snowflake process ID."""
+        return utils.snowflake_process_id(self.id)
+
+    @property
+    def increment(self) -> int:
+        """:class:`int`: Returns the channel's snowflake increment."""
+        return utils.snowflake_increment(self.id)
+
     @property
     def read_state(self) -> ReadState:
         """:class:`ReadState`: Returns the read state for this channel.

discord/guild.py

@@ -1363,6 +1363,21 @@ def created_at(self) -> datetime:
         """:class:`datetime.datetime`: Returns the guild's creation time in UTC."""
         return utils.snowflake_time(self.id)
 
+    @property
+    def worker_id(self) -> int:
+        """:class:`int`: Returns the guild's snowflake worker ID."""
+        return utils.snowflake_worker_id(self.id)
+
+    @property
+    def process_id(self) -> int:
+        """:class:`int`: Returns the guild's snowflake process ID."""
+        return utils.snowflake_process_id(self.id)
+
+    @property
+    def increment(self) -> int:
+        """:class:`int`: Returns the guild's snowflake increment."""
+        return utils.snowflake_increment(self.id)
+
     def get_member_named(self, name: str, /) -> Optional[Member]:
         """Returns the first member found that matches the name provided.
 

discord/invite.py

@@ -33,7 +33,7 @@
 from .object import Object
 from .scheduled_event import ScheduledEvent
 from .stage_instance import StageInstance
-from .utils import MISSING, _generate_session_id, _get_as_snowflake, parse_time, snowflake_time
+from .utils import MISSING, _generate_session_id, _get_as_snowflake, parse_time, snowflake_time, snowflake_process_id, snowflake_increment, snowflake_worker_id
 from .welcome_screen import WelcomeScreen
 
 __all__ = (
@@ -152,6 +152,21 @@ def created_at(self) -> datetime.datetime:
         """:class:`datetime.datetime`: Returns the channel's creation time in UTC."""
         return snowflake_time(self.id)
 
+    @property
+    def worker_id(self) -> int:
+        """:class:`int`: Returns the channel's snowflake worker ID."""
+        return snowflake_worker_id(self.id)
+
+    @property
+    def process_id(self) -> int:
+        """:class:`int`: Returns the channel's snowflake process ID."""
+        return snowflake_process_id(self.id)
+
+    @property
+    def increment(self) -> int:
+        """:class:`int`: Returns the channel's snowflake increment."""
+        return snowflake_increment(self.id)
+
     @property
     def icon(self) -> Optional[Asset]:
         """Optional[:class:`Asset`]: Returns the channel's icon asset if available.
@@ -258,6 +273,22 @@ def created_at(self) -> datetime.datetime:
         """:class:`datetime.datetime`: Returns the guild's creation time in UTC."""
         return snowflake_time(self.id)
 
+    @property
+    def worker_id(self) -> int:
+        """:class:`int`: Returns the guild's snowflake worker ID."""
+        return snowflake_worker_id(self.id)
+
+    @property
+    def process_id(self) -> int:
+        """:class:`int`: Returns the guild's snowflake process ID."""
+        return snowflake_process_id(self.id)
+
+    @property
+    def increment(self) -> int:
+        """:class:`int`: Returns the guild's snowflake increment."""
+        return snowflake_increment(self.id)
+
+
     @property
     def vanity_url(self) -> Optional[str]:
         """Optional[:class:`str`]: The Discord vanity invite URL for this partial guild, if available.

discord/message.py

@@ -951,6 +951,21 @@ def created_at(self) -> datetime.datetime:
         """:class:`datetime.datetime`: The partial message's creation time in UTC."""
         return utils.snowflake_time(self.id)
 
+    @property
+    def worker_id(self) -> int:
+        """:class:`int`: Returns the message's snowflake worker ID."""
+        return utils.snowflake_worker_id(self.id)
+
+    @property
+    def process_id(self) -> int:
+        """:class:`int`: Returns the message's snowflake process ID."""
+        return utils.snowflake_process_id(self.id)
+
+    @property
+    def increment(self) -> int:
+        """:class:`int`: Returns the message's snowflake increment."""
+        return utils.snowflake_increment(self.id)
+
     @property
     def jump_url(self) -> str:
         """:class:`str`: Returns a URL that allows the client to jump to this message."""
@@ -2408,6 +2423,22 @@ def created_at(self) -> datetime.datetime:
         """:class:`datetime.datetime`: The message's creation time in UTC."""
         return utils.snowflake_time(self.id)
 
+    @property
+    def worker_id(self) -> int:
+        """:class:`int`: Returns the message's snowflake worker ID."""
+        return utils.snowflake_worker_id(self.id)
+
+    @property
+    def process_id(self) -> int:
+        """:class:`int`: Returns the message's snowflake process ID."""
+        return utils.snowflake_process_id(self.id)
+
+    @property
+    def increment(self) -> int:
+        """:class:`int`: Returns the message's snowflake increment."""
+        return utils.snowflake_increment(self.id)
+
+
     @property
     def edited_at(self) -> Optional[datetime.datetime]:
         """Optional[:class:`datetime.datetime`]: An aware UTC datetime object containing the edited time of the message."""

discord/object.py

@@ -25,7 +25,7 @@
 from __future__ import annotations
 
 from .mixins import Hashable
-from .utils import snowflake_time, MISSING
+from .utils import snowflake_time, MISSING, snowflake_worker_id, snowflake_increment, snowflake_process_id
 
 from typing import (
     SupportsInt,
@@ -113,5 +113,19 @@ def created_at(self) -> datetime.datetime:
         """:class:`datetime.datetime`: Returns the snowflake's creation time in UTC."""
         return snowflake_time(self.id)
 
+    @property
+    def worker_id(self) -> int:
+        """:class:`int`: Returns the object's snowflake worker ID."""
+        return snowflake_worker_id(self.id)
+
+    @property
+    def process_id(self) -> int:
+        """:class:`int`: Returns the object's snowflake process ID."""
+        return snowflake_process_id(self.id)
+
+    @property
+    def increment(self) -> int:
+        """:class:`int`: Returns the object's snowflake increment."""
+        return snowflake_increment(self.id)
 
 OLDEST_OBJECT = Object(id=0)

discord/partial_emoji.py

@@ -240,6 +240,24 @@ def created_at(self) -> Optional[datetime]:
 
         return utils.snowflake_time(self.id)
 
+    @property
+    def worker_id(self) -> Optional[int]:
+        """:class:`int`: Returns the emoji's snowflake worker ID."""
+        if self.id:
+            return utils.snowflake_worker_id(self.id)
+
+    @property
+    def process_id(self) -> Optional[int]:
+        """:class:`int`: Returns the emoji's snowflake process ID."""
+        if self.id:
+            return utils.snowflake_process_id(self.id)
+
+    @property
+    def increment(self) -> Optional[int]:
+        """:class:`int`: Returns the emoji's snowflake increment."""
+        if self.id:
+            return utils.snowflake_increment(self.id)
+
     @property
     def url(self) -> str:
         """:class:`str`: Returns the URL of the emoji, if it is custom.

discord/profile.py

@@ -319,6 +319,21 @@ def created_at(self) -> datetime:
         """
         return utils.snowflake_time(self.id)
 
+    @property
+    def worker_id(self) -> int:
+        """:class:`int`: Returns the application's snowflake worker ID."""
+        return utils.snowflake_worker_id(self.id)
+
+    @property
+    def process_id(self) -> int:
+        """:class:`int`: Returns the application's snowflake process ID."""
+        return utils.snowflake_process_id(self.id)
+
+    @property
+    def increment(self) -> int:
+        """:class:`int`: Returns the application's snowflake increment."""
+        return utils.snowflake_increment(self.id)
+
     @property
     def flags(self) -> ApplicationFlags:
         """:class:`ApplicationFlags`: The flags of this application."""

discord/role.py

@@ -31,7 +31,7 @@
 from .flags import RoleFlags
 from .mixins import Hashable
 from .permissions import Permissions
-from .utils import MISSING, _bytes_to_base64_data, _get_as_snowflake, snowflake_time
+from .utils import MISSING, _bytes_to_base64_data, _get_as_snowflake, snowflake_time, snowflake_increment, snowflake_worker_id, snowflake_process_id
 
 __all__ = (
     'RoleTags',
@@ -367,6 +367,21 @@ def created_at(self) -> datetime.datetime:
         """:class:`datetime.datetime`: Returns the role's creation time in UTC."""
         return snowflake_time(self.id)
 
+    @property
+    def worker_id(self) -> int:
+        """:class:`int`: Returns the role's snowflake worker ID."""
+        return snowflake_worker_id(self.id)
+
+    @property
+    def process_id(self) -> int:
+        """:class:`int`: Returns the role's snowflake process ID."""
+        return snowflake_process_id(self.id)
+
+    @property
+    def increment(self) -> int:
+        """:class:`int`: Returns the role's snowflake increment."""
+        return snowflake_increment(self.id)
+
     @property
     def mention(self) -> str:
         """:class:`str`: Returns a string that allows you to mention a role."""