安装buildout

首先建立我们的开发目录，假设叫做buildout-demo，建立buildout配置文件buildout.cfg：

$ mkdir buildout-demo
$ cd buildout-demo
$ touch buildout.cfg

然后下载buildout的引导脚本 bootstrap.py 。运行bootstrap.py来生成buildout相关的文件和目录：

$ python bootstrap.py
Downloading http://pypi.python.org/packages/2.4/s/setuptools/setuptools-0.6c11-py2.4.egg
Creating directory '/home/amoblin/Projects/gitar/buildout-demo/bin'.
Creating directory '/home/amoblin/Projects/gitar/buildout-demo/parts'.
Creating directory '/home/amoblin/Projects/gitar/buildout-demo/eggs'.
Creating directory '/home/amoblin/Projects/gitar/buildout-demo/develop-eggs'.
Getting distribution for 'setuptools'.
Got setuptools 0.6c12dev-r85381.
Generated script '/home/amoblin/Projects/gitar/buildout-demo/bin/buildout'.

从上面可以看出，引导脚本下载了setuptools egg包，创建了目录bin，parts，eggs，develop-eggs，在bin目录下生成了buildout脚本。没错，buildout是基于setuptools开发的。 各文件夹的作用如下:

• bin目录用来存放生成的脚本文件
• parts目录存放生成的数据，大多用不上。
• develop-eggs 存放指向开发目录的链接文件。和buildout.cfg中develop选项相关。
• eggs 是存放从网络上下载下来的egg包。这些包一般在buildout.cfg中的egg选项里定义。

如果运行时出现类似下面的错误：

$ python bootstrap.py
Downloading http://pypi.python.org/packages/2.6/s/setuptools/setuptools-0.6c11-py2.6.egg
Traceback (most recent call last):
  File "bootstrap.py", line 256, in <module>
    ws.require(requirement)
  File "/tmp/tmp2cI1LD/setuptools-0.6c11-py2.6.egg/pkg_resources.py", line 666, in require
  File "/tmp/tmp2cI1LD/setuptools-0.6c11-py2.6.egg/pkg_resources.py", line 565, in resolve
pkg_resources.DistributionNotFound: zc.buildout==1.5.2

则可能是python的版本不正确。使用python 2.4版本即可。

使用buildout生成脚本

将 python egg学习笔记 中的egg例子拿过来，我们通过它来生成一个脚本。

$ mv ../egg-demo .
$ tree egg-demo
egg-demo/
|-- setup.py
`-- src
    `-- demo
        `-- __init__.py

2 directories, 2 files

首先要修改setup.py文件，在setup函数中增加一行：

entry_points = {'console_scripts':
    ['test = demo:test']},

然后编辑buildout配置文件buildout.cfg：

$cat buildout.cfg
[buildout]
develop = egg-demo
parts = test

[test]
recipe = zc.recipe.egg
eggs = demo
scripts = test

buildout.cfg配置文件使用INI格式。下面具体讲一下这个文件的内容：

[buildout]

定义buildout段。这是配置文件中唯一一个必选段。

develop = egg-demo

这告诉buildout我们要为我们的recipe安装一个开发中的egg。可以是多个路径，绝对的或者相对的。相对路径是相对buildout的主目录下的，这里就是buildout-demo目录。也可以是文件名，但这是只能是setup脚本。目录的话必须是包含setup.py文件的目录。这里我们使用egg-demo作为我们的开发egg包。

parts = test

每个buildout都要有一个parts列表，也可以为空。parts用来指定构建什么。如果parts中指定的段中还有parts的话，会递归构建。

[test]

开始新的一段。

recipe = zc.recipe.egg

每一段都要指定一个recipe。recipe包含python的代码，用来安装这一段。

eggs = demo

这里是egg-demo里我们的egg的名称。

scripts = test

指定要生成的脚本名称。和setup.py中entry_points参数的值 test对应。 保存buildout.cfg文件，执行buildout来构建：

$bin/buildout
Develop: '/home/amoblin/Projects/gitar/buildout-demo/egg-demo'
Uninstalling test.
Installing test.
Generated script '/home/amoblin/Projects/gitar/buildout-demo/bin/test'.

执行生成的test文件：

$bin/test
Hello, I'm amoblin.

和上一篇的输出结果完全一样。

使用自定义python解释器

编辑buildout配置文件buildout.cfg为如下内容：

$cat buildout.cfg
[buildout]
develop = .
parts = mypy

[mypy]
recipe = zc.recipe.egg
eggs = zope.component
interpreter = py

保存以后，运行buildout：

$bin/buildout
Installing mypy.
Getting distribution for 'zope.component'.
Got zope.component 3.10.0.
Getting distribution for 'zope.event'.
Got zope.event 3.5.0-1.
Getting distribution for 'zope.interface'.
Got zope.interface 3.6.1.
Generated interpreter '/home/amoblin/Projects/gitar/buildout-demo/bin/py'.

你会发现在bin目录下多了一个脚本py。执行将产生一个python解释器：

$bin/py

>>>print "hello, world"
hello, world

通过上面buildout.cfg的配置，buildout完成了相关egg包的下载，生成了我们想要的脚本文件。现在我们可以使用这个局部python环境啦，是不是可以取代virtualenv了呢？