kod8-cli 0.2.0__tar.gz

kod8_cli-0.2.0/MANIFEST.in

@@ -0,0 +1,3 @@
+include README.md pyproject.toml
+include kod8/exercises.json
+exclude examples/*

kod8_cli-0.2.0/PKG-INFO

@@ -0,0 +1,68 @@
+Metadata-Version: 2.4
+Name: kod8-cli
+Version: 0.2.0
+Summary: KOD8 Command Line Interface for local testing
+Home-page: https://github.com/Rodrigue-k/kod8
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: requests
+Requires-Dist: rich
+Requires-Dist: keyring
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# KOD8 CLI
+
+Tester des exercices à fichier unique en local, puis envoyer leur code au correcteur KOD8. Les tests locaux ne valident pas la progression.
+
+## Installation locale
+
+```bash
+cd cli
+pip install -e .
+```
+
+Se connecter sur KOD8, ouvrir `/formations/python/soumissions`, créer un jeton personnel et le fournir dans `KOD8_TOKEN`. Ne jamais le committer. `KOD8_API_URL` vaut `https://kod8.live/api/cli` ; en développement : `http://localhost:5173/api/cli`.
+
+---
+
+## Utilisation quotidienne
+
+### 1. Tester son code en local (sans impacter sa note)
+
+Créez le fichier imposé par l’énoncé (par exemple `contact.py`). L’installation et la connexion se font une seule fois dans le guide d’installation, avec `kod8 login`. La CLI conserve le jeton dans le coffre système ; Codespaces peut utiliser le secret `KOD8_TOKEN`. Vérifier la version avec `kod8 --version`.
+
+Utilisez directement le nom de l’exercice, sans extension :
+
+```bash
+kod8 test contact
+```
+
+*Ou si vous êtes directement dans le sous-dossier de l'exercice :*
+```bash
+kod8 test
+```
+
+L’outil exécute les tests publics disponibles sur votre ordinateur. Une grille absente ne permet pas de conclure à une réussite.
+
+---
+
+### 2. Valider et enregistrer officiellement sa progression
+
+Quand tout est vert, vous soumettez votre solution en une seule commande :
+
+```bash
+kod8 submit contact
+```
+
+La commande relance les tests publics. Après réussite, elle crée un commit horodaté pour le seul fichier de l’exercice, pousse le commit, puis soumet le code pour votre compte. Seuls des tests serveur réussis valident l’exercice. Un fichier inchangé ne crée pas de commit supplémentaire. `--retry` crée une nouvelle tentative après une erreur technique ; `--no-push` est réservé aux intégrations techniques.
+
+Codes de sortie : 0 réussite, 1 échec, 2 revue nécessaire, 3 erreur technique, 4 correction en cours. Les projets et exercices à plusieurs fichiers, à fichiers produits, d’environnement ou d’API se déposent sur leur page avec le dépôt et les preuves ; ils ne sont pas validés par un simple main.py.
+
+Pour GitHub Actions, copier `examples/github-actions.yml` dans `.github/workflows/kod8.yml` et `examples/ci_submit.py` dans `.github/scripts/ci_submit.py` du dépôt apprenant. Ajouter le secret `KOD8_TOKEN` et la variable `KOD8_API_URL` si nécessaire. Le helper soumet les scripts nommés reconnus par le catalogue et conserve la compatibilité avec `python/m*/ex*/main.py` ; il n’exécute pas le code apprenant dans la CI. Ne pas appliquer ce workflow aux activités qui demandent un livrable en revue.
+
+Le catalogue canonique est `lib/course-content/exercise-contracts.json`. Sa copie embarquée dans la CLI est `kod8/exercises.json`. Régénérer avec `python scripts/build-exercise-contracts.py`, puis produire l’archive téléchargeable avec `python scripts/package-cli.py`. Le paquet n’est pas confirmé publié sur PyPI.

kod8_cli-0.2.0/README.md

@@ -0,0 +1,51 @@
+# KOD8 CLI
+
+Tester des exercices à fichier unique en local, puis envoyer leur code au correcteur KOD8. Les tests locaux ne valident pas la progression.
+
+## Installation locale
+
+```bash
+cd cli
+pip install -e .
+```
+
+Se connecter sur KOD8, ouvrir `/formations/python/soumissions`, créer un jeton personnel et le fournir dans `KOD8_TOKEN`. Ne jamais le committer. `KOD8_API_URL` vaut `https://kod8.live/api/cli` ; en développement : `http://localhost:5173/api/cli`.
+
+---
+
+## Utilisation quotidienne
+
+### 1. Tester son code en local (sans impacter sa note)
+
+Créez le fichier imposé par l’énoncé (par exemple `contact.py`). L’installation et la connexion se font une seule fois dans le guide d’installation, avec `kod8 login`. La CLI conserve le jeton dans le coffre système ; Codespaces peut utiliser le secret `KOD8_TOKEN`. Vérifier la version avec `kod8 --version`.
+
+Utilisez directement le nom de l’exercice, sans extension :
+
+```bash
+kod8 test contact
+```
+
+*Ou si vous êtes directement dans le sous-dossier de l'exercice :*
+```bash
+kod8 test
+```
+
+L’outil exécute les tests publics disponibles sur votre ordinateur. Une grille absente ne permet pas de conclure à une réussite.
+
+---
+
+### 2. Valider et enregistrer officiellement sa progression
+
+Quand tout est vert, vous soumettez votre solution en une seule commande :
+
+```bash
+kod8 submit contact
+```
+
+La commande relance les tests publics. Après réussite, elle crée un commit horodaté pour le seul fichier de l’exercice, pousse le commit, puis soumet le code pour votre compte. Seuls des tests serveur réussis valident l’exercice. Un fichier inchangé ne crée pas de commit supplémentaire. `--retry` crée une nouvelle tentative après une erreur technique ; `--no-push` est réservé aux intégrations techniques.
+
+Codes de sortie : 0 réussite, 1 échec, 2 revue nécessaire, 3 erreur technique, 4 correction en cours. Les projets et exercices à plusieurs fichiers, à fichiers produits, d’environnement ou d’API se déposent sur leur page avec le dépôt et les preuves ; ils ne sont pas validés par un simple main.py.
+
+Pour GitHub Actions, copier `examples/github-actions.yml` dans `.github/workflows/kod8.yml` et `examples/ci_submit.py` dans `.github/scripts/ci_submit.py` du dépôt apprenant. Ajouter le secret `KOD8_TOKEN` et la variable `KOD8_API_URL` si nécessaire. Le helper soumet les scripts nommés reconnus par le catalogue et conserve la compatibilité avec `python/m*/ex*/main.py` ; il n’exécute pas le code apprenant dans la CI. Ne pas appliquer ce workflow aux activités qui demandent un livrable en revue.
+
+Le catalogue canonique est `lib/course-content/exercise-contracts.json`. Sa copie embarquée dans la CLI est `kod8/exercises.json`. Régénérer avec `python scripts/build-exercise-contracts.py`, puis produire l’archive téléchargeable avec `python scripts/package-cli.py`. Le paquet n’est pas confirmé publié sur PyPI.

kod8_cli-0.2.0/kod8/exercises.json

@@ -0,0 +1,522 @@
+[
+  {
+    "name": "contact",
+    "filename": "contact.py",
+    "moduleId": "01",
+    "stepId": "exercice-01",
+    "slug": "python/m1/ex1",
+    "mode": "code"
+  },
+  {
+    "name": "fiche",
+    "filename": "fiche.py",
+    "moduleId": "01",
+    "stepId": "exercice-02",
+    "slug": "python/m1/ex2",
+    "mode": "code"
+  },
+  {
+    "name": "budget",
+    "filename": "budget.py",
+    "moduleId": "01",
+    "stepId": "exercice-03",
+    "slug": "python/m1/ex3",
+    "mode": "code"
+  },
+  {
+    "name": "facture",
+    "filename": "facture.py",
+    "moduleId": "01",
+    "stepId": "exercice-04",
+    "slug": "python/m1/ex4",
+    "mode": "code"
+  },
+  {
+    "name": "temps",
+    "filename": "temps.py",
+    "moduleId": "01",
+    "stepId": "exercice-05",
+    "slug": "python/m1/ex5",
+    "mode": "code"
+  },
+  {
+    "name": "garde",
+    "filename": "garde.py",
+    "moduleId": "02",
+    "stepId": "exercice-01",
+    "slug": "python/m2/ex1",
+    "mode": "code"
+  },
+  {
+    "name": "parite",
+    "filename": "parite.py",
+    "moduleId": "02",
+    "stepId": "exercice-02",
+    "slug": "python/m2/ex2",
+    "mode": "code"
+  },
+  {
+    "name": "retrait",
+    "filename": "retrait.py",
+    "moduleId": "02",
+    "stepId": "exercice-03",
+    "slug": "python/m2/ex3",
+    "mode": "code"
+  },
+  {
+    "name": "cinema",
+    "filename": "cinema.py",
+    "moduleId": "02",
+    "stepId": "exercice-04",
+    "slug": "python/m2/ex4",
+    "mode": "code"
+  },
+  {
+    "name": "bissextile",
+    "filename": "bissextile.py",
+    "moduleId": "02",
+    "stepId": "exercice-05",
+    "slug": "python/m2/ex5",
+    "mode": "code"
+  },
+  {
+    "name": "repetition",
+    "filename": "repetition.py",
+    "moduleId": "03",
+    "stepId": "exercice-01",
+    "slug": "python/m3/ex1",
+    "mode": "code"
+  },
+  {
+    "name": "mot_de_passe",
+    "filename": "mot_de_passe.py",
+    "moduleId": "03",
+    "stepId": "exercice-02",
+    "slug": "python/m3/ex2",
+    "mode": "code"
+  },
+  {
+    "name": "menu",
+    "filename": "menu.py",
+    "moduleId": "03",
+    "stepId": "exercice-03",
+    "slug": "python/m3/ex3",
+    "mode": "code"
+  },
+  {
+    "name": "moyenne",
+    "filename": "moyenne.py",
+    "moduleId": "03",
+    "stepId": "exercice-04",
+    "slug": "python/m3/ex4",
+    "mode": "code"
+  },
+  {
+    "name": "pyramide",
+    "filename": "pyramide.py",
+    "moduleId": "03",
+    "stepId": "exercice-05",
+    "slug": "python/m3/ex5",
+    "mode": "code"
+  },
+  {
+    "name": "cri",
+    "filename": "cri.py",
+    "moduleId": "04",
+    "stepId": "exercice-01",
+    "slug": "python/m4/ex1",
+    "mode": "code"
+  },
+  {
+    "name": "voyelles",
+    "filename": "voyelles.py",
+    "moduleId": "04",
+    "stepId": "exercice-02",
+    "slug": "python/m4/ex2",
+    "mode": "code"
+  },
+  {
+    "name": "email",
+    "filename": "email.py",
+    "moduleId": "04",
+    "stepId": "exercice-03",
+    "slug": "python/m4/ex3",
+    "mode": "code"
+  },
+  {
+    "name": "censure",
+    "filename": "censure.py",
+    "moduleId": "04",
+    "stepId": "exercice-04",
+    "slug": "python/m4/ex4",
+    "mode": "code"
+  },
+  {
+    "name": "palindrome",
+    "filename": "palindrome.py",
+    "moduleId": "04",
+    "stepId": "exercice-05",
+    "slug": "python/m4/ex5",
+    "mode": "code"
+  },
+  {
+    "name": "courses",
+    "filename": "courses.py",
+    "moduleId": "05",
+    "stepId": "exercice-01",
+    "slug": "python/m5/ex1",
+    "mode": "code"
+  },
+  {
+    "name": "enumeration",
+    "filename": "enumeration.py",
+    "moduleId": "05",
+    "stepId": "exercice-02",
+    "slug": "python/m5/ex2",
+    "mode": "code"
+  },
+  {
+    "name": "statistiques",
+    "filename": "statistiques.py",
+    "moduleId": "05",
+    "stepId": "exercice-03",
+    "slug": "python/m5/ex3",
+    "mode": "code"
+  },
+  {
+    "name": "filtre",
+    "filename": "filtre.py",
+    "moduleId": "05",
+    "stepId": "exercice-04",
+    "slug": "python/m5/ex4",
+    "mode": "code"
+  },
+  {
+    "name": "tri_bulles",
+    "filename": "tri_bulles.py",
+    "moduleId": "05",
+    "stepId": "exercice-05",
+    "slug": "python/m5/ex5",
+    "mode": "code"
+  },
+  {
+    "name": "profil",
+    "filename": "profil.py",
+    "moduleId": "06",
+    "stepId": "exercice-01",
+    "slug": "python/m6/ex1",
+    "mode": "code"
+  },
+  {
+    "name": "mise_a_jour",
+    "filename": "mise_a_jour.py",
+    "moduleId": "06",
+    "stepId": "exercice-02",
+    "slug": "python/m6/ex2",
+    "mode": "code"
+  },
+  {
+    "name": "annuaire",
+    "filename": "annuaire.py",
+    "moduleId": "06",
+    "stepId": "exercice-03",
+    "slug": "python/m6/ex3",
+    "mode": "code"
+  },
+  {
+    "name": "panier",
+    "filename": "panier.py",
+    "moduleId": "06",
+    "stepId": "exercice-04",
+    "slug": "python/m6/ex4",
+    "mode": "code"
+  },
+  {
+    "name": "frequences",
+    "filename": "frequences.py",
+    "moduleId": "06",
+    "stepId": "exercice-05",
+    "slug": "python/m6/ex5",
+    "mode": "code"
+  },
+  {
+    "name": "politesse",
+    "filename": "politesse.py",
+    "moduleId": "07",
+    "stepId": "exercice-01",
+    "slug": "python/m7/ex1",
+    "mode": "code"
+  },
+  {
+    "name": "tva",
+    "filename": "tva.py",
+    "moduleId": "07",
+    "stepId": "exercice-02",
+    "slug": "python/m7/ex2",
+    "mode": "code"
+  },
+  {
+    "name": "validateur",
+    "filename": "validateur.py",
+    "moduleId": "07",
+    "stepId": "exercice-03",
+    "slug": "python/m7/ex3",
+    "mode": "code"
+  },
+  {
+    "name": "identifiant",
+    "filename": "identifiant.py",
+    "moduleId": "07",
+    "stepId": "exercice-04",
+    "slug": "python/m7/ex4",
+    "mode": "code"
+  },
+  {
+    "name": "multi_retours",
+    "filename": "multi_retours.py",
+    "moduleId": "07",
+    "stepId": "exercice-05",
+    "slug": "python/m7/ex5",
+    "mode": "code"
+  },
+  {
+    "name": "module_natif",
+    "filename": "module_natif.py",
+    "moduleId": "08",
+    "stepId": "exercice-01",
+    "slug": "python/m8/ex1",
+    "mode": "code"
+  },
+  {
+    "name": "structure",
+    "filename": "structure.py",
+    "moduleId": "08",
+    "stepId": "exercice-02",
+    "slug": "python/m8/ex2",
+    "mode": "code"
+  },
+  {
+    "name": "architecte",
+    "filename": "architecte.py",
+    "moduleId": "08",
+    "stepId": "exercice-03",
+    "slug": "python/m8/ex3",
+    "mode": "artifact"
+  },
+  {
+    "name": "import_specifique",
+    "filename": "import_specifique.py",
+    "moduleId": "08",
+    "stepId": "exercice-04",
+    "slug": "python/m8/ex4",
+    "mode": "artifact"
+  },
+  {
+    "name": "mutabilite",
+    "filename": "mutabilite.py",
+    "moduleId": "08",
+    "stepId": "exercice-05",
+    "slug": "python/m8/ex5",
+    "mode": "code"
+  },
+  {
+    "name": "bloc_notes",
+    "filename": "bloc_notes.py",
+    "moduleId": "09",
+    "stepId": "exercice-01",
+    "slug": "python/m9/ex1",
+    "mode": "artifact"
+  },
+  {
+    "name": "horodatage",
+    "filename": "horodatage.py",
+    "moduleId": "09",
+    "stepId": "exercice-02",
+    "slug": "python/m9/ex2",
+    "mode": "artifact"
+  },
+  {
+    "name": "export_csv",
+    "filename": "export_csv.py",
+    "moduleId": "09",
+    "stepId": "exercice-03",
+    "slug": "python/m9/ex3",
+    "mode": "artifact"
+  },
+  {
+    "name": "lecture_json",
+    "filename": "lecture_json.py",
+    "moduleId": "09",
+    "stepId": "exercice-04",
+    "slug": "python/m9/ex4",
+    "mode": "artifact"
+  },
+  {
+    "name": "conversion_csv",
+    "filename": "conversion_csv.py",
+    "moduleId": "09",
+    "stepId": "exercice-05",
+    "slug": "python/m9/ex5",
+    "mode": "artifact"
+  },
+  {
+    "name": "division",
+    "filename": "division.py",
+    "moduleId": "10",
+    "stepId": "exercice-01",
+    "slug": "python/m10/ex1",
+    "mode": "code"
+  },
+  {
+    "name": "age_valide",
+    "filename": "age_valide.py",
+    "moduleId": "10",
+    "stepId": "exercice-02",
+    "slug": "python/m10/ex2",
+    "mode": "code"
+  },
+  {
+    "name": "test_mon_code",
+    "filename": "test_mon_code.py",
+    "moduleId": "10",
+    "stepId": "exercice-03",
+    "slug": "python/m10/ex3",
+    "mode": "artifact"
+  },
+  {
+    "name": "lecture_securisee",
+    "filename": "lecture_securisee.py",
+    "moduleId": "10",
+    "stepId": "exercice-04",
+    "slug": "python/m10/ex4",
+    "mode": "code"
+  },
+  {
+    "name": "test_prix_ttc",
+    "filename": "test_prix_ttc.py",
+    "moduleId": "10",
+    "stepId": "exercice-05",
+    "slug": "python/m10/ex5",
+    "mode": "artifact"
+  },
+  {
+    "name": "creation_venv",
+    "filename": "creation_venv.py",
+    "moduleId": "11",
+    "stepId": "exercice-01",
+    "slug": "python/m11/ex1",
+    "mode": "artifact"
+  },
+  {
+    "name": "activation_venv",
+    "filename": "activation_venv.py",
+    "moduleId": "11",
+    "stepId": "exercice-02",
+    "slug": "python/m11/ex2",
+    "mode": "artifact"
+  },
+  {
+    "name": "test_couleur",
+    "filename": "test_couleur.py",
+    "moduleId": "11",
+    "stepId": "exercice-03",
+    "slug": "python/m11/ex3",
+    "mode": "artifact"
+  },
+  {
+    "name": "requirements",
+    "filename": "requirements.py",
+    "moduleId": "11",
+    "stepId": "exercice-04",
+    "slug": "python/m11/ex4",
+    "mode": "artifact"
+  },
+  {
+    "name": "transfert_venv",
+    "filename": "transfert_venv.py",
+    "moduleId": "11",
+    "stepId": "exercice-05",
+    "slug": "python/m11/ex5",
+    "mode": "artifact"
+  },
+  {
+    "name": "livre",
+    "filename": "livre.py",
+    "moduleId": "12",
+    "stepId": "exercice-01",
+    "slug": "python/m12/ex1",
+    "mode": "code"
+  },
+  {
+    "name": "details_livre",
+    "filename": "details_livre.py",
+    "moduleId": "12",
+    "stepId": "exercice-02",
+    "slug": "python/m12/ex2",
+    "mode": "code"
+  },
+  {
+    "name": "panier_objet",
+    "filename": "panier_objet.py",
+    "moduleId": "12",
+    "stepId": "exercice-03",
+    "slug": "python/m12/ex3",
+    "mode": "code"
+  },
+  {
+    "name": "transfert",
+    "filename": "transfert.py",
+    "moduleId": "12",
+    "stepId": "exercice-04",
+    "slug": "python/m12/ex4",
+    "mode": "code"
+  },
+  {
+    "name": "epargne",
+    "filename": "epargne.py",
+    "moduleId": "12",
+    "stepId": "exercice-05",
+    "slug": "python/m12/ex5",
+    "mode": "code"
+  },
+  {
+    "name": "configuration",
+    "filename": "configuration.py",
+    "moduleId": "13",
+    "stepId": "exercice-01",
+    "slug": "python/m13/ex1",
+    "mode": "artifact"
+  },
+  {
+    "name": "requete_get",
+    "filename": "requete_get.py",
+    "moduleId": "13",
+    "stepId": "exercice-02",
+    "slug": "python/m13/ex2",
+    "mode": "artifact"
+  },
+  {
+    "name": "poids_pokemon",
+    "filename": "poids_pokemon.py",
+    "moduleId": "13",
+    "stepId": "exercice-03",
+    "slug": "python/m13/ex3",
+    "mode": "artifact"
+  },
+  {
+    "name": "appel_ia",
+    "filename": "appel_ia.py",
+    "moduleId": "13",
+    "stepId": "exercice-04",
+    "slug": "python/m13/ex4",
+    "mode": "artifact"
+  },
+  {
+    "name": "fallback",
+    "filename": "fallback.py",
+    "moduleId": "13",
+    "stepId": "exercice-05",
+    "slug": "python/m13/ex5",
+    "mode": "artifact"
+  }
+]

kod8_cli-0.2.0/kod8/main.py

@@ -0,0 +1,180 @@
+import argparse
+import hashlib
+import json
+import getpass
+import os
+import pathlib
+import re
+import subprocess
+import sys
+import uuid
+from datetime import datetime, timezone
+from urllib.parse import urlparse
+import requests
+from rich.console import Console
+from rich.panel import Panel
+from rich.text import Text
+
+console = Console()
+
+EXERCISES = json.loads(pathlib.Path(__file__).with_name('exercises.json').read_text(encoding='utf-8'))
+CONFIG = pathlib.Path.home() / '.config' / 'kod8' / 'config.json'
+
+def settings():
+    return json.loads(CONFIG.read_text(encoding='utf-8')) if CONFIG.is_file() else {}
+
+def connection():
+    base = os.environ.get('KOD8_API_URL', settings().get('api_url', 'https://kod8.live/api/cli')).rstrip('/')
+    token = os.environ.get('KOD8_TOKEN', '')
+    if not token:
+        import keyring
+        try:
+            token = keyring.get_password('KOD8', base) or ''
+        except keyring.errors.KeyringError:
+            raise ValueError('Le coffre de votre système est indisponible. Configurez KOD8_TOKEN dans les secrets de votre environnement.')
+    parsed = urlparse(base)
+    if parsed.scheme != 'https' and not (parsed.scheme == 'http' and parsed.hostname in ('localhost', '127.0.0.1')):
+        raise ValueError('KOD8_API_URL doit utiliser HTTPS (HTTP permis uniquement en développement local).')
+    if not re.fullmatch(r'kod8_[a-f0-9]{64}', token):
+        raise ValueError('Terminez la configuration initiale : kod8 login.')
+    return base, {'Authorization': f'Bearer {token}'}
+
+def resolve_target(slug, file):
+    contract = next((c for c in EXERCISES if c['name'] == (slug or '').removesuffix('.py')), None)
+    if contract:
+        if contract['mode'] != 'code':
+            raise ValueError('Cette activité demande un dépôt et des preuves : utilisez sa page KOD8.')
+        target = pathlib.Path(file or contract['filename'])
+        if target.name != contract['filename']:
+            raise ValueError(f"Nommez le fichier exactement {contract['filename']}.")
+        if not target.is_file():
+            raise ValueError(f'Fichier introuvable : {target}')
+        return contract['slug'], target
+    if not slug:
+        match = re.search(r'(python/m\d+/ex[1-5])(?:/|$)', pathlib.Path.cwd().as_posix())
+        if not match:
+            raise ValueError('Précisez le nom indiqué dans l’exercice : kod8 submit contact')
+        slug = match.group(1)
+    if not re.fullmatch(r'python/m\d{1,2}/(?:ex[1-5]|activite-\d{2})', slug):
+        raise ValueError('Identifiant d’exercice invalide.')
+    target = pathlib.Path(file or 'main.py')
+    if not target.is_file():
+        raise ValueError(f'Fichier introuvable : {target}')
+    return slug, target
+
+def git_sha():
+    result = subprocess.run(['git', 'rev-parse', 'HEAD'], capture_output=True, text=True)
+    return result.stdout.strip() if result.returncode == 0 else None
+
+def test_command(args):
+    base, headers = connection()
+    slug, file = resolve_target(args.slug, args.file)
+    response = requests.get(f'{base}/tests', params={'slug': slug}, headers=headers, timeout=15)
+    if not response.ok:
+        raise ValueError(response.json().get('error', 'Tests indisponibles.'))
+    tests = response.json().get('tests', [])
+    if not tests:
+        print('Aucun test public disponible. La soumission restera en revue si la grille serveur manque.')
+        return 2
+    passed = 0
+    for test in tests:
+        definition = test['definition']
+        try:
+            run = subprocess.run([sys.executable, str(file)], input=definition.get('stdin', ''), text=True, capture_output=True, timeout=5)
+            success = run.returncode == 0 and all(part in run.stdout for part in definition['stdoutIncludesAll'])
+            detail = run.stderr[-1200:] if run.returncode else run.stdout[-1200:]
+        except subprocess.TimeoutExpired:
+            success = False
+            detail = 'Temps maximal dépassé (5 secondes).'
+        passed += int(success)
+        console.print(Text(f"{test['name']} : {'réussi' if success else 'à reprendre'}", style='#3158d8' if success else '#d75a36'))
+        if not success:
+            console.print(Panel(Text(detail or 'Aucune sortie.'), title='Résultat à reprendre', border_style='#d75a36'))
+    print(f'{passed}/{len(tests)} tests publics réussis. Ce résultat local ne modifie pas la progression.')
+    return 0 if passed == len(tests) else 1
+
+def submit_command(args):
+    base, headers = connection()
+    slug, file = resolve_target(args.slug, args.file)
+    source = file.read_text(encoding='utf-8')
+    if len(source.encode('utf-8')) > 64000:
+        raise ValueError('Source trop volumineuse (64 Ko maximum).')
+    # A submission first checks the public cases and only versions this file.
+    checked = test_command(args)
+    if checked != 0:
+        print('Soumission interrompue : les tests publics doivent réussir avant le commit et le push.')
+        return checked
+    if not args.no_push:
+        subprocess.run(['git', 'add', '--', str(file)], check=True)
+        staged = subprocess.run(['git', 'diff', '--cached', '--quiet', '--', str(file)], check=False)
+        if staged.returncode == 1:
+            stamp = datetime.now(timezone.utc).strftime('%Y-%m-%d %H:%M UTC')
+            subprocess.run(['git', 'commit', '--only', '-m', f'[KOD8] Validation : {file.stem} ({stamp})', '--', str(file)], check=True)
+        subprocess.run(['git', 'push'], check=True)
+    sha = git_sha()
+    key = uuid.uuid4().hex if args.retry else hashlib.sha256(f'{slug}:{sha}:{source}'.encode()).hexdigest()
+    response = requests.post(f'{base}/submit', json={'slug': slug, 'source': source, 'commitSha': sha, 'requestId': key}, headers=headers, timeout=40)
+    data = response.json()
+    if not response.ok:
+        raise ValueError(data.get('error', 'Soumission non enregistrée.'))
+    status = data.get('status')
+    print(f"{data.get('activity', slug)} : {status}")
+    if data.get('message'):
+        print(data['message'])
+    for result in data.get('results', []):
+        print(f"{result['name']} : {result['message']}")
+    if status == 'passed':
+        print('Exercice validé. Progression enregistrée dans votre compte.')
+        return 0
+    return {'failed': 1, 'needs_review': 2, 'error': 3, 'timeout': 3, 'running': 4}.get(status, 3)
+
+def login_command(args):
+    base = (args.api_url or os.environ.get('KOD8_API_URL', 'https://kod8.live/api/cli')).rstrip('/')
+    parsed = urlparse(base)
+    if parsed.scheme != 'https' and not (parsed.scheme == 'http' and parsed.hostname in ('localhost', '127.0.0.1')):
+        raise ValueError('Adresse KOD8 invalide : HTTPS requis.')
+    print(f"Configuration initiale : {base.removesuffix('/api/cli')}/formations/python/installation#cli")
+    token = getpass.getpass('Collez le jeton de configuration (saisie masquée) : ')
+    if not re.fullmatch(r'kod8_[a-f0-9]{64}', token):
+        raise ValueError('Jeton invalide.')
+    r = requests.get(f'{base}/tests', params={'slug': 'contact'}, headers={'Authorization': f'Bearer {token}'}, timeout=15)
+    if not r.ok:
+        raise ValueError('La connexion KOD8 n’a pas été confirmée. Vérifiez le jeton et l’adresse du site.')
+    import keyring
+    try:
+        keyring.set_password('KOD8', base, token)
+    except keyring.errors.KeyringError:
+        raise ValueError('Coffre système indisponible. Dans Codespaces, utilisez le secret KOD8_TOKEN et KOD8_API_URL.')
+    CONFIG.parent.mkdir(parents=True, exist_ok=True)
+    CONFIG.write_text(json.dumps({'api_url': base}), encoding='utf-8')
+    print('KOD8 est prêt. Vous pouvez utiliser kod8 test contact et kod8 submit contact.')
+    return 0
+
+def cli():
+    parser = argparse.ArgumentParser(description='KOD8 : tests locaux et soumissions liées à votre compte')
+    parser.add_argument('--version', action='version', version='KOD8 0.2.0')
+    sub = parser.add_subparsers(dest='command', required=True)
+    login = sub.add_parser('login', help='Configurer votre compte une seule fois')
+    login.add_argument('--api-url')
+    for command in ('test', 'submit'):
+        p = sub.add_parser(command)
+        p.add_argument('slug', nargs='?')
+        p.add_argument('file', nargs='?')
+        if command == 'submit':
+            p.add_argument('--no-push', action='store_true', help='Soumettre sans commit/push (usage technique)')
+            p.add_argument('--push', action='store_true', help=argparse.SUPPRESS)
+            p.add_argument('--retry', action='store_true', help='Créer une nouvelle tentative après une erreur technique')
+    args = parser.parse_args()
+    try:
+        status = login_command(args) if args.command == 'login' else test_command(args) if args.command == 'test' else submit_command(args)
+    except ValueError as error:
+        print(str(error), file=sys.stderr)
+        status = 3
+    except (OSError, requests.RequestException, subprocess.CalledProcessError):
+        print('Action non terminée. Vérifiez le jeton, la connexion, le fichier et les outils Git ; réessayez.', file=sys.stderr)
+        status = 3
+    sys.exit(status)
+
+if __name__ == '__main__':
+    cli()
+

kod8_cli-0.2.0/kod8_cli.egg-info/PKG-INFO

@@ -0,0 +1,68 @@
+Metadata-Version: 2.4
+Name: kod8-cli
+Version: 0.2.0
+Summary: KOD8 Command Line Interface for local testing
+Home-page: https://github.com/Rodrigue-k/kod8
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: requests
+Requires-Dist: rich
+Requires-Dist: keyring
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# KOD8 CLI
+
+Tester des exercices à fichier unique en local, puis envoyer leur code au correcteur KOD8. Les tests locaux ne valident pas la progression.
+
+## Installation locale
+
+```bash
+cd cli
+pip install -e .
+```
+
+Se connecter sur KOD8, ouvrir `/formations/python/soumissions`, créer un jeton personnel et le fournir dans `KOD8_TOKEN`. Ne jamais le committer. `KOD8_API_URL` vaut `https://kod8.live/api/cli` ; en développement : `http://localhost:5173/api/cli`.
+
+---
+
+## Utilisation quotidienne
+
+### 1. Tester son code en local (sans impacter sa note)
+
+Créez le fichier imposé par l’énoncé (par exemple `contact.py`). L’installation et la connexion se font une seule fois dans le guide d’installation, avec `kod8 login`. La CLI conserve le jeton dans le coffre système ; Codespaces peut utiliser le secret `KOD8_TOKEN`. Vérifier la version avec `kod8 --version`.
+
+Utilisez directement le nom de l’exercice, sans extension :
+
+```bash
+kod8 test contact
+```
+
+*Ou si vous êtes directement dans le sous-dossier de l'exercice :*
+```bash
+kod8 test
+```
+
+L’outil exécute les tests publics disponibles sur votre ordinateur. Une grille absente ne permet pas de conclure à une réussite.
+
+---
+
+### 2. Valider et enregistrer officiellement sa progression
+
+Quand tout est vert, vous soumettez votre solution en une seule commande :
+
+```bash
+kod8 submit contact
+```
+
+La commande relance les tests publics. Après réussite, elle crée un commit horodaté pour le seul fichier de l’exercice, pousse le commit, puis soumet le code pour votre compte. Seuls des tests serveur réussis valident l’exercice. Un fichier inchangé ne crée pas de commit supplémentaire. `--retry` crée une nouvelle tentative après une erreur technique ; `--no-push` est réservé aux intégrations techniques.
+
+Codes de sortie : 0 réussite, 1 échec, 2 revue nécessaire, 3 erreur technique, 4 correction en cours. Les projets et exercices à plusieurs fichiers, à fichiers produits, d’environnement ou d’API se déposent sur leur page avec le dépôt et les preuves ; ils ne sont pas validés par un simple main.py.
+
+Pour GitHub Actions, copier `examples/github-actions.yml` dans `.github/workflows/kod8.yml` et `examples/ci_submit.py` dans `.github/scripts/ci_submit.py` du dépôt apprenant. Ajouter le secret `KOD8_TOKEN` et la variable `KOD8_API_URL` si nécessaire. Le helper soumet les scripts nommés reconnus par le catalogue et conserve la compatibilité avec `python/m*/ex*/main.py` ; il n’exécute pas le code apprenant dans la CI. Ne pas appliquer ce workflow aux activités qui demandent un livrable en revue.
+
+Le catalogue canonique est `lib/course-content/exercise-contracts.json`. Sa copie embarquée dans la CLI est `kod8/exercises.json`. Régénérer avec `python scripts/build-exercise-contracts.py`, puis produire l’archive téléchargeable avec `python scripts/package-cli.py`. Le paquet n’est pas confirmé publié sur PyPI.

kod8_cli-0.2.0/kod8_cli.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+MANIFEST.in
+README.md
+pyproject.toml
+setup.py
+kod8/__init__.py
+kod8/exercises.json
+kod8/main.py
+kod8_cli.egg-info/PKG-INFO
+kod8_cli.egg-info/SOURCES.txt
+kod8_cli.egg-info/dependency_links.txt
+kod8_cli.egg-info/entry_points.txt
+kod8_cli.egg-info/requires.txt
+kod8_cli.egg-info/top_level.txt

kod8_cli-0.2.0/kod8_cli.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

kod8_cli-0.2.0/kod8_cli.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+kod8 = kod8.main:cli

kod8_cli-0.2.0/kod8_cli.egg-info/requires.txt

@@ -0,0 +1,3 @@
+requests
+rich
+keyring

kod8_cli-0.2.0/kod8_cli.egg-info/top_level.txt

@@ -0,0 +1 @@
+kod8

kod8_cli-0.2.0/pyproject.toml

@@ -0,0 +1,3 @@
+[build-system]
+requires = ["setuptools>=77", "wheel"]
+build-backend = "setuptools.build_meta"

kod8_cli-0.2.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

kod8_cli-0.2.0/setup.py

@@ -0,0 +1,24 @@
+from pathlib import Path
+from setuptools import setup, find_packages
+
+setup(
+    name='kod8-cli',
+    version='0.2.0',
+    description='KOD8 Command Line Interface for local testing',
+    long_description=Path(__file__).with_name('README.md').read_text(encoding='utf-8'),
+    long_description_content_type='text/markdown',
+    url='https://github.com/Rodrigue-k/kod8',
+    python_requires='>=3.10',
+    packages=find_packages(include=['kod8', 'kod8.*']),
+    package_data={'kod8': ['exercises.json']},
+    install_requires=[
+        'requests',
+        'rich',
+        'keyring',
+    ],
+    entry_points={
+        'console_scripts': [
+            'kod8=kod8.main:cli',
+        ],
+    },
+)