FirePython

FirePython is a sexy Python logger console integrated into Firebug 1.3.

Originally, I have created it to light up my lonely nights I was spending with Google App Engine.

Prerequisites

You definitely need Firebug 1.3.

Installation

Firefox Addon

Preferred way is to install this firefox extension via addons.mozilla.com. The latest version is available here.

Warning: some people have reported they are unable to download and install extension from addons.mozilla.com. In this case you may try workaround.

Python Library

The easy way:

sudo easy_install firepython

The manual way:

Clone project from github and copy folder python/firepython in your project directory. Or alternatively you may want to add folder python into your sys.path.

It depends on simplejson!

Usage:

Django

After installation, enable middleware by adding its path in MIDDLEWARE_CLASSES: firepython.django.FirePythonDjango.

WSGI compatible

After installation, enable middleware firepython.wsgi.FirePythonWSGI.

Custom usage

In all places where you want to capture logging ...

import firepython

# somewhere at the beginning of your response, before any of your loggings take place:
handler = firepython.FirePythonLogHandler()
logger = logging.getLogger()
logger.addHandler(handler)
logger.setLevel(logging.DEBUG)

# ... your handler code here

# right before serving your response back to client:
logger.removeHandler(handler)
handler.flush(response.add_header)   # this will add headers into response

Current State

Version 0.1 is tested to work with alpha Firebug 1.3 and Firefox 3.1.

Contributors

• Alexander Solovyov - Django and WSGI middlewares
• Firebug team - without these guys web wouldn't look like today.
• FirePHP authors - a lot of inspiration, good work mates!

Support

The support forum is here.

Articles

• FirePython — no prints? (by Alexander Solovyov)

History

• 0.2 (24.11.2008)

  • Django and WSGI middlewares by Alexander Solovyov
  • added as firepython package to PyPI index
  • fixed FirePython panel styles when Firebug window was detached from main window

• 0.1 (15.11.2008)

  • public alpha release
  • initial server-side support for Python and Google App Engine
  • communication via response headers
  • logging module functionality (debug, info, warning, error, critical)
  • log record filtering by type
  • log record searching
  • opening files in TextMate (click to timestamp field)