Formatierung, Farben und CDN-URLs¶

Drei kleine Module bauen den Text und die URLs, die Discord darstellt: bostie.fmt für Markdown, Erwähnungen und Zeitstempel, bostie.color für Farben und bostie.cdn für Bild-URLs.

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

Erwähnungen, Zeitstempel und Links¶

fmt.timestamp nimmt ein datetime oder Unix-Sekunden. Seine Stile sind die von Discord, hier in englischer Darstellung: "t" 16:20, "T" 16:20:30, "d" 20/04/2021, "D" April 20, 2021, "f" April 20, 2021 at 16:20 (Discords Standard, wenn kein Stil angegeben ist), "F" dasselbe mit Wochentag, "s" 20/04/2021, 16:20, "S" mit Sekunden und "R" relativ, etwa „in 5 minutes“. user.mention, role.mention und channel.mention an Modellen liefern denselben Text wie die Erwähnungsfunktionen, und bot.command_mention schlägt die ID eines Befehls für dich nach (Befehle registrieren).

Text von Benutzern¶

• fmt.escape_markdown(text) lässt Markdown so erscheinen, wie es getippt wurde, und lässt Links funktionieren.
• fmt.remove_markdown(text) entfernt es.
• fmt.escape_mentions(text) bricht @everyone, @here sowie Benutzer- und Rollenerwähnungen auf, sodass sie nicht anpingen können, indem es ein Leerzeichen ohne Breite einfügt.
• fmt.mentioned_users(text), fmt.mentioned_roles(text) und fmt.mentioned_channels(text) geben die IDs zurück, die in einem Text erwähnt werden.

Escaping ist nur eine Schicht; allowed_mentions entscheidet, was anpingen darf, egal was im Text steht.

Farben¶

bostie.color enthält Discords Markenfarben als int: BLURPLE, GREEN, YELLOW, FUCHSIA und RED. color.rgb(red, green, blue) nimmt drei Werte von 0 bis 255, color.hsv(hue, saturation, value) drei von 0 bis 1, und color.parse("#5865F2") liest sechs Hexadezimalziffern, mit #, 0x oder ohne beides. Das color von Embeds, das accent_color von Containern und Rollen nehmen diese Werte.

CDN-URLs¶

bostie.cdn baut die URLs von Bildern, die Discord speichert. Jede Funktion nimmt die IDs und den Bild-Hash aus einem Modell, dazu size, eine Zweierpotenz von 16 bis 4096, und format, eines von "png", "jpg", "jpeg", "webp" (der Standard) oder "gif". Ein animiertes Bild, dessen Hash mit a_ beginnt, bleibt in WebP oder GIF animiert; "gif" für ein Standbild oder eine Größe außerhalb der Liste löst ValueError aus. await bot.http.read(url) lädt eines herunter, wie die REST-Anleitung erklärt.