Introduction and Creating an Application

Following along with the examples

The examples in this guide are based on (A) Pyramid 1.3's default SQLAlchemy application and (B) the Akhet demo. (Akhet is an add-on package containing some Pylons-like support features for Pyramid.) Here are the basic steps to install and run these applications on Linux Ubuntu 11.10, but you should read Creating a Pyramid Project 在 Pyramid manual before doing so:

# Prepare virtual Python environment.

$ cd ~/workspace
$ virtualenv myvenv
$ source myvenv/bin/activate
(myvenv)$ pip install 'Pyramid>=1.3'

# Create a Pyramid "alchemy" application and run it.

(myvenv)$ pcreate -s alchemy PyramidApp
(myvenv)$ cd PyramidApp
(myvenv)$ pip install -e .
(myvenv)$ initialize_PyramidApp_db development.ini
(myvenv)$ pserve development.ini
Starting server in PID 3871.
serving on http://0.0.0.0:6543

# Press ctrl-C to quit server

# Check out the Akhet demo and run it.

(myvenv)$ git clone git://github.com/mikeorr/akhet_demo
(myvenv)$ cd akhet_demo
(myvenv)$ pip install -e .
(myvenv)$ pserve development.ini
Starting server in PID 3871.
serving on http://0.0.0.0:6543

# Check out the Pyramid source and Akhet source to study.

(myvenv)$ git clone git://github.com/pylons/pyramid
(myvenv)$ git clone git://github.com/pylons/akhet

(myvenv)$ ls -F
akhet/
akhet_demo/
PyramidApp/
pyramid/
myvenv/

*要查找的内容：*页面右上角的“dt”图标是调试工具栏，而 Pylons 没有。“填充 Pyramid ”脚本（第13行）创建数据库。如果你跳过这一步，你会在主页上得到一个例外；你可以“意外地”这样做来查看 Pyramid 的交互式回溯。

The p* Commands

Pylons 使用第三方实用程序 paster 创建和运行应用程序。 Pyramid 将这些子命令替换为一系列以“p”开头的顶级命令：

塔柱	Pyramid	描述	告诫
粘贴创建	帕盖特	创建一个应用程序	Option -s instead of -t
贴纸服务	帕塞尔	Run app based on INI file	-
贴片壳	壳牌	Load app in Python shell	Fewer vars initialized
paster setup-app	populate_App	Initialize database	"App" is application name
贴纸路径	普劳特斯	列出路线	-
-	普韦恩斯	列出吐温	-
-	pVIEW	列表视图	-

在许多情况下，代码是相同的，只是复制到Pyramid中并使python 3兼容。Paste还没有移植到Python3，Pyramid开发人员认为它包含了太多的遗留代码，使移植变得值得。所以他们只是把他们需要的零件装上了门。但是请注意，PasteDeploy is 移植到python 3，Pyramid使用它，我们将在下一章中看到。同样，之前由粘贴产生的其他几个包（如webob）已经移植到了python 3，pyramid仍然使用它们。（Pyramid的开发者们把它们移植了进来。）

脚手架

Pylons 有一个贴纸模板，询问您要创建哪种应用程序。 Pyramid 不会问问题，而是提供多种脚手架供选择。 Pyramid 1.3包括以下脚手架：

Routing mechanism	数据库	Pyramid scaffold
URL调度	SQLAlchemy	炼金术
URL调度	-	起动装置
遍历	ZODB	ZODB

前两个脚手架离 Pylons 最近，因为它们使用URL调度，这类似于路由。它们之间唯一的区别是是否为您配置了一个SQLAlchemy数据库。第三个支架使用 Pyramid 的其他路由机制，遍历。我们在本指南中不介绍遍历，但它在允许用户在任意深度创建URL的应用程序中很有用。URL调度更适合具有固定深度的URL层次结构的应用程序。

要了解其他类型的Pyramid应用程序是可能的，请查看kotti和ptah分布。Kotti是一个内容管理系统，它是使用SQLAlchemy进行遍历的一个例子。

Directory Layout

默认的“炼金术”应用程序在创建和安装后包含以下文件：

PyramidApp
├── CHANGES.txt
├── MANIFEST.in
├── README.txt
├── development.ini
├── production.ini
├── setup.cfg
├── setup.py
├── pyramidapp
│   ├── __init__.py
│   ├── models.py
│   ├── scripts
│   │   ├── __init__.py
│   │   └── populate.py
│   ├── static
│   │   ├── favicon.ico
│   │   ├── pylons.css
│   │   ├── pyramid.png
│   ├── templates
│   │   └── mytemplate.pt
│   ├── tests.py
│   └── views.py
└── PyramidApp.egg-info
    ├── PKG-INFO
    ├── SOURCES.txt
    ├── dependency_links.txt
    ├── entry_points.txt
    ├── not-zip-safe
    ├── requires.txt
    └── top_level.txt

（我们省略了一些静态文件。）如您所见，目录结构类似于 Pylons ，但不完全相同。