Usa Hermes come Libreria Python

Pensa a Hermes come a un assistente robot amichevole a cui puoi dare ordini con del semplice Python — niente bisogno di imparare un nuovo linguaggio o di cliccare in giro su una dashboard appariscente.

Cosa Significa “Usarlo come Libreria”?

Normalmente, parli con Hermes tramite una finestra di chat. Ma quando lo usi come libreria Python, scrivi script Python che dicono a Hermes cosa fare. È perfetto per automatizzare compiti ripetitivi come correggere codice, eseguire test o ripulire file.

I Tuoi Primi Comandi: Ricerca e Patch

Diciamo che hai un grande progetto con vecchie chiamate API da aggiornare. Invece di aprire ogni file manualmente, puoi scrivere uno script che le trova e le corregge tutte:

# Find all Python files using deprecated API and fix them
matches = search_files("old_api_call", path="src/", file_glob="*.py")
fixed = 0
for match in matches.get("matches", []):
    result = patch(
        path=match["path"],
        old_string="old_api_call(",
        new_string="new_api_call(",
        replace_all=True
    )
    if "error" not in str(result):
        fixed += 1

print(f"Fixed {fixed} files out of {len(matches.get('matches', []))} matches")

Ecco cosa succede: Hermes cerca in ogni file .py dentro src/, trova old_api_call(, e lo sostituisce con new_api_call(. Ti sei appena risparmiato ore di lavoro manuale.

Eseguire Test e Ottenere un Report

Vuoi sapere se il tuo codice funziona davvero? Puoi eseguire la tua suite di test e ottenere un riepilogo pulito:

from hermes_tools import terminal, read_file
import json

# Run tests, parse results, and report
result = terminal("cd /project && python -m pytest --tb=short -q 2>&1", timeout=120)
output = result.get("output", "")

# Parse test output
passed = output.count(" passed")
failed = output.count(" failed")
errors = output.count(" error")

report = {
    "passed": passed,
    "failed": failed,
    "errors": errors,
    "exit_code": result.get("exit_code", -1),
    "summary": output[-500:] if len(output) > 500 else output
}

print(json.dumps(report, indent=2))

Questo script esegue i tuoi test, conta quanti sono passati o falliti e stampa un bel report JSON. Puoi anche inviare questo report via email al tuo team automaticamente.

Due Modi per Eseguire il Tuo Codice

Hermes ti offre due “modalità” per eseguire gli script:

• Modalità Progetto (predefinita): Il tuo script viene eseguito nella cartella del tuo progetto, usando lo stesso ambiente Python che hai già. È la migliore per il lavoro di tutti i giorni — puoi fare import pandas o leggere file con percorsi relativi come al solito.

• Modalità Strict: Il tuo script viene eseguito in una cartella separata e isolata con il Python di Hermes. Usala quando vuoi la massima riproducibilità — ad esempio quando condividi uno script con qualcun altro e vuoi essere sicuro che funzioni allo stesso modo ovunque.

Puoi cambiare modalità nel tuo file di configurazione:

# ~/.hermes/config.yaml
code_execution:
  mode: project   # or "strict"

La Sicurezza Prima di Tutto (Anche Quando Scrivi Codice)

Non preoccuparti della sicurezza — Hermes è attento. In entrambe le modalità:

• Rimuove chiavi API e password dall’ambiente del tuo script
• Blocca gli script dal chiamare altri strumenti di Hermes in modo ricorsivo
• Limita per quanto tempo uno script può girare (massimo 5 minuti) e quanto output può stampare

Riepilogo e Consiglio da Pro

Usare Hermes come libreria Python trasforma le noiose faccende in script da una riga. Inizia in piccolo: scegli un compito ripetitivo (come rinominare variabili o eseguire test) e automatizzalo.

Consiglio pratico: Testa sempre il tuo script su una copia del tuo progetto prima, non sull’originale. In questo modo, se qualcosa va storto, non hai rotto nulla. Quando sei sicuro, eseguilo su quello vero. Buona automazione!

---