Python logging: how to represent newlines in the format string in a logging config file?

Question

I'm configuring my Python logging from a file (see http://www.python.org/doc//current/library/logging.html#configuration-file-format ).

From the example on that page, i have a formatter in the config file that looks like:

[formatter_form01]
format=F1 %(asctime)s %(levelname)s %(message)s
datefmt=
class=logging.Formatter

How do i put a newline in the "format" string that specifies the formatter? Neither \n nor \\n work (e.g. format=F1\n%(asctime)s %(levelname)s %(message)s does not work). Thanks

Answer 1

The logging.config module reads config files with ConfigParser, which has support for multiline values.

So you can specify your format string like this:

[formatter_form01]
format=F1
    %(asctime)s %(levelname)s %(message)s
datefmt=
class=logging.Formatter

Multilines values are continued by indenting the following lines (one or more spaces or tabs count as an indent).

Answer 2

The logging configuration file is based on the ConfigParser module. There you'll find you can solve it like this:

[formatter_form01]
format=F1
   %(asctime)s %(levelname)s %(message)s
datefmt=
class=logging.Formatter