Werkzeug

Werkzeug is a collection of various utilities for WSGI applications. It features request and response objects as well as a powerful url dispatcher and a debugging system.

If you're looking for information about Werkzeug, you're most likely in the wrong place. The Werkzeug webpage can be found at werkzeug.pocoo.org, this is the Werkzeug bug tracker.

If you want to file a bug please register and use your account to create tickets.

---

The Mercurial repository can be browsed here, and checked out with

hg clone http://dev.pocoo.org/hg/werkzeug-main

Starting Points

• check out or browse the source using mercurial
• browse the source using Trac
• create a new bug report / feature request
• read the documentation
• visit the website
• join the IRC channel (read the logs)
• read or post to the mailing list

Tips and Tricks

The following list points to various small and useful snippets for Werkzeug powered applications. Those snippets are community provided. If you have your own one, add it to the list.

• Request and Response Processor — Django inspired high level in-application middlewares.
• Application Example — A real-world WSGI application() using Werkzeug. Includes URL & view examples.
• SQLAlchemy And Werkzeug — Good ways to integrate SQLAlchemy into a Werkzeug powered application.
• Using the Werkzeug Debugger with Django — easily debug your Django applications using Werkzeug.
• Dynamic Dispatching — create WSGI applications on the fly based on environment variables.
• Error Handling in Production Mode — how to handle server errors in production environments.
• FCGI and HTTP Authentication — a workaround for authorization headers in FastCGI
• Using the Werkzeug Debugger with AppEngine — debugger templates converted to Jinja2 and a little hack to make the debugger work with AppEngine? development server.

Not so clever Tricks

• Using a reporter stream for uploads — use a reporter stream for uploads with AJAX magic.

Contrib

• Werkzeug live ebuild for Gentoo — If you want to live on the unstable edge, then do it properly.
• WerkzeugBasedFrameworks - Fuller stack frameworks based on Werkzeug.

Example Applications

Here a list of example applications with sourcecode available:

• Plnt — a planet application (Online Demo)
• SimpleWiki — a simple wiki application (Online Demo)
• Shorty — a tinyurl clone (Online Demo)

More applications can be found in the examples folder.