feat: add ThreadAutoArchiveDuration enum

Add an enumeration ThreadAutoArchiveDuration to get time before the thread was archived.

The selected enumeration value is automatically retrieved. You can always set the archiving time as a number without using this enumeration.

Author: BOXERRMD

CHANGELOG.md

@@ -57,6 +57,8 @@ These changes are available on the `master` branch, but have not yet been releas
   ([#2747](https://github.com/Pycord-Development/pycord/pull/2747))
 - Added `discord.Interaction.created_at`.
   ([#2801](https://github.com/Pycord-Development/pycord/pull/2801))
+- Added `ThreadAutoArchiveDuration` enum to get thread archive duration more efficiently.
+  ([#2826](https://github.com/Pycord-Development/pycord/pull/2826))
 
 ### Fixed
 

discord/channel.py

@@ -41,6 +41,7 @@
     StagePrivacyLevel,
     VideoQualityMode,
     VoiceRegion,
+    ThreadAutoArchiveDuration,
     try_enum,
 )
 from .errors import ClientException, InvalidArgument
@@ -1084,7 +1085,7 @@ async def edit(
         sync_permissions: bool = ...,
         category: CategoryChannel | None = ...,
         slowmode_delay: int = ...,
-        default_auto_archive_duration: ThreadArchiveDuration = ...,
+        default_auto_archive_duration: ThreadArchiveDuration | ThreadAutoArchiveDuration = ...,
         default_thread_slowmode_delay: int = ...,
         default_sort_order: SortOrder = ...,
         default_reaction_emoji: GuildEmoji | int | str | None = ...,
@@ -1130,6 +1131,7 @@ async def edit(self, *, reason=None, **options):
         default_auto_archive_duration: :class:`int`
             The new default auto archive duration in minutes for threads created in this channel.
             Must be one of ``60``, ``1440``, ``4320``, or ``10080``.
+            **ThreadAutoArchiveDuration** enum can be used for better understanding.
         default_thread_slowmode_delay: :class:`int`
             The new default slowmode delay in seconds for threads created in this channel.
 
@@ -1173,6 +1175,12 @@ async def edit(self, *, reason=None, **options):
             options["flags"] = ChannelFlags._from_value(self.flags.value)
             options["flags"].require_tag = options.pop("require_tag")
 
+        if "default_auto_archive_duration" in options:
+            default_auto_archive_duration = options["default_auto_archive_duration"]
+            options["default_auto_archive_duration"] = default_auto_archive_duration \
+                if isinstance(default_auto_archive_duration, (int, float)) \
+                else default_auto_archive_duration.value
+
         payload = await self._edit(options, reason=reason)
         if payload is not None:
             # the payload will always be the proper channel payload
@@ -1321,6 +1329,9 @@ async def create_thread(
                 raise InvalidArgument("file parameter must be File")
             files = [file]
 
+        if auto_archive_duration is not None and isinstance(auto_archive_duration, ThreadAutoArchiveDuration):
+            auto_archive_duration = auto_archive_duration.value
+
         try:
             data = await state.http.start_forum_thread(
                 self.id,

discord/enums.py

@@ -78,6 +78,7 @@
     "InteractionContextType",
     "PollLayoutType",
     "MessageReferenceType",
+    "ThreadAutoArchiveDuration"
 )
 
 
@@ -1078,6 +1079,15 @@ class SubscriptionStatus(Enum):
     inactive = 2
 
 
+class ThreadAutoArchiveDuration(Enum):
+    """Time set before the thread is auto archived"""
+
+    one_hour = 60
+    one_day = 1440
+    three_days = 4320
+    one_week = 10080
+
+
 T = TypeVar("T")
 
 

discord/threads.py

@@ -28,7 +28,7 @@
 from typing import TYPE_CHECKING, Callable, Iterable
 
 from .abc import Messageable, _purge_messages_helper
-from .enums import ChannelType, try_enum
+from .enums import ChannelType, try_enum, ThreadAutoArchiveDuration
 from .errors import ClientException
 from .flags import ChannelFlags
 from .mixins import Hashable
@@ -602,7 +602,7 @@ async def edit(
         locked: bool = MISSING,
         invitable: bool = MISSING,
         slowmode_delay: int = MISSING,
-        auto_archive_duration: ThreadArchiveDuration = MISSING,
+        auto_archive_duration: ThreadAutoArchiveDuration | ThreadArchiveDuration = MISSING,
         pinned: bool = MISSING,
         applied_tags: list[ForumTag] = MISSING,
         reason: str | None = None,
@@ -632,6 +632,7 @@ async def edit(
         auto_archive_duration: :class:`int`
             The new duration in minutes before a thread is automatically archived for inactivity.
             Must be one of ``60``, ``1440``, ``4320``, or ``10080``.
+            **ThreadAutoArchiveDuration** enum can be used for better understanding.
         slowmode_delay: :class:`int`
             Specifies the slowmode rate limit for user in this thread, in seconds.
             A value of ``0`` disables slowmode. The maximum value possible is ``21600``.
@@ -662,7 +663,9 @@ async def edit(
         if archived is not MISSING:
             payload["archived"] = archived
         if auto_archive_duration is not MISSING:
-            payload["auto_archive_duration"] = auto_archive_duration
+            payload["auto_archive_duration"] = auto_archive_duration.value \
+                if isinstance(auto_archive_duration, ThreadAutoArchiveDuration) \
+                else auto_archive_duration
         if locked is not MISSING:
             payload["locked"] = locked
         if invitable is not MISSING: