Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Greins is tack for Gunicorn. (Please fork from meebo/greins.)

branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 etc
Octocat-spinner-32 greins
Octocat-spinner-32 rpm
Octocat-spinner-32 AUTHORS
Octocat-spinner-32 LICENSE
Octocat-spinner-32 MANIFEST.in
Octocat-spinner-32 Makefile
Octocat-spinner-32 NOTICE
Octocat-spinner-32 README.rst
Octocat-spinner-32 THANKS
Octocat-spinner-32 setup.cfg
Octocat-spinner-32 setup.py
README.rst

About

Greins is a Gunicorn application which makes it easy to configure and manage any number of WSGI apps in one server daemon. It aims to simplify the process of setting up any number of system-wide Gunicorn daemons.

Installation

Greins requires a working version of Gunicorn. It is recommended to read and understand the Gunicorn installation instructions before using Greins.

Install from sources:

$ python setup.py install

Install as an rpm:

$ make rpm

Whatever was here before was wrong. There is no place in PyPI for Greins. The most useful aspects of Greins are in the packaging, since it aims to facilitate deployment of Gunicorn and adds no particular functionality itself.

There's an init script in etc/init aims to be LSB-compliant and packaging for other distributions and systems is an ongoing effort.

Those wishing to deploy Greins for their own infrastructure are encouraged to contribute to the development.

Basic Usage

Greins installs one command line script invoked as greins.

greins

Options are the same as for Gunicorn with one exception: the single APP_MODULE argument is replaced by APP_DIR, a directory containing python source files as described in the following section.

Application Configuration

Applications should be configured by placing a python source file in the configuration directory. This file should populate a dictionary in the global scope called mounts which maps address prefixes (or 'mount points') to WSGI handler functions.

These files are evaluated just like a Gunicorn config file. Server hooks are valid in these configuration files and work as in Gunicorn. Other options, such as logging and worker configuration, are ignored and should be configured globally for the Greins application.

It should be possible to write an application for Gunicorn and then place the application's configuration inside the configuration directory for Greins to begin using it within Greins immediately.

LICENSE

Greins is released under the MIT License. See the LICENSE file for more details.

Something went wrong with that request. Please try again.