Discord.py

Discord.py è una libreria open source^[1] per il linguaggio di programmazione Python, che permette di sviluppare Bot per il social media Discord.

Discord.py software
Genere
Ultima versione	2.5.2 (5 marzo 2025)
Sistema operativo	Microsoft Windows
Linguaggio	Python
Licenza	licenza MIT (licenza libera)
Lingua	Inglese
Sito web	API

Utilizzo

Con l'importazione del modulo all'interno di un programma, è possibile dare vita a un Bot il quale, attraverso le funzioni e le variabili della libreria, potrà comportarsi su Discord esattamente come un utente umano.

Funzioni

Il Bot potrà quindi eseguire, come un normale utente, le seguenti operazioni:

• Leggere i messaggi
• Inviare messaggi
• Allegare file^[2]
• Accedere alla lista degli utenti. (Lista che dopo l'ultimo aggiornamento ha causato problemi^[3], in quanto necessita di abilitare da Discord Developer Portal^[4] una funzione privilegiata^[5])
• Scrivere in privato agli utenti

Non potrà naturalmente leggere i messaggi di canali^[6] che per questioni di autorizzazione^[7] non possa vedere.

Allo stesso modo per mancanza di autorizzazione da parte del proprietario^[8] del server (che i programmatori usano chiamare Guild^[9]) potrebbe subire limitazioni nei permessi per:

• Scrivere in privato agli utenti
• Menzionare gli utenti
• Espellere gli utenti^[10]
• Bannare gli utenti^[11]
• Modificare il nickname degli altri utenti

Le autorizzazioni dei singoli Bot sono gestite da Discord Developer Portal, che genera link di invito al server per i Bot a seconda dei permessi che il ruolo personalizzato richiede.

In caso di mancata autorizzazione, il compilatore restituirà l'errore seguente:

discord.ext.command.errors.MissingPermission

Applicazioni

A partire dalle funzioni di base, utilizzando altri moduli tra i quali asyncio.py e time.py^[12], si possono creare applicazioni utili, tra le quali:

• Ban/Kick a tempo determinato

async def ban_temporaneo(member, tempo):
    await member.ban()
    await asyncio.sleep(tempo)
    await member.unban()

• Stato del Bot a tempo determinato

async def Cambia_stato(ctx, tempo, nuovo_stato):
    nuovo_stato = discord.Game(str(nuovo_stato))
    await Bot.change_presence(status = discord.Status.idle, activity = nuovo_stato)
    tempo = float(tempo)
    from asyncio import sleep
    await sleep(tempo) 
    await Bot.change_presence(status = discord.Status.idle, activity = gioco)

Esempi di codice

Il codice seguente è lo stretto necessario per un programma che semplicemente porti il Bot online.

import discord #L'alternativa è di importare  discord.client, discord.ban, discord.kick, discord.events e così via
import discord.ext.commands.errors
from discord.ext import commands
from discord import client

token = "<inserisci-qui-il-token-del-bot>" #I token dei Bot vengono presi da Discord Developer Portal, e vengono immediatamente rinnovati se trovati online dal sistema di Discord
Bot = commands.Bot(command_prefix = "£", description = "<inserisci-qui-la-descrizione-del-bot>")
gioco = discord.Game("£Aiuto | Bot | @Bot#1127")

Bot.run(token)

Il codice di cui sotto contiene un piccolo evento aggiunto, che stampa a schermata Bot#1127 è ora online ID: 12345678

@Bot.event
async def on_ready():
    print(Bot.user, " è ora online ", "ID: ", Bot.user.id)
    await Bot.change_presence(status = discord.Status.idle, activity = gioco)

Collegamenti esterni

• La documentazione ufficiale della libreria
• Istruzioni di installazione del modulo
• Hashtag Discord.py su Stack Overflow
• Esempio di Bot-Wikipediano su Github
• Esempi di alcuni Bot su Github

Note

1. ^ Discord.py, su awesomeopensource.com. URL consultato l'11 Maggio 2021.
2. ^ Che devono però essere presenti nella stessa cartella del programma, e che vanno quindi consegnati nel caso ci si avvalga di un servizio di hosting.
3. ^ discord.py - discord py, ctx.guild.members, only returns bot, su Stack Overflow. URL consultato l'11 maggio 2021.
4. ^ discord.guild.members, su Python.tutoriallink.com.
5. ^ discord.Intents, su https://discordpy.readthedocs.io/. URL consultato l'11 Maggio 2021.
6. ^ Si veda Discord, alla definizione di canale, sottodivisione del "server".
7. ^ Si veda Discord, nella sezione riguardante la gerarchia dei ruoli, e i vari permessi.
8. ^ Dalla stessa libreria Discord.py definito (discord.guild.)owner.user
9. ^ Server vs Guild, su GitHub, 15 Agosto 2016. URL consultato l'11 Maggio 2021.
10. ^ Esiste il comando apposito member.kick()
11. ^ Esiste il comando apposito member.ban()
12. ^ L'equivalente di <locale> (lettura "local-e") in C++, importa una serie di variabili a seconda del luogo nel quale ci si trova, tra le quali il fuso orario e i caratteri UTF-8 della lingua locale.

  Portale Informatica

  Portale Software libero