Formatting, colors and CDN URLs¶

Three small modules build the text and URLs that Discord renders: bostie.fmt for markdown, mentions and timestamps, bostie.color for colors, and bostie.cdn for image 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,)),
    )

Mentions, timestamps and links¶

fmt.timestamp takes a datetime or Unix seconds. Its styles are Discord's: "t" 16:20, "T" 16:20:30, "d" 20/04/2021, "D" April 20, 2021, "f" April 20, 2021 at 16:20 (Discord's default when no style is given), "F" the same with the weekday, "s" 20/04/2021, 16:20, "S" with seconds, and "R" relative, such as "in 5 minutes". user.mention, role.mention and channel.mention on models give the same text as the mention functions, and bot.command_mention looks up a command's id for you (Registering commands).

Text from users¶

• fmt.escape_markdown(text) makes markdown show as typed, leaving links working.
• fmt.remove_markdown(text) strips it.
• fmt.escape_mentions(text) breaks @everyone, @here and user and role mentions so they cannot ping, by inserting a zero-width space.
• fmt.mentioned_users(text), fmt.mentioned_roles(text) and fmt.mentioned_channels(text) return the ids mentioned in a text.

Escaping is one layer; allowed_mentions decides what can ping, whatever the text says.

Colors¶

bostie.color has Discord's brand colors as int: BLURPLE, GREEN, YELLOW, FUCHSIA and RED. color.rgb(red, green, blue) takes three values from 0 to 255, color.hsv(hue, saturation, value) three from 0 to 1, and color.parse("#5865F2") reads six hex digits, with #, 0x or neither. Embeds' color, containers' accent_color and roles take these values.

CDN URLs¶

bostie.cdn builds the URLs of images Discord stores. Each takes the ids and the image hash from a model, plus size, a power of two from 16 to 4096, and format, one of "png", "jpg", "jpeg", "webp" (the default) or "gif". An animated image, whose hash starts with a_, stays animated in WebP or GIF; "gif" for a still image, or a size off the list, raises ValueError. await bot.http.read(url) downloads one, as the REST guide explains.