buildout.recipe.uwsgi

This is a zc.buildout recipe for downloading and installing uWSGI inside a buildout. Forked from shaunsephton.recipe.uwsgi

Creates a bin/ uWSGI executable and parts XML configuration file with which you can easily launch Buildout sandboxed uWSGI processes.

Changelog

0.0.13

• Minor code/documentation cleanups

0.0.12

• Fixed a bug when using 'use-system-binary' (was working backwards)
• Fixed build process when the part's name was something other than 'uwsgi'

0.0.11

• New option, use-system-binary, to skip building uwsgi

0.0.10

• Added the version option to allow downloading a specific version of uwsgi
• Added the possibility of specifying a certain build profile
• Options that should go in the generated .xml file should be xml- prefixed

Usage

Add a part to your buildout.cfg like so:

[buildout]
parts=uwsgi

[uwsgi]
recipe=buildout.recipe.uwsgi

Running the buildout will download and compile uWSGI and add an executable with the same name as your part in the bin/ directory. In this case bin/uwsgi. It will also create a uwsgi.xml configuration file in a parts directory with the same name as your part. In this case bin/uwsgi/uwsgi.xml.

This allows you to start a uWSGI process configured by the generated XML file, i.e.:

$ ./bin/uwsgi --xml parts/uwsgi/uwsgi.xml

It is also possible to use an "external" uwsgi binary (installed by the means of the OS package manager or compiled manually) and just let the recipe to generate the xml file with settings:

[uwsgi]
recipe=buildout.recipe.uwsgi
use-system-binary = True

And then run it with:

$ /usr/bin/uwsgi --xml parts/uwsgi/uwsgi.xml

You can specify any and all additional uWSGI configuration options as additional options of the Buildout part. These should be prefixed with xml-. For instance to specify a socket and module and to enable the master process add xml-socket, xml-module and xml-master options to the buildout part, i.e.:

[buildout]
parts=uwsgi

[uwsgi]
recipe=buildout.recipe.uwsgi
version=1.2.5
xml-socket=127.0.0.1:7001
xml-module=my_uwsgi_package.wsgi
xml-master=True

Authors

Created By

1. Shaun Sephton

Fork Maintainer

1. Cosmin Luță lcosmin

Contributors

1. mooball
2. thefunny42
3. rage2000