substrate 0.7.2

资源

• Documentation
• PyPI Package
• Source Code Repository

安装

要安装基板，请运行：

$ easy_install substrate

要将基板安装更新到最新版本：

$ easy_install --upgrade substrate

要手动安装或更新，download the PyPI package， （或者要保持出血边缘，克隆substrate repository）并运行：

$ python setup.py install

创建新应用程序

要创建新应用程序，请运行：

$ substrate new your-app-id

这将创建一个新目录your-app-id，并解压基底 它的应用程序库。app.yaml中的应用程序名将是 设置为your-app-id。

或者，如果你觉得安装一个脚本来完成这项工作很乏味，那么 可以克隆substrate repository并将app目录复制到 创建应用程序。

升级现有的应用程序

如果你有一个现有的应用程序，你可以把它升级到最新的 通过更新基底包（请参见Installation）并运行：

$ substrate update ~/development/your-app-id

其中~/development/your-app-id是应用程序目录 （包含app.yaml文件的文件）进行升级。 （例如，可以使用.在当前目录中运行此命令）

此命令不会触及应用程序的任何文件。只有 local/substrate和lib/substrate目录中的“基片文件” ^应用程序目录中的{tt10}$和env_setup.py将是 覆盖。可以将新文件添加到local/usr和lib/usr，但不能 编辑现有的“基板文件”或您的更改将丢失时升级。

管理控制台

manage.py是应用程序的管理控制台。它可以调用几个命令。

$ ./manage.py shell

对本地应用程序运行shell（如果可用，则使用iPython）。

$ ./manage.py rshell

在google应用程序上对应用程序运行远程shell 引擎。指定不同于 app.yaml，使用-A。如果远程API终结点不在 默认位置，可以将路径作为参数传递。

$ ./manage.py test

运行应用程序的测试。任何附加参数都将传递给unitetest2 discover命令：

$ ./manage.py test --help

Usage: unit2 discover [options]

Options:
  -h, --help            show this help message and exit
  -v, --verbose         Verbose output
  -f, --failfast        Stop on first fail or error
  -c, --catch           Catch ctrl-C and display results so far
  -b, --buffer          Buffer stdout and stderr during tests
  -s START, --start-directory=START
                        Directory to start discovery ('.' default)
  -p PATTERN, --pattern=PATTERN
                        Pattern to match tests ('test*.py' default)
  -t TOP, --top-level-directory=TOP
                        Top level directory of project (defaults to start
                        directory)

添加您自己的命令

manage.py将在 local/usr/manage/substrate_manage_usr/commands目录为 命令。

向应用程序添加新库

基板将其库存储在lib/substrate和 local/substrate/lib（对于不应部署到的库 谷歌应用引擎）。不要将新库作为 它们在升级时被删除并重新复制。

用户库可以放在lib/usr和 local/usr/lib。这些路径由添加到sys.path中 env_setup.setup

测试

如上所述，manage.py有一个test命令。这一切都结束了 在应用程序的tests目录中使用 unittest2。基底应用程序中包含一个简单的“hello “World”测试，您可以运行该测试来验证您的安装。它是 位于tests/handlers/test_main.py。

基板包括位于agar.test中的测试助手 包裹。agar.test使用google.appengine.ext.testbed设置 每次测试运行前，google app engine环境都会更新。主要是 与旧的gaetestbed项目兼容的api，以及新的添加。

许可证

基质主要是其他物质的包装R库，它们有 拥有许可证。基板中的原始代码在MIT license下面。