Custom Application

New in version 19.0.

Sometimes, you want to integrate Gunicorn with your WSGI application. In this case, you can inherit from gunicorn.app.base.BaseApplication.

Here is a small example where we create a very small WSGI app and load it with a custom Application:

  1. from __future__ import unicode_literals
  3. import multiprocessing
  5. import gunicorn.app.base
  7. from gunicorn.six import iteritems
  10. def number_of_workers():
  11.     return (multiprocessing.cpu_count() * 2) + 1
  14. def handler_app(environ, start_response):
  15.     response_body = b'Works fine'
  16.     status = '200 OK'
  18.     response_headers = [
  19.         ('Content-Type', 'text/plain'),
  20.     ]
  22.     start_response(status, response_headers)
  24.     return [response_body]
  27. class StandaloneApplication(gunicorn.app.base.BaseApplication):
  29.     def __init__(self, app, options=None):
  30.         self.options = options or {}
  31.         self.application = app
  32.         super(StandaloneApplication, self).__init__()
  34.     def load_config(self):
  35.         config = dict([(key, value) for key, value in iteritems(self.options)
  36.                        if key in self.cfg.settings and value is not None])
  37.         for key, value in iteritems(config):
  38.             self.cfg.set(key.lower(), value)
  40.     def load(self):
  41.         return self.application
  44. if __name__ == '__main__':
  45.     options = {
  46.         'bind': '%s:%s' % ('127.0.0.1', '8080'),
  47.         'workers': number_of_workers(),
  48.     }
  49.     StandaloneApplication(handler_app, options).run()