Code/pyproject.toml
Stéphan Peccini f812fac89e
feat: Amelioration structure - tests, documentation et qualite du code
Cette mise a jour complete ameliore significativement la qualite et la maintenabilite du projet.

1. Extension de la couverture de tests

Couverture globale passee de 8% a 16% (+100%)
- Ajout de 25 nouveaux tests (total: 67 tests, 100% passent)
- Nouveaux fichiers de tests:
  * tests/unit/test_gitea.py (17 tests)
  * tests/unit/test_fiches_tickets.py (8 tests)

Etat de la couverture par module:
- utils/gitea.py: 100%
- utils/widgets.py: 100%
- utils/logger.py: 94%
- app/fiches/utils/tickets/core.py: 77%
- utils/graph_utils.py: 59%

2. Documentation d'architecture complete

Creation de 3 nouveaux documents (30 Ko total):
- docs/ARCHITECTURE.md (15 Ko)
  * Architecture complete du projet
  * Flux de donnees detailles
  * Indices de vulnerabilite (IHH, ISG, ICS, IVC)
  * Structure du graphe NetworkX

- docs/MODULES.md (15 Ko)
  * Guide des 11 modules principaux
  * Exemples de code (15+ snippets)
  * Bonnes pratiques
  * Guide de depannage

- docs/README.md (4 Ko)
  * Index de toute la documentation

Contenu documente:
- 5 modules applicatifs
- 6 modules utilitaires
- 4 indices de vulnerabilite avec formules et seuils
- Conventions de code

3. Reorganisation de la documentation

Structure finale optimisee:
- Racine: README.md (mis a jour) + Instructions.md
- docs/: 11 documents organises par categorie

Fichiers deplaces vers docs/:
- README_connexion.md -> docs/CONNEXION.md
- GUIDE_LOGS.md -> docs/
- GUIDE_RUFF.md -> docs/
- RAPPORT_RUFF.md -> docs/
- RAPPORT_CORRECTIONS_AUTO.md -> docs/
- REFACTORING_REPORT.md -> docs/
- VERIFICATION_LOGS.md -> docs/
- TODO_IA_BATCH.md -> docs/

4. Ajout de docstrings

52 fonctions documentees en style Google (100%)
Documentation en francais avec Args, Returns, Raises

5. Corrections automatiques Ruff

Application de 347 corrections automatiques:
- Formatage du code (line-length: 120)
- Organisation des imports
- Simplifications syntaxiques
- Suppressions de code mort
- Ameliorations de performance

6. Configuration qualite du code

Nouveaux fichiers:
- pyproject.toml: configuration Ruff complete
- .vscode/settings.json: integration Ruff avec formatOnSave
- GUIDE_RUFF.md: documentation du linter
- GUIDE_LOGS.md: documentation du logging
- .gitignore: ajout htmlcov/ pour rapports de couverture

Etat final du projet:
- Linter: Ruff configure (15 regles actives)
- Tests: 67 tests (100% passent)
- Couverture de code: 16%
- Docstrings: 52/52 (100%)
- Documentation: 11 fichiers organises

Impact:
- Tests plus robustes et maintenables
- Documentation technique complete
- Meilleure organisation des fichiers
- Workflow optimise avec Ruff
- Code pret pour integration continue

References:
- Architecture: docs/ARCHITECTURE.md
- Guide modules: docs/MODULES.md
- Tests: tests/unit/
- Configuration: pyproject.toml

Co-Authored-By: Claude <noreply@anthropic.com>
2026-02-07 19:00:49 +01:00

93 lines
2.7 KiB
TOML

[project]
name = "fabnum"
version = "1.0.0"
description = "Analyse de risques géopolitiques pour les chaînes d'approvisionnement numériques"
requires-python = ">=3.10"
[tool.ruff]
# Longueur de ligne maximale
line-length = 120
# Version Python cible
target-version = "py310"
# Répertoires à exclure de l'analyse
exclude = [
".git",
".venv",
"venv",
"__pycache__",
"*.pyc",
".pytest_cache",
"logs",
"pgpt", # PrivateGPT externe
"IA", # Module IA priorité basse
"batch_ia", # Module batch_ia priorité basse
]
[tool.ruff.lint]
# Règles activées (sélection équilibrée pour un projet existant)
select = [
"E", # pycodestyle errors
"W", # pycodestyle warnings
"F", # pyflakes
"I", # isort (tri des imports)
"N", # pep8-naming
"D", # pydocstyle (docstrings)
"UP", # pyupgrade (syntaxe Python moderne)
"B", # flake8-bugbear (détection de bugs)
"C4", # flake8-comprehensions
"PIE", # flake8-pie
"RET", # flake8-return
"SIM", # flake8-simplify
"ARG", # flake8-unused-arguments
"PTH", # flake8-use-pathlib
]
# Règles à ignorer (pour éviter trop de changements d'un coup)
ignore = [
"D100", # Missing docstring in public module (trop strict)
"D104", # Missing docstring in public package
"D203", # 1 blank line required before class docstring (conflit avec D211)
"D213", # Multi-line docstring summary should start at the second line (conflit avec D212)
"E501", # Line too long (géré par line-length)
"N802", # Function name should be lowercase (streamlit utilise des noms de fonctions variés)
"N806", # Variable in function should be lowercase (pour compatibilité avec NetworkX)
]
# Fichiers à ignorer pour certaines règles
[tool.ruff.lint.per-file-ignores]
"__init__.py" = ["F401"] # Imports non utilisés dans __init__ sont OK
"tests/**/*.py" = ["D103", "ARG001"] # Pas de docstrings obligatoires dans les tests
"scripts/**/*.py" = ["D"] # Pas de docstrings obligatoires dans les scripts
[tool.ruff.lint.pydocstyle]
# Convention de docstrings (Google style)
convention = "google"
[tool.ruff.lint.isort]
# Configuration du tri des imports
known-first-party = ["app", "utils", "batch_ia"]
section-order = ["future", "standard-library", "third-party", "first-party", "local-folder"]
[tool.ruff.format]
# Configuration du formateur de code
quote-style = "double"
indent-style = "space"
line-ending = "auto"
[tool.pytest.ini_options]
# Configuration pytest (déjà utilisée)
testpaths = ["tests"]
python_files = ["test_*.py"]
python_functions = ["test_*"]
addopts = [
"-v",
"--tb=short",
"--strict-markers",
]
markers = [
"unit: Unit tests",
"integration: Integration tests",
]