glog 0.1

Core benefits

• You and your code don’t need to care about how logging works. Unless you want to, of course.

• No more complicated setup boilerplate!

• Your apps and scripts will all have a consistent log format, and the same predictable behaviours.

This library configures the root logger, so nearly everything you import that uses the standard Python logging module will play along nicely.

Behaviours

• Messages are always written to stderr.

• Lines are prefixed with a google-style log prefix, of the form

E0924 22:19:15.123456 19552 filename.py:87] Log message blah blah

Splitting on spaces, the fields are:

1. The first character is the log level, followed by MMDD (month, day)

2. HH:MM:SS.microseconds

3. Process ID

4. basename_of_sourcefile.py:linenumber]

5. The body of the log message.

Example use

import glog as log

log.info("It works.")
log.warn("Something not ideal")
log.error("Something went wrong")
log.fatal("AAAAAAAAAAAAAAA!")

If your app uses gflags, it will automatically gain a –verbosity flag. In order for that flag to be effective, you must call log.init() after parsing flags, like so:

import sys
import gflags
import glog as log

FLAGS = gflags.FLAGS

def main():
  log.debug('warble garble %s', FLAGS.verbosity)

if __name__ == '__main__':
    posargs = FLAGS(sys.argv)
    log.init()
    main(posargs[1:])

Happy logging!