Simple Google-style logging wrapper for Python.
A simple Google-style logging wrapper for Python.
This library attempts to greatly simplify logging in Python applications. Nobody wants to spend hours pouring over the PEP 282 logger documentation, and almost nobody actually needs things like loggers that can be reconfigured over the network. We just want to get on with writing our apps.
Styled somewhat after the twitter.common.log interface, which in turn was modeled after Google’s internal python logger, which was never actually released to the wild, and which in turn was based on the C++ glog library.
This library configures the root logger, so nearly everything you import that uses the standard Python logging module will play along nicely.
E0924 22:19:15.123456 19552 filename.py:87] Log message blah blah
Splitting on spaces, the fields are:
import glog as log log.setLevel("INFO") # Integer levels are also allowed. 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, and you can skip calling log.setLevel. Just import glog and start logging.
Like the C++ version of glog, python-glog provides a set of check macros  that help document and enforce invariants. These provide a detailed message indicating what values caused the assertion to fail, along with a stack trace identifying the code-path that caused the failure, hopefully making it easier to reproduce the error. Failed checks raise the FailedCheckException. You may find these more convenient and/or more familiar than standard Python asserts, particularly if you are working in a mixed C++ and Python codebase.
import glog as log import math def compute_something(a): log.check_eq(type(a), float) # require floating point types log.check_ge(a, 0) # require non-negative values value = math.sqrt(a) return value if __name__ == '__main__': compute_something(10)
Provided check functions:
check(condition) check_eq(obj1, obj2) check_ne(obj1, obj2) check_le(obj1, obj2) check_ge(obj1, obj2) check_lt(obj1, obj2) check_gt(obj1, obj2) check_notnone(obj1, obj2)
|||Technically these are functions, not macros. Python does not have syntactic macros in the sense that C++ and most lisp-like languages do.|
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|File Name & Checksum SHA256 Checksum Help||Version||File Type||Upload Date|
|glog-0.3.1-py2.py3-none-any.whl (7.8 kB) Copy SHA256 Checksum SHA256||py2.py3||Wheel||Dec 14, 2016|
|glog-0.3.1.tar.gz (5.3 kB) Copy SHA256 Checksum SHA256||–||Source||Dec 14, 2016|