discord.py

discord.py
<colbgcolor=#fff,#1f2023><colcolor=#4b50c9> 최신 버전	2.3.2
필요 파이썬 버전	3.8 이상
상태	개발 중
| |

1. 개요

2. 개발 중단 선언과 복귀

• 디스코드가 공식 API 문서를 공개[1]하면서 수많은 기능과 지원을 약속받음.
• 하지만 약속은 제대로 지켜지지 않았고 디스코드 직원들은 향후 3년 동안 라이브러리 개발자들의 피드백을 소홀히 함.
• 디스코드 API 서버는 직원들과 라이브러리 개발자들이 변경 사항에 대해 논의할 수 있는 곳이었으나, 시간이 지나면서 대화는 점점 단절되어 감.
• 그러던 중, 디스코드 직원들은 디스코드 API 서버 대신 Discord Infrastructure[2]에만 변경 사항을 공유하기 시작했다. 하지만 라이브러리 개발자들이 해당 서버에 초대를 받지 못함. [3]
• 문제는 라이브러리에 큰 영향을 받는 변경 사항을 위 서버의 개발자들과만 논의하였다는 것. 대부분의 라이브러리 개발자들은 이를 탐탁지 않게 여김.
• 2020년 4월 7일, 디스코드 블로그에 미래에 대한 계획이 발표됨. 여기에는 수많은 기능[4]과 봇 인증[5]이 공개됨.
• 봇 인증을 받기 위해서는 국가에서 발행한 신분증을 사용해야 하는데 개발자들은 개인정보를 침해한다고 반발했으나 검토가 이뤄지지 않음.
• 2020년 7월과 8월경, Discord Infrastructure에 슬래시 커맨드[6]에 대하여 이야기함.
• 문제는 슬래시 명령어를 도입하면서 기존에 쓰고 있는 메시지형 명령어[7] 기능이 제한된다.
• 업데이트가 된다면 이를 모두 슬래시 명령어로 바꿔야 하는데 discord.py 라이브러리 자체를 싹 갈아엎어야 한다는 것이다.
• 인증 시스템이 도입되고 디스코드 직원들의 적절한 협의 없는 급격한 변화로 인한 잦은 변화로 라이브러리 작업에 대한 동기가 줄어듦.

3. 제작

3.1. 제작 전

3.2. discord.Client

#!syntax python
import discord

client = discord.Client(intents=discord.Intents.default())

@client.event
async def on_ready():
    print('Logged in as')
    print(client.user.name)
    print(client.user.id)
    print('------')

@client.event
async def on_message(message):
    if message.content.startswith('!ping'):
        await message.channel.send('pong')

client.run('token')

3.3. discord.ext.commands.Bot

#!syntax python
import discord
from discord.ext import commands

bot = commands.Bot(command_prefix='!')

@bot.event
async def on_ready():
    print('Logged in as')
    print(bot.user.name)
    print(bot.user.id)
    print('------')

@bot.command()
async def ping(ctx):
    await ctx.send('pong')

bot.run('token')

3.3.1. discord.Client와 discord.ext.commands.Bot의 호환

3.4. 개발 중 및 유지

4. 업데이트

4.1. Discord.py 2.0

4.1.1. 기본 대화 및 출력

#!syntax python
import discord
from discord import app_command

intents = discord.Intents.default()
intents.message_content = True

class MyBot(commands.Bot):
    def __init__(self):
        super().__init__(
            command_prefix="!",
            intents=intents.all(),
            sync_command=True,
            application_id= #디스코드 봇의 application id를 입력한다.
        )
        
    async def setup_hook(self):
        await bot.tree.sync()

    async def on_ready(self):
        print("ready!")
        
        activity = discord.Game("상태 메세지")
        await self.change_presence(status=discord.Status.online, activity=activity)

    @app_command.command(name="ping")
    async def ping(self, ctx: commands.Context) -> None:
        await ctx.send("pong!")

bot = MyBot()
bot.run("token")