feat: Introduce GAMES list and refactor CLI configuration

- Added a GAMES list to `games.py` for predefined heavy applications.
- Updated `__init__.py` to export GAMES for easier access.
- Refactored CLI to use `fortscript.yaml` instead of `config.yaml`.
- Removed obsolete `config.yaml` file from CLI directory.
- Enhanced backend simulator and main scripts to utilize GAMES list.
- Improved logging and code formatting across various modules.
- Added new example project demonstrating the use of GAMES list.

Author: WesleyQDev

README_ptBR.md

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

src/fortscript/__init__.py

@@ -20,10 +20,10 @@ def main():
     """Main entry point for the CLI."""
     # Configure logging with Rich
     logging.basicConfig(
-        level="INFO",
-        format="%(message)s",
-        datefmt="[%X]",
-        handlers=[RichHandler(rich_tracebacks=True, show_path=False)]
+        level='INFO',
+        format='%(message)s',
+        datefmt='[%X]',
+        handlers=[RichHandler(rich_tracebacks=True, show_path=False)],
     )
 
     # Minimalist and elegant header
@@ -36,7 +36,7 @@ def main():
 
     # Path for the global config
     config_path = os.path.join(
-        os.path.dirname(os.path.abspath(__file__)), 'config.yaml'
+        os.path.dirname(os.path.abspath(__file__)), 'fortscript.yaml'
     )
 
     app = FortScript(config_path=config_path)

src/fortscript/cli/cli.py

@@ -10,9 +10,13 @@
 
 def simulate_requests():
     """Simulates a developer backend logging API requests."""
-    methods = ["GET", "POST", "PUT", "DELETE"]
-    endpoints = ["/api/v1/users", "/api/v1/auth/login",
-                 "/api/v1/products", "/api/v1/orders"]
+    methods = ['GET', 'POST', 'PUT', 'DELETE']
+    endpoints = [
+        '/api/v1/users',
+        '/api/v1/auth/login',
+        '/api/v1/products',
+        '/api/v1/orders',
+    ]
 
     logs = []
 
@@ -25,11 +29,11 @@ def simulate_requests():
             latency = random.randint(10, 500)
 
             log_entry = {
-                "time": time.strftime("%H:%M:%S"),
-                "method": method,
-                "endpoint": endpoint,
-                "status": status,
-                "latency": f"{latency}ms"
+                'time': time.strftime('%H:%M:%S'),
+                'method': method,
+                'endpoint': endpoint,
+                'status': status,
+                'latency': f'{latency}ms',
             }
 
             logs.append(log_entry)
@@ -38,24 +42,31 @@ def simulate_requests():
 
             # Create a nice UI table
             table = Table(
-                title="[bold blue]Developer Backend Simulator - Service A[/bold blue]")
-            table.add_column("Time", style="dim")
-            table.add_column("Method", style="bold")
-            table.add_column("Endpoint", style="cyan")
+                title='[bold blue]Developer Backend Simulator - Service A[/bold blue]'
+            )
+            table.add_column('Time', style='dim')
+            table.add_column('Method', style='bold')
+            table.add_column('Endpoint', style='cyan')
             table.add_column(
-                "Status", style="green" if status < 400 else "red")
-            table.add_column("Latency", style="magenta")
+                'Status', style='green' if status < 400 else 'red'
+            )
+            table.add_column('Latency', style='magenta')
 
             for log in logs:
-                table.add_row(log["time"], log["method"], log["endpoint"], str(
-                    log["status"]), log["latency"])
+                table.add_row(
+                    log['time'],
+                    log['method'],
+                    log['endpoint'],
+                    str(log['status']),
+                    log['latency'],
+                )
 
             live.update(table)
             time.sleep(random.uniform(0.5, 2.0))
 
 
-if __name__ == "__main__":
+if __name__ == '__main__':
     try:
         simulate_requests()
     except KeyboardInterrupt:
-        console.print("\n[yellow]Shutting down Backend Simulator...[/yellow]")
+        console.print('\n[yellow]Shutting down Backend Simulator...[/yellow]')

src/fortscript/cli/config.yaml src/fortscript/cli/fortscript.yamlsrc/fortscript/cli/config.yaml renamed to src/fortscript/cli/fortscript.yaml

@@ -4,50 +4,49 @@
 from fortscript import FortScript
 
 # Basic logging configuration for the cookbook example
-logging.basicConfig(format="%(message)s")
+logging.basicConfig(format='%(message)s')
 
 # Define the absolute path to our backend simulator
 base_dir = os.path.dirname(os.path.abspath(__file__))
-backend_path = os.path.join(base_dir, "backend_simulator.py")
+backend_path = os.path.join(base_dir, 'backend_simulator.py')
 
 # Configuration for a typical developer development stack
 # These projects will be started automatically when system resources are stable
 development_projects = [
-    {
-        'name': 'API Gateway Simulator',
-        'path': backend_path
-    }
+    {'name': 'API Gateway Simulator', 'path': backend_path}
 ]
 
 # Define heavy applications that should pause our dev stack
 # (e.g., when you want to play a game or render a video)
 productivity_blockers = [
     {'name': 'Chrome (Heavy Usage)', 'process': 'chrome.exe'},
     {'name': 'High-End Game', 'process': 'cyberpunk2077.exe'},
-    {'name': 'Video Editor', 'process': 'premiere.exe'}
+    {'name': 'Video Editor', 'process': 'premiere.exe'},
 ]
 
 
 def on_pause():
-    print(">>> [Event] Development stack PAUSED. Enjoy your game!")
+    print('>>> [Event] Development stack PAUSED. Enjoy your game!')
 
 
 def on_resume():
-    print(">>> [Event] System stable. Returning to development mode...")
+    print('>>> [Event] System stable. Returning to development mode...')
 
 
 # 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)
+    ram_safe=80,  # Resume only when RAM falls below 80% (Hysteresis)
     on_pause=on_pause,
     on_resume=on_resume,
-    log_level="DEBUG"  # Show detailed logs for debugging
+    log_level='DEBUG',  # Show detailed logs for debugging
 )
 
-if __name__ == "__main__":
-    print("--- FortScript: Developer Productivity Case ---")
-    print("Scenario: Managing a local backend stack that pauses during heavy tasks.")
+if __name__ == '__main__':
+    print('--- FortScript: Developer Productivity Case ---')
+    print(
+        'Scenario: Managing a local backend stack that pauses during heavy tasks.'
+    )
     app.run()

src/fortscript/cookbook/project_with_arguments/backend_simulator.py

@@ -0,0 +1,31 @@
+import random
+import time
+
+# Minimalist simulator without external dependencies (rich) for stability in this test
+def simulate_requests():
+    """Simulates a developer backend logging API requests."""
+    methods = ['GET', 'POST', 'PUT', 'DELETE']
+    endpoints = [
+        '/api/v1/users',
+        '/api/v1/auth/login',
+        '/api/v1/products',
+        '/api/v1/orders',
+    ]
+    
+    print("Backend Simulator Started. Press Ctrl+C to stop.")
+
+    while True:
+        method = random.choice(methods)
+        endpoint = random.choice(endpoints)
+        status = random.choice([200, 201, 400, 404, 500])
+        latency = random.randint(10, 500)
+        timestamp = time.strftime('%H:%M:%S')
+
+        print(f"[{timestamp}] {method} {endpoint} -> {status} ({latency}ms)")
+        time.sleep(random.uniform(0.5, 2.0))
+
+if __name__ == '__main__':
+    try:
+        simulate_requests()
+    except KeyboardInterrupt:
+        print('\nShutting down Backend Simulator...')

src/fortscript/cookbook/project_with_arguments/main.py

@@ -0,0 +1,60 @@
+import logging
+import os
+import sys
+
+# 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, "../../../"))
+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')
+
+# Define the absolute path to our backend simulator
+base_dir = os.path.dirname(os.path.abspath(__file__))
+backend_path = os.path.join(base_dir, 'backend_simulator.py')
+
+# Configuration for a typical developer development stack
+development_projects = [
+    {'name': 'Backend API Simulator', 'path': backend_path}
+]
+
+def on_pause():
+    print('>>> [Event] Game detected! Development stack PAUSED.')
+
+def on_resume():
+    print('>>> [Event] No games running. Resuming development stack...')
+
+# Initialize FortScript utilizing the imported GAMES list
+# This demonstrates how to use the built-in list of heavy processes
+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,
+    log_level='DEBUG',
+)
+
+if __name__ == '__main__':
+    print('--- FortScript: Built-in Games List Example ---')
+    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
+    # but we will simulate the check to prove it works. 
+    
+    print("\n--- Verifying Configuration ---")
+    print(f"Projects configured: {len(app.projects)}")
+    print(f"Heavy processes monitored: {len(app.heavy_processes)}")
+    
+    # Check if the first game in the list is correctly monitored
+    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.")
+    app.run()

src/fortscript/cookbook/project_with_games_list/backend_simulator.py

@@ -4,35 +4,37 @@
 from fortscript import FortScript
 
 # Basic logging configuration for the cookbook example
-logging.basicConfig(level=logging.INFO, format="%(message)s")
+logging.basicConfig(level=logging.INFO, format='%(message)s')
 
 # Path to our English configuration file
 base_dir = os.path.dirname(os.path.abspath(__file__))
-config_path = os.path.join(base_dir, "config.yaml")
+config_path = os.path.join(base_dir, 'config.yaml')
 
 
 def alert_system():
-    print("📢 [System Alert] Resource usage threshold reached! Pausing overlays.")
+    print(
+        '📢 [System Alert] Resource usage threshold reached! Pausing overlays.'
+    )
 
 
 def welcome_back():
-    print("✅ [System Alert] Resources cleared. Overlays are live again!")
+    print('✅ [System Alert] Resources cleared. Overlays are live again!')
 
 
 # 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, on_pause=alert_system, on_resume=welcome_back
 )
 
 
 def main():
-    print("--- FortScript: Content Creator Case ---")
-    print(f"Loading external configuration from: {config_path}")
-    print("Scenario: Managing streaming overlays with settings (and log level) defined in YAML.")
+    print('--- FortScript: Content Creator Case ---')
+    print(f'Loading external configuration from: {config_path}')
+    print(
+        'Scenario: Managing streaming overlays with settings (and log level) defined in YAML.'
+    )
     app.run()
 
 
-if __name__ == "__main__":
+if __name__ == '__main__':
     main()

src/fortscript/cookbook/project_with_games_list/main.py

@@ -15,31 +15,32 @@ def streaming_overlay():
 
         while True:
             elapsed = time.strftime(
-                "%H:%M:%S", time.gmtime(time.time() - start_time))
+                '%H:%M:%S', time.gmtime(time.time() - start_time)
+            )
             cpu_usage = psutil.cpu_percent()
 
             # Simulated Twitch/YouTube events
             status_text = (
-                f"[bold cyan]Overlay Active[/bold cyan]\n"
-                f"Uptime: {elapsed}\n"
-                f"Heartbeat: [green]Stable[/green]\n"
-                f"CPU Load: [yellow]{cpu_usage}%[/yellow]\n\n"
-                f"[dim]Listening for stream events...[/dim]"
+                f'[bold cyan]Overlay Active[/bold cyan]\n'
+                f'Uptime: {elapsed}\n'
+                f'Heartbeat: [green]Stable[/green]\n'
+                f'CPU Load: [yellow]{cpu_usage}%[/yellow]\n\n'
+                f'[dim]Listening for stream events...[/dim]'
             )
 
             panel = Panel(
                 status_text,
-                title="[bold magenta]StreamTools Helper[/bold magenta]",
-                subtitle="Managed by FortScript",
-                border_style="magenta"
+                title='[bold magenta]StreamTools Helper[/bold magenta]',
+                subtitle='Managed by FortScript',
+                border_style='magenta',
             )
 
             live.update(panel)
             time.sleep(0.25)
 
 
-if __name__ == "__main__":
+if __name__ == '__main__':
     try:
         streaming_overlay()
     except KeyboardInterrupt:
-        console.print("\n[magenta]StreamTools Helper Closed.[/magenta]")
+        console.print('\n[magenta]StreamTools Helper Closed.[/magenta]')