安装 Pyramid

注解

为了简单起见,本安装指南强调使用python 3.4及更高版本。

在安装金字塔之前

为您的操作系统安装python 3.4或更高版本,并满足 安装包的要求 ,如以下章节所述。

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) 和满足 安装包的要求 ,现在可以安装金字塔。

  1. 做一个 virtual environment 工作空间:

    export VENV=~/env
    python3 -m venv $VENV
    

    您可以使用环境变量 $VENV 或将其替换为虚拟环境的根目录。如果您选择前一种方法,请确保 $VENV 是绝对路径。在后一种情况下, export 可以跳过命令。

  2. (可选)考虑使用 $VENV/bin/activate 使您的shell环境连接起来以使用虚拟环境。

  3. 使用 pip 得到 Pyramid 以及安装的直接依赖项:

    $VENV/bin/pip install "pyramid==1.10.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) 和满足 安装包的要求 ,现在可以安装金字塔。

  1. 做一个 virtual environment 工作空间:

    cd \
    set VENV=c:\env
    python -m venv %VENV%
    cd %VENV%
    

    您可以使用环境变量 %VENV% 或将其替换为虚拟环境的根目录。如果您选择前一种方法,请确保 %VENV% 是绝对路径。在后一种情况下, set 可以跳过命令。

  2. (可选)考虑使用 %VENV%\Scripts\activate.bat 使您的shell环境连接起来以使用虚拟环境。

  3. 使用 pip 得到 Pyramid 以及安装的直接依赖项:

    %VENV%\Scripts\pip install "pyramid==1.10.2"
    

安装了什么

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

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