4e72ddc32f
Discovery synthesis, docs tree, Python src layout, CLAUDE.md, pyproject.toml. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
50 lines
1.2 KiB
Markdown
50 lines
1.2 KiB
Markdown
# gitea-dashboard
|
|
|
|
Dashboard CLI Python affichant l'etat des repos Gitea (issues, releases, milestones).
|
|
|
|
## Stack
|
|
|
|
- **Langage** : Python 3.x
|
|
- **Dependances** : requests, rich
|
|
- **API** : Gitea REST v1
|
|
- **Instance** : http://192.168.0.106:3000
|
|
|
|
## Principes
|
|
|
|
1. **Lecture seule** — le dashboard ne modifie jamais de donnees Gitea
|
|
2. **Configuration externalisee** — token et URL en variables d'environnement, jamais dans le code
|
|
3. **Separation des responsabilites** — client API / formatage / point d'entree distincts
|
|
4. **Gestion gracieuse** — un repo sans release ou milestone ne casse pas l'affichage
|
|
|
|
## Points d'attention
|
|
|
|
- Ne jamais committer de token ou secret
|
|
- Gerer la pagination API Gitea (reponses potentiellement tronquees)
|
|
- Tester avec des repos sans release et sans milestone
|
|
- L'API Gitea peut varier selon la version — tester sur l'instance reelle
|
|
|
|
## Commandes
|
|
|
|
```bash
|
|
# Installation
|
|
pip install -e .
|
|
|
|
# Execution
|
|
gitea-dashboard
|
|
# ou
|
|
python -m gitea_dashboard
|
|
|
|
# Tests
|
|
pytest
|
|
|
|
# Lint
|
|
ruff check src/ tests/
|
|
```
|
|
|
|
## Variables d'environnement
|
|
|
|
| Variable | Description | Defaut |
|
|
|----------|-------------|--------|
|
|
| `GITEA_URL` | URL de l'instance Gitea | http://192.168.0.106:3000 |
|
|
| `GITEA_TOKEN` | Token API Gitea | (requis) |
|