用Buildout来构建Python项目,buildout构建python,什么是Buildout(


什么是Buildout

(Remixed by Matt Hamilton, original from http://xkcd.com/303)

Buildout是一个基于Python的构建工具, 通过一个配置文件,可以从多个部分创建、组装并部署你的应用,即使应用包含了非Python的组件,Buildout也能够胜任. Buildout不但能够像setuptools一样自动更新或下载安装依赖包,而且还能够像virtualenv一样,构建一个封闭隔离的开发环境.

初始化Buildout

首先我们新建一个目录来共享Buildout配置和文件:

~/Projects$ mkdir buildout~/Projects$ cd buildout

下载一个2.0的bootstrap.py脚本:

~/Projects/buildout$ wget http://downloads.buildout.org/2/bootstrap.py

然后创建一个Buildout的配置文件:

~/Projects/buildout$ touch buildout.cfg

运行bootstrap.py来生成Buildout相关的文件和目录:

~/Projects/buildout$ python bootstrap.pyCreating directory '/Users/Eric/Projects/buildout/bin'.Creating directory '/Users/Eric/Projects/buildout/parts'.Creating directory '/Users/Eric/Projects/buildout/eggs'.Creating directory '/Users/Eric/Projects/buildout/develop-eggs'.Generated script '/Users/Eric/Projects/buildout/bin/buildout'.

从上面可以看出,创建了目录bin,parts,eggs,develop-eggs,在bin目录下生成了buildout脚本:

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

把Python和Pyramid集成进来

配置Buildout

~/Projects/buildout$ vim buildout.cfg[buildout]# 每个buildout都要有一个parts列表,也可以为空。# parts用来指定构建什么。如果parts中指定的段中还有parts的话,会递归构建。parts = tools[tools]# 每一段都要指定一个recipe, recipe包含python的代码,用来安装这一段,# zc.recipe.egg就是把一些把下面的egg安装到eggs目录中recipe = zc.recipe.egg# 定义python解释器interpreter = python# 需要安装的eggeggs =    pyramid

执行buildout命令来构建一下, 这将会把Pyramid集成进来:

~/Projects/buildout$ bin/buildout

用buildout来构建项目

现在可以创建Pyramid应用了:

~/Projects/buildout$ bin/pcreate -t starter myproject

配置一下Buildout:

~/Projects/buildout$ vim buildout.cfg[buildout]parts =    tools    appsdevelop = myproject[tools]recipe = zc.recipe.egginterpreter = pythoneggs =    pyramid[apps]recipe = zc.recipe.eggeggs = myproject

再次运行一下buildout:

~/Projects/buildout$ bin/buildout

现在可以再buildout的环境中启动myproject了:

~/Projects/buildout$ bin/pserve myproject/development.iniStarting server in PID 40619.serving on http://0.0.0.0:6543

最佳实践/Tips

固化egg的版本

把所有的版本信息写到[versions]里面:

extends = versions.cfgversions = versionsshow-picked-versions = true

配置中的“show-picked-versions = true “会在运行buildout的时候把所有的版本打印出来, 把它写到"versions.cfg"中就可以固化了:

[versions]Chameleon = 2.11Mako = 0.7.3MarkupSafe = 0.15PasteDeploy = 1.5.0WebOb = 1.2.3distribute = 0.6.35repoze.lru = 0.6translationstring = 1.1venusian = 1.0a7zc.buildout = 2.0.1zc.recipe.egg = 2.0.0a3zope.deprecation = 4.0.2zope.interface = 4.0.5# Required by:# pyramid-debugtoolbar==1.0.4Pygments = 1.6# Required by:# myproject==0.0pyramid = 1.4# Required by:# myproject==0.0pyramid-debugtoolbar = 1.0.4# Required by:# myproject==0.0waitress = 0.8.2

2. 使用mr.developer插件来组织大型的项目, 让开发更方便

[buildout]...extensions = mr.developer…

3. 开发环境 VS 生产环境

我们可以创建多个配置文件, 比如把buildout.cfg作为生产环境的配置, 把develop的配置从buildout.cfg删除, 创建一个development.cfg作为开发环境的配置:

[buildout]extends = buildout.cfgdevelop = myproject

评论关闭