gitea-dashboard/CLAUDE.md

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

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