Skip to content

ngamita/firepython

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

139 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

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.

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

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

Also thanks to

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: TextMate hint

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

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)

About

Python logging console for Firebug

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors