Add ruff output for code quality checks and address identified issues

- Created a new file `ruff_output.txt` to capture the output from the ruff linter.
- Identified and documented multiple issues including:
  - Unsorted or unformatted import blocks in `__init__.py` and `backend_simulator.py`.
  - Magic values used in comparisons, suggesting replacement with constant variables.
  - Lines exceeding the maximum length in several files, including `backend_simulator.py` and `main.py`.
- Highlighted the need for organizing imports and reducing line lengths to improve code readability and maintainability.

Author: WesleyQDev

pyproject.toml

@@ -11,6 +11,7 @@ license = "MIT"
 license-files = ["LICEN[CS]E*"]
 dependencies = [
     "psutil>=7.1.3",
+    "pydantic>=2.12.5",
     "pyyaml>=6.0.3",
     "rich>=14.2.0",
 ]

ruff_output.txt

@@ -1,4 +1,4 @@
-from .main import FortScript, RamConfig, Callbacks
 from .games import GAMES
+from .main import Callbacks, FortScript, RamConfig
 
 __all__ = ['FortScript', 'RamConfig', 'GAMES', 'Callbacks']

src/fortscript/__init__.py

@@ -1,8 +1,9 @@
-from fortscript import GAMES, Callbacks, FortScript, RamConfig
 import logging
 import os
 import sys
 
+from fortscript import GAMES, Callbacks, FortScript, RamConfig
+
 # Ensure we can import fortscript from source
 current_dir = os.path.dirname(os.path.abspath(__file__))
 src_path = os.path.abspath(os.path.join(current_dir, '../../../'))

src/fortscript/cookbook/project_with_games_list/main.py

@@ -2,7 +2,9 @@
 Pre-defined list of popular games and heavy applications with their process names.
 """
 
-GAMES = [
+from .main import HeavyProcessConfig
+
+GAMES: list[HeavyProcessConfig] = [
     # Battle Royale / Shooter
     {'name': 'Fortnite', 'process': 'fortnite'},
     {'name': 'Fortnite', 'process': 'fortniteclient-win64-shipping'},

src/fortscript/games.py

@@ -4,7 +4,7 @@
 import sys
 import time
 from dataclasses import dataclass
-from typing import Any, Callable, TypedDict
+from typing import Any, Callable, Mapping, Sequence, TypedDict, cast
 
 import psutil
 import yaml
@@ -81,21 +81,28 @@ class Callbacks:
     on_resume: Callable | None = None
 
 
+@dataclass
+class Functions:
+    ...
+
+
 class FortScript:
     """Main class to manage scripts and monitor application status."""
 
     def __init__(
         self,
         config_path: str = 'fortscript.yaml',
-        projects: list[ProjectConfig] | None = None,
-        heavy_process: list[HeavyProcessConfig] | None = None,
+        projects: Sequence[Mapping[str, Any]] | None = None,
+        functions: Functions | None = None,
+        heavy_process: Sequence[Mapping[str, Any]] | None = None,
         ram_config: RamConfig | None = None,
         callbacks: Callbacks | None = None,
         log_level: str | int | None = None,
         new_console: bool = True,
     ):
         """
-        Initializes FortScript with the configuration file and monitoring parameters.
+        Initializes FortScript with the configuration file and monitoring
+        parameters.
 
         Args:
             config_path (str): The path to the YAML configuration file.
@@ -106,22 +113,25 @@ def __init__(
             ram_config (RamConfig, optional): RAM usage configuration.
             callbacks (Callbacks, optional): Callback functions for events.
             log_level (str | int, optional): Severity level for logging.
-            new_console (bool): If True, launches scripts in a separate console.
+            new_console (bool): If True, launches scripts in a separate
+                console.
         """
         self.new_console = new_console
         self.file_config = self.load_config(config_path)
 
         self.active_processes: list[subprocess.Popen] = []
 
-        self.projects: list[ProjectConfig] = (
+        self.projects: list[ProjectConfig] = cast(
+            list[ProjectConfig],
             projects
             if projects is not None
-            else self.file_config.get('projects', [])
+            else self.file_config.get('projects', []),
         )
-        self.heavy_processes: list[HeavyProcessConfig] = (
+        self.heavy_processes: list[HeavyProcessConfig] = cast(
+            list[HeavyProcessConfig],
             heavy_process
             if heavy_process is not None
-            else (self.file_config.get('heavy_processes') or [])
+            else (self.file_config.get('heavy_processes') or []),
         )
         if ram_config is None:
             self.ram_config = RamConfig(
@@ -147,7 +157,7 @@ def __init__(
         self.ram_monitoring = RamMonitoring()
 
     def load_config(self, path: str) -> dict[str, Any]:
-        """Loads the configuration from a YAML file. Returns empty dict if file fails."""
+        """Loads the configuration from a YAML file."""
         try:
             if os.path.exists(path):
                 with open(path, 'r') as file: