Discord.py: differenze tra le versioni

Versione delle 15:35, 12 mag 2021

Versione attuale delle 14:33, 28 feb 2025

(17 versioni intermedie di 12 utenti non mostrate)

Riga 1:

{{O|software|maggio 2021}}'''Discord.py''' è una [[Libreria (software)|libreria]] [[open source]]<ref>{{Cita web|url=https://awesomeopensource.com/projects/discord-py|titolo=Discord.py|sito=awesomeopensource.com|lingua=EN|accesso=11 Maggio 2021}}</ref> per il linguaggio di programmazione [[Python]], che permette di sviluppare [[Bot (informatica)|Bot]] per il [[social media]] [[Discord (software)|Discord]].

{{Software

|Nome = Discorddiscord.py

|Sviluppatore = Rapptz

|UltimaVersione = 2.4.0

|UltimaVersione = [https://discordpy.readthedocs.io/en/stable/whats_new.html?highlight=latest%20version&#124; 1.7.2]

|SistemaOperativo = Windowsmultipiattaforma

|Linguaggio = Python

|Genere = Botpython

|Licenza = [[Licenza MIT|MIT]]

|Lingua = Inglese

|Lingua = [[lingua inglese|inglese]]

|SoftwareLibero = sì

|SitoWeb = [https://discordpy.readthedocsrtfd.ioorg/en/stable/api.html&#124; API]latest

}}

== VersioniStoria ==

La libreria discord.py è stata sviluppata da Rapptz come modulo Python per sviluppare Bot per la piattaforma [[VoIP]] [[Discord (software)|Discord]].

La prima versione è chiamata V0.10.0<ref name=":0">{{Cita web|url=https://discordpy.readthedocs.io/en/stable/whats_new.html?highlight=latest%20version|titolo=Versioni di Discord.py|sito=discordpy.readthedocs.io}}</ref> {{Senza fonte|ed è stata rilasciata nel 2018}}, disponibile da Python 3.5.3<ref>{{Cita web|url=https://discordpy.readthedocs.io/en/stable/migrating.html?highlight=versions|titolo=Compatibilità della versione 1.0}}</ref> in poi.

La prima versione della libreria è stata rilasciata il 23 agosto 2015<ref>{{Cita web|url=https://github.com/Rapptz/discord.py/releases/tag/v0.1.0|titolo=Release v0.1.0 · Rapptz/discord.py|sito=GitHub|lingua=en|accesso=2021-05-12}}</ref>, compatibile con versioni di Python 2.7+ e 3.3+. La versione 0.10.0 è stata rilasciata il 28 giugno 2016<ref>{{Cita web|url=https://github.com/Rapptz/discord.py/releases/tag/v0.10.0|titolo=Release v0.10.0 · Rapptz/discord.py|sito=GitHub|lingua=en|accesso=2021-05-12}}</ref> è stata la prima versione totalmente compatibile col modulo ''asyncio'', che permette di scrivere codice Python usando la [[sintassi]] async/await<ref>{{Cita web|url=https://docs.python.org/3/library/asyncio.html|titolo=asyncio — Asynchronous I/O — Python 3.9.5 documentation|sito=docs.python.org|lingua=EN|accesso=2021-05-12}}</ref>.

Il passaggio alla versione 1.0 è definito così:<blockquote>''"one of the biggest breaking changes in the library due to a complete redesign"''</blockquote>La versione più recente è la 1.7.2<ref name=":0" />, disponibile dalla versione di Python 3.9.1 in poi.

Il 9 aprile 2019 è stata rilasciata la versione v1.0.0<ref>{{Cita web|url=https://github.com/Rapptz/discord.py/releases/tag/v1.0.0|titolo=Release v1.0.0 · Rapptz/discord.py|sito=GitHub|lingua=en|accesso=2021-05-12}}</ref>, frutto di una completa ristrutturazione<ref>{{Cita web|url=https://discordpy.readthedocs.io/en/stable/migrating.html#migrating-1-0|titolo=Migrating to v1.0|sito=discordpy.readthedocs.io|lingua=EN|accesso=2021-05-12}}</ref> e con molteplici cambiamenti non retrocompatibili; inoltre, è stato abbandonato il supporto per Python 3.4 e precedenti.

I creatori hanno annunciato la fine dello sviluppo della libreria<ref name=":1">{{Cita web|url=https://gist.github.com/Rapptz/4a2f62751b9600a31a0d3c78100287f1|titolo=The future of Discord.py|autore=Rapptz|sito=Github|data=28 Agosto 2021|lingua=EN|accesso=21 Ottobre 2021}}</ref> a fine Agosto 2021<ref name=":1" />, per poi riprendere lo sviluppo<ref>{{Cita web|url=https://gist.github.com/Rapptz/c4324f17a80c94776832430007ad40e6|titolo=On Resuming discord.py Development|autore=Rapptz|sito=GitHub Gists|lingua=en|accesso=2022-03-26}}</ref> nei primi giorni di Marzo 2022.

Il 18 agosto 2022 è stata rilasciata la version v2.0.0<ref>{{Cita web|url=https://github.com/Rapptz/discord.py/releases/tag/v2.0.0|titolo=Release v2.0.0 · Rapptz/discord.py|sito=GitHub|lingua=en|accesso=2023-10-26}}</ref>, che portò molti cambiamenti non retrocompatibili<ref>{{Cita web|url=https://discordpy.readthedocs.io/en/stable/whats_new.html#v2-0-0|titolo=Changelog — v2.0.0|sito=discordpy.readthedocs.io|lingua=EN|accesso=2023-10-26}}</ref>, i più notevoli sono una completa revisione di molte componenti async<ref>{{Cita web|url=https://discordpy.readthedocs.io/en/stable/migrating.html#asyncio-event-loop-changes|titolo=asyncio Event Loop Changes|sito=discordpy.readthedocs.io|accesso=2023-10-26}}</ref>, e la rimozione del supporto per gli account utente<ref>{{Cita web|url=https://discordpy.readthedocs.io/en/stable/migrating.html#removal-of-support-for-user-accounts|titolo=Removal of Support For User Accounts|sito=discordpy.readthedocs.io|accesso=2023-10-26}}</ref>, consentendo fare [[login]] solo con gli account bot, in conformità con le modifiche ai termini di servizio di Discord<ref>{{Cita web|url=https://support.discord.com/hc/en-us/articles/115002192352-Automated-user-accounts-self-bots|titolo=Automated user accounts (self-bots)|lingua=EN}}</ref>; inoltre, è stato abbandonato il supporto per Python 3.7 e precedenti.

La versione più recente è la 2.4.0<ref name=":0">{{Cita web|url=https://discordpy.readthedocs.io/en/stable/whats_new.html|titolo=Versioni di Discord.py|sito=discordpy.readthedocs.io|lingua=EN}}</ref>.

== Utilizzo ==

Dopo aver importato il modulo discord.py in un programma, è possibile utilizzare i suoi metodi per creare il codice di un Bot, il quale a tutti gli effetti può agire su Discord come un utente umano, ma avendo anche certe funzioni extra come i comandi applicazione<ref>{{Cita web|url=https://discord.com/developers/docs/interactions/application-commands|titolo=Application Commands|sito=Discord Developer Portal|lingua=EN|accesso=2023-10-26}}</ref> e le componenti di messaggio<ref>{{Cita web|url=https://discord.com/developers/docs/interactions/message-components|titolo=Message Components|sito=Discord Developer Portal|lingua=EN|accesso=2023-10-26}}</ref>.

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à quindipuò eseguire, così come un normale utente, le seguenti operazioni:

* Leggereleggere ie inviare messaggi

* Inviareallegare file ad essi messaggi

* scrivere in privato agli utenti

* Allegare file<ref>Che devono però essere presenti nella stessa cartella del programma, e che vanno quindi consegnati nel caso ci si avvalga di un [[Hosting|servizio di hosting]].</ref>

* Scriverebannare, inespellere privatoe aglimoderare gli utenti

* eliminare messaggi e canali

* creare guilds<ref>Funzione disponibile solo se il bot è in meno di 10 guild.</ref>

* collegarsi a canali vocali e riprodurre audio

Non potràpuò naturalmente leggere i messaggi di canali<ref>Si veda [[Discord]], alla definizione di canale, sottodivisione del "server".</ref> che per questioni di autorizzazione<ref>Si veda [[Discord]], nella sezione riguardante la gerarchia dei ruoli, e i vari permessi.</ref> non possa vedere. Non può neanche leggere il contenuto dei messaggi se gli appositi intenti non sono attivati<ref>{{Cita web|url=https://discordpy.readthedocs.io/en/stable/intents.html#message-content|titolo=A Primer to Gateway Intents|sito=discordpy.readthedocs.io|lingua=EN|accesso=2023-10-26}}</ref>.

Allo stesso modo, per mancanza di autorizzazione da parte del proprietario<ref>Dalla stessa libreria '''Discord.py''' definito ''(discord.guild.)owner.user''</ref> del server (che i programmatori usano chiamare Guild<ref>{{Cita web|url=https://githubdiscordpy.comreadthedocs.io/Rapptzen/stable/api.html#discord.py/issues/302Guild.owner|titolo=Serverdiscord.Guild.owner vs— GuildAPI Reference|sito=GitHubdiscordpy.readthedocs.io|datalingua=15 Agosto 2016EN|accesso=11 Maggio 20212023-10-26}}</ref>) o dagli amministratori del guild, il bot potrebbe subire limitazioni nei permessi per eseguire diverse azioni, esse elencate nella [https://discordpy.readthedocs.io/en/stable/api.html#discord.Permissions documentazione dei permessi].

Le autorizzazioni dei singoli Bot sono gestite da [[discord:developers/applications|Discord Developer Portal]], che genera link di invito al guild per i Bot a seconda dei permessi selezionati. In caso di mancata autorizzazione, l'[[Interprete (informatica)|interprete]] restituisce un errore. I permessi per ogni particolare guild possono essere sempre modificati dagli amministratori del guild.

* Scrivere in privato agli utenti

* Menzionare gli utenti

* Espellere gli utenti<ref>Esiste il comando apposito member.kick()</ref>

* Bannare gli utenti<ref>Esiste il comando apposito member.ban()</ref>

* Modificare il [[nickname]] degli altri utenti

=== Esempi di codice ===

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.

Questo codice crea un semplice bot che quando si esegue il comando '!ciao', lui risponde.

In caso di mancata autorizzazione, il [[compilatore]] restituirà l'errore seguente:<syntaxhighlight lang="python3">

discord.ext.command.errors.MissingPermission

</syntaxhighlight>Un Bot avente tutte le autorizzazioni all'interno di un server, può accedere a gran parte del [https://support.discord.com/hc/it/articles/360004957991-Il-tuo-Pacchetto-Dati-di-Discord pacchetto dati] degli utenti a lui visibili, che include:

Per fare bot più complessi, è suggerito usare la libreria ''discord.ext.commands''<ref>{{Cita web|url=https://discordpy.readthedocs.io/en/stable/ext/commands/index.html|titolo=discord.ext.commands – Bot commands framework|sito=discordpy.readthedocs.io|lingua=EN|accesso=2023-10-26}}</ref>, compresa in ogni installazione di discord.py. Esempi più avanzati si possono trovare [https://github.com/Rapptz/discord.py/tree/master/examples sul sito GitHub della libreria].<syntaxhighlight lang="python3" line="1">

* Il tuo [[indirizzo IP]]

# Questo esempio necessita avere l'intento 'message_content' abilitato.

* Account che hai connesso a Discord ([[Twitch.tv|Twitch]], [[Twitter]], [[Steam (informatica)|Steam]], [[spotify]])

* Il tuo numero discriminatore<ref>Quattro cifre, separate dal nome utente da un'hashtag, che anche i Bot a loro volta hanno.</ref>

* Una lista di qualsiasi [[sessione]] attiva tu abbia: PC, cellulare, [[browser]] (incluso indirizzo IP)

* La lista dei tuoi amici

* La lista degli utenti bloccati

* Informazioni sui pagamenti (se sei iscritto a Nitro<ref>Servizio a pagamento, abbonamento "premium" di Discord</ref>)

* Informazioni sviluppatore<ref>[https://discord.com/developers/applications Discord Developer Portal] associa ogni Bot all'utente che l'ha creato.</ref> (per [[Webhook|webhooks]], Bot)

* La lista degli utenti. (Dall'aggiornamento alla versione 1.7 ha causato problemi<ref>{{Cita web|url=https://stackoverflow.com/questions/64518536/discord-py-ctx-guild-members-only-returns-bot|titolo=discord.py - discord py, ctx.guild.members, only returns bot|sito=Stack Overflow|accesso=2021-05-11}}</ref>, in quanto necessita di abilitare da Discord Developer Portal<ref>{{Cita web|url=https://python.tutorialink.com/how-to-get-all-members-of-a-guild-in-discord-py/|titolo=discord.guild.members|sito=Python.tutoriallink.com}}</ref> una funzione privilegiata<ref>{{Cita web|url=https://discordpy.readthedocs.io/en/latest/intents.html|titolo=discord.Intents|sito=https://discordpy.readthedocs.io/|accesso=11 Maggio 2021}}</ref>)

import discord

=== Esempi di codice ===

class MyClient(discord.Client):

Il codice seguente è lo stretto necessario per un programma che semplicemente porti il Bot online.<syntaxhighlight lang="python3">

async def on_ready(self):

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

"""Funzione chiamata dalla libreria quando il cache

import discord.ext.commands.errors

interno del cliente è completamente popolato."""

from discord.ext import commands

from discord import client

print(f'Autenticato come {self.user} (ID: {self.user.id})')

print(f'Sono in {len(self.guilds)} server, e vedo {len(bot.users)} utenti.')

print('------')

async def on_message(self, message):

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

"""Evento chiamato quando il cliente riceve un messaggio."""

Bot = commands.Bot(command_prefix = "£", description = "<inserisci-qui-la-descrizione-del-bot>")

gioco = discord.Game("£Aiuto | Bot | @Bot#1127")

# non vogliamo che il bot risponda a se stesso.

Bot.run(token)

if message.author == self.user:

</syntaxhighlight>Il codice di cui sotto contiene un piccolo evento aggiunto, che stampa a schermata ''<code>Bot#1127 è ora online ID: 12345678</code>''<syntaxhighlight lang="python3">

return

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

</syntaxhighlight>

# Se il messaggio inizia con '!ciao', noi rispondiamo.

== Collegamenti esterni ==

if message.content.startswith('!ciao'):

await message.reply('Ciao da Wikipedia!', mention_author=True)

# Intenti di base, più l'intento necessario per leggere il contenuto dei messaggi.

intents = discord.Intents.default()

intents.message_content = True

# Attività: messaggio mostrato sotto il nome del bot.

activity = discord.CustomActivity(name="Ciao da Wikipedia!")

client = MyClient(intents=intents, activity=activity)

client.run('token del bot')

</syntaxhighlight>''Questo esempio è una copia modificata e tradotta dell'esempio ufficiale [https://github.com/Rapptz/discord.py/blob/master/examples/reply.py reply.py]''

== Note ==

<references />

== Collegamenti esterni ==

* [https://discordpy.readthedocs.io/en/latest/api.html La documentazione ufficiale della libreria]

* [https://pypi.org/project/discord.py/ Istruzioni di installazione del modulo]

Line 83 ⟶ 98:

* [https://github.com/FLAK-ZOSO/Discord.py Esempi di alcuni Bot su Github]

{{Portale|informatica|software libero}}

== Note ==

<references />

{{Portale|Informatica|Software libero}}

[[Categoria:Librerie Python]]