feature: add support for log messages formatting

CHANGES.rst

@@ -9,9 +9,14 @@ New Features
 
 - notifications: Implement 'List-Unsubscribe' header (`#906`_, ix5)
 - css: Grey styling for comment code, code blocks (`#907`_, ix5)
+- add support for log messages formatting, #976
+
+    [general]
+    log-format =
 
 .. _#906: https://github.com/posativ/isso/pull/906
 .. _#907: https://github.com/posativ/isso/pull/907
+.. _#976: https://github.com/posativ/isso/pull/976
 
 Breaking Changes
 ^^^^^^^^^^^^^^^^

contrib/isso-dev.cfg

@@ -16,6 +16,7 @@ max-age = 15m
 notify = stdout
 reply-notifications = false
 log-file =
+log-format =
 latest-enabled = true
 
 [admin]

docs/docs/reference/server-config.rst

@@ -49,6 +49,7 @@ Here are the **default values** for this section:
     max-age = 15m
     notify = stdout
     log-file =
+    log-format =
     gravatar = false
     gravatar-url = https://www.gravatar.com/avatar/{}?d=identicon&s=55
     latest-enabled = false
@@ -118,6 +119,12 @@ log-file
 
     Default: (empty)
 
+log-format
+    Format string for console messages logged to file (see Python
+    `logging.Formatter`).
+
+    Default: (empty)
+
 gravatar
     When set to ``true`` this will add the property "gravatar_image"
     containing the link to a gravatar image to every comment. If a comment

isso/__init__.py

@@ -281,6 +281,9 @@ def main():
     if conf.get("general", "log-file"):
         handler = logging.FileHandler(conf.get("general", "log-file"))
 
+        if conf.get("general", "log-format"):
+            handler.setFormatter(logging.Formatter(conf.get("general", "log-format")))
+
         logger.addHandler(handler)
         logging.getLogger("werkzeug").addHandler(handler)
 

isso/isso.cfg

@@ -51,6 +51,10 @@ reply-notifications=false
 # Log console messages to file instead of standard output.
 log-file =
 
+# Format string for console messages logged to file (see Python
+# `logging.Formatter`).
+log-format =
+
 # adds property "gravatar_image" to json response when true
 # will automatically build md5 hash by email and use "gravatar_url" to build
 # the url to the gravatar image