서식, 색상, CDN URL¶

작은 모듈 세 개가 Discord가 렌더링하는 텍스트와 URL을 만듭니다. bostie.fmt는 마크다운, 멘션, 타임스탬프를, bostie.color는 색상을, bostie.cdn은 이미지 URL을 담당합니다.

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" "in 5 minutes"처럼 상대적인 시간입니다. 모델의 user.mention, role.mention, channel.mention은 멘션 함수와 같은 텍스트를 돌려주며, bot.command_mention은 명령어의 ID를 대신 찾아 줍니다(명령어 등록).

사용자가 입력한 텍스트¶

• fmt.escape_markdown(text)는 링크는 그대로 동작하게 두고, 마크다운이 입력한 그대로 보이게 합니다.
• fmt.remove_markdown(text)는 마크다운을 제거합니다.
• fmt.escape_mentions(text)는 폭이 없는 공백(zero-width space)을 넣어 @everyone, @here, 사용자 멘션과 역할 멘션이 알림을 보내지 못하도록 깨뜨립니다.
• fmt.mentioned_users(text), fmt.mentioned_roles(text), fmt.mentioned_channels(text)는 텍스트에서 멘션된 ID를 반환합니다.

이스케이프는 하나의 방어층일 뿐입니다. 텍스트 내용과 상관없이 무엇이 알림을 보낼 수 있는지는 allowed_mentions가 결정합니다.

색상¶

bostie.color에는 Discord의 브랜드 색상이 int로 들어 있습니다. BLURPLE, GREEN, YELLOW, FUCHSIA, RED입니다. color.rgb(red, green, blue)는 0부터 255까지의 값 세 개를, color.hsv(hue, saturation, value)는 0부터 1까지의 값 세 개를 받고, color.parse("#5865F2")는 #이나 0x가 붙었거나 붙지 않은 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)을 사용합니다.