Pycord installieren

Dies ist die Dokumentation für Pycord, eine Bibliothek für Python, die bei der Erstellung von Anwendungen hilft, die die Discord API verwenden.

Voraussetzungen

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.

Installieren

Bemerkung

Für neue Funktionen in kommenden Versionen müssen Sie die Vorversion installieren, bis eine stabile Version veröffentlicht ist.

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

Für Windows-Benutzer sollte dieser Befehl verwendet werden, um die Betaversion zu installieren:

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

Sie können die Bibliothek direkt von PyPI erhalten:

python3 -m pip install -U py-cord

Wenn Sie Windows verwenden, sollte stattdessen folgendes verwendet werden:

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

Um zusätzliche Pakete für Beschleunigung zu installieren, sollten Sie py-cord[speed] anstelle von py-cord verwenden, z.B.

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

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

Um Sprachunterstützung zu erhalten, sollten Sie py-cord[voice] anstelle von py-cord verwenden, z. B.

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

Auf Linux-Umgebungen erfordert das Installieren der Sprachunterstützung folgende Abhängigkeiten:

Für ein Debian-basiertes System erhält der folgende Befehl folgende Abhängigkeiten:

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

Denken Sie daran, Ihre Berechtigungen zu überprüfen!

Virtuelle Umgebungen

Manchmal möchten Sie Bibliotheken davon abhalten, System Installationen zu verschmutzen oder eine andere Version von Bibliotheken als die auf dem System installierten zu verwenden. Möglicherweise haben Sie ebenfalls nicht die Berechtigung, Bibliotheken systemweit zu installieren. Zu diesem Zweck enthält die Standardbibliothek ab Python 3.3 ein Konzept mit dem Namen „Virtuelle Umgebung“en, um diese separaten Versionen zu unterhalten.

Eine ausführlichere Anleitung finden Sie auf Virtual Environments and Packages.

Aber für die Schnellen und Schmutzigen:

  1. Gehen Sie zum Arbeitsverzeichnis Ihres Projekts:

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

  2. Aktivieren Sie die virtuelle Umgebung:

    $ source bot-env/bin/activate

    Auf Windows aktivieren Sie diese mit:

    $ bot-env\Scripts\activate.bat

  3. Pip wie üblich verwenden:

    $ pip install -U py-cord

Glückwunsch. Sie haben nun eine virtuelle Umgebung eingerichtet.

Basic Concepts

Pycord dreht sich um das Konzept von events. Ein Event ist etwas, auf das Sie hören und dann reagieren. Zum Beispiel, wenn eine Nachricht passiert, erhalten Sie ein Event darüber, auf das Sie reagieren können.

Ein schnelles Beispiel, um zu zeigen, wie Events funktionieren:

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')