wiki:TracWsgiPlugin

WSGI hacks for Trac

Description

  • Provides a Paste application entry point with some configuration options to run Trac
  • Allows to hook other WSGI apps into trac URL space, re-using trac.ini for PasteDeploy configuration

Bugs/Feature Requests

Existing bugs and feature requests for TracWsgiPlugin are here.

If you have any issues, create a new ticket.

Download

Download the zipped source from here.

Source

You can check out TracWsgiPlugin from here using Subversion, or browse the source with Trac.

Examples

Run trac with Paste

To run Trac with Paste, put into a PasteDeploy script:

[app:main]
use = egg:WSGITrac#trac
path = /path/to/your/trac/env

To serve all projects from /path/to/trac/env/parent via HTTPS use:

[app:projects]
use = egg:WSGITrac#tracs
path = /path/to/trac/env/parent
secure = true

NOTE: REMOTE_USER should be set BEFORE calling WSGITrac. WIKI_VIEW permission is needed to list the project in the index.

Run WSGI webapps inside Trac

To run 'myapp' on http://example.com/trac/something and 'thirdapp' on /trac/foobar, put into your trac.ini file:

[webapps]
something = myapp
foobar = config:/path/to/some/paste.ini#thirdapp
[app:myapp]
use = egg:YourEgg#yourapp

Complete example

Add to your trac.ini the following:

[app:main]
use = egg:WSGITrac#trac
path = %(here)s/..

[server:main]
use = egg:PasteScript#wsgiutils
host = 127.0.0.1
port = 8080
[webapps]
foobar = egg:FooBar#foobar

Now you can run trac with whatever WSGI server you have (this example uses WSGIUtil server) by issuing:

 $ paster serve /path/to/your/trac.ini

Trac will run on http://localhost:8080. http://localhost:8080/foobar serves the foobar application from FooBar egg

Recent Changes

[11608] by rjollos on 2012-05-31 17:02:40
Refs #3966: Part of [11607] - Replaced calls to _open_environment with open_environment.
[11607] by rjollos on 2012-05-30 21:48:27
Refs #3966: Fixed incorrect package import (trac.web.main._open_environment existed in Trac 0.10, but does not exist in 0.11).
[2323] by martinpaljak on 2007-06-20 17:40:32
TracWsgiPlugin:

Include index.html

Author/Contributors

Author: martinpaljak
Maintainer: none
Contributors:

Last modified 12 months ago Last modified on Dec 17, 2013, 7:56:01 PM