#! /usr/bin/env python
"""

My spiffy trace/debug routine....   :-)

"""
__version__ = """$Id: debugtools.py,v 1.1 2008-06-11 17:15:19 sandro Exp $"""

import sys


tags = set()

indent = 0

def debug(tag, *obj):
    """Output a debugging line, if debugging for this tag is turned
    on.   Also does nest-indenting.   If the tag ends with "(" then
    succeeding lines are indented.  If it ends with ")" then this is
    the last line at this indent level."""

    global indent
    global tags

    indentChange = 0
    if tag.endswith("("):
        indentChange = 1
        tag = tag[0:-1]
    if tag.endswith(")"):
        indentChange = -1
        tag = tag[0:-1]
    if len(obj) > 0:
        if tag in tags or "all" in tags:
            # sys.stderr.write("(indent %04d)" % indent)
            sys.stderr.write("%-7s " %(tag+":"))
            sys.stderr.write(".  " * indent)
            sys.stderr.write(" ".join([str(x) for x in obj]) + "\n")
    indent += indentChange


def dict_repr(d):
    """stable serialization of dict"""

    pairs = []
    keys = d.keys()
    keys.sort()
    for k in keys:
        pairs.append(k+": "+repr(d[k]))
    return "{"+", ".join(pairs)+"}"