Format non-strings automatically

.vscode/settings.json

@@ -0,0 +1,11 @@
+{
+    "cSpell.words": [
+        "coveragerc",
+        "minilog",
+        "minimalistic",
+        "sinfo",
+        "USERPROFILE",
+        "venv",
+        "verchew"
+    ]
+}

CHANGELOG.md

@@ -1,6 +1,7 @@
-# 2.1 (beta)
+# 2.1 (2022-03-06)
 
 - Dropped support for Python 3.6.
+- Added automatic formatting of non-string messages.
 
 # 2.0.1 (2021-06-03)
 

README.md

@@ -43,7 +43,7 @@ if __name__ == "__main__":
     log.init()
 ```
 
-It will produce the exact same standard library `logging` records behind the scenes.
+It will produce the exact same standard library `logging` records behind the scenes with automatic formatting for non-strings.
 
 ## Installation
 

log/tests/test_utils.py

@@ -2,7 +2,7 @@
 
 import logging
 
-from log.utils import create_logger_record, parse_name
+from log.utils import create_logger_record, format_message, parse_name
 
 
 def describe_create_logger_record():
@@ -29,3 +29,12 @@ def it_uses_the_filename_when_main(expect):
 
     def it_handles_interactive_sessions(expect):
         expect(parse_name("__main__", {})[0]) == "interactive"
+
+
+def describe_format_message():
+    def it_formats_structures(expect):
+        data = {x: x * 10 for x in range(20)}
+        expect(format_message(data).count("\n")) == 19
+
+    def it_preserves_strings(expect):
+        expect(format_message("foobar")) == "foobar"

log/utils.py

@@ -2,6 +2,7 @@
 
 import inspect
 import logging
+from pprint import pformat
 from typing import Dict, Tuple
 
 from . import state
@@ -24,9 +25,9 @@ def create_logger_record(
     record = logger.makeRecord(
         name,
         level,
-        fn=parse_fn(frame.f_globals),
+        fn=parse_filename(frame.f_globals),
         lno=frame.f_lineno,
-        msg=message,
+        msg=format_message(message),
         args=args,
         exc_info=exc_info,
         extra=kwargs,
@@ -36,10 +37,6 @@ def create_logger_record(
     return True
 
 
-def parse_fn(frame_info: Dict) -> str:
-    return frame_info.get("__file__", "interactive")
-
-
 def parse_name(custom_name: str, frame_info: Dict) -> Tuple[str, str]:
     module_name = custom_name or frame_info["__name__"]
     if module_name == "__main__":
@@ -59,3 +56,13 @@ def get_logger(name: str, parent_name: str):
     if not logger.level:
         logger.level = logging.root.level
     return logger
+
+
+def parse_filename(frame_info: Dict) -> str:
+    return frame_info.get("__file__", "interactive")
+
+
+def format_message(value) -> str:
+    if not isinstance(value, str):
+        value = pformat(value)
+    return value

pyproject.toml

@@ -1,7 +1,7 @@
 [tool.poetry]
 
 name = "minilog"
-version = "2.1b1"
+version = "2.1"
 description = "Minimalistic wrapper for Python logging."
 
 license = "MIT"