Adds rich plugin context APIs and improves BCASL/SDK utilities

Adds a comprehensive set of plugin SDK and BCASL enhancements to provide plugins richer, safer and more useful workspace/context primitives.

Why:
- Plugins require convenient, robust helpers to inspect workspaces, iterate files, detect venvs/managers, parse dependency files, analyze code, and generate reports; providing these improves plugin reliability and reduces duplicated logic across plugins.
- PreCompileContext and BCASL integration benefit from explicit workspace metadata, safer iteration, caching control and exclusion handling to make pre-compile actions more predictable.
- UI/dialog and engine helper code is hardened for thread-safety and platform differences, and many small formatting/cleanup tweaks reduce churn and improve readability.

Key effects:
- Extends the plugin context with structured dataclasses and many utility functions for workspace inspection, file-pattern matching, dependency parsing, venv detection, git/CI/docker introspection, code metrics, security scanning, command execution, caching, report generation, and template generation.
- Enhances PreCompileContext with workspace metadata accessors, improved iter_files (deduplication, optional caching, exclusion handling), and convenience getters for patterns/required files; exposes is_workspace_valid and other helpers for safer plugin behavior.
- Integrates workspace metadata into BCASL loader/runner so pre-compile runs receive consistent context.
- Improves thread-safe dialog invocation and progress dialog behavior for various platforms/display servers.
- Minor refactors and whitespace/formatting cleanup across many modules to standardize style and small logic/IO calls.

Overall this makes plugin development and BCASL pre-compile processing more powerful and resilient, enabling more sophisticated plugins with less boilerplate.

Author: PyCompiler ARK++

Core/Auto_Command_Builder/auto_build.py

@@ -1,4 +1,3 @@
-
 # Copyright (C) 2025
 
 """

Core/Compiler/compiler.py

@@ -33,36 +33,36 @@ def _continue_compile_all(self):
     auto_detect_entry_points = ark_config.get("auto_detect_entry_points", True)
     compile_only_main_ark = ark_config.get("compile_only_main", False)
     main_file_names_ark = ark_config.get("main_file_names", ["main.py", "app.py"])
-    
+
     # Déplacé depuis compile_all pour poursuivre après BCASL sans bloquer l'UI
     # Compteurs pour les exclusions
     exclusion_counts = {
         "site_packages": 0,
         "ark_patterns": 0,
         "no_entry_point": 0,
         "read_error": 0,
-        "not_exists": 0
+        "not_exists": 0,
     }
-    
+
     def is_executable_script(path):
         # Vérifie que le fichier existe, n'est pas dans site-packages, et contient un point d'entrée
         if not os.path.exists(path):
             exclusion_counts["not_exists"] += 1
             return False
-        
+
         # Vérifier les patterns d'exclusion depuis ARK_Main_Config.yml
         if should_exclude_file(path, self.workspace_dir, exclusion_patterns):
             exclusion_counts["ark_patterns"] += 1
             return False
-        
+
         if "site-packages" in path:
             exclusion_counts["site_packages"] += 1
             return False
-        
+
         # Si auto_detect_entry_points est désactivé, accepter tous les fichiers
         if not auto_detect_entry_points:
             return True
-        
+
         try:
             with open(path, encoding="utf-8") as f:
                 content = f.read()
@@ -88,8 +88,12 @@ def is_executable_script(path):
             use_nuitka = True
 
     # L'option UI a priorité sur la config ARK
-    compile_only_main = self.opt_main_only.isChecked() if hasattr(self, "opt_main_only") else compile_only_main_ark
-    
+    compile_only_main = (
+        self.opt_main_only.isChecked()
+        if hasattr(self, "opt_main_only")
+        else compile_only_main_ark
+    )
+
     # Sélection des fichiers à compiler selon le compilateur
     if use_nuitka:
         # Nuitka : compile tous les fichiers sélectionnés ou tous les fichiers du workspace
@@ -144,17 +148,27 @@ def is_executable_script(path):
     self.current_compiling.clear()
     self.processes.clear()
     self.progress.setRange(0, 0)  # Mode indéterminé pendant toute la compilation
-    
+
     # Afficher les informations de configuration ARK
     if ark_config:
         self.log.append("📋 Configuration ARK chargée depuis ARK_Main_Config.yml\n")
         # Afficher les paramètres de compilation utilisés
-        self.log.append(f"   • Patterns d'inclusion : {', '.join(inclusion_patterns)}\n")
-        self.log.append(f"   • Patterns d'exclusion : {len(exclusion_patterns)} pattern(s)\n")
-        self.log.append(f"   • Détection point d'entrée : {'Activée' if auto_detect_entry_points else 'Désactivée'}\n")
-        self.log.append(f"   • Compiler uniquement main : {'Oui' if compile_only_main else 'Non'}\n")
-    
-    self.log.append(f"🔨 Compilation parallèle démarrée ({len(files_ok)} fichier(s))...\n")
+        self.log.append(
+            f"   • Patterns d'inclusion : {', '.join(inclusion_patterns)}\n"
+        )
+        self.log.append(
+            f"   • Patterns d'exclusion : {len(exclusion_patterns)} pattern(s)\n"
+        )
+        self.log.append(
+            f"   • Détection point d'entrée : {'Activée' if auto_detect_entry_points else 'Désactivée'}\n"
+        )
+        self.log.append(
+            f"   • Compiler uniquement main : {'Oui' if compile_only_main else 'Non'}\n"
+        )
+
+    self.log.append(
+        f"🔨 Compilation parallèle démarrée ({len(files_ok)} fichier(s))...\n"
+    )
 
     self.set_controls_enabled(False)
     self.try_start_processes()

Core/Compiler/mainprocess.py

@@ -14,8 +14,6 @@
 # limitations under the License.
 
 
-
-
 import json
 import os
 import platform
@@ -44,7 +42,6 @@
 # ACASL support removed (obsolete)
 
 
-
 def try_start_processes(self):
     from PySide6.QtWidgets import QApplication
 
@@ -59,12 +56,13 @@ def try_start_processes(self):
         self.progress.setRange(0, 1)
         self.progress.setValue(1)
         from PySide6.QtWidgets import QApplication
+
         QApplication.processEvents()
         self.log.append("✔️ Toutes les compilations sont terminées.\n")
         # Exécuter immédiatement les hooks de succès des moteurs et restaurer l'UI
         try:
             hooks = getattr(self, "_pending_engine_success_hooks", [])
-            for (eng, fpath) in hooks:
+            for eng, fpath in hooks:
                 try:
                     eng.on_success(self, fpath)
                 except Exception:
@@ -180,7 +178,7 @@ def start_compilation_process(self, file):
     process._cancel_file = cancel_file
     process.readyReadStandardOutput.connect(lambda p=process: self.handle_stdout(p))
     process.readyReadStandardError.connect(lambda p=process: self.handle_stderr(p))
-    
+
     # Capture stderr data before process deletion to avoid accessing deleted C++ object
     def _on_finished(ec, es, p=process):
         try:
@@ -198,7 +196,7 @@ def _on_finished(ec, es, p=process):
                 p.deleteLater()
             except Exception:
                 pass
-    
+
     process.finished.connect(_on_finished)
     self.processes.append(process)
     self.current_compiling.add(file)

Core/Compiler/process_killer.py

@@ -13,6 +13,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+
 def _kill_process_tree(pid: int, *, timeout: float = 5.0, log=None) -> bool:
     def _log(msg: str):
         try:

Core/MainWindow.py

@@ -14,8 +14,6 @@
 # limitations under the License.
 
 
-
-
 import asyncio
 import json
 import os
@@ -184,8 +182,7 @@ def __init__(self):
 
         self.load_preferences()
         self.init_ui()
-        
-                
+
         # Détection langue système si préférence = "System"
         import locale
 
@@ -392,13 +389,13 @@ def dropEvent(self, event: QDropEvent):
 
     def add_py_files_from_folder(self, folder):
         from Core.ark_config_loader import load_ark_config, should_exclude_file
-        
+
         count = 0
         excluded_count = 0
         # Charger la configuration ARK pour les patterns d'exclusion
         ark_config = load_ark_config(self.workspace_dir)
         exclusion_patterns = ark_config.get("exclusion_patterns", [])
-        
+
         for root, _, files in os.walk(folder):
             for f in files:
                 if f.endswith(".py"):
@@ -409,12 +406,14 @@ def add_py_files_from_folder(self, folder):
                         == self.workspace_dir
                     ):
                         continue
-                    
+
                     # Vérifier les patterns d'exclusion depuis ARK_Main_Config.yml
-                    if should_exclude_file(full_path, self.workspace_dir, exclusion_patterns):
+                    if should_exclude_file(
+                        full_path, self.workspace_dir, exclusion_patterns
+                    ):
                         excluded_count += 1
                         continue
-                    
+
                     if full_path not in self.python_files:
                         self.python_files.append(full_path)
                         relative_path = (
@@ -424,14 +423,14 @@ def add_py_files_from_folder(self, folder):
                         )
                         self.file_list.addItem(relative_path)
                         count += 1
-        
+
         # Afficher un message récapitulatif si des fichiers ont été exclus
         if excluded_count > 0:
             self.log_i18n(
                 f"⏩ Exclusion appliquée : {excluded_count} fichier(s) exclu(s) selon ARK_Main_Config.yml",
-                f"⏩ Exclusion applied: {excluded_count} file(s) excluded according to ARK_Main_Config.yml"
+                f"⏩ Exclusion applied: {excluded_count} file(s) excluded according to ARK_Main_Config.yml",
             )
-        
+
         return count
 
     def select_workspace(self):
@@ -452,7 +451,7 @@ def apply_workspace_selection(self, folder: str, source: str = "ui") -> bool:
                 QApplication.processEvents()
             except Exception:
                 loading_dialog = None
-            
+
             # Ensure target folder exists; auto-create if missing; never refuse
             if not folder:
                 try:
@@ -553,10 +552,11 @@ def apply_workspace_selection(self, folder: str, source: str = "ui") -> bool:
                     self.log_i18n("Dossier venv détecté.", "Venv folder detected.")
             except Exception:
                 pass
-            
+
             # Créer le fichier ARK_Main_Config.yml s'il n'existe pas
             try:
                 from Core.ark_config_loader import create_default_ark_config
+
                 if create_default_ark_config(folder):
                     self.log_i18n(
                         "📋 Fichier ARK_Main_Config.yml créé dans le workspace.",
@@ -567,14 +567,14 @@ def apply_workspace_selection(self, folder: str, source: str = "ui") -> bool:
                     f"⚠️ Impossible de créer ARK_Main_Config.yml: {e}",
                     f"⚠️ Failed to create ARK_Main_Config.yml: {e}",
                 )
-            
+
             # Fermer le dialog de chargement
             try:
                 if loading_dialog:
                     loading_dialog.close()
             except Exception:
                 pass
-            
+
             return True
         except Exception as _e:
             try:
@@ -943,13 +943,14 @@ def open_ark_config(self):
                 ),
             )
             return
-        
+
         config_path = os.path.join(self.workspace_dir, "ARK_Main_Config.yml")
-        
+
         # Créer le fichier s'il n'existe pas
         if not os.path.exists(config_path):
             try:
                 from Core.ark_config_loader import create_default_ark_config
+
                 if create_default_ark_config(self.workspace_dir):
                     self.log_i18n(
                         "📋 Fichier ARK_Main_Config.yml créé.",
@@ -965,20 +966,20 @@ def open_ark_config(self):
                     ),
                 )
                 return
-        
+
         # Ouvrir le fichier dans l'éditeur par défaut
         try:
             import subprocess
             import platform
-            
+
             system = platform.system()
             if system == "Windows":
                 os.startfile(config_path)
             elif system == "Darwin":  # macOS
                 subprocess.run(["open", config_path])
             else:  # Linux
                 subprocess.run(["xdg-open", config_path])
-            
+
             self.log_i18n(
                 f"📝 Ouverture de {config_path}",
                 f"📝 Opening {config_path}",
@@ -1579,6 +1580,7 @@ def _on_result(res):
                 # Registry-based propagation to engine instances
                 try:
                     import Core.engines_loader as engines_loader
+
                     engines_loader.registry.apply_translations(self, tr)
                 except Exception:
                     pass
@@ -1741,7 +1743,6 @@ def _safe_log(self, text):
             except Exception:
                 pass
 
-    
     def _has_active_background_tasks(self):
         # Compilation en cours
         if self.processes:
@@ -1777,9 +1778,9 @@ def closeEvent(self, event):
                 details.append("compilation")
             if hasattr(self, "venv_manager") and self.venv_manager:
                 details.extend(self.venv_manager.get_active_task_labels("Français"))
-            
+
             is_english = getattr(self, "current_language", "Français") == "English"
-            
+
             if is_english:
                 mapping = {
                     "compilation": "build",
@@ -1788,7 +1789,7 @@ def closeEvent(self, event):
                     "vérification/installation du venv": "venv check/installation",
                 }
                 details_disp = [mapping.get(d, d) for d in details]
-                
+
                 # Construire le message détaillé
                 title = "⚠️ Process Running"
                 msg = "A process is currently running:\n\n"
@@ -1798,12 +1799,12 @@ def closeEvent(self, event):
                     msg += "\n"
                 msg += "If you quit now, the process will be stopped and any unsaved work will be lost.\n\n"
                 msg += "Do you really want to quit?"
-                
+
                 yes_text = "Yes, Quit"
                 no_text = "No, Continue"
             else:
                 details_disp = details
-                
+
                 # Construire le message détaillé
                 title = "⚠️ Processus en cours"
                 msg = "Un processus est actuellement en cours :\n\n"
@@ -1813,24 +1814,24 @@ def closeEvent(self, event):
                     msg += "\n"
                 msg += "Si vous quittez maintenant, le processus sera arrêté et tout travail non sauvegardé sera perdu.\n\n"
                 msg += "Voulez-vous vraiment quitter ?"
-                
+
                 yes_text = "Oui, Quitter"
                 no_text = "Non, Continuer"
-            
+
             # Créer la boîte de dialogue avec des boutons personnalisés
             msgbox = QMessageBox(self)
             msgbox.setWindowTitle(title)
             msgbox.setText(msg)
             msgbox.setIcon(QMessageBox.Warning)
             msgbox.setStandardButtons(QMessageBox.Yes | QMessageBox.No)
             msgbox.setDefaultButton(QMessageBox.No)
-            
+
             # Personnaliser les textes des boutons
             msgbox.button(QMessageBox.Yes).setText(yes_text)
             msgbox.button(QMessageBox.No).setText(no_text)
-            
+
             reply = msgbox.exec()
-            
+
             if reply == QMessageBox.Yes:
                 self._closing = True
                 # Annule les compilations en cours si nécessaire