Mise en forme, couleurs et URL du CDN¶

Trois petits modules construisent le texte et les URL que Discord affiche : bostie.fmt pour le markdown, les mentions et les horodatages, bostie.color pour les couleurs, et bostie.cdn pour les URL d'images.

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

Mentions, horodatages et liens¶

fmt.timestamp prend un datetime ou des secondes Unix. Ses styles sont ceux de Discord : "t" 16:20, "T" 16:20:30, "d" 20/04/2021, "D" April 20, 2021, "f" April 20, 2021 at 16:20 (le style par défaut de Discord quand aucun n'est donné), "F" la même chose avec le jour de la semaine, "s" 20/04/2021, 16:20, "S" avec les secondes, et "R" relatif, par exemple « dans 5 minutes ». Sur les modèles, user.mention, role.mention et channel.mention donnent le même texte que les fonctions de mention, et bot.command_mention cherche l'id d'une commande pour vous (Enregistrer les commandes).

Texte venant des utilisateurs¶

• fmt.escape_markdown(text) fait apparaître le markdown tel qu'il a été tapé, en gardant les liens fonctionnels.
• fmt.remove_markdown(text) le retire.
• fmt.escape_mentions(text) neutralise @everyone, @here et les mentions d'utilisateurs et de rôles pour qu'elles ne notifient personne, en insérant une espace sans chasse.
• fmt.mentioned_users(text), fmt.mentioned_roles(text) et fmt.mentioned_channels(text) renvoient les id mentionnés dans un texte.

L'échappement n'est qu'une couche ; allowed_mentions décide de ce qui peut notifier, quoi que dise le texte.

Couleurs¶

bostie.color contient les couleurs de la marque Discord sous forme d'int : BLURPLE, GREEN, YELLOW, FUCHSIA et RED. color.rgb(red, green, blue) prend trois valeurs de 0 à 255, color.hsv(hue, saturation, value) trois valeurs de 0 à 1, et color.parse("#5865F2") lit six chiffres hexadécimaux, avec #, 0x ou aucun des deux. Le color des embeds, l'accent_color des conteneurs et les rôles acceptent ces valeurs.

URL du CDN¶

bostie.cdn construit les URL des images que Discord stocke. Chaque fonction prend les id et le hash de l'image depuis un modèle, plus size, une puissance de deux de 16 à 4096, et format, parmi "png", "jpg", "jpeg", "webp" (la valeur par défaut) ou "gif". Une image animée, dont le hash commence par a_, reste animée en WebP ou en GIF ; "gif" pour une image fixe, ou une taille hors de la liste, lève ValueError. await bot.http.read(url) en télécharge une, comme l'explique le guide REST.