cykooz.djangorecipe 1.2.1

描述

此项目是Jeroen Vloothuis最初创建的django recipe (https://launchpad.net/djangorecipe)的一个分支。分支用于调整我们的内部工作流程和目录结构。

此构建配方可以用于创建Django的配置。它将自动下载Django并将其安装在buildout的沙盒中。

以下是一个如何使用配方的示例

[buildout]
parts = satchmo django
eggs = ipython
versions = versions

[satchmo]
recipe = gocept.download
url = http://www.satchmoproject.com/snapshots/satchmo-0.6.tar.gz
md5sum = 659a4845c1c731be5cfe29bfcc5d14b1

[django]
recipe = cykooz.djangorecipe
settings = development
eggs = ${buildout:eggs}
extra-paths =
  ${satchmo:location}
project = dummyshop

[versions]
Django = 1.3

支持选项

此配方支持以下选项。

project

此选项设置项目的名称。如果项目尚不存在，则配方将创建一个基本结构。

projectegg

当您想使用egg作为项目时，请使用此选项代替project选项。这将禁用项目结构的生成。

python

可以使用此选项指定特定的Python版本，这可以不同于运行buildout的版本。

settings

您可以使用此选项设置要使用的设置文件名称。如果您想有一个与开发设置不同的生产设置，这很有用。默认为development。

extra-paths

此处指定的所有路径都将用于扩展bin/*脚本的默认Python路径。

pth-files

将来自站点.pth文件的路径添加到extra-paths。对于像Pinax这样的维护自己的外部_libs目录的东西很有用。

control-script

bin文件夹中创建的脚本名称。这是Django通常创建的manage.py的等效物。默认情况下，它使用部分的名称（[ ]之间的部分）。

wsgi

当此设置为true时，在bin文件夹中生成一个额外的脚本。这可以与mod_wsgi一起使用来部署项目。脚本默认名称为control-script.wsgi。

WSGI脚本

WSGI脚本的名称。

日志文件

如果使用的WSGI服务器不允许打印到stdout，可以将此变量设置为一个文件系统路径 - 所有stdout/stderr数据将重定向到日志而不是打印

fcgi

类似于WSGI，这将在bin文件夹中创建一个额外的脚本。此脚本可以与FCGI部署一起使用。

测试

如果您想在bin文件夹中的脚本运行特定应用集的所有测试，则可以使用此选项。将此设置为要测试的应用标签列表。

testrunner

这是将要创建的testrunner的名称。默认为test。

以下所有选项仅在指定的项目选项尚未创建时才有效。

urlconf

您可以将其设置为特定的url conf。默认将使用project.urls。

media_root

您可以将其设置为特定的MEDIA_ROOT值。默认为os.path.join(os.path.dirname(__file__), ‘media’)

static_root

您可以将其设置为特定的STATIC_ROOT值（仅适用于Django >= 1.3）。默认为os.path.join(os.path.dirname(__file__), ‘static’)

FCGI特定设置

可以在设置文件（settings.py）中设置FCGI选项。选项是FCGI_OPTIONS。它应该设置为字典。下面的部分是一个示例

FCGI_OPTIONS = {
    'method': 'threaded',
}

另一个示例

下一个示例展示了如何使用更多选项

[buildout]
parts = django extras
eggs =
  hashlib

[extras]
recipe = iw.recipe.subversion
urls =
  http://django-command-extensions.googlecode.com/svn/trunk/ django-command-extensions
  http://django-mptt.googlecode.com/svn/trunk/ django-mptt

[django]
recipe = cykooz.djangorecipe
settings = development
project = exampleproject
wsgi = true
eggs =
  ${buildout:eggs}
test =
  someapp
  anotherapp

使用.pth文件的示例

Pinax使用.pth文件向其路径添加许多库；我们可以指定它的目录以将指定的库添加到我们的路径中

[buildout]
parts = PIL
        svncode
        myproject

[PIL]
recipe        = zc.recipe.egg:custom
egg           = PIL
find-links    = http://dist.repoze.org/

[svncode]
recipe        = iw.recipe.subversion
urls          = http://svn.pinaxproject.com/pinax/tags/0.5.1rc1       pinax

[myproject]
recipe        = cykooz.djangorecipe
eggs          = PIL
project       = myproject
settings      = settings
extra-paths   = ${buildout:directory}/myproject/apps
                ${svncode:location}/pinax/apps/external_apps
                ${svncode:location}/pinax/apps/local_apps
pth-files     = ${svncode:location}/pinax/libs/external_libs
wsgi          = true

上面，我们使用标准Pinax的pth文件和extra-paths路径为应用程序，以及我们的项目为将首先在列表中找到的路径。注意，我们期望我们的项目被检出（例如，通过svn:external）直接位于此目录下的“myproject”中。

不同Python版本的示例

要从在生成的脚本中运行buildout的不同Python版本使用，可以使用类似以下内容

[buildout]
parts = myproject

[special-python]
executable = /some/special/python

[myproject]
recipe        = cykooz.djangorecipe
project       = myproject
python                = special-python

mod_wsgi的示例配置

如果您想使用mod_wsgi部署项目，可以使用此示例作为起点

<Directory /path/to/buildout>
       Order deny,allow
       Allow from all
</Directory>
<VirtualHost 1.2.3.4:80>
       ServerName      my.rocking.server
       CustomLog       /var/log/apache2/my.rocking.server/access.log combined
       ErrorLog        /var/log/apache2/my.rocking.server/error.log
       WSGIScriptAlias / /path/to/buildout/bin/django.wsgi
</VirtualHost>

更改