Formato, colores y URL de la CDN¶

Tres módulos pequeños construyen el texto y las URL que muestra Discord: bostie.fmt para el markdown, las menciones y las marcas de tiempo, bostie.color para los colores y bostie.cdn para las URL de las imágenes.

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

Menciones, marcas de tiempo y enlaces¶

fmt.timestamp acepta un datetime o segundos Unix. Sus estilos son los de Discord: "t" 16:20, "T" 16:20:30, "d" 20/04/2021, "D" 20 de abril de 2021, "f" 20 de abril de 2021 a las 16:20 (el valor por defecto de Discord cuando no se indica estilo), "F" lo mismo con el día de la semana, "s" 20/04/2021, 16:20, "S" con segundos, y "R" relativo, como "en 5 minutos". user.mention, role.mention y channel.mention en los modelos dan el mismo texto que las funciones de mención, y bot.command_mention busca el id de un comando por ti (Registrar comandos).

Texto de los usuarios¶

• fmt.escape_markdown(text) hace que el markdown se muestre tal como se escribió, sin romper los enlaces.
• fmt.remove_markdown(text) lo quita.
• fmt.escape_mentions(text) rompe @everyone, @here y las menciones de usuarios y roles para que no puedan notificar, insertando un espacio de ancho cero.
• fmt.mentioned_users(text), fmt.mentioned_roles(text) y fmt.mentioned_channels(text) devuelven los ids mencionados en un texto.

Escapar es una capa; allowed_mentions decide qué puede notificar, diga lo que diga el texto.

Colores¶

bostie.color tiene los colores de marca de Discord como int: BLURPLE, GREEN, YELLOW, FUCHSIA y RED. color.rgb(red, green, blue) acepta tres valores de 0 a 255, color.hsv(hue, saturation, value) tres de 0 a 1, y color.parse("#5865F2") lee seis dígitos hexadecimales, con #, 0x o sin nada. El color de los embeds, el accent_color de los contenedores y los roles aceptan estos valores.

URL de la CDN¶

bostie.cdn construye las URL de las imágenes que guarda Discord. Cada función acepta los ids y el hash de la imagen de un modelo, además de size, una potencia de dos de 16 a 4096, y format, uno de "png", "jpg", "jpeg", "webp" (el valor por defecto) o "gif". Una imagen animada, cuyo hash empieza con a_, sigue animada en WebP o GIF; "gif" para una imagen estática, o un tamaño fuera de la lista, lanza ValueError. await bot.http.read(url) descarga una, como explica la guía de REST.