Formatação, cores e URLs da CDN¶

Três módulos pequenos montam o texto e as URLs que o Discord renderiza: bostie.fmt para markdown, menções e timestamps, bostie.color para cores e bostie.cdn para URLs de imagens.

from datetime import UTC, datetime, timedelta

import bostie
from bostie import AllowedMentions, Context, Embed, EmbedMedia, User, cdn, color, fmt

bot = bostie.Bot()


@bot.user_command("Profile card")
async def profile_card(ctx: Context, user: User) -> None:
    created = user.created_at
    banner = None
    if user.banner is not None:
        banner = EmbedMedia(url=cdn.user_banner(user.id, user.banner, size=1024))
    embed = Embed(
        title=fmt.escape_markdown(user.display_name),
        description=f"Joined Discord {fmt.timestamp(created, 'R')}",
        color=color.hsv(user.id % 360 / 360, 0.6, 0.9),
        thumbnail=EmbedMedia(url=cdn.display_avatar(user, size=256)),
        image=banner,
    )
    await ctx.respond(embeds=[embed], ephemeral=True)


@bot.command
async def remind(ctx: Context, text: str, minutes: int = 10) -> None:
    """Show a reminder time in everyone's own time zone."""
    due = datetime.now(UTC) + timedelta(minutes=minutes)
    safe = fmt.escape_mentions(text)
    await ctx.respond(
        f"{fmt.user(ctx.user.id)}: {safe} at {fmt.timestamp(due, 't')}",
        allowed_mentions=AllowedMentions(users=(ctx.user.id,)),
    )

Menções, timestamps e links¶

fmt.timestamp aceita um datetime ou segundos Unix. Os estilos são os do Discord: "t" 16:20, "T" 16:20:30, "d" 20/04/2021, "D" 20 de abril de 2021, "f" 20 de abril de 2021 às 16:20 (o padrão do Discord quando nenhum estilo é dado), "F" o mesmo com o dia da semana, "s" 20/04/2021, 16:20, "S" com segundos, e "R" relativo, como "em 5 minutos". user.mention, role.mention e channel.mention nos modelos dão o mesmo texto que as funções de menção, e bot.command_mention busca o ID de um comando para você (Registrando comandos).

Texto vindo de usuários¶

• fmt.escape_markdown(text) faz o markdown aparecer como foi digitado, mantendo os links funcionando.
• fmt.remove_markdown(text) o remove.
• fmt.escape_mentions(text) quebra @everyone, @here e as menções a usuários e cargos para que não possam notificar, inserindo um espaço de largura zero.
• fmt.mentioned_users(text), fmt.mentioned_roles(text) e fmt.mentioned_channels(text) retornam os IDs mencionados em um texto.

O escape é uma camada; allowed_mentions decide o que pode notificar, diga o texto o que disser.

Cores¶

bostie.color tem as cores da marca do Discord como int: BLURPLE, GREEN, YELLOW, FUCHSIA e RED. color.rgb(red, green, blue) aceita três valores de 0 a 255, color.hsv(hue, saturation, value) três de 0 a 1, e color.parse("#5865F2") lê seis dígitos hexadecimais, com #, 0x ou nenhum dos dois. O color das incorporações, o accent_color dos contêineres e os cargos aceitam esses valores.

URLs da CDN¶

bostie.cdn monta as URLs das imagens que o Discord guarda. Cada função recebe os IDs e o hash da imagem de um modelo, além de size, uma potência de dois de 16 a 4096, e format, um entre "png", "jpg", "jpeg", "webp" (o padrão) ou "gif". Uma imagem animada, cujo hash começa com a_, continua animada em WebP ou GIF; "gif" para uma imagem estática, ou um tamanho fora da lista, levanta ValueError. await bot.http.read(url) baixa uma delas, como o guia de REST explica.