Форматирование, цвета и URL в CDN¶

Три небольших модуля строят текст и URL, которые отображает Discord: bostie.fmt — разметку Markdown, упоминания и метки времени, bostie.color — цвета, а bostie.cdn — URL изображений.

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,)),
    )

Упоминания, метки времени и ссылки¶

fmt.timestamp принимает datetime или секунды Unix. Стили — те же, что у Discord: "t" 16:20, "T" 16:20:30, "d" 20/04/2021, "D" April 20, 2021, "f" April 20, 2021 at 16:20 (стиль Discord по умолчанию, если стиль не указан), "F" то же с днём недели, "s" 20/04/2021, 16:20, "S" с секундами и "R" — относительное время, например «через 5 минут». user.mention, role.mention и channel.mention у моделей дают тот же текст, что и функции упоминаний, а bot.command_mention сам находит ID команды («Регистрация команд»).

Текст от пользователей¶

• fmt.escape_markdown(text) заставляет разметку Markdown отображаться так, как её набрали, оставляя ссылки рабочими.
• fmt.remove_markdown(text) удаляет её.
• fmt.escape_mentions(text) ломает @everyone, @here и упоминания пользователей и ролей, вставляя пробел нулевой ширины, чтобы они не могли пинговать.
• fmt.mentioned_users(text), fmt.mentioned_roles(text) и fmt.mentioned_channels(text) возвращают ID, упомянутые в тексте.

Экранирование — лишь один уровень защиты; что может пинговать, решает allowed_mentions, что бы ни было написано в тексте.

Цвета¶

В bostie.color есть фирменные цвета Discord в виде int: BLURPLE, GREEN, YELLOW, FUCHSIA и RED. color.rgb(red, green, blue) принимает три значения от 0 до 255, color.hsv(hue, saturation, value) — три значения от 0 до 1, а color.parse("#5865F2") читает шесть шестнадцатеричных цифр с #, 0x или без префикса. Эти значения принимают color эмбедов, accent_color контейнеров и роли.

URL в CDN¶

bostie.cdn строит URL изображений, которые хранит Discord. Каждая функция принимает ID и хеш изображения из модели, а также size — степень двойки от 16 до 4096 — и format: "png", "jpg", "jpeg", "webp" (по умолчанию) или "gif". Анимированное изображение, чей хеш начинается с a_, остаётся анимированным в WebP или GIF; "gif" для статичного изображения или размер не из списка вызывают ValueError. Скачать изображение можно через await bot.http.read(url), как объясняет руководство по REST.