# 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) |