add logging to file by demand

Author: voorhs

autointent/_logging/config.yaml

@@ -18,9 +18,10 @@ formatters:
 handlers:
   stdout:
     class: logging.StreamHandler
-    formatter: json
+    formatter: simple
     stream: ext://sys.stdout
 loggers:
   root:
+    level: DEBUG
     handlers:
     - stdout

autointent/_logging/setup.py

@@ -1,18 +1,29 @@
 import importlib.resources as ires
 import logging.config
 import logging.handlers
+from pathlib import Path
 
 import yaml
 
 from autointent.custom_types import LogLevel
 
 
-def setup_logging(level: LogLevel | str) -> None:
+def setup_logging(level: LogLevel | str, log_to_filepath: Path | str | None = None) -> None:
     config_file = ires.files("autointent._logging").joinpath("config.yaml")
     with config_file.open() as f_in:
         config = yaml.safe_load(f_in)
 
     level = LogLevel(level)
-    config["loggers"]["root"]["level"] = level.value
+    config["handlers"]["stdout"]["level"] = level.value
+
+    if log_to_filepath is not None:
+        config["loggers"]["root"]["handlers"].append("file")
+        config["handlers"]["file"] = {
+            "class": "logging.FileHandler",
+            "level": "DEBUG",
+            "formatter": "json",
+            "filename": str(log_to_filepath),
+        }
+
 
     logging.config.dictConfig(config)