Il modo più divertente che ho trovato per imparare a programmare con Python è quello di lavorare su scripts e tools che possano avere un'applicazione reale.

Le cose si fanno ancora più interessanti quando ciò a cui sto lavorando non solo ha un'applicazione reale "teorica", ma anche "pratica".

L'esempio più recente me lo ha fornito @stradaxlaliberta, che recentemente si è messo all'opera per dare vita ad un progetto che, attraverso l'uso di una AI appositamente addestrata, potrà produrre alcuni risultati molto interessanti su Splinterlands.

non dico di più perchè il progetto non è mio e non ne so quasi nulla, per cui non vorrei dire qualche scemenza 😅

Per procedere nel suo lavoro @stradaxlaliberta aveva infatti bisogno di una lista contenente i dati di tutte le carte presenti su Splinterlands, possibilmente raccolti in un file excel.

I dati di cui aveva bisogno erano non solo i nomi delle carte, l'espansione di appartenenza, il colore ed il costo di mana, ma anche tutte le statistiche divise per ciascun livello della carta.

Un lavoro che fare manualmente sembra al limite dell'impossibile, anche con l'aiuto di strumenti che possano raccogliere parte delle informazioni.

Sembra la classica ipotesi di lavoro che sarebbe un miliardo di volte più semplice e veloce se potesse essere automatizzato...

... e questa a me è parsa l'occasione perfetta per mettermi di nuovo al lavoro e sfruttare le mie limitate conoscenze di Python per cercare di dare una mano a @stradaxlaliberta!

Le API di Splinterlands

Il primo punto di partenza è stato rintracciare la documentazione relativa alle API di Splinterlands, della cui esistenza sapevo già da diverso tempo grazie ai post di @slobberchops.

Ho trovato ciò che cercavo qui e, dopo aver scorso i vari metodi presenti, ho identificato quello che faceva al caso mio:

Con cards/get_details ho così potuto accedere in pochi secondi ad un file JSON contenente informazioni su tutte le carte di Splinterlands.

Ora avevo "solo" bisogno di individuare quello che mi interessavano e salvarle in un file excel.

La libreria giusta fa tutta la differenza

Per farlo ho, dapprima, creato una funzione che si occupasse attraverso un for loop di passare in rassegna ogni singolo livello di ogni singola carta per salvare le informazioni che mi servivano e, poi, cercato una libreria che potesse aiutarmi a salvarle in un file excel.

La libreria che sembrava fare al caso mio si è rivelata essere openpyxl: la sua facilità di utilizzo ha consentito anche ad uno come me, che ne sa poco sia di Python che di Excel, di creare abbastanza facilmente un file xlsx pronto all'uso e contenente un elenco dettagliato di tutte le carte di Splinterlands.

Il risultato non è niente male e mi ha richiesto anche un numero di ore di lavoro che, se togliamo la parte in cui non avevo capito che a @stradaxlaliberta serviva un file excel, e non delle tabelle a caso fatte con tabulate, sono sicuramente di molto inferiori a quelle che sarebbero servite per creare lo stesso file manualmente.

Il codice che ho scritto l'ho poi caricato su GitHub, con il quale sto piano piano prendendo confidenza: lo trovate qui.

Nella stessa Repository (che molto poco originalmente ho chiamato "splinterlands_cards") trovate anche il file xlsx con tutte le carte di Splinterlands, pronto per essere utilizzato ed aggiornato fino a Heloise the Hollow.

immagini di proprietà di @splinterlands e dei rispettivi proprietari; cover da me editata con GIMP

a supporto della community #OliodiBalena, il 3% delle ricompense di questo post va a @balaenoptera

Se sei arrivato a leggere fin qui, grazie! Se hai voglia di lasciare un upvote, un reblog, un follow, un commento... be', un qualsiasi segnale di vita, in realtà, è molto apprezzato!

Se non sei registrato su Splinterlands... be', sei in tempo per rimediare.

E se vuoi rentare automaticamente le tue carte grazie ad un comodissimo e super-efficiente bot, prova il Rental Golem by Splex.GG!