Add utility functions to Lodel.logger and updated settings

Lodel/logger.py

@@ -5,20 +5,33 @@ import os.path
 from Lodel.settings import Settings
 
 # Variables & constants definitions
-default_format = '%(asctime)-15s %(levelname)s %(_pathname)s:%(_lineno)s:%(_funcName)s() %(message)s'
+default_format = '%(asctime)-15s %(levelname)s %(_pathname)s:%(_lineno)s:%(_funcName)s() : %(message)s'
+simple_format = '%(asctime)-15s %(levelname)s : %(message)s'
 SECURITY_LOGLEVEL = 35
 logging.addLevelName(SECURITY_LOGLEVEL, 'SECURITY')
-
-# Disabled, because the custom format raises error (enable to give the _ preffixed arguments to logger resulting into a KeyError exception )
-#logging.captureWarnings(True) # Log warnings
+handlers = dict() # Handlers list (generated from settings)
 
 # Fetching default root logger
 logger = logging.getLogger()
-logger.setLevel(logging.DEBUG)
 
 # Setting options from Lodel.settings.Settings.logging
-for logging_opt in Settings.logging:
-    print("Ben woot !")
+def __init_from_settings():
+    # Disabled, because the custom format raises error (enable to give the _ preffixed arguments to logger resulting into a KeyError exception )
+    #logging.captureWarnings(True) # Log warnings
+
+    logger.setLevel(logging.DEBUG)
+    for name, logging_opt in Settings.logging.items():
+        add_handler(name, logging_opt)
+
+## @brief Add an handler, identified by a name, to a given logger 
+# @param logger logging.Logger : Basically the root logger
+# @param name str : The handler name
+# @param logging_opt dict : dict containing options ( see @ref jesaispasou_pour_les_details )
+def add_handler(name, logging_opt):
+    logger = logging.getLogger()
+    if name in handlers:
+        raise KeyError("A handler named '%s' allready exists")
+
     if 'filename' in logging_opt:
         maxBytes = (1024 * 10) if 'maxBytes' not in logging_opt else logging_opt['maxBytes']
         backupCount = 10 if 'backupCount' not in logging_opt else logging_opt['backupCount']
@@ -37,10 +50,30 @@ for logging_opt in Settings.logging:
     if 'format' in logging_opt:
         formatter = logging.Formatter(logging_opt['format'])
     else:
-        formatter = logging.Formatter(default_format)
+        if 'context' in logging_opt and not logging_opt['context']:
+            formatter = logging.Formatter(simple_format)
+        else:
+            formatter = logging.Formatter(default_format)
 
     handler.setFormatter(formatter)
+    handlers[name] = handler
     logger.addHandler(handler)
+    
+
+## @brief Remove an handler generated from configuration (runtime logger configuration)
+# @param name str : handler name
+def remove_handler(name):
+    if name in handlers:
+        logger.removeHandler(handlers[name])
+    # else: can we do anything ?
+
+## @brief Utility function that disable unconditionnaly handlers that implies console output
+# @note In fact, this function disables handlers generated from settings wich are instances of logging.StreamHandler
+def remove_console_handlers():
+    for name, handler in handlers.items():
+        if isinstance(handler, logging.StreamHandler):
+            remove_handler(name)
+    
 
 # Utility functions
 
@@ -52,7 +85,10 @@ for logging_opt in Settings.logging:
 def log(lvl, msg, *args, **kwargs):
     caller = logger.findCaller() # Opti warning : small overhead
     extra = {
-        '_pathname': os.path.relpath(caller[0]), # os.path.relpath add another small overhead
+        '_pathname': os.path.relpath(
+                                        caller[0],
+                                        start=Settings.lodel2_lib_path
+        ), # os.path.relpath add another small overhead
         '_lineno': caller[1],
         '_funcName': caller[2],
     }
@@ -64,3 +100,7 @@ def warning(msg, *args, **kwargs): log(logging.WARNING, msg, *args, **kwargs)
 def security(msg, *args, **kwargs): log(SECURITY_LOGLEVEL, msg, *args, **kwargs)
 def error(msg, *args, **kwargs): log(logging.ERROR, msg, *args, **kwargs)
 def critical(msg, *args, **kwargs): log(logging.CRITICAL, msg, *args, **kwargs)
+
+# Initialisation triggering
+if len(handlers) == 0:
+    __init_from_settings()

settings.py

@@ -31,12 +31,16 @@ migration_options = {
 em_graph_format = 'png'
 em_graph_output = '/tmp/em_%s_graph.png'
 
-logging = [
-    { 'level': 'INFO' },
-    {
+logging = {
+    'stderr': {
+        'level': 'INFO',
+        'context': False,
+    },
+    'logfile': {
         'level': 'DEBUG',
         'filename': '/tmp/lodel2.log',
         'maxBytes': 1024 * 50, # rotate at 50MB
         'backupCount': 10, # keep at most 10 backup
+        'context': True, # if false use a simpler format string
     }
-]
+}