書式、色、CDN URL¶

Discord が表示するテキストと URL は、3 つの小さなモジュールで組み立てます。マークダウン、メンション、タイムスタンプには bostie.fmt、色には bostie.color、画像の URL には bostie.cdn を使います。

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) は、リンクを機能させたまま、マークダウンを入力どおりに表示させます。
• fmt.remove_markdown(text) はマークダウンを取り除きます。
• fmt.escape_mentions(text) は、ゼロ幅スペースを挿入して @everyone、@here、ユーザーとロールのメンションを崩し、通知が届かないようにします。
• fmt.mentioned_users(text)、fmt.mentioned_roles(text)、fmt.mentioned_channels(text) は、テキスト内でメンションされた ID を返します。

エスケープは防御の 1 層にすぎません。テキストの内容にかかわらず、何が通知を送れるかは allowed_mentions が決めます。

色¶

bostie.color には、Discord のブランドカラーが int として BLURPLE、GREEN、YELLOW、FUCHSIA、RED の名前で用意されています。color.rgb(red, green, blue) は 0 から 255 までの 3 つの値を、color.hsv(hue, saturation, value) は 0 から 1 までの 3 つの値を受け取り、color.parse("#5865F2") は # や 0x の有無にかかわらず 6 桁の 16 進数を読み取ります。埋め込みの color、コンテナの accent_color、ロールはこれらの値を受け付けます。

CDN URL¶

bostie.cdn は、Discord が保存している画像の URL を組み立てます。どの関数も、モデルから得た ID と画像のハッシュに加えて、16 から 4096 までの 2 のべき乗である size と、"png"、"jpg"、"jpeg"、"webp"（既定）、"gif" のいずれかである format を受け取ります。ハッシュが a_ で始まるアニメーション画像は、WebP または GIF ではアニメーションのままになります。静止画に "gif" を指定したり、一覧にないサイズを指定したりすると ValueError が送出されます。REST のガイドで説明しているとおり、await bot.http.read(url) で画像をダウンロードできます。