From f12ec380c73fc4bf0ab13f47a6510a802c216eb3 Mon Sep 17 00:00:00 2001 From: sylvain Date: Thu, 12 Mar 2026 04:18:54 +0100 Subject: [PATCH] docs(v1.2.0): update README, freeze CHANGELOG, bump version Co-Authored-By: Claude Opus 4.6 --- CHANGELOG.md | 21 +++++++++++++++++++++ README.md | 44 ++++++++++++++++++++++++++++++++++++-------- pyproject.toml | 2 +- 3 files changed, 58 insertions(+), 9 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 832b6a0..49f9965 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,6 +6,26 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/). ## [Unreleased] +## [1.2.0] - 2026-03-12 + +### Added + +- Export du dashboard en JSON via `--format json` (nouveau module `exporter.py`) +- Colonne "Dernier commit" affichant la date relative du dernier commit par repo +- Option `--sort` / `-s` pour trier les repos (valeurs : `name`, `issues`, `release`, `activity`) +- Coloration des milestones selon l'échéance (rouge = dépassée, jaune = < 7 jours, vert = sinon) + +### Fixed + +- Retry automatique sur timeout API (max 2 retries, backoff linéaire) au lieu d'un crash immédiat + +### Technical + +- Nouveau module `exporter.py` pour la sérialisation JSON +- Retry centralisé dans `GiteaClient._get_with_retry()` +- Fonction `sort_repos` publique dans `display.py` +- Helper de test partagé dans `tests/helpers.py` + ## [1.1.0] - 2026-03-11 ### Added @@ -26,4 +46,5 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/). - Gestion des erreurs réseau (connexion refusée, timeout, erreurs API) - Masquage du token dans les messages d'erreur +[1.2.0]: https://gitea.tsmse.fr/admin/gitea-dashboard/compare/v1.1.0...v1.2.0 [1.1.0]: https://gitea.tsmse.fr/admin/gitea-dashboard/compare/v1.0.0...v1.1.0 diff --git a/README.md b/README.md index 5be92f3..cd86138 100644 --- a/README.md +++ b/README.md @@ -59,19 +59,47 @@ gitea-dashboard --exclude archive --exclude test gitea-dashboard --repo projet --exclude archive ``` +### Tri des repos + +L'option `--sort`/`-s` trie les repos selon un critère : + +| Valeur | Description | +|--------|-------------| +| `name` | Ordre alphabétique (défaut) | +| `issues` | Nombre d'issues décroissant | +| `release` | Date de release décroissante | +| `activity` | Date du dernier commit décroissante | + +```bash +# Trier par nombre d'issues (les plus actifs en premier) +gitea-dashboard --sort issues + +# Trier par activité récente +gitea-dashboard -s activity +``` + +### Export JSON + +L'option `--format json` exporte les données du dashboard au format JSON au lieu de l'affichage tabulaire. Utile pour intégrer le dashboard dans d'autres outils. + +```bash +gitea-dashboard --format json +gitea-dashboard --format json > export.json +``` + ### Exemple de sortie ``` - Gitea Dashboard -┏━━━━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━┓ -┃ Repo ┃ Issues ┃ Release ┃ -┡━━━━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━┩ -│ mon-projet │ 3 │ v1.2.0 (il y a 2j) │ -│ autre-repo │ 0 │ — │ -└─────────────────┴────────┴──────────────────────┘ + Gitea Dashboard +┏━━━━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━┓ +┃ Repo ┃ Issues ┃ Release ┃ Dernier commit ┃ +┡━━━━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━┩ +│ mon-projet │ 3 │ v1.2.0 (il y a 2j) │ il y a 3h │ +│ autre-repo │ 0 │ — │ il y a 5j │ +└─────────────────┴────────┴──────────────────────┴────────────────┘ Milestones - mon-projet / v2.0 : 3/5 (60%) + mon-projet / v2.0 : 3/5 (60%) [échéance dépassée] ``` ## Développement diff --git a/pyproject.toml b/pyproject.toml index a51632e..5c2e0d8 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta" [project] name = "gitea-dashboard" -version = "1.1.0" +version = "1.2.0" description = "CLI dashboard for Gitea repos status" requires-python = ">=3.10" dependencies = [