Instalación de Pycord

Esta es la documentación para Pycord, una biblioteca para Python para ayudar en la creación de aplicaciones que usan la API de Discord.

Requisitos previos

Pycord works with Python 3.10 or higher. Support for earlier versions of Python is not provided. Python 2.7 or lower is not supported. Python 3.8 or lower is not supported.

Instalación

Nota

Para nuevas características en las próximas versiones, necesitarás instalar la versión de pre lanzamiento hasta que se publique una versión estable.

python3 -m pip install -U py-cord --pre

Para los usuarios de Windows, este comando debe usarse para instalar la versión de pre lanzamiento:

py -3 -m pip install -U py-cord --pre

Puedes obtener la biblioteca directamente desde PyPI:

python3 -m pip install -U py-cord

Si estás usando Windows, entonces deberías usar lo siguiente en su lugar:

py -3 -m pip install -U py-cord

Para instalar paquetes adicionales para una mayor velocidad, deberías usar py-cord[speed] en lugar de py-cord, por ejemplo.

# Linux/macOS
python3 -m pip install -U "py-cord[speed]"

# Windows
py -3 -m pip install -U py-cord[speed]

Para obtener soporte de voz, deberías usar py-cord[voice] en lugar de py-cord, por ejemplo

python3 -m pip install -U py-cord[voice]

En entornos Linux, la instalación de voz requiere las siguientes dependencias:

Para un sistema basado en Debian, el siguiente comando instalará estas dependencias:

$ apt install libffi-dev libnacl-dev python3-dev

¡Recuerda comprobar tus permisos!

Entornos virtuales

A veces se quiere evitar que las bibliotecas contaminen las instalaciones en el sistema o usar una versión distinta de aquellas instaladas en el sistema. Es posible que tampoco tengas permisos para instalar bibliotecas en tu sistema. Para este propósito, la biblioteca estándar a partir de Python 3.3 viene con un concepto llamado «entornos virtuales» para ayudar a mantener estas versiones separadas.

Puedes encontrar un tutorial más detallado en Virtual Environments and Packages.

Sin embargo, para lo rápido y sucio:

  1. Ve al directorio de trabajo de tu proyecto:

    $ cd your-bot-source
$ python3 -m venv bot-env

  2. Activa el entorno virtual:

    $ source bot-env/bin/activate

    En Windows lo activas con:

    $ bot-env\Scripts\activate.bat

  3. Usa pip como de costumbre:

    $ pip install -U py-cord

Enhorabuena. Ahora tienes un entorno virtual configurado.

Conceptos básicos

Pycord gira en torno al concepto de eventos. Un evento es algo a lo que escuchas y luego respondes. Por ejemplo, cuando ocurre un mensaje, recibirás un evento al que puedas responder.

Un ejemplo rápido para mostrar cómo funcionan los eventos:

import discord

class MyClient(discord.Client):
    async def on_ready(self):
        print(f'Logged on as {self.user}!')

    async def on_message(self, message):
        print(f'Message from {message.author}: {message.content}')

client = MyClient()
client.run('my token goes here')