feat: Add support for Guild Scheduled Event Recurrence #2749

DA-344 · 2025-03-23T18:56:35Z

Summary

Adds support for receiving, setting, and updating a Scheduled Event's recurrence rule.

Documentation: resources/guild-scheduled-event

Needs testing.

Information

This PR fixes an issue.
This PR adds something new (e.g. new method or parameters).
This PR is a breaking change (e.g. methods or parameters removed/renamed).
This PR is not a code change (e.g. documentation, README, typehinting,
examples, ...).

Checklist

I have searched the open pull requests for duplicates.
If code changes were made then they have been tested.
- I have updated the documentation to reflect the changes.
If type: ignore comments were used, a comment is also left explaining why.
I have updated the changelog to include these changes.

discord/scheduled_events.py

Co-authored-by: plun1331 <plun1331@gmail.com> Signed-off-by: DA344 <108473820+DA-344@users.noreply.github.com>

discord/scheduled_events.py

… into feat/recurrence-rule

plun1331 · 2025-05-09T19:15:54Z

discord/scheduled_events.py

+        If this recurrence rule was obtained from the API you will need to
+        :meth:`.copy` it in order to edit it.


one more question... why?

This class seems to serve more as a dataclass-ish than an API object. Which is fine, but having an edit method here, and then disallowing editing attributes seems weird. This class should realistically not even hold self._state (I believe). It would probably make everything easier.

Lulalaby · 2025-08-02T03:25:47Z

Merge conflicts
(complicated discord feature, requires intense testing)

docs/api/enums.rst

Signed-off-by: Lala Sabathil <lala@pycord.dev>

Lulalaby · 2025-09-01T20:03:33Z

@DA-344 went ahead and fixed the merge conflicts for you. please double check

Paillat-dev · 2025-09-01T20:00:31Z

discord/scheduled_events.py

+        If this recurrence rule was obtained from the API you will need to
+        :meth:`.copy` it in order to edit it.


discord/scheduled_events.py

Paillat-dev · 2025-09-30T13:50:06Z

discord/guild.py

        image: Optional[:class:`bytes`]
-            The cover image of the scheduled event
+            The cover image of the scheduled event.
+        recurrence_rule: Optional[:class:`ScheduledEventRecurrenceRule`]


If this is provided, is start_date ignored ?

Signed-off-by: Lumouille <144063653+Lumabots@users.noreply.github.com>

Signed-off-by: Lala Sabathil <lala@pycord.dev>

Paillat-dev

Also see merge conflicts

discord/scheduled_events.py

Paillat-dev · 2025-12-10T11:44:43Z

discord/scheduled_events.py

+        return f"<ScheduledEventRecurrenceRule start_date={self.start_date} frequency={self.frequency} interval={self.interval}>"
+
+    @property
+    def weekdays(self) -> list[ScheduledEventWeekday]:


I've been thinking about this again. If you can, I think we should just make these normal attributes. Realistically, it's more likely to confuse someone than prevent misuse. See my comment on edit below as well

Paillat-dev · 2025-12-10T11:46:16Z

discord/scheduled_events.py

+        If this recurrence rule was obtained from the API you will need to
+        :meth:`.copy` it in order to edit it.


This class seems to serve more as a dataclass-ish than an API object. Which is fine, but having an edit method here, and then disallowing editing attributes seems weird. This class should realistically not even hold self._state (I believe). It would probably make everything easier.

Co-authored-by: Paillat <paillat@pycord.dev> Signed-off-by: DA344 <108473820+DA-344@users.noreply.github.com>

Lumabots · 2025-12-12T06:48:47Z

discord/scheduled_events.py

+        self.exceptions: list[Object] = list(
+            map(
+                Object,
+                data.get("guild_scheduled_events_exceptions") or [],


i cant find any docs on guild_scheduled_events_exceptions, could you link one to me ?

https://docs.discord.food/resources/guild-scheduled-event#:~:text=guild_scheduled_event_exceptions

well so its not documented by discord it shouldnt be here imo

Paillat-dev · 2025-12-12T09:06:50Z

discord/scheduled_events.py

+        self,
+        start_date: datetime.datetime,
+        frequency: ScheduledEventRecurrenceFrequency,
+        interval: Literal[1, 2],


This could be made an enum

There are no names for each interval, so an enum does not work here imo

But can interval just be 1 or 2 ? I assumed that and that's why I commented that.

It should be our goal to provide enums to end users so that they don't have to add magic values. We can still add a union with that Literal, and use an IntEnum if needed, and type the attribute as a Literal only.

discord/scheduled_events.py

Paillat-dev · 2025-12-12T09:41:28Z

discord/scheduled_events.py

+        "_state",
+    )
+
+    def __init__(


Also (don't wanna sound painful 😭) but could be neat if this had some overloads to enforce presence / absence of params

Paillat-dev · 2025-12-12T09:44:05Z

discord/scheduled_events.py

+        *,
+        weekdays: list[WeekDay | ScheduledEventWeekday] = MISSING,
+        n_weekdays: list[NWeekDay] = MISSING,
+        month_days: list[datetime.date] = MISSING,


How does this work with two different days on two different months ? Realistically that would end up to 4x a year instead of 2x a year when casted into discord's api's format

DA-344 added 2 commits March 23, 2025 19:52

feat: Add support for scheduled event recurrence

c95dfe5

merge branch 'master' from https://github.com/Pycord-Development/pycord

1d824da

DA-344 requested a review from a team as a code owner March 23, 2025 18:56

pullapprove4 bot requested a review from VincentRPS March 23, 2025 18:56

pullapprove4 bot added PA: All Contributors pending PA: Maintainers pending labels Mar 23, 2025

pre-commit-ci bot and others added 3 commits March 23, 2025 18:57

style(pre-commit): auto fixes from pre-commit.com hooks

e87b93d

oops

476d106

style(pre-commit): auto fixes from pre-commit.com hooks

14ebe20

plun1331 reviewed Mar 31, 2025

View reviewed changes

DA-344 and others added 3 commits April 1, 2025 09:53

update scheduled_events.py

2fed715

Co-authored-by: plun1331 <plun1331@gmail.com> Signed-off-by: DA344 <108473820+DA-344@users.noreply.github.com>

chore: do some things i dont remember

2e6cfa9

style(pre-commit): auto fixes from pre-commit.com hooks

548304a

Icebluewolf reviewed Apr 4, 2025

View reviewed changes

discord/scheduled_events.py Outdated Show resolved Hide resolved

DA-344 added 3 commits April 9, 2025 19:41

chore: Replace 24 to 4

dca1557

Merge branch 'feat/recurrence-rule' of https://github.com/da-344/pycord…

a66bbd8

… into feat/recurrence-rule

chore: Add changelog

0389bc1

plun1331 reviewed May 9, 2025

View reviewed changes

Paillat-dev added API reflection Discord API isn't correctly reflected hold: testing This pull request requires further testing labels Aug 6, 2025

Lulalaby added the on hold label Aug 30, 2025

Lulalaby requested a review from a team as a code owner August 30, 2025 20:33

Lulalaby force-pushed the master branch 2 times, most recently from b55c125 to 82659b2 Compare August 30, 2025 21:10

Lulalaby removed the on hold label Aug 30, 2025

Lulalaby requested a review from a team as a code owner September 1, 2025 12:31

Paillat-dev self-assigned this Sep 1, 2025

Paillat-dev self-requested a review September 1, 2025 15:41

Paillat-dev reviewed Sep 1, 2025

View reviewed changes

docs/api/enums.rst Show resolved Hide resolved

Merge branch 'master' into feat/recurrence-rule

84421c5

Signed-off-by: Lala Sabathil <lala@pycord.dev>

Lulalaby force-pushed the master branch from 6529ef4 to 9855a4e Compare September 1, 2025 22:02

Paillat-dev reviewed Sep 30, 2025

View reviewed changes

Lumabots and others added 3 commits October 20, 2025 22:01

Merge branch 'master' into feat/recurrence-rule

032d7c5

Signed-off-by: Lumouille <144063653+Lumabots@users.noreply.github.com>

Merge branch 'master' into feat/recurrence-rule

f556991

Signed-off-by: Lala Sabathil <lala@pycord.dev>

Merge branch 'master' into feat/recurrence-rule

73ad285

Paillat-dev requested changes Dec 10, 2025

View reviewed changes

pullapprove4 bot removed PA: All Contributors pending PA: Maintainers pending labels Dec 10, 2025

Paillat-dev added the priority: medium Medium Priority label Dec 10, 2025

Update or check

3ca31c7

Co-authored-by: Paillat <paillat@pycord.dev> Signed-off-by: DA344 <108473820+DA-344@users.noreply.github.com>

Lumabots reviewed Dec 12, 2025

View reviewed changes

Paillat-dev requested changes Dec 12, 2025

View reviewed changes

Paillat-dev reviewed Dec 12, 2025

View reviewed changes

		If this recurrence rule was obtained from the API you will need to
		:meth:`.copy` it in order to edit it.

Uh oh!

feat: Add support for Guild Scheduled Event Recurrence #2749

Are you sure you want to change the base?

feat: Add support for Guild Scheduled Event Recurrence #2749

Conversation

DA-344 commented Mar 23, 2025

Summary

Information

Checklist

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Lulalaby commented Aug 2, 2025

Uh oh!

Uh oh!

Lulalaby commented Sep 1, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Paillat-dev left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Paillat-dev Dec 12, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

7 participants

Paillat-dev Dec 12, 2025 •

edited

Loading