-This is a module that offers an opinionated take on how whole program
-logging should be initialized and controlled. It uses standard Python
-:py:mod:`logging` but gives you control, via commandline config, to:
-
- - Set the logging level of the program including overriding the
- logging level for individual modules,
- - Define the logging message format including easily adding a
- PID/TID marker on all messages to help with multithreaded debugging,
- - Control the destination (file, `sys.stderr`, syslog) of messages,
- - Control the facility and logging level used with syslog,
- - Squelch repeated messages,
- - Log probalistically,
- - Clear rogue logging handlers added by other imports.
-