Python : linter et formatter

Cette version garde les limites générales du projet C++ et confie les règles Python courantes à Ruff. Elle utilise l'AST et tokenize pour distinguer code, chaînes, docstrings et commentaires.

Installation

Depuis ce dépôt :

python -m pip install -e ./python

Pour activer la détection de la langue des commentaires, installer l'extra optionnel (Lingua est volumineux) :

python -m pip install -e "./python[comments]"

Depuis un autre projet, une installation non éditable fonctionne aussi : python -m pip install <chemin-vers-ce-dépôt>/python. La commande nk-python est ensuite disponible dans le même environnement Python. On peut également utiliser python -m nk_python.

Utilisation

nk-python check Src Tests              # Ruff et règles propres, sans écriture
nk-python format Src Tests             # trie les imports et formate en place
nk-python check fichier.py            # fichier précis
nk-python check . --max-files 10       # seuil de dossier personnalisé

Sans chemin, la commande traite le dossier courant. Les sous-dossiers de cache, d'environnement virtuel et de construction sont ignorés. Cela inclut tous les dossiers dont le nom commence par .venv, comme .venv-cardd et .venv-vision. check contrôle aussi le formatage Ruff et retourne un code non nul si une règle échoue. format applique le tri des imports Ruff et ruff format; relancer check pour les diagnostics qui ne se corrigent pas automatiquement.

Les diagnostics s'affichent sans extraits de code, avec des chemins relatifs au dossier courant. La sortie de check commence par un résumé : fichiers analysés, nombre de warnings du linter (Ruff et règles PY…), problèmes d'ordre des imports et fichiers à reformater. Elle présente ensuite les diagnostics du linter, puis une section formatter à la fin : ordre des imports et fichiers à reformater. Cette dernière correspond aux corrections appliquées par format. Les autres corrections automatiques proposées par Ruff ne sont pas appliquées par cette commande.

Règles

Ruff vérifie en plus les erreurs Python (E4, E7, E9, F), l'ordre des imports (I), les erreurs fréquentes (B), certaines modernisations sûres (UP) et la variable créée uniquement pour être retournée (RET504). Sa configuration est fournie par l'outil, donc les mêmes règles s'appliquent depuis un autre projet. Le formatter impose une indentation de quatre espaces, des guillemets doubles et des fins de ligne LF. Les règles C++ propres aux accolades, #include, modules et initialiseurs désignés ne s'appliquent pas à Python.

Les directives usuelles (# noqa, # type: ignore, # pylint:, # fmt:, # ruff:, # isort: et # pragma: no cover) restent permises. Les docstrings ne sont pas des commentaires # et restent autorisées dans les fonctions.