Skip to content

metinuk/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

Version 0.2 (outdated)

Version 0.2 is quite outdated (November 2008). I haven't made time to do proper release of 0.3 yet. Are you adventurous? Skip this and check installation of latest version from sources in next section.

Firefox Addon

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

Python Library

sudo easy_install firepython

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/firepython-addon.git
git clone git://github.com/darwin/firepython.git
cd firepython
rake

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

You should be able to install XPI file into Firefox: File -> Open File ... and browse for firepython-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

Current State

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

Contributors

Also thanks to

Support

FAQ

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

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

I was unable to download/install FirePython 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 #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

Languages

  • Python 100.0%