Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!


Project Description

Run WSGI applications defined by paste.deploy configurations

A script, run-wsgi is provided that runs WSGI applications defined in Paste Deployment configuration files. For example, given a configuration file, paste.ini:

use = egg:bobo
bobo_resources = myapp

pipeline = debug reload main

use = egg:bobo#reload
modules = zc.wsgirunner.tests

use = egg:bobo#debug

use = egg:waitress
host = localhost
port = 8080

use = call:myapp:config
key = 42

log = INFO

We can run the applicaton with [1]:

run-wsgi paste.ini

If we want to run the debug pipeline:

run-wsgi -a debug paste.ini

Logging and configuration

zc.wsgirunner extends the Paste Deploy vocabulary of sections with logging and configuration sections.

As with the other sections, you can have multiple sections and select which one you want with command-line options.

Logging sections

Logging sections come in 2 flavors, ZConfig, and basic. If a logging section has a config option, its value is passed ZConfig’s [2] configureLoggers method. Otherwise, the options in the logging section are passed to logging.basicConfig.

Configuration sections

Configuration sections identify a configuration function with a use option, as with other Paste Deploy sections. The configuration object is called with global defaults and with options from the configuration section.


0.1.0 (2014-04-12)

Initial release

[1]You should use a tool like ZDaemon or supervisord with run-wsgi in production. run-wsgi doesn’t daemonize itself.

ZConfig provides the easiest way to create non-trivial logger configurations.

Note, however, that ZConfig isn’t a dependency of zc.wsgirunner, so if you want to use ZConfig to configure logging, you need to install it separately.

Release History

Release History

This version
History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
zc.wsgirunner-0.1.0.tar.gz (4.9 kB) Copy SHA256 Checksum SHA256 Source Apr 12, 2014

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting