feat(doc): finaliser la normalisation des docstrings EN sur le reste du projet

Author: raidos23

Core/ArkConfigManager.py

@@ -24,10 +24,10 @@
 
 Le file de configuration utilise le format YAML et permet de personnaliser:
 - Les patterns de files à inclure/exclure de la compilation
-- Les gestionnaires d'environnement virtuel (Poetry, Pipenv, Conda, etc.)
-- Les options de dépendances
+- Les managementnaires d'environment virtual (Poetry, Pipenv, Conda, etc.)
+- Les options de dependencies
 
-Note: La configuration des plugins BCASL est gérée exclusivement par bcasl.yml
+Note: La configuration des BCASL plugins est gérée exclusivement par bcasl.yml
 """
 
 import os
@@ -131,19 +131,19 @@
 
 def _deep_merge_dict(base: dict, override: dict) -> dict:
     """
-  Recursively merge two dictionaries.
+ Recursively merge two dictionaries.
 
-  Cette fonction permet de combiner une configuration de base avec des
-  valeurs personnalisées. Les dictionnaires imbriqués sont fusionnés
-  plutôt que remplacés, permettant une configuration modulaire.
+ Cette fonction permet de combiner une configuration de base avec des
+ valeurs personnalisées. Les dictionnaires imbriqués sont fusionnés
+ plutôt que remplacés, permettant une configuration modulaire.
 
-  Args:
-    base: Dictionnaire de configuration de base
-    override: Dictionnaire contenant les valeurs à surcharger
+ Args:
+  base: Dictionnaire de configuration de base
+  override: Dictionnaire contenant les valeurs à surloadr
 
-  Returns:
-    Un nouveau dictionnaire avec les valeurs fusionnées
-  """
+ Returns:
+  Un nouveau dictionnaire avec les valeurs fusionnées
+ """
     result = base.copy()
     for key, value in override.items():
         if key in result and isinstance(result[key], dict) and isinstance(value, dict):
@@ -157,25 +157,25 @@ def _deep_merge_dict(base: dict, override: dict) -> dict:
 
 def load_ark_config(workspace_dir: str) -> dict[str, Any]:
     """
-  Load ARK configuration from a YAML file.
+ Load ARK configuration from a YAML file.
 
-  Cette fonction recherche un file de configuration dans le workspace
-  selon un ordre de priorité prédéfini et fusionne la configuration
-  utilisateur avec les valeurs par défaut.
+ Cette fonction recherche un file de configuration dans le workspace
+ selon un ordre de priorité prédéfini et fusionne la configuration
+ utilisateur avec les valeurs par défaut.
 
-  Fichiers recherchés (ordre de priorité):
-  1. ARK_Main_Config.yaml
-  2. ARK_Main_Config.yml
-  3. .ARK_Main_Config.yaml
-  4. .ARK_Main_Config.yml
+ Fichiers recherchés (ordre de priorité):
+ 1. ARK_Main_Config.yaml
+ 2. ARK_Main_Config.yml
+ 3. .ARK_Main_Config.yaml
+ 4. .ARK_Main_Config.yml
 
-  Args:
-    workspace_dir: Path absolu vers le directory du workspace
+ Args:
+  workspace_dir: Path absolu vers le directory du workspace
 
-  Returns:
-    Dictionnaire complet de configuration, incluant les valeurs par défaut
-    et les personnalisations utilisateur
-  """
+ Returns:
+  Dictionnaire complet de configuration, incluant les valeurs par défaut
+  et les personnalisations utilisateur
+ """
     import copy
 
     # Commencer avec une copie complète de la configuration par défaut
@@ -283,11 +283,11 @@ def load_ark_config(workspace_dir: str) -> dict[str, Any]:
 
 def get_dependency_options(config: dict[str, Any]) -> dict[str, Any]:
     """
-  Return dependency management options.
+ Return dependency management options.
 
-  Returns:
-    Dictionnaire des options de dépendances
-  """
+ Returns:
+  Dictionnaire des options de dependencies
+ """
     return config.get("dependencies", {})
 
 
@@ -313,11 +313,11 @@ def get_build_options(config: dict[str, Any]) -> dict[str, Any]:
 
 def get_entrypoint(config: dict[str, Any]) -> Optional[str]:
     """
-  Return configured entry point.
+ Return configured entry point.
 
-  Returns:
-    Path relatif du point d'entrée ou None
-  """
+ Returns:
+  Path relatif du point d'entrée ou None
+ """
     build_opts = get_build_options(config)
     if not isinstance(build_opts, dict):
         return None
@@ -327,15 +327,15 @@ def get_entrypoint(config: dict[str, Any]) -> Optional[str]:
 
 def save_ark_config(workspace_dir: str, config: dict[str, Any]) -> bool:
     """
-  Save ARK configuration to ARK_Main_Config.yml.
+ Save ARK configuration to ARK_Main_Config.yml.
 
-  Args:
-    workspace_dir: Path du workspace
-    config: Configuration complète à enregistrer
+ Args:
+  workspace_dir: Path du workspace
+  config: Configuration complète à enregistrer
 
-  Returns:
-    True si succès, False sinon
-  """
+ Returns:
+  True si success, False sinon
+ """
     if not workspace_dir or not isinstance(config, dict):
         return False
     try:
@@ -356,15 +356,15 @@ def save_ark_config(workspace_dir: str, config: dict[str, Any]) -> bool:
 
 def set_entrypoint(workspace_dir: str, entrypoint: Optional[str]) -> bool:
     """
-  Update entry point in ARK_Main_Config.yml.
+ Update entry point in ARK_Main_Config.yml.
 
-  Args:
-    workspace_dir: Path du workspace
-    entrypoint: Path relatif du point d'entrée (ou None pour effacer)
+ Args:
+  workspace_dir: Path du workspace
+  entrypoint: Path relatif du point d'entrée (ou None pour clearr)
 
-  Returns:
-    True si succès, False sinon
-  """
+ Returns:
+  True si success, False sinon
+ """
     if not workspace_dir:
         return False
     cfg = load_ark_config(workspace_dir)
@@ -382,12 +382,12 @@ def set_entrypoint(workspace_dir: str, entrypoint: Optional[str]) -> bool:
 
 def _normalize_exclusion_pattern(pattern: str) -> str:
     """
-  Normalize exclusion pattern for reliable cross-platform matching.
+ Normalize exclusion pattern for reliable cross-platform matching.
 
-  - Convertit les séparateurs Windows en "/"
-  - Retire le préfixe "./"
-  - Si le pattern se termine par "/", on l'étend à "/**"
-  """
+ - Convertit les séparateurs Windows en "/"
+ - Retire le préfixe "./"
+ - Si le pattern se termine par "/", on l'étend à "/**"
+ """
     p = str(pattern).strip()
     if not p:
         return ""
@@ -482,19 +482,19 @@ def should_exclude_file(
 
 def create_default_ark_config(workspace_dir: str) -> bool:
     """
-  Create ARK_Main_Config.yml with default configuration.
+ Create ARK_Main_Config.yml with default configuration.
 
-  Cette fonction génère un file de configuration complet avec
-  toutes les options disponibles et leurs valeurs par défaut.
-  Elle ne remplace pas un file existant.
+ Cette fonction génère un file de configuration complet avec
+ toutes les options disponibles et leurs valeurs par défaut.
+ Elle ne remplace pas un file existant.
 
-  Args:
-    workspace_dir: Path du directory du workspace
+ Args:
+  workspace_dir: Path du directory du workspace
 
-  Returns:
-    True si le file a été créé avec succès, False s'il existe déjà
-    ou si une erreur s'est produite
-  """
+ Returns:
+  True si le file a été créé avec success, False s'il existe déjà
+  ou si une erreur s'est produite
+ """
     if not workspace_dir:
         return False
 

Core/Auto_Command_Builder/auto_build.py

@@ -2,12 +2,12 @@
 
 """
 Automatic detection of sensitive modules and hook/plugin application
-pour les moteurs, basée sur un mapping JSON piloté par les moteurs (ENGINES).
+pour les engines, basée sur un mapping JSON piloté par les engines (ENGINES).
 
 Règles clés:
 - La détection est automatique et non désactivable par l'utilisateur.
 - Priorité à requirements.txt s'il existe dans le workspace, sinon scan des imports.
-- Les actions sont dérivées du JSON (clé = id du moteur).
+- Les actions sont dérivées du JSON (clé = id du engine).
 - Rapport optionnel pouvant être écrit dans le workspace.
 """
 
@@ -259,10 +259,10 @@ def _parse_requirements(requirements_path: str) -> set[str]:
 
 def _scan_imports(py_files: list[str], workspace_dir: str) -> set[str]:
     """Analyze .py files and return imported top-level module names.
-  - Ignore venv/, __pycache__/ et folders cachés
-  - Ignore files trop volumineux (>1.5 Mo) pour robustesse
-  - Tolérant aux erreurs d'encodage/syntaxe
-  """
+ - Ignore venv/, __pycache__/ et folders cachés
+ - Ignore files trop volumineux (>1.5 Mo) pour robustesse
+ - Tolérant aux erreurs d'encodage/syntaxe
+ """
     found: set[str] = set()
     # Exclure venv interne
     venv_dir = os.path.abspath(os.path.join(workspace_dir, "venv"))
@@ -580,14 +580,14 @@ def compute_for_all(
     self, engine_ids: Optional[list[str]] = None
 ) -> dict[str, list[str]]:
     """
-  Compute auto arguments for all engines (plug-and-play).
-  - engine_ids: liste optionnelle d'identifiants de moteurs à traiter. Si None,
-   on détecte automatiquement:
-    * moteurs enregistrés dans _ENGINE_BUILDERS
-    * moteurs avec un mapping engine_plugins/<engine_id>/mapping.json
-    * moteurs embarqués utils/engines/<engine_id>/mapping.json
-  Return un dict: { engine_id: List[str] }.
-  """
+ Compute auto arguments for all engines (plug-and-play).
+ - engine_ids: liste optionnelle d'identifiants de engines à traiter. Si None,
+  on detect automatiquement:
+  * engines enregistrés dans _ENGINE_BUILDERS
+  * engines avec un mapping engine_plugins/<engine_id>/mapping.json
+  * engines embarqués utils/engines/<engine_id>/mapping.json
+ Return un dict: { engine_id: List[str] }.
+ """
     # Construire la liste ordonnée des moteurs à traiter
     ordered: list[str] = []
     if engine_ids:

Core/Compiler/compiler.py

@@ -442,20 +442,20 @@ def compile(
         workspace_dir: Optional[str] = None,
     ) -> bool:
         """
-    Start a compilation.
-
-    Args:
-      program: Executable path
-      args: Argument list
-      env: Environment variables (optional)
-      working_dir: Working directory (optional)
-      engine_id: Identifiant du moteur (optionnel)
-      file_path: Path du file à compiler (optionnel)
-      workspace_dir: Path du workspace (optionnel)
-
-    Returns:
-      True si la compilation a démarré, False sinon
-    """
+  Start a compilation.
+
+  Args:
+   program: Executable path
+   args: Argument list
+   env: Environment variables (optional)
+   working_dir: Working directory (optional)
+   engine_id: Identifiant du engine (optionnel)
+   file_path: Path du file à compiler (optionnel)
+   workspace_dir: Path du workspace (optionnel)
+
+  Returns:
+   True si la compilation a démarré, False sinon
+  """
         if self.is_running:
             self.log_message.emit("warning", "Compilation already in progress")
             return False
@@ -498,11 +498,11 @@ def compile(
 
     def cancel(self) -> bool:
         """
-    Cancel current compilation.
+  Cancel current compilation.
 
-    Returns:
-      True si l'annulation a été demandée, False sinon
-    """
+  Returns:
+   True si l'annulation a été demandée, False sinon
+  """
         if not self.is_running:
             return False
 
@@ -555,15 +555,15 @@ def _on_finished(self, return_code: int) -> None:
 
     def get_command_line(self, program: str, args: List[str]) -> str:
         """
-    Return the formatted command line.
+  Return the formatted command line.
 
-    Args:
-      program: Programme à exécuter
-      args: Arguments
+  Args:
+   program: Programme à executer
+   args: Arguments
 
-    Returns:
-      Ligne de commande formatée
-    """
+  Returns:
+   Ligne de commande formatée
+  """
         cmd = [program] + args
         return " ".join(cmd)
 
@@ -575,17 +575,17 @@ def dry_run(
         working_dir: Optional[str] = None,
     ) -> str:
         """
-    Simulate compilation and return the command.
+  Simulate compilation and return the command.
 
-    Args:
-      program: Programme à exécuter
-      args: Arguments
-      env: Environment variables (optional)
-      working_dir: Working directory (optional)
+  Args:
+   program: Programme à executer
+   args: Arguments
+   env: Environment variables (optional)
+   working_dir: Working directory (optional)
 
-    Returns:
-      Commande formatée
-    """
+  Returns:
+   Commande formatée
+  """
         cmd = self.get_command_line(program, args)
         result = f"[DRY RUN] Command: {cmd}\n"
         result += f"Working directory: {working_dir or 'current'}\n"