← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/trace.py

  • Committer: Mark Hammond
  • Date: 2009-01-12 01:55:34 UTC
  • mto: (3995.8.2 prepare-1.12)
  • mto: This revision was merged to the branch mainline in revision 4007.
  • Revision ID: mhammond@skippinet.com.au-20090112015534-yfxg50p7mpds9j4v
Include all .html files from the tortoise doc directory.

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/trace.py
12
12
#
13
13
# You should have received a copy of the GNU General Public License
14
14
# along with this program; if not, write to the Free Software
15
 
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
 
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
16
16
 
17
17
"""Messages and logging for bazaar-ng.
18
18
 
216
216
 
217
217
 
218
218
def _open_bzr_log():
219
 
    """Open the .bzr.log trace file.
 
219
    """Open the .bzr.log trace file.  
220
220
 
221
221
    If the log is more than a particular length, the old file is renamed to
222
222
    .bzr.log.old and a new file is started.  Otherwise, we append to the
281
281
 
282
282
    :param to_file: A file-like object to which messages will be sent.
283
283
 
284
 
    :returns: A memento that should be passed to _pop_log_file to restore the
 
284
    :returns: A memento that should be passed to _pop_log_file to restore the 
285
285
    previously active logging.
286
286
    """
287
287
    global _trace_file
316
316
    """Undo changes to logging/tracing done by _push_log_file.
317
317
 
318
318
    This flushes, but does not close the trace file.
319
 
 
 
319
    
320
320
    Takes the memento returned from _push_log_file."""
321
321
    global _trace_file
322
322
    _trace_file = old_trace_file
329
329
    new_trace_file.flush()
330
330
 
331
331
 
 
332
@symbol_versioning.deprecated_function(symbol_versioning.one_two)
 
333
def enable_test_log(to_file):
 
334
    """Redirect logging to a temporary file for a test
 
335
    
 
336
    :returns: an opaque reference that should be passed to disable_test_log
 
337
    after the test completes.
 
338
    """
 
339
    return push_log_file(to_file)
 
340
 
 
341
 
 
342
@symbol_versioning.deprecated_function(symbol_versioning.one_two)
 
343
def disable_test_log(memento):
 
344
    return pop_log_file(memento)
 
345
 
 
346
 
332
347
def log_exception_quietly():
333
348
    """Log the last exception to the trace file only.
334
349
 
335
 
    Used for exceptions that occur internally and that may be
336
 
    interesting to developers but not to users.  For example,
 
350
    Used for exceptions that occur internally and that may be 
 
351
    interesting to developers but not to users.  For example, 
337
352
    errors loading plugins.
338
353
    """
339
354
    mutter(traceback.format_exc())
383
398
    return _verbosity_level > 0
384
399
 
385
400
 
 
401
@symbol_versioning.deprecated_function(symbol_versioning.one_two)
 
402
def disable_default_logging():
 
403
    """Turn off default log handlers.
 
404
 
 
405
    Don't call this method, use _push_log_file and _pop_log_file instead.
 
406
    """
 
407
    pass
 
408
 
 
409
 
 
410
_short_fields = ('VmPeak', 'VmSize', 'VmRSS')
 
411
 
386
412
def debug_memory(message='', short=True):
387
413
    """Write out a memory dump."""
388
 
    if sys.platform == 'win32':
389
 
        from bzrlib import win32utils
390
 
        win32utils.debug_memory_win32api(message=message, short=short)
391
 
    else:
392
 
        _debug_memory_proc(message=message, short=short)
393
 
 
394
 
 
395
 
_short_fields = ('VmPeak', 'VmSize', 'VmRSS')
396
 
 
397
 
def _debug_memory_proc(message='', short=True):
398
414
    try:
399
415
        status_file = file('/proc/%s/status' % os.getpid(), 'rb')
400
416
    except IOError: