feat: Add the shared client theme object on message sent and in message object by UnBonWhisky · Pull Request #3209 · Pycord-Development/pycord

UnBonWhisky · 2026-04-20T23:17:18Z

Caution

Feature freeze is active, as described by our Release Schedule.

Summary

It adds the object of shared client theme described here by Discord.

Yes AI has been used (partially)

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.
AI Usage has been disclosed.
- If AI has been used, I understand fully what the code does

pycord-app · 2026-04-20T23:17:22Z

Thanks for opening this pull request!
Please make sure you have read the Contributing Guidelines and Code of Conduct.

This pull request can be checked-out with:

git fetch origin pull/3209/head:pr-3209
git checkout pr-3209

This pull request can be installed with:

pip install git+https://github.com/Pycord-Development/pycord@refs/pull/3209/head

… files

UnBonWhisky · 2026-04-20T23:42:27Z

Note : shared client theme should not work with components v2 (source: Discord docs) but it works.

…guments.

plun1331

Since shared client theme is constructible, I feel like we should add methods like set_colors and whatnot to make that easier

Co-authored-by: Dorukyum <53639936+Dorukyum@users.noreply.github.com> Signed-off-by: Flavien F <65244389+UnBonWhisky@users.noreply.github.com>

Co-authored-by: plun1331 <plun1331@gmail.com> Signed-off-by: Flavien F <65244389+UnBonWhisky@users.noreply.github.com>

Co-authored-by: Dorukyum <53639936+Dorukyum@users.noreply.github.com> Signed-off-by: Flavien F <65244389+UnBonWhisky@users.noreply.github.com>

… alias

Signed-off-by: Paillat <paillat@pycord.dev>

Soheab · 2026-05-22T11:59:14Z

Since shared client theme is constructible, I feel like we should add methods like set_colors and whatnot to make that easier

Or just properties with setters

Soheab · 2026-05-22T12:00:27Z

Just a couple of nitpicks:

I believe colors and colours should default to MISSING and then you can do colour = colours of colours is not MISSING else color
I don't think we take str as colors anywhere? Discord does return them as that, but we shouldn't. Users can just do 0xHEX. The _coerce_colour function wouldn't be needed either then.
Should we maybe follow the client and set some defaults? 0 for the gradient and intensity and dark as theme
Maybe simplify the enum SharedClientThemeBaseType to BaseTheme or SharedClientTheme?
You can add some more checks:
- gradient_angle may only be set if there are at least 2 colours in the list
- base_mix should be set to 0 if there are less than 2 colours

…actory

…aclass initialization

Paillat-dev

I wonder if you can respond to interactions with a shared client theme. Probably not.

Co-authored-by: Paillat <jeremiecotti@ik.me> Signed-off-by: UnBonWhisky <65244389+UnBonWhisky@users.noreply.github.com>

Paillat-dev

Seems good enough to me, thanks for the PR ! Just a couple nitpicks.

Paillat-dev · 2026-06-07T13:48:14Z

+    ----------
+    colours: List[:class:`Colour`]
+        The colours of the theme. A maximum of 5 colours.
+    colors: List[:class:`Colour`]


Should be documented in the property method not here since it's not an attribute technically.

Paillat-dev · 2026-06-07T13:49:00Z


 ### Added

+- Added `SharedClientTheme` object for sending and receiving client themes.


Suggested change

- Added `SharedClientTheme` object for sending and receiving client themes.

- Added support for sending and receiving client themes.

UnBonWhisky added 2 commits April 21, 2026 00:30

feat: Add SharedClientTheme support for customizable message appearance

236e8ec

fix: Remove redundant validation checks for shared_client_theme

9116f68

UnBonWhisky requested review from a team and Lulalaby April 20, 2026 23:17

github-project-automation Bot added this to Pycord Apr 20, 2026

UnBonWhisky requested a review from plun1331 April 20, 2026 23:17

github-project-automation Bot moved this to Todo in Pycord Apr 20, 2026

UnBonWhisky requested a review from a team as a code owner April 20, 2026 23:17

UnBonWhisky requested review from DA-344 and JustaSqu1d April 20, 2026 23:17

pullapprove4 Bot added PA: All Contributors pending PA: Maintainers pending labels Apr 20, 2026

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

7c2ae1e

UnBonWhisky changed the title ~~Add the shared client theme object on message sent and in message object~~ feat: Add the shared client theme object on message sent and in message object Apr 20, 2026

UnBonWhisky added 2 commits April 21, 2026 01:24

fix: Update versionadded for SharedClientTheme to 2.9 across multiple…

03e795b

… files

fix: Add SharedClientTheme in changelog

2ac124b

fix: Update the SharedClientTheme constructor to mark the required ar…

e940162

…guments.

Paillat-dev self-assigned this Apr 22, 2026

Paillat-dev self-requested a review April 22, 2026 13:53

Paillat-dev requested changes Apr 26, 2026

View reviewed changes

pullapprove4 Bot removed PA: All Contributors pending PA: Maintainers pending labels Apr 26, 2026

plun1331 requested changes Apr 26, 2026

View reviewed changes

Dorukyum reviewed May 9, 2026

View reviewed changes

Comment thread discord/abc.py Outdated

Comment thread discord/shared_client_theme.py Outdated

Update discord/shared_client_theme.py

d41f8f6

Co-authored-by: Dorukyum <53639936+Dorukyum@users.noreply.github.com> Signed-off-by: Flavien F <65244389+UnBonWhisky@users.noreply.github.com>

UnBonWhisky and others added 7 commits May 10, 2026 10:44

Update CHANGELOG.md

d4c1a55

Co-authored-by: plun1331 <plun1331@gmail.com> Signed-off-by: Flavien F <65244389+UnBonWhisky@users.noreply.github.com>

Update discord/abc.py

73c3ce1

Co-authored-by: Dorukyum <53639936+Dorukyum@users.noreply.github.com> Signed-off-by: Flavien F <65244389+UnBonWhisky@users.noreply.github.com>

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

6234b77

fix: applied the comments and used colour as the main and color as an…

d96ea81

… alias

docs: moved SharedClientTheme from data_class to models

2ad9447

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

b8a1994

Merge branch 'master' into master

9e84f08

Signed-off-by: Paillat <paillat@pycord.dev>

Paillat-dev reviewed May 22, 2026

View reviewed changes

Comment thread discord/shared_client_theme.py Outdated

Paillat-dev requested a review from Soheab May 22, 2026 11:09

UnBonWhisky and others added 10 commits May 23, 2026 13:15

fix: refactor SharedClientTheme initialization and color handling

4401b08

fix: update from_dict method to use Self type hint

c99567d

fix: add parentheses to SharedClientTheme autoclass declaration

23bd2cf

fix: refactor SharedClientTheme to use dataclass and update type hints

7d4d65d

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

5a1f0c1

fix: update SharedClientTheme to use field for colours with default f…

aa00312

…actory

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

12adfcb

fix: update SharedClientTheme to use field for colours and adjust dat…

b827ed1

…aclass initialization

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

a53d601

fix: remove __repr__ method from SharedClientTheme class

4e8926c

Paillat-dev requested changes May 23, 2026

View reviewed changes

Comment thread discord/message.py Outdated

UnBonWhisky and others added 2 commits May 23, 2026 14:31

Update discord/message.py

28c746f

Co-authored-by: Paillat <jeremiecotti@ik.me> Signed-off-by: UnBonWhisky <65244389+UnBonWhisky@users.noreply.github.com>

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

cfdcb80

Paillat-dev added this to the 2.9.0rc1 milestone Jun 7, 2026

Paillat-dev reviewed Jun 7, 2026

View reviewed changes


		### Added

		- Added `SharedClientTheme` object for sending and receiving client themes.

	- Added `SharedClientTheme` object for sending and receiving client themes.
	- Added support for sending and receiving client themes.

Uh oh!

Conversation

UnBonWhisky commented Apr 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Information

Checklist

Uh oh!

pycord-app Bot commented Apr 20, 2026

Uh oh!

UnBonWhisky commented Apr 20, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

plun1331 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Soheab commented May 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Soheab commented May 22, 2026 • edited by Paillat-dev Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Paillat-dev left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Paillat-dev left a comment

Choose a reason for hiding this comment

Uh oh!

Paillat-dev Jun 7, 2026

Choose a reason for hiding this comment

Uh oh!

Paillat-dev Jun 7, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

UnBonWhisky commented Apr 20, 2026 •

edited

Loading

Soheab commented May 22, 2026 •

edited

Loading

Soheab commented May 22, 2026 •

edited by Paillat-dev

Loading