# cherrypy.test.modwsgi module

Wrapper for mod_wsgi, for use as a CherryPy HTTP server.

To autostart modwsgi, the “apache” executable or script must be on your system path, or you must override the global APACHE_PATH. On some platforms, “apache” may be called “apachectl” or “apache2ctl”– create a symlink to them if needed.

## KNOWN BUGS

1. Apache processes Range headers automatically; CherryPy’s truncated

     output is then truncated again by Apache. See test_core.testRanges. This was worked around in http://www.cherrypy.dev/changeset/1319.

2. Apache does not allow custom HTTP methods like CONNECT as per the spec.

     See test_core.testHTTPMethods.

3. Max request header and body settings do not work with Apache.

4. Apache replaces status “reason phrases” automatically. For example,

     CherryPy may set “304 Not modified” but Apache will write out “304 Not Modified” (capital “M”).

5. Apache does not allow custom error codes as per the spec.

6. Apache (or perhaps modpython, or modpython_gateway) unquotes %xx in the

     Request-URI too early.

7. mod_wsgi will not read request bodies which use the “chunked”

     transfer-coding (it passes REQUEST_CHUNKED_ERROR to ap_setup_client_block instead of REQUEST_CHUNKED_DECHUNK, see Apache2’s http_protocol.c and mod_python’s requestobject.c).

8. When responding with 204 No Content, mod_wsgi adds a Content-Length

     header for you.

9. When an error is raised, mod_wsgi has no facility for printing a

     traceback as the response content (it’s sent to the Apache log instead).

10. Startup and shutdown of Apache when running mod_wsgi seems slow.

class cherrypy.test.modwsgi.ModWSGISupervisor(**kwargs)

  Bases: `Supervisor`

  Server Controller for ModWSGI and CherryPy.

  start(modulename)
  stop()

    Gracefully shutdown a server that is serving forever.

  template = '\n# Apache2 server conf file for testing CherryPy with modpython_gateway.\n\nServerName 127.0.0.1\nDocumentRoot "/"\nListen %(port)s\n\nAllowEncodedSlashes On\nLoadModule rewrite_module modules/mod_rewrite.so\nRewriteEngine on\nRewriteMap escaping int:escape\n\nLoadModule log_config_module modules/mod_log_config.so\nLogFormat "%%h %%l %%u %%t \\"%%r\\" %%>s %%b \\"%%{Referer}i\\" \\"%%{User-agent}i\\"" combined\nCustomLog "%(curdir)s/apache.access.log" combined\nErrorLog "%(curdir)s/apache.error.log"\nLogLevel debug\n\nLoadModule wsgi_module modules/mod_wsgi.so\nLoadModule env_module modules/mod_env.so\n\nWSGIScriptAlias / "%(curdir)s/modwsgi.py"\nSetEnv testmod %(testmod)s\n'
  using_apache = True
  using_wsgi = True

cherrypy.test.modwsgi.application(environ, start_response)

cherrypy.test.modwsgi.read_process(cmd, args='')