feat: enhance RAM monitoring and configuration management in FortScript

Author: WesleyQDev

README.md

@@ -138,7 +138,7 @@ log_level: "INFO"
 You can pass all configurations directly in Python code without needing a YAML file:
 
 ```python
-from fortscript import FortScript
+from fortscript import FortScript, RamConfig
 
 app = FortScript(
     projects=[
@@ -149,8 +149,7 @@ app = FortScript(
         {"name": "GTA V", "process": "gta5"},
         {"name": "OBS Studio", "process": "obs64"},
     ],
-    ram_threshold=90,
-    ram_safe=80,
+    ram_config=RamConfig(threshold=90, safe=80),
     log_level="INFO",
 )
 
@@ -188,7 +187,7 @@ app.run()
 Run custom functions when scripts are paused or resumed:
 
 ```python
-from fortscript import FortScript
+from fortscript import FortScript, Callbacks
 
 def when_paused():
     print("🎮 Gaming mode active! Scripts paused.")
@@ -198,8 +197,10 @@ def when_resumed():
 
 app = FortScript(
     config_path="fortscript.yaml",
-    on_pause=when_paused,
-    on_resume=when_resumed,
+    callbacks=Callbacks(
+        on_pause=when_paused,
+        on_resume=when_resumed,
+    )
 )
 
 app.run()
@@ -210,7 +211,7 @@ app.run()
 To keep your code organized, you can separate project and process lists into variables.
 
 ```python
-from fortscript import FortScript
+from fortscript import FortScript, RamConfig, Callbacks
 
 # 1. Define your callbacks
 def notify_pause():
@@ -237,10 +238,11 @@ my_processes = [
 app = FortScript(
     projects=my_projects,
     heavy_process=my_processes,
-    ram_threshold=90,
-    ram_safe=80,
-    on_pause=notify_pause,
-    on_resume=notify_resume,
+    ram_config=RamConfig(threshold=90, safe=80),
+    callbacks=Callbacks(
+        on_pause=notify_pause,
+        on_resume=notify_resume
+    ),
     log_level="DEBUG",
 )
 
@@ -316,10 +318,11 @@ def on_resume():
 app = FortScript(
     projects=my_projects,
     heavy_process=my_heavy_processes,
-    ram_threshold=85,
-    ram_safe=75,
-    on_pause=on_pause,
-    on_resume=on_resume,
+    ram_config=RamConfig(threshold=85, safe=75),
+    callbacks=Callbacks(
+        on_pause=on_pause,
+        on_resume=on_resume,
+    ),
 )
 
 if __name__ == "__main__":
@@ -339,7 +342,7 @@ if __name__ == "__main__":
 - [ ] **Graceful Shutdown**: Try a graceful shutdown (SIGINT/CTRL+C) before forcing process termination.
 - [ ] **Dead Process Handling**: Periodically check if started processes are still alive.
 - [ ] **Project Abstraction**: Refactor into classes (`PythonProject`, `NodeProject`) to easily add new languages.
-- [ ] **Type Hinting**: Improve typing across all methods for better IDE support.
+- [x] **Type Hinting**: Improve typing across all methods for better IDE support.
 
 ### CLI
 

README_ptBR.md

@@ -152,7 +152,7 @@ log_level: "INFO"
 Você pode passar todas as configurações diretamente no código Python, sem precisar de arquivo YAML:
 
 ```python
-from fortscript import FortScript
+from fortscript import FortScript, RamConfig
 
 app = FortScript(
     projects=[
@@ -163,8 +163,7 @@ app = FortScript(
         {"name": "GTA V", "process": "gta5"},
         {"name": "OBS Studio", "process": "obs64"},
     ],
-    ram_threshold=90,
-    ram_safe=80,
+    ram_config=RamConfig(threshold=90, safe=80),
     log_level="INFO",
 )
 
@@ -204,7 +203,7 @@ app.run()
 Execute funções personalizadas quando os scripts são pausados ou retomados:
 
 ```python
-from fortscript import FortScript
+from fortscript import FortScript, Callbacks
 
 def quando_pausar():
     print("🎮 Modo gaming ativado! Scripts pausados.")
@@ -216,8 +215,10 @@ def quando_retomar():
 
 app = FortScript(
     config_path="fortscript.yaml",
-    on_pause=quando_pausar,    # Função executada ao pausar
-    on_resume=quando_retomar,  # Função executada ao retomar
+    callbacks=Callbacks(
+        on_pause=quando_pausar,    # Função executada ao pausar
+        on_resume=quando_retomar,  # Função executada ao retomar
+    )
 )
 
 app.run()
@@ -228,7 +229,7 @@ app.run()
 Para manter seu código organizado, você pode separar as listas de projetos e processos em variáveis.
 
 ```python
-from fortscript import FortScript
+from fortscript import FortScript, RamConfig, Callbacks
 
 # 1. Defina seus callbacks
 def notificar_pausa():
@@ -255,10 +256,11 @@ meus_processos = [
 app = FortScript(
     projects=meus_projetos,
     heavy_process=meus_processos,
-    ram_threshold=90,             # Pausar se RAM > 90%
-    ram_safe=80,                  # Retomar se RAM < 80%
-    on_pause=notificar_pausa,
-    on_resume=notificar_retomada,
+    ram_config=RamConfig(threshold=90, safe=80),
+    callbacks=Callbacks(
+        on_pause=notificar_pausa,
+        on_resume=notificar_retomada
+    ),
     log_level="DEBUG",
 )
 
@@ -335,10 +337,11 @@ def ao_retomar():
 app = FortScript(
     projects=meus_projetos,
     heavy_process=meus_processos_pesados,
-    ram_threshold=85,
-    ram_safe=75,
-    on_pause=ao_pausar,
-    on_resume=ao_retomar,
+    ram_config=RamConfig(threshold=85, safe=75),
+    callbacks=Callbacks(
+        on_pause=ao_pausar,
+        on_resume=ao_retomar,
+    ),
 )
 
 if __name__ == "__main__":
@@ -372,7 +375,6 @@ if __name__ == "__main__":
 - [ ] **Encerramento Amigável**: Tentar um encerramento gracioso (SIGINT/CTRL+C) antes de forçar o término do processo.
 - [ ] **Tratamento de Processos Mortos**: Verificar periodicamente se os processos iniciados ainda estão vivos.
 - [ ] **Abstração de Projetos**: Refatorar para classes (`PythonProject`, `NodeProject`) facilitando a adição de novas linguagens.
-- [ ] **Type Hinting**: Melhorar a tipagem em todos os métodos para melhor suporte em IDEs.
 - [ ] Arrumar bugs relacionado a path, atualmente se adicionar um script python e ele não estiver na raiz do projeto o venv não sera executado, fortscript tenta executar com python padrão, mas da erro por não possuir os imports e a janela do terminal se encerra
 
 ### CLI
@@ -400,6 +402,7 @@ if __name__ == "__main__":
 - [x] Níveis de log configuráveis (DEBUG, INFO, WARNING, ERROR)
 - [x] Encerramento seguro de processos (tree-kill)
 - [x] Adicionar opção de ativar ou desativar as janelas que aparecem dos scripts (Apenas em OS Windows)
+- [x] Type Hinting: Melhorar a tipagem em todos os métodos para melhor suporte em IDEs.
 
 ---
 

src/fortscript/__init__.py

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

src/fortscript/cookbook/project_with_arguments/main.py

@@ -1,7 +1,7 @@
 import logging
 import os
 
-from fortscript import FortScript
+from fortscript import Callbacks, FortScript, RamConfig
 
 # Basic logging configuration for the cookbook example
 logging.basicConfig(format='%(message)s')
@@ -33,14 +33,20 @@ def on_resume():
     print('>>> [Event] System stable. Returning to development mode...')
 
 
+ram = RamConfig(
+    threshold=90,  # Pause if RAM usage exceeds 90%
+    safe=80,  # Resume only when RAM falls below 80% (Hysteresis)
+)
+
 # Initialize FortScript with our custom configuration and events
 app = FortScript(
     projects=development_projects,
     heavy_process=productivity_blockers,
-    ram_threshold=90,  # Pause if RAM usage exceeds 90%
-    ram_safe=80,  # Resume only when RAM falls below 80% (Hysteresis)
-    on_pause=on_pause,
-    on_resume=on_resume,
+    ram_config=ram,
+    callbacks=Callbacks(
+        on_pause=on_pause,
+        on_resume=on_resume,
+    ),
     log_level='DEBUG',  # Show detailed logs for debugging
 )
 

src/fortscript/cookbook/project_with_games_list/main.py

@@ -1,3 +1,4 @@
+from fortscript import GAMES, Callbacks, FortScript, RamConfig
 import logging
 import os
 import sys
@@ -8,7 +9,6 @@
 if src_path not in sys.path:
     sys.path.insert(0, src_path)
 
-from fortscript import FortScript, GAMES
 
 # Basic logging configuration
 logging.basicConfig(format='%(message)s')
@@ -36,10 +36,11 @@ def on_resume():
 app = FortScript(
     projects=development_projects,
     heavy_process=GAMES,  # Using the imported list directly
-    ram_threshold=95,
-    ram_safe=85,
-    on_pause=on_pause,
-    on_resume=on_resume,
+    ram_config=RamConfig(threshold=95, safe=85),
+    callbacks=Callbacks(
+        on_pause=on_pause,
+        on_resume=on_resume,
+    ),
     log_level='DEBUG',
 )
 
@@ -48,7 +49,8 @@ def on_resume():
     print('This example uses the pre-defined "GAMES" list from the library.')
     print(f'Loaded {len(GAMES)} game definitions automatically.')
 
-    # We will not call app.run() here to avoid blocking the CI/Interactive session indefinitely
+    # We will not call app.run() here to avoid blocking
+    # the CI/Interactive session indefinitely
     # but we will simulate the check to prove it works.
 
     print('\n--- Verifying Configuration ---')
@@ -59,7 +61,6 @@ def on_resume():
     first_game = GAMES[0]['name']
     print(f'First monitored game: {first_game}')
 
-    print(
-        "\n✅ Setup complete. To run the full loop, uncomment 'app.run()' in the code."
-    )
+    print('\n✅ Setup complete. '
+          "To run the full loop, uncomment 'app.run()' in the code.")
     app.run()

src/fortscript/cookbook/project_with_yaml_file/main.py

@@ -1,7 +1,7 @@
 import logging
 import os
 
-from fortscript import FortScript
+from fortscript import Callbacks, FortScript
 
 # Basic logging configuration for the cookbook example
 logging.basicConfig(level=logging.INFO, format='%(message)s')
@@ -23,7 +23,8 @@ def welcome_back():
 
 # Initialize FortScript using the external YAML file and events
 app = FortScript(
-    config_path=config_path, on_pause=alert_system, on_resume=welcome_back
+    config_path=config_path,
+    callbacks=Callbacks(on_pause=alert_system, on_resume=welcome_back),
 )