docs(v1.2.0): update README, freeze CHANGELOG, bump version

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
sylvain
2026-03-12 04:18:54 +01:00
parent 1a8115678c
commit f12ec380c7
3 changed files with 58 additions and 9 deletions

View File

@@ -6,6 +6,26 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/).
## [Unreleased] ## [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 ## [1.1.0] - 2026-03-11
### Added ### 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) - Gestion des erreurs réseau (connexion refusée, timeout, erreurs API)
- Masquage du token dans les messages d'erreur - 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 [1.1.0]: https://gitea.tsmse.fr/admin/gitea-dashboard/compare/v1.0.0...v1.1.0

View File

@@ -59,19 +59,47 @@ gitea-dashboard --exclude archive --exclude test
gitea-dashboard --repo projet --exclude archive 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 ### Exemple de sortie
``` ```
Gitea Dashboard Gitea Dashboard
┏━━━━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━┓ ┏━━━━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━
┃ Repo ┃ Issues ┃ Release ┃ ┃ Repo ┃ Issues ┃ Release ┃ Dernier commit ┃
┡━━━━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━┩ ┡━━━━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━
│ mon-projet │ 3 │ v1.2.0 (il y a 2j) │ │ mon-projet │ 3 │ v1.2.0 (il y a 2j) │ il y a 3h │
│ autre-repo │ 0 │ — │ │ autre-repo │ 0 │ — │ il y a 5j │
└─────────────────┴────────┴──────────────────────┘ └─────────────────┴────────┴──────────────────────┴────────────────
Milestones Milestones
mon-projet / v2.0 : 3/5 (60%) mon-projet / v2.0 : 3/5 (60%) [échéance dépassée]
``` ```
## Développement ## Développement

View File

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
[project] [project]
name = "gitea-dashboard" name = "gitea-dashboard"
version = "1.1.0" version = "1.2.0"
description = "CLI dashboard for Gitea repos status" description = "CLI dashboard for Gitea repos status"
requires-python = ">=3.10" requires-python = ">=3.10"
dependencies = [ dependencies = [