# @type code org.darkhelm.showsort.server.Code

def tracer(code):

    """

    Simple decorator function that handles identification of recursion and the

    name of the current function to ShowSort. It must have the code parameter

    be set to the Java Code object that will be executing the function.

    """

    import sys

    def wrapAll(func):

        def wrappedFunc(*args, ** kwargs):

            top = sys._getframe(1)

            current = top

            while current.f_back:

                current = current.f_back

                if top.f_code == current.f_code:

                    code.recurse()          # Tell ShowSort that a recursion happened.

                    break

            code.pyFuncName = func.__name__ # Tell ShowSort the name of the function.

            return func(*args, ** kwargs)

        wrappedFunc.__doc__ = func.__doc__

        return wrappedFunc

    return wrapAll