-
-
Save swrichards/addfc44194e5a75ede95 to your computer and use it in GitHub Desktop.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
"""\ | |
See `StreamLogger`. | |
""" | |
import sys | |
import logging | |
import cStringIO | |
class StreamLogger(object): | |
""" | |
A helper which intercepts what's written to an output stream | |
then sends it, line by line, to a `logging.Logger` instance. | |
Usage: | |
By overwriting `sys.stdout`: | |
sys.stdout = StreamLogger('stdout') | |
print 'foo' | |
As a context manager: | |
with StreamLogger('stdout'): | |
print 'foo' | |
""" | |
def __init__(self, name, logger=None, unbuffered=False, | |
flush_on_new_line=True): | |
""" | |
``name``: The stream name to incercept ('stdout' or 'stderr') | |
``logger``: The logger that will receive what's written to the stream. | |
``unbuffered``: If `True`, `.flush()` will be called each time | |
`.write()` is called. | |
``flush_on_new_line``: If `True`, `.flush()` will be called each time | |
`.write()` is called with data containing a | |
new line character. | |
""" | |
self.__name = name | |
self.__stream = getattr(sys, name) | |
self.__logger = logger or logging.getLogger() | |
self.__buffer = cStringIO.StringIO() | |
self.__unbuffered = unbuffered | |
self.__flush_on_new_line = flush_on_new_line | |
def write(self, data): | |
"""Write data to the stream. | |
""" | |
self.__buffer.write(data) | |
if self.__unbuffered is True or \ | |
(self.__flush_on_new_line is True and '\n' in data): | |
self.flush() | |
def flush(self): | |
"""Flush the stream. | |
""" | |
self.__buffer.seek(0) | |
while True: | |
line = self.__buffer.readline() | |
if line: | |
if line[-1] == '\n': | |
line = line[:-1] | |
if line: | |
level, line = self.parse(line) | |
logger = getattr(self.__logger, level) | |
logger(line) | |
else: | |
self.__buffer.seek(0) | |
self.__buffer.write(line) | |
self.__buffer.truncate() | |
break | |
else: | |
self.__buffer.seek(0) | |
self.__buffer.truncate() | |
break | |
def parse(self, data): | |
"""Override me! | |
""" | |
return 'info', data | |
def isatty(self): | |
"""I'm not a tty. | |
""" | |
return False | |
def __enter__(self): | |
"""Enter the context manager. | |
""" | |
setattr(sys, self.__name, self) | |
def __exit__(self, exc_type, exc_value, traceback): | |
"""Leave the context manager. | |
""" | |
setattr(sys, self.__name, self.__stream) | |
def test_with_fabric(): | |
"""Example use of `StreamLogger` to intercept Fabric's output. | |
""" | |
# Setup logger | |
logger = logging.getLogger(__name__) | |
handler = logging.StreamHandler(sys.stdout) | |
formatter = logging.Formatter('%(levelname)s: %(message)s') | |
handler.setFormatter(formatter) | |
logger.addHandler(handler) | |
logger.setLevel(logging.DEBUG) | |
# Intercepts Fabric's output | |
from fabric.api import run, env | |
env.host_string = sys.argv[1] | |
with StreamLogger('stdout', logger): | |
run('ls -l') | |
if __name__ == '__main__': | |
test_with_fabric() |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment