Refactor logging setup for debug flag

README.md

@@ -116,6 +116,14 @@ python main.py
 
 Press **Esc** or close the window to quit.
 
+### Debug logging
+
+Run the emulator with verbose debug logs:
+
+```bash
+python main.py --debug
+```
+
 
 ## UML Diagrams
 

main.py

@@ -1,8 +1,19 @@
+import argparse
+
 from src.emulator.emulator import C64Emulator
-from src.utils.log_setup import log
+from src.utils.log_setup import setup_logging
 
 
 def main() -> None:
+    parser = argparse.ArgumentParser(description="Commodore 64 Emulator")
+    parser.add_argument(
+        "--debug",
+        action="store_true",
+        help="Enable debug mode with more detailed logs",
+    )
+    args = parser.parse_args()
+
+    log = setup_logging(debug=args.debug)
     emulator = C64Emulator()
 
     try:

src/utils/log_setup.py

@@ -1,36 +1,32 @@
-import argparse
 import logging
 
+log: logging.Logger = logging.getLogger("C64Emulator")
 
-def setup_logging() -> logging.Logger:
-    """
-    Configures global logging for the Commodore 64 Emulator.
 
-    :return: Configured logger instance.
+def setup_logging(*, debug: bool = False) -> logging.Logger:
     """
-    parser: argparse.ArgumentParser = argparse.ArgumentParser(
-        description="Commodore 64 Emulator Logging Setup"
-    )
-    parser.add_argument(
-        "--debug",
-        action="store_true",
-        help="Enables debug mode with more detailed logs",
-    )
-    args, _ = parser.parse_known_args()
+    Configure global logging for the Commodore 64 Emulator.
+
+    Parameters
+    ----------
+    debug: bool
+        Enables debug mode with more detailed logs.
 
-    debug_enabled: bool = args.debug
-    level: int = logging.DEBUG if debug_enabled else logging.INFO
+    Returns
+    -------
+    logging.Logger
+        Configured logger instance.
+
+    """
+    level: int = logging.DEBUG if debug else logging.INFO
 
     logging.basicConfig(
         level=level,
         format="%(asctime)s - %(levelname)s - %(message)s",
         datefmt="%Y-%m-%d %H:%M:%S",
     )
 
-    logger: logging.Logger = logging.getLogger("C64Emulator")
-    logger.info("Logging configured")
-
-    return logger
-
+    log.setLevel(level)
+    log.info("Logging configured")
 
-log: logging.Logger = setup_logging()
+    return log