Simone
6e91c0ac31
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.
1.7 KiB
1.7 KiB
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
- Gitea → avatar → Settings → Applications
- Sezione "Manage Access Tokens" → nome a piacere (es.
release-body-update) - Permission: Repository →
Read and Write - Generate Token → copia il valore (mostrato una sola volta)
Uso
# 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:
- Chiama
GET /api/v1/repos/{owner}/{repo}/releases/tags/vX.Y.Zper ottenere l'ID - 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.