feat: Guild Scheduled Event Recurrence

discord/enums.py

@@ -74,6 +74,8 @@
     'EntitlementType',
     'EntitlementOwnerType',
     'PollLayoutType',
+    'ScheduledEventRecurrenceFrequency',
+    'ScheduledEventRecurrenceWeekday',
 )
 
 
@@ -835,6 +837,23 @@ class ReactionType(Enum):
     burst = 1
 
 
+class ScheduledEventRecurrenceFrequency(Enum):
+    yearly = 0
+    monthly = 1
+    weekly = 2
+    daily = 3
+
+
+class ScheduledEventRecurrenceWeekday(Enum):
+    monday = 0
+    tuesday = 1
+    wednesday = 2
+    thursday = 3
+    friday = 4
+    saturday = 5
+    sunday = 6
+
+
 def create_unknown_value(cls: Type[E], val: Any) -> E:
     value_cls = cls._enum_value_cls_  # type: ignore # This is narrowed below
     name = f'unknown_{val}'

discord/guild.py

@@ -84,7 +84,7 @@
 from .asset import Asset
 from .flags import SystemChannelFlags
 from .integrations import Integration, PartialIntegration, _integration_factory
-from .scheduled_event import ScheduledEvent
+from .scheduled_event import ScheduledEvent, ScheduledEventRecurrenceRule
 from .stage_instance import StageInstance
 from .threads import Thread, ThreadMember
 from .sticker import GuildSticker
@@ -3038,6 +3038,7 @@ async def create_scheduled_event(
         description: str = ...,
         image: bytes = ...,
         reason: Optional[str] = ...,
+        recurrence_rule: Optional[ScheduledEventRecurrenceRule] = ...,
     ) -> ScheduledEvent:
         ...
 
@@ -3054,6 +3055,7 @@ async def create_scheduled_event(
         description: str = ...,
         image: bytes = ...,
         reason: Optional[str] = ...,
+        recurrence_rule: Optional[ScheduledEventRecurrenceRule] = ...,
     ) -> ScheduledEvent:
         ...
 
@@ -3069,6 +3071,7 @@ async def create_scheduled_event(
         description: str = ...,
         image: bytes = ...,
         reason: Optional[str] = ...,
+        recurrence_rule: Optional[ScheduledEventRecurrenceRule] = ...,
     ) -> ScheduledEvent:
         ...
 
@@ -3084,6 +3087,7 @@ async def create_scheduled_event(
         description: str = ...,
         image: bytes = ...,
         reason: Optional[str] = ...,
+        recurrence_rule: Optional[ScheduledEventRecurrenceRule] = ...,
     ) -> ScheduledEvent:
         ...
 
@@ -3100,6 +3104,7 @@ async def create_scheduled_event(
         description: str = MISSING,
         image: bytes = MISSING,
         reason: Optional[str] = None,
+        recurrence_rule: Optional[ScheduledEventRecurrenceRule] = MISSING,
     ) -> ScheduledEvent:
         r"""|coro|
 
@@ -3146,6 +3151,9 @@ async def create_scheduled_event(
             Required if the ``entity_type`` is :attr:`EntityType.external`.
         reason: Optional[:class:`str`]
             The reason for creating this scheduled event. Shows up on the audit log.
+        recurrence_rule: Optional[:class:`ScheduledEventRecurrenceRule`]
+            The recurrence rule this event will follow. If this is ``None`` then this is
+            a one-time event.
 
         Raises
         -------
@@ -3240,6 +3248,12 @@ async def create_scheduled_event(
                 )
             payload['scheduled_end_time'] = end_time.isoformat()
 
+        if recurrence_rule is not MISSING:
+            if recurrence_rule is not None:
+                payload['recurrence_rule'] = recurrence_rule._to_dict()
+            else:
+                payload['recurrence_rule'] = None
+
         if metadata:
             payload['entity_metadata'] = metadata
 

discord/http.py

@@ -2032,6 +2032,7 @@ def create_guild_scheduled_event(
             'description',
             'entity_type',
             'image',
+            'recurrence_rule',
         )
         payload = {k: v for k, v in payload.items() if k in valid_keys}
 
@@ -2085,6 +2086,7 @@ def edit_scheduled_event(
             'description',
             'entity_type',
             'image',
+            'recurrence_rule',
         )
         payload = {k: v for k, v in payload.items() if k in valid_keys}