Add a wsgi application factory suitable for wsgi servers.
This factory can generate a wsgi application for a cubicweb instance.
It reads the instance name from the CW_INSTANCE environment variable, and
activates the debugmode if CW_DEBUG is defined in environment.
It is usable by uwsgi as the 'module' parameter :
CW_INSTANCE=test uwsgi --plugins python,http --http 0.0.0.0:8080 --module pyramid_cubicweb:wsgi_application()
[pyramid\_cubicweb][] is one specific way of integrating [CubicWeb][] with a
[Pyramid][] web application.
### Features
* provides a default route that let a cubicweb instance handle the request.
### Usage
To use, install pyramid\_cubicweb in your python environment,
and then [include][] the package:
config.include('pyramid_cubicweb')
### Configuration
Requires the following [INI setting / environment variable][]:
* `cubicweb.instance` / `CUBICWEB_INSTANCE`
[pyramid\_cubicweb]: https://www.cubicweb.org/project/pyramid-cubicweb
[CubicWeb]: http://www.cubicweb.com/
[Pyramid]: http://pypi.python.org/pypi/pyramid
[include]: http://docs.pylonsproject.org/projects/pyramid/en/latest/api/config.html#pyramid.config.Configurator.include
[INI setting / environment variable]: http://docs.pylonsproject.org/projects/pyramid/en/latest/narr/environment.html#adding-a-custom-setting