fhe-cli 1.3.1__tar.gz

fhe_cli-1.3.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ravin THILAGARASA, Thomas GRUNDSZTEJN
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

fhe_cli-1.3.1/MANIFEST.in

@@ -0,0 +1,11 @@
+# Contenu du sdist : code du paquet, données embarquées, tests de l'outil.
+include README.md LICENSE
+graft fhecli/data
+graft tests
+# Jamais dans les archives publiées : solutions en clair, espace de travail
+# de développement, script d'encodage (inutile sans les solutions en clair).
+prune solutions_src
+prune exercises
+prune scripts
+exclude fhecli.toml pytest.ini requirements.txt
+global-exclude *.py[cod] __pycache__

fhe_cli-1.3.1/PKG-INFO

@@ -0,0 +1,280 @@
+Metadata-Version: 2.4
+Name: fhe-cli
+Version: 1.3.1
+Summary: Atelier d'exercices en ligne de commande, à la rustlings : chiffrement classique et chiffrement homomorphe (FHE)
+Author: Ravin THILAGARASA, Thomas GRUNDSZTEJN
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Defl3ct-941/Scoring_FHE
+Project-URL: Source, https://github.com/Defl3ct-941/Scoring_FHE/tree/main/03_cas_pratiques/fhe-exercices-cli
+Project-URL: Issues, https://github.com/Defl3ct-941/Scoring_FHE/issues
+Project-URL: GitLab, https://gitlab.securechat.fr/esgi/5a/Scoring_FHE
+Project-URL: Changelog, https://github.com/Defl3ct-941/Scoring_FHE/blob/main/CHANGELOG.md
+Keywords: fhe,chiffrement homomorphe,homomorphic encryption,cryptographie,cryptography,exercices,rustlings,enseignement,scoring
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Education
+Classifier: Natural Language :: French
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Classifier: Topic :: Education
+Classifier: Topic :: Security :: Cryptography
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pytest<10,>=9.2
+Requires-Dist: cryptography<51,>=50.0
+Provides-Extra: ckks
+Requires-Dist: tenseal<0.4,>=0.3.16; extra == "ckks"
+Dynamic: license-file
+
+# fhecli : atelier CLI de chiffrement classique et FHE
+
+Un atelier d'exercices en ligne de commande, inspiré de
+[rustlings](https://github.com/rust-lang/rustlings) : vous éditez les fichiers
+d'exercice dans votre propre éditeur, avec votre propre environnement Python,
+et un petit outil (`fhecli`) surveille vos fichiers et relance les tests à
+chaque sauvegarde.
+
+Il accompagne le cours « Scoring financier sur données chiffrées via FHE »
+(FYC, ESGI) : c'est la même progression pédagogique que l'atelier web du
+projet, adaptée pour tourner directement dans votre terminal.
+
+> **Version actuelle : 3 exercices.** Seul le module A (chiffrement
+> classique) est publié pour le moment. Les modules suivants (arithmétique
+> modulaire, Paillier from scratch, scoring chiffré, bonus CKKS) arriveront
+> dans une prochaine mise à jour.
+
+## Installation
+
+Python 3.11 ou plus récent est requis.
+
+```bash
+python -m venv .venv
+# Windows
+.venv\Scripts\activate
+# macOS / Linux
+source .venv/bin/activate
+
+pip install fhe-cli
+fhecli init            # crée le dossier ./fhe-exercices avec les exercices
+cd fhe-exercices
+fhecli watch
+```
+
+Le paquet s'installe sous le nom **`fhe-cli`** ; la commande et le module
+Python restent `fhecli`.
+
+`fhecli init [dossier]` crée un **espace de travail** : le dossier
+`exercises/` (vos fichiers), un `pytest.ini` et un fichier marqueur
+`fhecli.toml`. Les commandes de `fhecli` retrouvent cet espace depuis n'importe
+quel sous-dossier. `fhecli init` refuse d'écraser un espace existant.
+
+### Sans Python : exécutable autonome
+
+Pour chaque OS, un exécutable unique embarque tout (Python, `fhecli`,
+`pytest`, `cryptography` et les exercices) : **aucune installation de Python
+n'est nécessaire**. Téléchargez celui de votre système
+(`fhecli-<version>-windows-x86_64.exe`, `-linux-x86_64`, `-macos-arm64` ou
+`-macos-x86_64`), puis :
+
+```bash
+# Windows (PowerShell)
+.hecli-1.2.0-windows-x86_64.exe init
+# macOS / Linux
+chmod +x fhecli-1.2.0-linux-x86_64
+./fhecli-1.2.0-linux-x86_64 init
+```
+
+Renommez-le en `fhecli` (ou `fhecli.exe`) et placez-le dans un dossier du
+`PATH` pour l'utiliser comme dans les exemples ci-dessous. Le code et les
+solutions y sont embarqués compressés, jamais en clair. Sous macOS, au premier
+lancement, autorisez le binaire dans Réglages système > Confidentialité et
+sécurité (il n'est pas signé).
+
+## Utilisation
+
+### Mode guidé (recommandé pour commencer)
+
+```bash
+fhecli watch
+```
+
+Affiche l'exercice courant, relance ses tests à chaque fois que vous
+sauvegardez le fichier, et passe automatiquement au suivant une fois qu'il est
+résolu (en proposant alors d'afficher la solution de référence pour comparer).
+Ctrl+C pour quitter à tout moment : rien n'est perdu, vos fichiers restent sur
+le disque.
+
+### Autres commandes
+
+```bash
+fhecli list                  # vue d'ensemble des exercices et de leur statut
+fhecli run ex1_cesar         # lance les tests d'un seul exercice
+fhecli hint ex1_cesar        # affiche un indice ciblé
+fhecli solution ex1_cesar    # affiche la solution (une fois l'exercice résolu)
+fhecli reset ex1_cesar       # remet CET exercice à son énoncé de départ (avec confirmation)
+fhecli reset --all           # remet TOUS les exercices à leur énoncé de départ (avec confirmation)
+fhecli reset --all -y        # idem, sans confirmation
+fhecli --version
+```
+
+Codes de sortie de `fhecli run` : `0` exercice résolu, `1` tests en échec
+(ou erreur), `2` tests OK mais ligne `# I AM NOT DONE` encore présente.
+
+Vous pouvez aussi lancer les tests vous-même avec `python -m pytest` depuis
+l'espace de travail : le `pytest.ini` fourni collecte bien les exercices.
+
+## Comment marche un exercice
+
+Chaque exercice est un unique fichier `.py` dans `exercises/`, qui contient
+tout :
+
+1. Un docstring en haut du fichier avec l'énoncé complet (contexte,
+   formules, ce qu'il faut implémenter, indices).
+2. Une ligne `# I AM NOT DONE` juste après : tant qu'elle est présente,
+   l'exercice est considéré comme « pas terminé », même si les tests passent
+   déjà. **Retirez-la vous-même** une fois satisfait de votre solution :
+   c'est un geste délibérément manuel, pour vous forcer à vraiment valider
+   votre travail.
+3. La ou les fonctions à compléter (marquées `raise NotImplementedError`).
+4. Une section de tests en bas du fichier (à ne pas modifier), exécutée par
+   `pytest` à chaque `fhecli run` / `fhecli watch`.
+
+## Solutions
+
+La solution de référence d'un exercice est **verrouillée** tant que
+l'exercice n'est pas résolu : `fhecli solution` ne l'affiche qu'une fois que
+les tests passent **et** que la ligne `# I AM NOT DONE` a été retirée.
+
+Dans le paquet, les solutions ne sont pas stockées en clair : elles sont
+compressées et encodées (zlib + base64). C'est une **dissuasion**, pour
+éviter de tomber sur la correction par hasard en fouillant le dossier du
+paquet, **pas une protection** : rien n'empêche quelqu'un de déterminé de les
+décoder. Le vrai garde-fou reste pédagogique.
+
+## Progression (dans l'ordre suivi par `fhecli watch`)
+
+| # | Exercice | Catégorie |
+|---|----------|-----------|
+| 1 | ex1_cesar | A. Chiffrement classique |
+| 2 | ex2_xor_malleability | A. Chiffrement classique |
+| 3 | ex3_fernet_tamper | A. Chiffrement classique |
+| 4 | ex4_modpow | B. Briques mathématiques |
+| 5 | ex5_modinv | B. Briques mathématiques |
+| 6 | ex6_paillier_keygen | C. Paillier, pas à pas |
+| 7 | ex7_paillier_enc_dec | C. Paillier, pas à pas |
+| 8 | ex8_paillier_homomorphic | C. Paillier, pas à pas |
+| 9 | ex9_scoring_paillier | D. Scoring chiffré |
+| 10 | ex10_ckks_bonus | E. Bonus : FHE réel avec CKKS |
+
+Le parcours va du chiffrement classique (où tout calcul sur le chiffré est
+impossible) à Paillier reconstruit à la main, puis à un score bancaire chiffré
+de bout en bout, et enfin à un vrai calcul FHE avec CKKS.
+
+Le bonus **ex10 (CKKS)** s'appuie sur [TenSEAL](https://github.com/OpenMined/TenSEAL),
+une dépendance native qui n'est pas installée par défaut (et qui n'est pas
+embarquée dans les exécutables autonomes). Pour le faire :
+
+```bash
+pip install "fhe-cli[ckks]"
+```
+
+Sans TenSEAL, les tests de l'ex10 sont simplement ignorés (skipped).
+
+## Développement (depuis le dépôt Scoring FHE)
+
+Le dossier `03_cas_pratiques/fhe-exercices-cli` du dépôt est lui-même un
+espace de travail (il contient `fhecli.toml`, `pytest.ini` et `exercises/`) :
+
+```bash
+cd 03_cas_pratiques/fhe-exercices-cli
+python -m venv .venv
+.venv\Scripts\activate          # macOS / Linux : source .venv/bin/activate
+pip install -e .
+fhecli watch
+python -m pytest tests -q       # tests de l'outil lui-même
+```
+
+Avant de commiter : `fhecli reset --all -y`, pour ne jamais versionner de
+réponses dans `exercises/`.
+
+```
+fhe-exercices-cli/
+├── pyproject.toml             # empaquetage (PyPI), point d'entrée `fhecli`
+├── LICENSE, MANIFEST.in
+├── fhecli/                    # le paquet
+│   ├── cli.py                 # commandes : init, watch, list, run, hint, solution, reset
+│   ├── workspace.py           # création et recherche de l'espace de travail
+│   ├── watch.py               # boucle de surveillance des fichiers
+│   ├── runner.py              # exécution de pytest en sous-processus isolé
+│   ├── info.py, resources.py  # liste des exercices, accès aux données du paquet
+│   ├── solutions.py           # encodage / décodage des solutions
+│   ├── ui.py                  # couleurs, UTF-8, confirmations
+│   └── data/                  # embarqué dans le paquet (lecture seule)
+│       ├── info.toml          # métadonnées des exercices (titre, catégorie, indice)
+│       ├── originals/         # énoncés d'origine (fhecli init / reset)
+│       └── solutions/         # solutions ENCODÉES (.sol)
+├── solutions_src/             # solutions en clair : dans le dépôt, JAMAIS dans la wheel ni le sdist
+├── scripts/                   # encode_solutions.py, build_binary.py, check_binary.py
+├── packaging/                 # spécification PyInstaller (exécutables autonomes)
+├── tests/                     # tests automatisés de l'outil
+├── exercises/                 # espace de travail de développement
+├── fhecli.toml, pytest.ini    # marqueur et configuration de cet espace
+└── requirements.txt
+```
+
+Après toute modification d'une solution dans `solutions_src/` :
+
+```bash
+python scripts/encode_solutions.py
+```
+
+Construire le paquet (sans le publier) :
+
+```bash
+python -m pip install build
+python -m build                # dist/fhe_cli-<version>-py3-none-any.whl et .tar.gz
+```
+
+## Exécutables, CI et publication
+
+Construire et vérifier l'exécutable de l'OS courant (PyInstaller ne fait pas
+de compilation croisée) :
+
+```bash
+pip install -e . pyinstaller
+python scripts/build_binary.py   # dist/fhecli-<version>-<os>-<arch>[.exe]
+```
+
+`scripts/build_binary.py` lance ensuite `scripts/check_binary.py`, qui
+rejoue le parcours d'un étudiant avec le binaire seul (sans Python dans le
+`PATH`) et vérifie qu'aucun source, aucune solution ni aucun énoncé n'apparaît
+en clair dans le fichier.
+
+La CI **GitHub Actions** (`.github/workflows/fhecli.yml`) fait tout cela
+automatiquement : tests sur Linux, Windows et macOS (Python 3.11 et 3.15),
+exécutables Windows, Linux, macOS arm64 et macOS x86_64, wheel et sdist.
+
+Pour publier une version : mettre à jour `fhecli.__version__` et le
+CHANGELOG, puis pousser un tag `fhecli-vX.Y.Z` (il doit correspondre à la
+version). GitHub crée alors une release avec les exécutables et publie sur
+PyPI. Une version publiée sur PyPI ne peut pas être republiée : en cas de
+problème, publier la version suivante.
+
+Configuration à faire une seule fois :
+
+- PyPI, « trusted publishing » : sur pypi.org, ajouter un *pending publisher*
+  pour le projet `fhecli` (dépôt `Defl3ct-941/Scoring_FHE`, workflow
+  `fhecli.yml`, environnement `pypi`), et créer l'environnement `pypi` dans
+  les réglages du dépôt GitHub (limité aux tags `fhecli-v*`). Aucun jeton
+  API n'est nécessaire.
+
+## Licence
+
+MIT, voir [LICENSE](LICENSE).

fhe_cli-1.3.1/README.md

@@ -0,0 +1,245 @@
+# fhecli : atelier CLI de chiffrement classique et FHE
+
+Un atelier d'exercices en ligne de commande, inspiré de
+[rustlings](https://github.com/rust-lang/rustlings) : vous éditez les fichiers
+d'exercice dans votre propre éditeur, avec votre propre environnement Python,
+et un petit outil (`fhecli`) surveille vos fichiers et relance les tests à
+chaque sauvegarde.
+
+Il accompagne le cours « Scoring financier sur données chiffrées via FHE »
+(FYC, ESGI) : c'est la même progression pédagogique que l'atelier web du
+projet, adaptée pour tourner directement dans votre terminal.
+
+> **Version actuelle : 3 exercices.** Seul le module A (chiffrement
+> classique) est publié pour le moment. Les modules suivants (arithmétique
+> modulaire, Paillier from scratch, scoring chiffré, bonus CKKS) arriveront
+> dans une prochaine mise à jour.
+
+## Installation
+
+Python 3.11 ou plus récent est requis.
+
+```bash
+python -m venv .venv
+# Windows
+.venv\Scripts\activate
+# macOS / Linux
+source .venv/bin/activate
+
+pip install fhe-cli
+fhecli init            # crée le dossier ./fhe-exercices avec les exercices
+cd fhe-exercices
+fhecli watch
+```
+
+Le paquet s'installe sous le nom **`fhe-cli`** ; la commande et le module
+Python restent `fhecli`.
+
+`fhecli init [dossier]` crée un **espace de travail** : le dossier
+`exercises/` (vos fichiers), un `pytest.ini` et un fichier marqueur
+`fhecli.toml`. Les commandes de `fhecli` retrouvent cet espace depuis n'importe
+quel sous-dossier. `fhecli init` refuse d'écraser un espace existant.
+
+### Sans Python : exécutable autonome
+
+Pour chaque OS, un exécutable unique embarque tout (Python, `fhecli`,
+`pytest`, `cryptography` et les exercices) : **aucune installation de Python
+n'est nécessaire**. Téléchargez celui de votre système
+(`fhecli-<version>-windows-x86_64.exe`, `-linux-x86_64`, `-macos-arm64` ou
+`-macos-x86_64`), puis :
+
+```bash
+# Windows (PowerShell)
+.hecli-1.2.0-windows-x86_64.exe init
+# macOS / Linux
+chmod +x fhecli-1.2.0-linux-x86_64
+./fhecli-1.2.0-linux-x86_64 init
+```
+
+Renommez-le en `fhecli` (ou `fhecli.exe`) et placez-le dans un dossier du
+`PATH` pour l'utiliser comme dans les exemples ci-dessous. Le code et les
+solutions y sont embarqués compressés, jamais en clair. Sous macOS, au premier
+lancement, autorisez le binaire dans Réglages système > Confidentialité et
+sécurité (il n'est pas signé).
+
+## Utilisation
+
+### Mode guidé (recommandé pour commencer)
+
+```bash
+fhecli watch
+```
+
+Affiche l'exercice courant, relance ses tests à chaque fois que vous
+sauvegardez le fichier, et passe automatiquement au suivant une fois qu'il est
+résolu (en proposant alors d'afficher la solution de référence pour comparer).
+Ctrl+C pour quitter à tout moment : rien n'est perdu, vos fichiers restent sur
+le disque.
+
+### Autres commandes
+
+```bash
+fhecli list                  # vue d'ensemble des exercices et de leur statut
+fhecli run ex1_cesar         # lance les tests d'un seul exercice
+fhecli hint ex1_cesar        # affiche un indice ciblé
+fhecli solution ex1_cesar    # affiche la solution (une fois l'exercice résolu)
+fhecli reset ex1_cesar       # remet CET exercice à son énoncé de départ (avec confirmation)
+fhecli reset --all           # remet TOUS les exercices à leur énoncé de départ (avec confirmation)
+fhecli reset --all -y        # idem, sans confirmation
+fhecli --version
+```
+
+Codes de sortie de `fhecli run` : `0` exercice résolu, `1` tests en échec
+(ou erreur), `2` tests OK mais ligne `# I AM NOT DONE` encore présente.
+
+Vous pouvez aussi lancer les tests vous-même avec `python -m pytest` depuis
+l'espace de travail : le `pytest.ini` fourni collecte bien les exercices.
+
+## Comment marche un exercice
+
+Chaque exercice est un unique fichier `.py` dans `exercises/`, qui contient
+tout :
+
+1. Un docstring en haut du fichier avec l'énoncé complet (contexte,
+   formules, ce qu'il faut implémenter, indices).
+2. Une ligne `# I AM NOT DONE` juste après : tant qu'elle est présente,
+   l'exercice est considéré comme « pas terminé », même si les tests passent
+   déjà. **Retirez-la vous-même** une fois satisfait de votre solution :
+   c'est un geste délibérément manuel, pour vous forcer à vraiment valider
+   votre travail.
+3. La ou les fonctions à compléter (marquées `raise NotImplementedError`).
+4. Une section de tests en bas du fichier (à ne pas modifier), exécutée par
+   `pytest` à chaque `fhecli run` / `fhecli watch`.
+
+## Solutions
+
+La solution de référence d'un exercice est **verrouillée** tant que
+l'exercice n'est pas résolu : `fhecli solution` ne l'affiche qu'une fois que
+les tests passent **et** que la ligne `# I AM NOT DONE` a été retirée.
+
+Dans le paquet, les solutions ne sont pas stockées en clair : elles sont
+compressées et encodées (zlib + base64). C'est une **dissuasion**, pour
+éviter de tomber sur la correction par hasard en fouillant le dossier du
+paquet, **pas une protection** : rien n'empêche quelqu'un de déterminé de les
+décoder. Le vrai garde-fou reste pédagogique.
+
+## Progression (dans l'ordre suivi par `fhecli watch`)
+
+| # | Exercice | Catégorie |
+|---|----------|-----------|
+| 1 | ex1_cesar | A. Chiffrement classique |
+| 2 | ex2_xor_malleability | A. Chiffrement classique |
+| 3 | ex3_fernet_tamper | A. Chiffrement classique |
+| 4 | ex4_modpow | B. Briques mathématiques |
+| 5 | ex5_modinv | B. Briques mathématiques |
+| 6 | ex6_paillier_keygen | C. Paillier, pas à pas |
+| 7 | ex7_paillier_enc_dec | C. Paillier, pas à pas |
+| 8 | ex8_paillier_homomorphic | C. Paillier, pas à pas |
+| 9 | ex9_scoring_paillier | D. Scoring chiffré |
+| 10 | ex10_ckks_bonus | E. Bonus : FHE réel avec CKKS |
+
+Le parcours va du chiffrement classique (où tout calcul sur le chiffré est
+impossible) à Paillier reconstruit à la main, puis à un score bancaire chiffré
+de bout en bout, et enfin à un vrai calcul FHE avec CKKS.
+
+Le bonus **ex10 (CKKS)** s'appuie sur [TenSEAL](https://github.com/OpenMined/TenSEAL),
+une dépendance native qui n'est pas installée par défaut (et qui n'est pas
+embarquée dans les exécutables autonomes). Pour le faire :
+
+```bash
+pip install "fhe-cli[ckks]"
+```
+
+Sans TenSEAL, les tests de l'ex10 sont simplement ignorés (skipped).
+
+## Développement (depuis le dépôt Scoring FHE)
+
+Le dossier `03_cas_pratiques/fhe-exercices-cli` du dépôt est lui-même un
+espace de travail (il contient `fhecli.toml`, `pytest.ini` et `exercises/`) :
+
+```bash
+cd 03_cas_pratiques/fhe-exercices-cli
+python -m venv .venv
+.venv\Scripts\activate          # macOS / Linux : source .venv/bin/activate
+pip install -e .
+fhecli watch
+python -m pytest tests -q       # tests de l'outil lui-même
+```
+
+Avant de commiter : `fhecli reset --all -y`, pour ne jamais versionner de
+réponses dans `exercises/`.
+
+```
+fhe-exercices-cli/
+├── pyproject.toml             # empaquetage (PyPI), point d'entrée `fhecli`
+├── LICENSE, MANIFEST.in
+├── fhecli/                    # le paquet
+│   ├── cli.py                 # commandes : init, watch, list, run, hint, solution, reset
+│   ├── workspace.py           # création et recherche de l'espace de travail
+│   ├── watch.py               # boucle de surveillance des fichiers
+│   ├── runner.py              # exécution de pytest en sous-processus isolé
+│   ├── info.py, resources.py  # liste des exercices, accès aux données du paquet
+│   ├── solutions.py           # encodage / décodage des solutions
+│   ├── ui.py                  # couleurs, UTF-8, confirmations
+│   └── data/                  # embarqué dans le paquet (lecture seule)
+│       ├── info.toml          # métadonnées des exercices (titre, catégorie, indice)
+│       ├── originals/         # énoncés d'origine (fhecli init / reset)
+│       └── solutions/         # solutions ENCODÉES (.sol)
+├── solutions_src/             # solutions en clair : dans le dépôt, JAMAIS dans la wheel ni le sdist
+├── scripts/                   # encode_solutions.py, build_binary.py, check_binary.py
+├── packaging/                 # spécification PyInstaller (exécutables autonomes)
+├── tests/                     # tests automatisés de l'outil
+├── exercises/                 # espace de travail de développement
+├── fhecli.toml, pytest.ini    # marqueur et configuration de cet espace
+└── requirements.txt
+```
+
+Après toute modification d'une solution dans `solutions_src/` :
+
+```bash
+python scripts/encode_solutions.py
+```
+
+Construire le paquet (sans le publier) :
+
+```bash
+python -m pip install build
+python -m build                # dist/fhe_cli-<version>-py3-none-any.whl et .tar.gz
+```
+
+## Exécutables, CI et publication
+
+Construire et vérifier l'exécutable de l'OS courant (PyInstaller ne fait pas
+de compilation croisée) :
+
+```bash
+pip install -e . pyinstaller
+python scripts/build_binary.py   # dist/fhecli-<version>-<os>-<arch>[.exe]
+```
+
+`scripts/build_binary.py` lance ensuite `scripts/check_binary.py`, qui
+rejoue le parcours d'un étudiant avec le binaire seul (sans Python dans le
+`PATH`) et vérifie qu'aucun source, aucune solution ni aucun énoncé n'apparaît
+en clair dans le fichier.
+
+La CI **GitHub Actions** (`.github/workflows/fhecli.yml`) fait tout cela
+automatiquement : tests sur Linux, Windows et macOS (Python 3.11 et 3.15),
+exécutables Windows, Linux, macOS arm64 et macOS x86_64, wheel et sdist.
+
+Pour publier une version : mettre à jour `fhecli.__version__` et le
+CHANGELOG, puis pousser un tag `fhecli-vX.Y.Z` (il doit correspondre à la
+version). GitHub crée alors une release avec les exécutables et publie sur
+PyPI. Une version publiée sur PyPI ne peut pas être republiée : en cas de
+problème, publier la version suivante.
+
+Configuration à faire une seule fois :
+
+- PyPI, « trusted publishing » : sur pypi.org, ajouter un *pending publisher*
+  pour le projet `fhecli` (dépôt `Defl3ct-941/Scoring_FHE`, workflow
+  `fhecli.yml`, environnement `pypi`), et créer l'environnement `pypi` dans
+  les réglages du dépôt GitHub (limité aux tags `fhecli-v*`). Aucun jeton
+  API n'est nécessaire.
+
+## Licence
+
+MIT, voir [LICENSE](LICENSE).