♻️ move snowflake_time function to public.py

Author: Paillat-dev

discord/interactions.py

@@ -28,7 +28,7 @@
 import asyncio
 from typing import TYPE_CHECKING, Any, Coroutine, Union
 
-from .utils.private import get_as_snowflake
+from .utils.private import get_as_snowflake, deprecated
 from . import utils
 from .channel import ChannelType, PartialMessageable, _threaded_channel_factory
 from .enums import (
@@ -292,7 +292,7 @@ def is_component(self) -> bool:
         return self.type == InteractionType.component
 
     @utils.cached_slot_property("_cs_channel")
-    @discord.utils.private.deprecated("Interaction.channel", "2.7", stacklevel=4)
+    @deprecated("Interaction.channel", "2.7", stacklevel=4)
     def cached_channel(self) -> InteractionChannel | None:
         """The cached channel from which the interaction was sent.
         DM channels are not resolved. These are :class:`PartialMessageable` instead.
@@ -428,7 +428,7 @@ async def original_response(self) -> InteractionMessage:
         self._original_response = message
         return message
 
-    @discord.utils.private.deprecated("Interaction.original_response", "2.2")
+    @deprecated("Interaction.original_response", "2.2")
     async def original_message(self):
         """An alias for :meth:`original_response`.
 
@@ -555,7 +555,7 @@ async def edit_original_response(
 
         return message
 
-    @discord.utils.private.deprecated("Interaction.edit_original_response", "2.2")
+    @deprecated("Interaction.edit_original_response", "2.2")
     async def edit_original_message(self, **kwargs):
         """An alias for :meth:`edit_original_response`.
 
@@ -613,7 +613,7 @@ async def delete_original_response(self, *, delay: float | None = None) -> None:
         else:
             await func
 
-    @discord.utils.private.deprecated("Interaction.delete_original_response", "2.2")
+    @deprecated("Interaction.delete_original_response", "2.2")
     async def delete_original_message(self, **kwargs):
         """An alias for :meth:`delete_original_response`.
 
@@ -1238,7 +1238,7 @@ async def send_modal(self, modal: Modal) -> Interaction:
         self._parent._state.store_modal(modal, self._parent.user.id)
         return self._parent
 
-    @discord.utils.private.deprecated("a button with type ButtonType.premium", "2.6")
+    @deprecated("a button with type ButtonType.premium", "2.6")
     async def premium_required(self) -> Interaction:
         """|coro|
 

discord/utils/__init__.py

@@ -58,7 +58,7 @@
 )
 
 from ..errors import HTTPException
-from .public import basic_autocomplete, generate_snowflake, utcnow
+from .public import basic_autocomplete, generate_snowflake, utcnow, snowflake_time
 
 try:
     import msgspec
@@ -288,23 +288,6 @@ def oauth_url(
     return url
 
 
-def snowflake_time(id: int) -> datetime.datetime:
-    """Converts a Discord snowflake ID to a UTC-aware datetime object.
-
-    Parameters
-    ----------
-    id: :class:`int`
-        The snowflake ID.
-
-    Returns
-    -------
-    :class:`datetime.datetime`
-        An aware datetime in UTC representing the creation time of the snowflake.
-    """
-    timestamp = ((id >> 22) + DISCORD_EPOCH) / 1000
-    return datetime.datetime.fromtimestamp(timestamp, tz=datetime.timezone.utc)
-
-
 def find(predicate: Callable[[T], Any], seq: Iterable[T]) -> T | None:
     """A helper to return the first element found in the sequence
     that meets the predicate. For example: ::

discord/utils/public.py

@@ -6,6 +6,8 @@
 from collections.abc import Awaitable, Callable, Iterable
 from typing import TYPE_CHECKING, Any, Literal
 
+from . import DISCORD_EPOCH
+
 if TYPE_CHECKING:
     from ..commands.context import AutocompleteContext
     from ..commands.options import OptionChoice
@@ -176,3 +178,20 @@ def generate_snowflake(
         return (discord_millis << 22) + (2**22 - 1 if high else 0)
     else:
         raise ValueError(f"Invalid mode '{mode}'. Must be 'realistic' or 'boundary'")
+
+
+def snowflake_time(id: int) -> datetime.datetime:
+    """Converts a Discord snowflake ID to a UTC-aware datetime object.
+
+    Parameters
+    ----------
+    id: :class:`int`
+        The snowflake ID.
+
+    Returns
+    -------
+    :class:`datetime.datetime`
+        An aware datetime in UTC representing the creation time of the snowflake.
+    """
+    timestamp = ((id >> 22) + DISCORD_EPOCH) / 1000
+    return datetime.datetime.fromtimestamp(timestamp, tz=datetime.timezone.utc)