Skip to content

4spam/firepython

 
 

Repository files navigation

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.

screenshot

Prerequisites

You definitely need Firebug 1.2 or higher.

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.

Here is source repository for firefox addon with instructions how to install bleeding edge version.

Python Library

The easy way

sudo easy_install firepython

The manual way

Just note, that it depends on simplejson.

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 firepython

(you may want to replace last parameter with real path in your repo)

If firepython directory is not on your import paths, you need to add firepython 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

Current State

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

Version 0.3 will also work with final Firebug 1.3 + Firefox 3.1 and Firebug 1.2.1 + Firefox 3.0.4.

Contributors

Also thanks to

Support

Bugs / Feature requests

The support forum is here.

IRC

IRC channel #firepython at freenode

Articles

History

  • v0.3 (to be released)

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

About

Python logging console for Firebug

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors