Skip to main content

Create tree structures for your logs

Project description


This package adds structure to your application logs by creating a tree structure for functions that execute within functions.

These nested functions can be very troublesome to troubleshoot using a regular logger, but by using the tree logger, you can easily see the chain of events and drill down to where the error occurs.

Below is an example of what the tree would look like. The example shows how output of a function can be nested to the appropriate level.

Function Stand_Up 
-"Begin Standing Up" 
--Function Move_Legs
---"Moving Legs" 
----Function Check_Balance
-----"Balance is Good"
----Finish Check_Balance
---"Leg Movement Sucessful"
-- Finish Move_Legs 
-"Stand Up took 1 Second(s)" 
Finish Stand_up

To begin tree logging, import the tree object and treewrap decorator into your modules. 

from treelogger import tree, treewrap 

def showthis(value):


def nest(value):

    tree.log('Nesting a value of %i' % value)


    tree.log('Nesting a value of %i + 1' % value)

    showthis(value + 1)

You can then import things from your modules into one or more main modules. In the main module, use the tree = TreeLogger() form to create a logging instance.

The TreeLogger class instance is a global instance (kind of like sys.stdout) and all of your modules that imported tree will send their logs to the global tree. When defining the global tree, it has 2 default outputs: stdout and text file.
from test import showthis, nest
from treelogger import tree, TreeLogger

tree = TreeLogger()


Running would give you the output below.

<?xml version="1.0" ?>
		<msg>  Nesting a value of 123  </msg>
			<msg>  123  </msg>
		<msg>  Nesting a value of 123 + 1  </msg>
			<msg>  124  </msg>

As you can see, functions become nested and so do the logging messages for the functions. The resulting XML file can be searched using Xpath or visualized using an XML visualizer.

A common mistake is to use the treewrap without the (). Unlike other decorators, the brackets are necessary for properly returning values from the decorated function.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for treelogger, version 0.15
Filename, size File type Python version Upload date Hashes
Filename, size treelogger-0.15-py3-none-any.whl (6.6 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size treelogger-0.15.tar.gz (3.7 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page