教学法

本教程使用约定来保持介绍的重点和简洁。“另见”注释中提到了详细信息、参考资料和更深入的讨论。

参见

这是“另见”注释的示例。

目录树

本“入门”教程分为独立的步骤，从最小的“单文件wsgi应用程序”示例开始。每个步骤都通过工作代码引入一个主题和一组非常小的概念。每个步骤都对应于工作区中的一个目录，其中每个步骤的目录都是一个python包。本教程中使用的源代码位于 Pyramid repository in the directory "docs/quick_tutorial" . 你可以 git clone 存储库、下载或复制粘贴源代码。如果这样做，请确保使用与此文档相同的分支。

在开发教程时，目录树将类似于下面的结构：

quick_tutorial
├── env
└── request_response
    ├── tutorial
    │   ├── __init__.py
    │   ├── tests.py
    │   └── views.py
    ├── development.ini
    └── setup.py

我们的每个目录 quick_tutorial 工作区（例如， request_response 是一个 * Python 计划* （除了 hello_world 步骤）。这个 tutorial 目录是 * Python 包* .

对于大多数步骤，您都会将早期步骤的目录复制到新目录，将工作目录更改为新目录，然后安装项目：

cd ..; cp -r package ini; cd ini
$VENV/bin/pip install -e .

对于几个步骤，您将不会复制早期步骤的目录，但仍需要使用安装项目 $VENV/bin/pip install -e . .

最后，对于几个步骤，您可以在 setup.py file, and then install both the dependency and the project with either $VENV/bin/pip install -e . 或 $VENV/bin/pip install -e ".[dev]" .