FirePython

FirePython is a sexy Python logger console integrated into Firebug.

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

Prerequisites

You definitely need Firebug 1.2 or higher. You also have to install Firefox Addon which is called FireLogger.

Easy Installation

Firefox Addon

Preferred way is to install this firefox extension via addons.mozilla.com.

Python Library

sudo easy_install firepython

Install latest version from sources (preferred)

Firefox Addon

If you want to install latest addon from sources, you need to build it. It should be simple, but make sure you have these tools on your paths:

• git
• zip
• ruby and rake

Build steps:

git clone git://github.com/darwin/firelogger.git
cd firelogger
rake

After that your XPI should be available in build/firelogger-X.Y.xpi.

You should be able to install XPI file into Firefox: File -> Open File ... and browse for firelogger-X.Y.xpi.

Remember, that you should be also using latest FirePython library on server-side (see next section).

Python Library

Just note, that it depends on simplejson (or some other json parsing library needed by jsonpickle).

Clone project from github in your project directory.

Or if your web project uses git for versioning, you may want to be cool and use firepython as a submodule of your git repository.

git submodule add git://github.com/darwin/firepython.git relative/path/to/firepython

Note: replace last parameter with relative path in your repo.

In case firepython directory is not on your import paths, you need to add relative/path/to folder into your sys.path.

Usage

Django

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

WSGI compatible

After installation, enable middleware firepython.middleware.FirePythonWSGI.

Custom usage

Look for inspiration in middleware.py

Real world examples

• FirePython added to Bloog (blog engine for GAE)
• FirePython added to DryDrop (GAE hosting engine for GitHubbers && !Pythonists)

Current State

• Version 0.3 works with:
  • Firebug 1.3 + Firefox 3.1
  • Firebug 1.2.1 + Firefox 3.0.4.
  • I'm running it with Firebug 1.4 (SVN branch) + Firefox 3.2 (Nightly)
• Version 0.2 is tested to work with alpha Firebug 1.3 and Firefox 3.1.

Contributors

• Alexander Solovyov - python server-side library, Django and WSGI middlewares.
• Ivan Fedorov - helping out with threading issues.

Also thanks to

• Joe Hewitt, John J. Barton, Jan Odvarko and others in Firebug working group - without these guys, the web wouldn't look like today.
• Christoph Dorn and FirePHP contributors - a lot of inspiration, good work mates!
• John Paulett for jsonpickle library - I was naively developing poor man's solution for inspecting objects in Python, but hopefully googled this gem early

Support

FAQ

Clicking on source-file links in Logger panel does nothing. How can I open trace-back sources in TextMate?

Go to Firebug Menu -> Open With Editor -> Configure editors ... like this:

I was unable to download/install FireLogger extension from addons.mozilla.org. Can you package latest version for me?

Some people reported this problem too. You may try workaround.

Bugs / Feature requests

The support forum is here.

IRC

IRC channel #firelogger at freenode

Articles

• FirePython — no prints? (by Alexander Solovyov)

History

• v0.4 (to be released)

• v0.3 (16.03.2009)

  • compatibility with Firebug 1.2
  • password protection for production site
  • path rewrite functionality
  • console supports rich formatting of python log messages
  • thread-safety
  • improved API
  • Firefox Addon detached as a separate project FireLogger
  • option for hiding internal reprs of exported objects

• v0.2 (24.11.2008)

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

• v0.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)