80
_stderr_handler = None
86
# global verbosity for bzrlib; controls the log level for stderr; 0=normal; <0
87
# is quiet; >0 is verbose.
81
88
_verbosity_level = 0
90
# File-like object where mutter/debug output is currently sent. Can be
91
# changed by _push_log_file etc. This is directly manipulated by some
92
# external code; maybe there should be functions to do that more precisely
93
# than push/pop_log_file.
96
# Absolute path for ~/.bzr.log. Not changed even if the log/trace output is
97
# redirected elsewhere. Used to show the location in --version.
85
98
_bzr_log_filename = None
86
_bzr_log_opened = None
89
# configure convenient aliases for output routines
100
# The time the first message was written to the trace file, so that we can
101
# show relative times since startup.
102
_bzr_log_start_time = bzrlib._start_time
105
# held in a global for quick reference
91
106
_bzr_logger = logging.getLogger('bzr')
94
109
def note(*args, **kwargs):
95
110
# FIXME note always emits utf-8, regardless of the terminal encoding
112
# FIXME: clearing the ui and then going through the abstract logging
113
# framework is whack; we should probably have a logging Handler that
114
# deals with terminal output if needed.
97
116
bzrlib.ui.ui_factory.clear_term()
98
117
_bzr_logger.info(*args, **kwargs)
100
120
def warning(*args, **kwargs):
102
122
bzrlib.ui.ui_factory.clear_term()
103
123
_bzr_logger.warning(*args, **kwargs)
126
# configure convenient aliases for output routines
128
# TODO: deprecate them, have one name for each.
106
130
log_error = _bzr_logger.error
107
131
error = _bzr_logger.error
172
def open_tracefile(tracefilename=None):
173
# Messages are always written to here, so that we have some
174
# information if something goes wrong. In a future version this
175
# file will be removed on successful completion.
176
global _file_handler, _bzr_log_file, _bzr_log_filename
179
if tracefilename is None:
189
def _get_bzr_log_filename():
190
bzr_log = os.environ.get('BZR_LOG')
193
home = os.environ.get('BZR_HOME')
180
195
if sys.platform == 'win32':
181
196
from bzrlib import win32utils
182
197
home = win32utils.get_home_location()
184
199
home = os.path.expanduser('~')
185
_bzr_log_filename = os.path.join(home, '.bzr.log')
187
_bzr_log_filename = tracefilename
189
_bzr_log_filename = os.path.expanduser(_bzr_log_filename)
200
return os.path.join(home, '.bzr.log')
204
"""Open the .bzr.log trace file.
206
If the log is more than a particular length, the old file is renamed to
207
.bzr.log.old and a new file is started. Otherwise, we append to the
210
This sets the global _bzr_log_filename.
212
global _bzr_log_filename
213
_bzr_log_filename = _get_bzr_log_filename()
190
214
_rollover_trace_maybe(_bzr_log_filename)
193
#tf = codecs.open(trace_fname, 'at', 'utf8', buffering=LINE_BUFFERED)
194
tf = open(_bzr_log_filename, 'at', LINE_BUFFERED)
196
# tf.tell() on windows always return 0 until some writing done
199
tf.write("this is a debug log for diagnosing/reporting problems in bzr\n")
200
tf.write("you can delete or truncate this file, or include sections in\n")
201
tf.write("bug reports to https://bugs.launchpad.net/bzr/+filebug\n\n")
202
_file_handler = logging.StreamHandler(tf)
203
fmt = r'[%(process)5d] %(asctime)s.%(msecs)03d %(levelname)s: %(message)s'
204
datefmt = r'%Y-%m-%d %H:%M:%S'
205
_file_handler.setFormatter(logging.Formatter(fmt, datefmt))
206
_file_handler.setLevel(logging.DEBUG)
207
logging.getLogger('').addHandler(_file_handler)
216
bzr_log_file = open(_bzr_log_filename, 'at', 1) # line buffered
217
# bzr_log_file.tell() on windows always return 0 until some writing done
218
bzr_log_file.write('\n')
219
if bzr_log_file.tell() <= 2:
220
bzr_log_file.write("this is a debug log for diagnosing/reporting problems in bzr\n")
221
bzr_log_file.write("you can delete or truncate this file, or include sections in\n")
222
bzr_log_file.write("bug reports to https://bugs.launchpad.net/bzr/+filebug\n\n")
208
224
except IOError, e:
209
225
warning("failed to open trace file: %s" % (e))
226
# TODO: What should happen if we fail to open the trace file? Maybe the
227
# objects should be pointed at /dev/null or the equivalent? Currently
228
# returns None which will cause failures later.
231
def enable_default_logging():
232
"""Configure default logging: messages to stderr and debug to .bzr.log
234
This should only be called once per process.
236
Non-command-line programs embedding bzrlib do not need to call this. They
237
can instead either pass a file to _push_log_file, or act directly on
238
logging.getLogger("bzr").
240
Output can be redirected away by calling _push_log_file.
242
# create encoded wrapper around stderr
243
bzr_log_file = _open_bzr_log()
244
push_log_file(bzr_log_file,
245
r'[%(process)5d] %(asctime)s.%(msecs)03d %(levelname)s: %(message)s',
246
r'%Y-%m-%d %H:%M:%S')
247
# after hooking output into bzr_log, we also need to attach a stderr
248
# handler, writing only at level info and with encoding
249
writer_factory = codecs.getwriter(osutils.get_terminal_encoding())
250
encoded_stderr = writer_factory(sys.stderr, errors='replace')
251
stderr_handler = logging.StreamHandler(encoded_stderr)
252
stderr_handler.setLevel(logging.INFO)
253
logging.getLogger('bzr').addHandler(stderr_handler)
256
def push_log_file(to_file, log_format=None, date_format=None):
257
"""Intercept log and trace messages and send them to a file.
259
:param to_file: A file-like object to which messages will be sent.
261
:returns: A memento that should be passed to _pop_log_file to restore the
262
previously active logging.
266
new_handler = logging.StreamHandler(to_file)
267
new_handler.setLevel(logging.DEBUG)
268
if log_format is None:
269
log_format = '%(levelname)8s %(message)s'
270
new_handler.setFormatter(logging.Formatter(log_format, date_format))
271
# save and remove any existing log handlers
272
bzr_logger = logging.getLogger('bzr')
273
old_handlers = bzr_logger.handlers[:]
274
del bzr_logger.handlers[:]
275
# set that as the default logger
276
bzr_logger.addHandler(new_handler)
277
bzr_logger.setLevel(logging.DEBUG)
278
# TODO: check if any changes are needed to the root logger
280
# TODO: also probably need to save and restore the level on bzr_logger.
281
# but maybe we can avoid setting the logger level altogether, and just set
282
# the level on the handler?
284
# save the old trace file
285
old_trace_file = _trace_file
286
# send traces to the new one
287
_trace_file = to_file
288
result = new_handler, _trace_file
289
return ('log_memento', old_handlers, new_handler, old_trace_file, to_file)
292
def pop_log_file((magic, old_handlers, new_handler, old_trace_file, new_trace_file)):
293
"""Undo changes to logging/tracing done by _push_log_file.
295
This flushes, but does not close the trace file.
297
Takes the memento returned from _push_log_file."""
298
assert magic == 'log_memento'
300
_trace_file = old_trace_file
301
bzr_logger = logging.getLogger('bzr')
302
bzr_logger.removeHandler(new_handler)
303
# must be closed, otherwise logging will try to close it atexit, and the
304
# file will likely already be closed underneath.
306
bzr_logger.handlers = old_handlers
307
new_trace_file.flush()
310
@symbol_versioning.deprecated_function(symbol_versioning.one_two)
311
def enable_test_log(to_file):
312
"""Redirect logging to a temporary file for a test
314
:returns: an opaque reference that should be passed to disable_test_log
315
after the test completes.
317
return push_log_file(to_file)
320
@symbol_versioning.deprecated_function(symbol_versioning.one_two)
321
def disable_test_log(memento):
322
return pop_log_file(memento)
212
325
def log_exception_quietly():
282
376
return _verbosity_level > 0
379
@symbol_versioning.deprecated_function(symbol_versioning.one_two)
285
380
def disable_default_logging():
286
381
"""Turn off default log handlers.
288
This is intended to be used by the test framework, which doesn't
289
want leakage from the code-under-test into the main logs.
292
l = logging.getLogger('')
293
l.removeHandler(_stderr_handler)
295
l.removeHandler(_file_handler)
299
def enable_test_log(to_file):
300
"""Redirect logging to a temporary file for a test
302
returns an opaque reference that should be passed to disable_test_log
303
after the test completes.
305
disable_default_logging()
308
hdlr = logging.StreamHandler(to_file)
309
hdlr.setLevel(logging.DEBUG)
310
hdlr.setFormatter(logging.Formatter('%(levelname)8s %(message)s'))
311
_bzr_logger.addHandler(hdlr)
312
_bzr_logger.setLevel(logging.DEBUG)
313
result = hdlr, _trace_file, _trace_depth
314
_trace_file = to_file
319
def disable_test_log((test_log_hdlr, old_trace_file, old_trace_depth)):
320
_bzr_logger.removeHandler(test_log_hdlr)
321
test_log_hdlr.close()
324
_trace_file = old_trace_file
325
_trace_depth = old_trace_depth
327
enable_default_logging()
383
Don't call this method, use _push_log_file and _pop_log_file instead.
330
388
def report_exception(exc_info, err_file):
added
removed
bzrlib/trace.py
