用buildout来构建python项目

buildout是什么

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

buildout 的中文文档很是稀少，这里有篇blog,抄一些东西过来

demo

步骤

假设你有一个项目newproject，历来用过buildout，安装什么的就不说了

cd newproject
buildout init
wget -O bootstrap.py https://bootstrap.pypa.io/bootstrap-buildout.py
python bootstrap.py

此时你能够看到生成了一些目录:eggs, develop-eggs,bin,parts等，先无论

vim buildout.cfg

将下面的东西加到 [buildout] 段, 能够新建一个versions.cfg来作之前pip时requirements.txt的做用

show-picked-versions=true
extends = versions.cfg
update-versions-file = versions.cfg
versions = versions

例如项目依赖为ipython，vim versions.cfg

[versions]
ipython = 5.1.0

vim buildout.cfg，添加一个develop = 的玩意儿，假设开发的东西是个包，那么目录为.，而且须要写一个setup.py,不然执行bin/buildout会报错

[buildout]
develop = .

随便先写一个简单的setup.py, 其中package_dir={'': 'src'}必写，src为你项目的代码根目录,固然若是有依赖包的话须要些install_requires

# -*- coding: utf-8 -*-
from setuptools import find_packages, setup

setup(
    name='buildout_demo',
    version='0.0.1',
    license='MIT',
    author='',
    author_email='',
    description='buildout demo',
    url='',
    packages=find_packages(exclude=['tests']),
    package_data={'buildout_demo': ['README.md']},
    package_dir={'': 'src'},
)

vim buildout.cfg, 注意这里面必定要有一个part = 的东西

而后执行 bin/buildout, 你就会看到buildout会自动下载一些包（例如这里的ipython）丢到eggs目录下

添加part

[buildout]
parts = tools

[tools]
recipe = zc.recipe.egg
interpreter = ipython
eggs = ipython

[ls_root]
recipe = plone.recipe.command
command = ls -al /
update-command = ${:command}

其中，每一个part都必须有recipe这个玩意儿,而recipe则能够认为是buildout一些工做流的命令，例如 zc.recipe.egg是把包装到egg目录， plone.recipe.command 是在buildout时能够执行的某些命令， 能够在 pypi 搜索 buildout recipe列表