tools: add update_gitea_releases.py and release-notes snippets

One-shot script to backfill Gitea release bodies for existing releases using the Gitea API. Reads per-version Markdown files from tools/release-notes/ and PATCHes each release body. Includes README.md in tools/release-notes/ explaining usage.
2026-05-02 21:54:01 +02:00
parent df1e68b378
commit 6e91c0ac31
7 changed files with 181 additions and 0 deletions
@@ -0,0 +1,54 @@
+# update_gitea_releases.py
+
+Script one-shot per aggiornare il body delle release Gitea esistenti con il testo del CHANGELOG.
+
+## Quando usarlo
+
+Il workflow `release.yml` aggiorna automaticamente il body delle release **nuove** su Gitea.
+Questo script serve per le release **già esistenti**, create prima che quella funzionalità fosse aggiunta.
+
+## Prerequisiti
+
+- Python 3.8+
+- Un Gitea API token con permesso **Repository → Read and Write**
+
+### Creare il token su Gitea
+
+1. Gitea → avatar → **Settings** → **Applications**
+2. Sezione **"Manage Access Tokens"** → nome a piacere (es. `release-body-update`)
+3. Permission: **Repository** → `Read and Write`
+4. **Generate Token** → copia il valore (mostrato una sola volta)
+
+## Uso
+
+```bash
+# Tramite variabile d'ambiente
+GITEA_TOKEN=<token> python3 tools/update_gitea_releases.py
+
+# Tramite argomento
+python3 tools/update_gitea_releases.py --token <token>
+```
+
+## Output atteso
+
+```
+[v2.0.0] recupero release... id=1, aggiorno body... OK
+[v2.0.1] recupero release... id=2, aggiorno body... OK
+[v2.1.0] recupero release... id=3, aggiorno body... OK
+[v2.2.0] recupero release... id=4, aggiorno body... OK
+[v2.2.1] recupero release... id=5, aggiorno body... OK
+```
+
+Se una release non esiste su Gitea per quel tag, la riga mostra `SALTATO`.
+
+## Come funziona
+
+Per ogni file `tools/release-notes/vX.Y.Z.md`:
+
+1. Chiama `GET /api/v1/repos/{owner}/{repo}/releases/tags/vX.Y.Z` per ottenere l'ID
+2. Chiama `PATCH /api/v1/repos/{owner}/{repo}/releases/{id}` con il body del file `.md`
+
+## Aggiungere nuove versioni
+
+Crea un file `tools/release-notes/vX.Y.Z.md` con il contenuto desiderato, poi riesegui lo script.
+Per le release future il workflow lo fa automaticamente — questo script non è necessario.