appfy.recipe.gae 0.9.10

选项

eggs:

要安装的包名。

lib-directory:

库的目的地目录。默认为distlib。

use-zipimport:

如果设置为true，则创建一个包含库的zip文件而不是目录。zip文件名将是lib-directory的值加上.zip。

ignore-globs:

不从库中复制的glob模式列表。

ignore-packages:

要忽略的顶级包名或模块列表。这对于忽略不会使用的依赖项很有用。一些包可能安装distribute，setuptools或pkg_resources，但在App Engine上它们并不非常有用，因此可以将它们设置为忽略，例如。

delete-safe:

如果设置为true，则在构建时始终将lib-directory移动到parts目录内的临时目录作为备份，而不是删除它。这是为了避免如果lib-directory配置不当而意外删除。默认为true。

示例

[app_lib]
# Sets the library dependencies for the app.
recipe = appfy.recipe.gae:app_lib
lib-directory = app/distlib
use-zipimport = false

# Define the libraries.
eggs =
    tipfy

# Don't copy files that match these glob patterns.
ignore-globs =
    *.c
    *.pyc
    *.pyo
    */test
    */tests
    */testsuite
    */django
    */sqlalchemy

# Don't install these packages or modules.
ignore-packages =
    distribute
    setuptools
    easy_install
    site
    pkg_resources

选项

url:

App Engine SDK文件的URL。默认是从storage.googleapis.com下载最新版本。

destination:

提取SDK的目的地。默认为parts目录。

clear-destination:

如果设置为true，则在提取下载之前删除目标目录。默认为true。

示例

[gae_sdk]
# Dowloads and extracts the App Engine SDK.
recipe = appfy.recipe.gae:sdk
url = http://googleappengine.googlecode.com/files/google_appengine_1.3.5.zip
destination = ${buildout:parts-directory}
hash-name = false
clear-destination = true

选项

sdk-directory:

App Engine SDK目录的路径。可以是绝对路径，也可以是引用appfy.recipe.gae:sdk目的地选项的引用。默认为${buildout:parts-directory}/google_appengine。

appcfg-script:

要安装在bin目录中的appcfg脚本名称。默认为appcfg。

bulkload_client-script:

要安装在bin目录中的bulkloader脚本名称。默认为bulkload_client。

bulkloader-script:

要安装在bin目录中的bulkloader脚本名称。默认为bulkloader。

dev_appserver-script:

要安装在bin目录中的dev_appserver脚本名称。默认为dev_appserver。

remote_api_shell-script:

要安装在bin目录中的remote_api_shell脚本名称。默认为remote_api_shell。

config-file:

包含在脚本中使用的默认值的配置文件。默认为gaetools.cfg。

extra-paths:

要包含在生成的脚本sys.path中的额外路径。

initialization:

允许指定要包含在脚本中的某些Python代码。

示例

[gae_tools]
# Installs appcfg, dev_appserver and python executables in the bin directory.
recipe = appfy.recipe.gae:tools
sdk-directory = ${gae_sdk:destination}/google_appengine
# add extra code
initialization =
  import dev_appserver
  dev_appserver.fix_sys_path()
# Add these paths to sys.path in the generated scripts.
extra-paths =
    app/lib
    app/distlib

注意，此示例引用了appfy.recipe.gae:sdk示例中的gae_sdk部分。也可以使用绝对路径。

为了设置启动dev_appserver的默认值，在定义的配置文件（默认为gaetools.cfg）中创建一个dev_appserver部分。例如

[dev_appserver]
# Set default values to start the dev_appserver. All options from the
# command line are allowed. They are inserted at the beginning of the
# arguments. Values are used as they are; don't use variables here.
recipe = appfy.recipe.gae:tools
defaults =
    --datastore_path=var/data.store
    --history_path=var/history.store
    --blobstore_path=var/blob.store
    app

每个选项应单独一行设置，如上所示。调用dev_appserver时提供的选项将覆盖默认值。