feat: Add spoiler channel flag and functions

[ToothyDev]

Summary

This adds ChannelFlags.is_spoiler_channel (following https://docs.discord.food/resources/channel#channel-flags) as well as a .spoiler property to all applicable channel types (all except category). Same goes for making it possible to create these channels via the regular channel creation methods, again with the exception of category channels. Channel editing with this flag is also functional.

Now that it's officially documented, here's the ddocs PR: discord/discord-api-docs#8465

Depends on discord/discord-api-docs#8465

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
• I have read the Contributing Guidelines

[pycord-app]

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/3252/head:pr-3252
git checkout pr-3252

This pull request can be installed with:

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

[Lulalaby]

take a shower <3

[Lulalaby]

took a shower apparently

[Lulalaby]

Can someone request changes reminding me to add editing & creating channels with that flag
and whatever else i may have forgotten

[Soheab]

Needs a way for bots to create this kind of channel

This message was sponsored by toothyfernsan on discord.

[ToothyDev]

I tested it with all but MediaChannels since I don't have access to those anywhere, but I'd still like a second pair of testing eyes on this

[ToothyDev]

Also, creating a channel with this turned on isn't possible unfortunately, gotta create + edit

[Paillat-dev]

@ToothyDev Can you add to the PR body a link to the discord api docs PR for it ?

[ToothyDev]

The Stage Channel edit is a weird case and I'm not sure what to prefer here. The existing edit function doesn't even allow nsfw being passed there at all, while the creation method does allow it. Functionally, stage channels don't support NSFW behavior at all, so idk whether I should add the nsfw param to the edit method too for parity

[Paillat-dev]

In the warn()s you use NSFW in all caps, and mention that the channel will "become" even when it doesn't exist yet.

A better wording would indicate that the two parameters (with their python name) are exclusive, and which of the two will be ignored.

[vmphase]

Good job.