要求

让我们来设置我们的教程环境。大多数设置工作都是在标准的Python开发实践中进行的（安装Python并创建一个独立的虚拟环境）。

备注

Pyramid鼓励使用打包工具、虚拟环境、日志记录等标准的Python开发实践。在整个Python社区中有许多变体、实现和观点。为了保持一致性，易于文档维护，并尽量减少混淆，Pyramid 文档 采用了与 Python Packaging Authority .

这个 快速教程 基于：

  • Python 3.8 。金字塔完全支持Python3.7+。本教程使用 Python 3.8 。

  • venv . 我们相信虚拟环境。对于本教程，我们使用Python3的内置解决方案 venv .

  • pip . 我们使用 pip 用于包管理。

  • 工作区、项目和包。 我们的主目录将包含 教程工作区 我们的python虚拟环境和 Python项目 （包含包装信息和 Python软件包 工作代码。）

  • UNIX命令 . 本教程中的命令使用UNIX语法和路径。Windows用户应该相应地调整命令。

备注

2011年10月，Pyramid是第一个完全支持Python3的Web框架。

备注

Windows命令使用普通的旧msdos shell。有关PowerShell命令语法，请参阅其文档。

步骤

  1. 安装python 3

  2. 创建项目目录结构

  3. 设置环境变量

  4. 创建虚拟环境

  5. 安装Pyramid

安装python 3

请参阅下面描述的操作系统的详细建议 安装 Pyramid .

创建项目目录结构

我们将得到一个目录结构 workspace -> project -> package ，工作区的名称 quick_tutorial . 下面的树图显示了它的结构，以及 virtual environment 将在我们继续学习本教程时驻留：

~
└── projects
    └── quick_tutorial
        ├── env
        └── step_one
            ├── intro
            │   ├── __init__.py
            │   └── app.py
            └── setup.py

对于MacOS和Linux，执行此操作的命令如下：

# macOS and Linux
cd ~
mkdir -p projects/quick_tutorial
cd projects/quick_tutorial

对于Windows：

# Windows
cd \
mkdir projects\quick_tutorial
cd projects\quick_tutorial

在上图中，用户主目录由 ~ . 在主目录中，所有项目都位于 projects 目录。这是一个通用的约定，不特定于许多开发人员使用的Pyramid。Windows用户会很好地使用 c:\ 作为 projects 以避免路径名中出现空格。

下一内 projects 您的工作区目录，这里命名为 quick_tutorial . 工作区是集成开发环境（IDE）常用的术语，如pycharm和pydev，其中存储虚拟环境、特定项目文件和存储库。

设置环境变量

本教程将经常参考 virtual environment . 我们设置了一个环境变量，以便以后保存键入的内容。

# macOS and Linux
export VENV=~/projects/quick_tutorial/env

# Windows
set VENV=c:\projects\quick_tutorial\env

创建虚拟环境

venv 是创建独立的python 3环境的工具，每个环境在其站点目录中都有自己的python二进制文件和独立的一组已安装的python包。让我们使用刚刚在环境变量中指定的位置创建一个。

# macOS and Linux
python3 -m venv $VENV

# Windows
python -m venv %VENV%

参见

也见 venv module .

在虚拟环境中更新打包工具

更新到最新版本的打包工具总是一个好主意，因为安装的Python只捆绑发布时可用的版本。

# macOS and Linux
$VENV/bin/pip install --upgrade pip setuptools

# Windows
%VENV%\Scripts\pip install --upgrade pip setuptools

参见

也见 Why use $VENV/bin/pip instead of source bin/activate, then pip .

安装Pyramid

我们的Python标准先决条件已经过时了。Pyramid部分很容易。我们还将安装一个wsgi服务器，服务员。

# macOS and Linux
$VENV/bin/pip install "pyramid==2.0.2" waitress

# Windows
%VENV%\Scripts\pip install "pyramid==2.0.2" waitress

我们的python虚拟环境现在有了Pyramid软件以及 waitress 包。