Soheab

The following approach is needed because Discord has effectively abandoned the voice status feature.

It is not documented in the official Discord API documentation, which means it is considered unstable and may change at any time without notice.

That level of uncertainty is not ideal for a library like discord.py. The behavior described below is not necessarily undocumented or explicitly discouraged, but you are largely on your own. You are working directly with the raw data that the Discord API sends to the library, before it is parsed or exposed through any higher-level abstractions.

For more information or questions about this approach, you can ask in the discord.py server.

Also see discord/discord-api-docs#6398

Soheab

Basics

• (Forum) posts are threads in forum channels.
• Threads can be created per message or per channel.
• Only channel threads can be private.
• For message and forum threads, the thread's ID matches the starter message's ID.
• You can lock threads so only users with the right permissions can send messages.
• Threads can be archived, which removes them from the channel list. This also happens automatically after a period of inactivity.
  • You can set how long a thread stays active before auto-archiving with auto_archive_duration.
  • Get the archive time with archive_timestamp.

Soheab

• automod commands (https://github.com/demoutrei/discord-autobot)
• channel commands
  • name
  • topic
  • thread name (https://github.com/demoutrei/discord-commands)
  • overwrites
  • invite
  • typing event
• user commands
• nickname

Soheab

from __future__ import annotations
import datetime
from typing import Any, Literal, Self, overload

import discord

type ValidMediaType = (
    str
    | Media
    | discord.MediaGalleryItem

Soheab

Components V2 Paginator

Looking for a non-cv2 paginator? Go to https://gist.github.com/Soheab/f226fc06a3468af01ea3168c95b30af8

Usage

0. Give this gist a ⭐️ :P
1. Copy and paste the contents above into a file like utils/paginator.py
2. Import ButtonPaginator and subclass it or use it directly anywhere.

Arguments

Soheab

Components V2

Looking to paginate with v2 components like a Container? Go to https://gist.github.com/Soheab/891c39d7294b1bdbadc7ecf35ce51cc5

Usage

1. Copypaste the contents above into a file like utils/paginator.py
2. Import ButtonPaginator and subclass it or use it directly anywhere.

Options

ButtonPaginator has a couple of arguments.

Soheab

What is self.bot and how does it work?

TLDR: it's a custom attribute which you define.

self = class instance
bot = attribute that's usually assigned to the bot instance given in an extension's setup function.

Basically:

class MyCog(Cog):
    # this function is called when we do MyCog()

Soheab

# for testing:
# import collections
# emoji = collections.namedtuple("emo", ["animated"])(False)

emoji = ... # some (Partial)Emoji object
guild = ... # some Guild object
emojis = guild.emojis
total = len(guild.emojis)
limit = guild.emoji_limit
animated = sum(1 for e in emojis if e.animated)

Soheab

The hyperlinks are either links to a gist or discord message in the discord.py server

• [2021-04-04]
  • Danny starts development of discord.py 2.0
• [2021-08-28]
  • Danny stops dpy development
• [2022-03-06]
  • Danny starts dpy development again, after announcement of v10
• [2022-03-14]

• Danny reworks async stuff, breaking changes for all!

Soheab

See here the "complete" check

"complete" as in it supports app and text commands and has some comments explaining the code. As you may have noticed, there are multiple files in this gist:

Text Cmmands Only Here

Complete

See here the complete check with support for app and text commands: