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.

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, in quanto necessita di abilitare da Discord Developer Portal^[3] una funzione privilegiata^[4])
• Scrivere in privato agli utenti

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

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

• Scrivere in privato agli utenti
• Menzionare gli utenti
• Espellere gli utenti^[9]
• Bannare gli utenti^[10]
• 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^[11], 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

Esempio di codice

import discord
import discord.ext.commands.errors
from discord.ext import commands
from discord import client

token = "<inserisci-qui-il-token-del-bot>"
Bot = commands.Bot(command_prefix = "£", description = "<inserisci-qui-la-descrizione-del-bot>")
gioco = discord.Game("£Aiuto | Bot | @Bot#1127")

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

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.guild.members, su Python.tutoriallink.com.
4. ^ discord.Intents, su https://discordpy.readthedocs.io/. URL consultato l'11 Maggio 2021.
5. ^ Si veda Discord, alla definizione di canale, sottodivisione del "server".
6. ^ Si veda Discord, nella sezione riguardante la gerarchia dei ruoli, e i vari permessi.
7. ^ Dalla stessa libreria Discord.py definito (discord.guild.)owner.user
8. ^ Server vs Guild, su GitHub, 15 Agosto 2016. URL consultato l'11 Maggio 2021.
9. ^ Esiste il comando apposito

   member.kick()
   

   Con il parametro opzionale reason
10. ^ Esiste il comando apposito

    member.ban()
    

    Con il parametro opzionale reason
11. ^ 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: accedi alle voci di Wikipedia che trattano di Informatica