buildout是什么
Buildout是一个基于Python的构建工具, 通过一个配置文件,可以从多个部分创建、组装并部署你的应用,即使应用包含了非Python的组件,Buildout也能够胜任. Buildout不但能够像setuptools一样自动更新或下载安装依赖包,而且还能够像virtualenv一样,构建一个封闭隔离的开发环境.
buildout 的中文文档非常稀少,这里有篇blog,抄一些东西过来
步骤
假设你有一个项目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列表