安装 Pyramid¶

备注

为简单起见，本安装指南强调使用Python3.7及更高版本。

在安装金字塔之前¶

安装适用于您的操作系统的Python版本3.7或更高版本，并满足安装包的要求，如以下各节所述。

Pyramid 众所周知，它可以在所有流行的类Unix系统（如Linux、MacOS和FreeBSD）以及Windows平台上运行。它也可以继续运行 PyPy （1.9 +）。

Pyramid 安装不需要编译任何C代码。然而，一些 Pyramid 依赖项可能会尝试从C代码构建二进制扩展，以提高性能。如果编译器或python头不可用，那么依赖关系将返回到使用纯python。

备注

如果您看到任何与未能编译二进制扩展相关的警告或错误，在大多数情况下，您可以安全地忽略这些错误。如果您希望使用二进制扩展名，请验证是否为您的操作系统安装了一个运行正常的编译器和python头文件。

为MACOS用户¶

python预装在MacOS上，但由于苹果的发布周期，它经常过时。除非您需要特定的早期版本，否则建议安装最新的3.x版本的python。

您可以从上的二进制文件安装最新版本的python for macos。 python.org .

或者，您可以使用 homebrew 包管理器。

# for python 3.x
brew install python3

如果您为您的Python使用安装程序，那么您可以跳到该部分安装 Pyramid 在UNIX系统上 .

如果您还没有python解释器（unix）¶

如果您的系统没有python解释器，并且您在unix上，那么您可以使用操作系统的包管理器安装python。 or 您可以很容易地从源代码在任何具有开发工具的UNIX系统上安装python。

参见

参见官方的python文档 Using Python on Unix platforms 详细信息。

如果您还没有Python解释器（Windows）¶

如果您的Windows系统没有python解释器，您需要通过从下载python 3.x系列解释器来安装它。 python.org's download section （标记为“Windows Installer”的文件）。下载后，双击可执行文件并在安装过程中选择适当的选项。为了标准化此文档，我们使用了GUI安装程序并选择了以下选项：

屏幕1：安装python 3.x.x（32位或64位）
- 选中“为所有用户安装启动器（推荐）”。
- 选中“将python 3.x添加到路径”。
- 单击“立即安装”。
屏幕2：用户帐户控制
- 单击“是”。

参见

参见官方的python文档 Using Python on Windows 详细信息。

参见

您可能还需要下载并安装 Python for Windows extensions . 仔细阅读构建列表末尾的readme.txt文件，并按照其说明进行操作。确保获得正确的32位或64位构建和Python版本。

参见

Python launcher for Windows 提供命令 py 它允许用户运行任何已安装的python版本。

警告

在Windows上安装python之后，可能需要添加python和其他程序（如pip）所在的目录。 Setuptools 和cookiecutter安装在您的环境中 Path . 这将使从命令提示符调用它们成为可能。

为此，请在计算机上搜索“环境变量”（在Windows 10上，它位于 System Properties --> Advanced ）并将该目录添加到 Path 环境变量，使用GUI编辑路径段。

示例段应该类似 C:\Users\<username>\AppData\Local\Programs\Python3x-32 ，您的用户名不是 <username> 以及您的python版本以及它是32位还是64位。另外，确保路径段以 \Scripts ，即 C:\Users\<username>\AppData\Local\Programs\Python3x-32\Scripts ，对于用户安装的python程序， %APPDATA%\Python\Python3x\Scripts .

您可能需要重新启动命令提示会话来加载环境变量。

参见

见 Configuring Python (on Windows) 详细信息。

安装包的要求¶

使用 pip 用于安装软件包和 python3 -m venv env 用于创建虚拟环境。虚拟环境是一个半隔离的Python环境，它允许安装包供特定应用程序使用，而不是在系统范围内安装。

参见

参见python packaging authority（pypa）文档 Requirements for Installing Packages 详细信息。

安装 Pyramid 在UNIX系统上¶

安装python之后，如前面所述为MACOS用户或如果您还没有python解释器（unix）和满足安装包的要求，现在可以安装金字塔。

做一个 virtual environment 工作空间：
```
export VENV=~/env
python3 -m venv $VENV
```
您可以使用环境变量 $VENV 或将其替换为虚拟环境的根目录。如果您选择前一种方法，请确保 $VENV 是绝对路径。在后一种情况下， export 可以跳过命令。
（可选）考虑使用 $VENV/bin/activate 使您的shell环境连接起来以使用虚拟环境。
使用 pip 得到 Pyramid 以及安装的直接依赖项：
```
$VENV/bin/pip install "pyramid==2.0.2"
```

备注

为什么使用 $VENV/bin/pip 而不是 source bin/activate 然后 pip 是吗？

$VENV/bin/pip 明确规定 pip 从虚拟环境中运行，而不是在系统级别上运行。

activate 对用户的shell环境进行更改，这通常很方便。但是，在长格式文档的上下文中，很容易忘记环境配置。通过保持每个代码段的显式，我们可以减少用户对错误的Python环境执行命令时的复制/粘贴错误。也， deactivate 可能无法正确还原以前的shell环境变量。避免 activate 使环境更具重现性。

虽然使用 source bin/activate 然后 pip 在调用命令时需要较少的击键来发出命令，还有其他需要考虑的事情。Michael F.Lamb（数据报）在 Virtualenv's bin/activate is Doing It Wrong .

最终，我们更喜欢保持事物的清晰和简单，所以我们使用 $VENV/bin/pip .

安装 Pyramid 在Windows系统上¶

安装python之后，如前面所述如果您还没有Python解释器（Windows）和满足安装包的要求，现在可以安装金字塔。

做一个 virtual environment 工作空间：
```
cd \
set VENV=c:\env
python -m venv %VENV%
cd %VENV%
```
您可以使用环境变量 %VENV% 或将其替换为虚拟环境的根目录。如果您选择前一种方法，请确保 %VENV% 是绝对路径。在后一种情况下， set 可以跳过命令。
（可选）考虑使用 %VENV%\Scripts\activate.bat 使您的shell环境连接起来以使用虚拟环境。
使用 pip 得到 Pyramid 以及安装的直接依赖项：
```
%VENV%\Scripts\pip install "pyramid==2.0.2"
```

备注

见上述注释 Why use $VENV/bin/pip instead of source bin/activate, then pip .

安装了什么¶

安装时 Pyramid 安装了各种库，如WebOB、PasteDeploy和其他库。

此外，如创建一个 Pyramid 项目我们的 cookiecutter 将被使用，这使得启动新的 Pyramid 项目。