buildout.recipe.uwsgi 0.1.2

buildout.recipe.uwsgi

这是一个zc.buildout配方，用于在buildout内部下载、安装和配置uWSGI。它在bin/中编译一个uWSGI可执行文件，并在parts/中创建一个配置文件（xml或ini）。

从shaunsephton.recipe.uwsgi 分叉。

变更日志

0.1.2

• 更改下载URL到 https://。

• 修复了在Python 3下 is_uwsgi_installed() 的错误工作（问题#29）

0.1.1

• 修复了在没有设置 LANG、LC_* 变量的环境中构建时与编码相关的异常（问题#25）

0.1.0

• 合并了一些文档修复

• 合并了对格式字符串的修复（python 2.6）

0.0.25

• 添加了一个新的配置选项 output-format，可以用来指定要创建哪种类型的配置文件（xml - 默认，或 ini）

• xml-* 选项已被弃用，改用 config-*；使用前者将导致警告。

0.0.24

• 对于有疑虑的用户：添加 md5sum 选项以强制对下载的 tar 包进行校验和验证。

0.0.23

• 正确地在多行选项上使用 '\n' 进行分割

0.0.22

• 使用 subprocess.check_call 以兼容 Python 2.6

0.0.21

• 检查在更新 buildout 时是否需要重新构建 uwsgi（之前由于更新没有返回安装路径列表而没有工作）。

• 始终删除构建目录（即使在出错的情况下）。

• 调用 uwsgiconfig.py 而不是 make 来安装 uWSGI。这允许你选择想要使用的 Python 版本。

• 检查 uwsgi 是否已安装及其版本。

• 添加一个选项来配置生成的 uWSGI 配置文件的路径。

0.0.20

• 修复了下载缓存问题；如果 [buildout] 部分中存在 download-cache，则将用于缓存下载后的 uwsgi 源存档

0.0.19

• 将 PYTHON_BIN 环境变量设置为当前 Python 解释器（用于使用正确的解释器构建 uwsgi）

0.0.18

• 修复了问题 #11

0.0.17

• 添加了“pythonpath-eggs-directory”选项，以调整生成的 pythonpath 配置指令的基本目录

0.0.16

• 文档增强

0.0.15

• 添加 download-url 选项以配置非标准下载 URL

0.0.14

• 修复了 extra-paths 问题

0.0.13

• 代码/文档的微小清理

0.0.12

• 修复了使用 'use-system-binary' 时的错误（之前是反向工作的）

• 修复了部分名称不是 'uwsgi' 时的构建过程

0.0.11

• 新增选项 use-system-binary，以跳过 uwsgi 的构建

0.0.10

• 添加了版本选项，允许下载特定版本的 uwsgi

• 添加了指定特定构建配置文件的可能性

• 应添加到生成的 .xml 文件中的选项应使用 xml- 前缀

用法

将部分添加到您的 buildout.cfg，如下所示

[buildout]
parts=uwsgi

[uwsgi]
recipe=buildout.recipe.uwsgi

运行 buildout 将下载和编译 uWSGI，并在 bin/ 目录中添加与部分名称相同的可执行文件（例如，bin/uwsgi）。它还会在与部分名称相同的 parts 目录中创建一个 uwsgi.xml 配置文件（例如，parts/uwsgi/uwsgi.xml）。

uwsgi 可以通过以下方式启动

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

通过配置 output-format 选项，您可以选择其他配置文件格式，例如 ini。

配置选项

您可以为此配方指定多个选项，以“微调”构建过程。以下是 buildout 文件中可能出现的所有可能选项的示例

[buildout]
parts=uwsgi

[uwsgi]
recipe=buildout.recipe.uwsgi
download-url=http://projects.unbit.it/downloads/uwsgi-{0}.tar.gz
version=1.2.5
md5sum=d23ed461d1848aee4cfa16bde247b293
output=${buildout:directory}/parts/uwsgi/uwsgi.ini
output-format=ini
profile=default.ini
use-system-binary=1
config-socket=127.0.0.1:7001
config-module=my_uwsgi_package.wsgi
config-master=True

download-url

指定从该 URL 下载 uWSGI 源代码的位置。此 URL 中的 {0} 将由 version 选项的值替换。download-url 的默认值为 http://projects.unbit.it/downloads/uwsgi-{0}.tar.gz

version

要下载的 uWSGI 版本（默认为最新版本）。

md5sum

源 tar 包的 MD5 校验和。如果校验和不匹配，将引发错误。如果未设置，则不执行检查。

output

生成 uWSGI 配置文件的路径（默认为 parts 目录中名为 {part 的名称}.{output-format} 的文件）。

output-format

要生成的 uWSGI 配置文件类型（xml 或 ini）。

profile

uWSGI 有配置文件（构建配置），可以用来指定与 uWSGI 一起构建的插件（参见 https://github.com/unbit/uwsgi/tree/master/buildconf）。默认为 default.ini。如果指定的配置文件是绝对路径，则使用该路径，否则在 uwsgi 的源文件夹（buildconf/）中查找配置文件，最后退回到当前目录（buildout 被调用的目录）。

use-system-binary

可以使用“外部”的 uWSGI 二进制文件（由操作系统包管理器安装或手动编译）并仅让配方生成 xml 配置文件（不构建 uWsgi）。默认为 False。

pythonpath-eggs-directory

默认情况下，配置生成器会使用绝对路径来指定 python eggs，通常在 buildout:eggs-directory 中通过调用 zc.recipe.egg.Egg(...).working_set()。为了支持需要使用 relative-paths = true 选项的设置，此选项允许调整生成的 uwsgi pythonpath 配置指令的基本目录，例如。

pythonpath-eggs-directory = /opt/vendor/product/python/eggs

config-*

以 config- 开头的任何选项都将去除此前缀，并使用 output-format 作为格式写入由 output 指定的配置文件；例如，config-socket=127.0.0.1:7001 如果 output-format 是 xml，则输出为 <socket>127.0.0.1:7001</socket>。

作者