Parto subito con una piccola premessa: non dirò chi è il "qualcuno" a cui si riferisce il titolo.

Perchè? Perchè si tratta del primo utente che mi ha supportato su Hive, che da sempre mi dà ottimi consigli ogni volta che ne ho bisogno e che non ha mai smesso di essere di esempio per me e per tutta la Community. E non parlo solo di quella italiana, ma di tutta Hive.

L'aiuto che lui mi ha dato, e ancora mi dà, è tantissimo e non sarà certo con uno script che mi sentirò di averlo ricambiato.

Non voglio quindi dire il suo nome perchè mi sembrerebbe di voler dare l'impressione che gli sto facendo un favore, quando la verità è che sto solo cercando di ricambiare l'1% del supporto che lui mi ha dato sino ad oggi.

Ecco il perchè di questo script

Se c'è una cosa in cui credo è che nella vita bisogna restituire il bene che riceviamo: farlo è bellissimo, ed è ancora più bello quando lo si fa nei confronti di qualcuno che sappiamo meritarlo.

In quest'ultimo mese ho perciò lavorato attivamente con un solo obiettivo in testa: creare qualcosa che potesse semplificare la vita di questa persona, aiutandola a risparmiare tempo quando svolge qualcuna delle sue attività qui su Hive.

In particolare, sapendo che gestisce un contest nella community Olio di Balena e che per farlo è costretto a verificare i requisiti di ogni possibile partecipante, ho cercato di creare uno script che potesse effettuare in maniera automatica questi controlli al suo posto.

Per farlo ho sfruttato le conoscenze che ho acquisito in questi mesi, anche se gli utenti con i quali mi sono maggiormente confrontato si metterebbero le mani nei capelli vedendo che confusione c'è nel codice che ho scritto 🤣

Il problema è stato che ogni volta che pensavo di aver finito saltava fuori qualcosa che non funzionava... lo risolvevo ed ecco un'altra cosa non andava come doveva...

E non voglio poi ripensare a quanto è stato difficile cercare di capire il funzionamento di alcuni metodi (si chiamano così?) delle API di Hive: senza spiegazioni chiare in molti casi l'unica soluzione è stata provare e riprovare, sperando che qualcosa ad un certo punto desse il risultato sperato!

Alla fine, però, dopo due giorni passati quasi interamente davanti al pc - mi è capitato un weekend completamente libero, evento più unico che raro - ce l'ho finalmente fatta!

Successo!

Lo script funziona! I risultati generati sono attendibili e richiedono, di media, meno di 30 secondi di attesa.

L'affidabilità del risultato è già stata valutata nell'ultimo contest organizzato su Olio di Balena e ciò significa che, a breve, l'utente a cui è destinato questo strumento potrà iniziare ad usarlo, risparmiando del tempo che così potrà sfruttare per altre attività - o per riposarsi!

La soddisfazione che ciò mi dà è enorme; aver creato qualcosa che verrà utilizzato da qualcuno è bellissimo! Pensare poi che il mio primo progetto che avrà un'applicazione pratica reale aiuterà una persona che fa tanto per tutta Hive mi dà ancora più felicità e mi sprona a voler fare ancora meglio.

Come ho già fatto in passato taggo alcuni utenti, come @felixxx e @gamer00, che mi stanno aiutando davvero tanto in questa mia esplorazione del mondo della programmazione: sebbene le loro capacità siano parecchio più ampie delle mie, hanno avuto la pazienza di rispondere a diversi dei miei dubbi. Gli script poi che condividono su Hive sono stati essenziali per capire meglio il funzionamento delle API di Hive e, se non fosse stato per loro, non sarei mai stato in grado di venire a capo dei (numerosi) problemi che ho incontrato creando questo script.

Alcuni snippets

A differenza delle altre volte, oggi non condividerò l'intero codice, principalmente perchè è abbastanza lungo e non voglio intasare ogni volta questi post con due chilometri di codice 🤣

Ecco quindi le funzioni che si occupano di ottenere dalle API di Hive le informazioni che mi occorrono: quella per ottenere le operazioni custom json è quella che mi ha fatto impazzire, per colpa di un sistema di paging che non voleva saperne di collaborare 😅

# Get posts published in the target community
def get_community_posts(url, last_author, last_permlink, session: requests.Session):
    data = f'{{"jsonrpc":"2.0", "method":"bridge.get_ranked_posts", "params":{{"sort":"created","tag":"hive-146620","observer":"", "limit": 100,  "start_author":"{last_author}", "start_permlink":"{last_permlink}"}}, "id":1}}'
    response = get_response(data, url, session)
    posts = response.json()["result"]
    return posts


# Get replies from target author
def get_replies(url, author, session: requests.Session):
    data = f'{{"jsonrpc":"2.0", "method":"bridge.get_account_posts", "params":{{"sort":"comments", "account": "{author}", "limit": 100}}, "id":1}}'
    response = get_response(data, url, session)
    replies = response.json()["result"]
    return replies


# Get all custom operations from target account, poll votes included
def get_custom_json(author, num, url, session: requests.Session):
    data = f'{{"jsonrpc":"2.0", "method":"condenser_api.get_account_history", "params":["{author}", {num}, 1000, 262144], "id":1}}'
    response = get_response(data, url, session)
    custom_json = response.json()["result"]
    return custom_json

Lo so, quello che segue è un while loop infinito, ma oggi avevo davvero esaurito le energie alla fine e non ho trovato un modo più elegante per cercare tra le operazioni custom json di un utente finchè non trovo un voto in un sondaggio nel lasso di tempo che mi interessa (3 settimane)...

# Check if target account voted in one of the 3 last polls
def has_voted_poll(last_poll, author, url, session: requests.Session):
    today = datetime.now()
    three_weeks_ago = today - timedelta(days=21, hours=23)
    num = -1
    while True:
        custom_json = get_custom_json(author, num, url, session)
        for op in custom_json:
            link = op[1]["op"][1]["id"]
            if link in last_poll:
                return True
        timestamp = custom_json[0][1]["timestamp"]
        timestamp_formatted = datetime.strptime(timestamp, "%Y-%m-%dT%H:%M:%S")
        if timestamp_formatted < three_weeks_ago:
            return False
        num = custom_json[0][0]

Una piccola aggiunta alla funzione che si occupa di contare il numero di parole di un post: adesso il testo viene previamente ripulito da hyperlinks ed immagini, in modo da non falsare il risultato.

# Clean text before counting words
def clean_markdown(md_text):
    # Remove images
    md_text = re.sub(r"!\[.*?\]\(.*?\)", "", md_text)

    # Remove hyperlinks
    md_text = re.sub(r"\[(.*?)\]\(.*?\)", r"\1", md_text)

    return md_text

Se poi qualcuno fosse interessato al codice completo sono ovviamente disponibile a condividerlo!

cover realizzata con Bing AI ed 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!