The repoze.bfg Web Application Framework

repoze.bfg is a small, fast, down-to-earth Python web application framework. It is developed as part of the Repoze project by Agendaless Consulting and other contributors. It is licensed under a BSD-like license.

Narrative documentation

Narrative documentation in chapter form explaining how to use repoze.bfg.

Detailed Change History

Design Documentation

Sample Applications

repoze.cluegun is a simple pastebin application based on Rocky Burt’s ClueBin. It demonstrates form processing, security, and the use of ZODB within a repoze.bfg application. It also has very simple repoze.who integration. Check this application out of Subversion via:

svn co repoze.cluegun

repoze.virginia is a very simple dynamic file rendering application. It is willing to render structured text documents, HTML documents, and images from a filesystem directory. This application runs the website. Check this application out of Subversion via:

svn co repoze.virginia

repoze.shootout is an example “idea competition” application by Carlos de la Guardia. It demonstrates a hybrid of URL dispatch and traversal and integration with SQLAlchemy and repoze.who. Check this application out of Subversion via:

svn co repoze.shootout

bfgsite is the software which runs the website. It demonstrates integration with Trac, and includes several mini-applications such as a pastebin and tutorial engine. Check a buildout for this application out of Subversion via:

svn co bfgsite_buildout

KARL is a moderately-sized application (roughly 70K lines of Python code) built on top of repoze.bfg and other Repoze software. It is an open source web system for collaboration, organizational intranets, and knowledge management, It provides facilities for wikis, calendars, manuals, searching, tagging, commenting, and file uploads. See the KARL site for download and installation details.

Support and Development

The BFG web site is the main online source of repoze.bfg support and development information.

To report bugs, use the bug tracker.

If you’ve got questions that aren’t answered by this documentation, contact the Repoze-dev maillist or join the #repoze IRC channel.

Browse and check out tagged and trunk versions of repoze.bfg via the Repoze Subversion repository. To check out the trunk via Subversion, use this command:

svn co repoze.bfg

To find out how to become a contributor to repoze.bfg, please see the contributor’s page.

Index and Glossary