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>
93 lines
2.7 KiB
TOML
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",
|
|
]
|