collective.recipe.pip 0.3.4

collective.recipe.pip

构建配方，可以解析pip配置文件（通常命名为requirements.txt），允许独立使用pip和buildout进行同一项目的构建。

概述

该配方允许将pip配置文件（通常是requirements.txt）解析成用于构建out其他部分的egg列表。

该配方将解析的egg列表镜像到其部分中，例如${pip:eggs}将给出解析的egg列表。

来自url（例如来自github）的egg列表也导出到urls参数中：${pip:urls}将给出解析的egg url列表。

目前该配方只有一个选项configs - 要解析的配置文件列表。

配置文件在解析Recipe实例的初始化期间解析，即读取buildout.cfg之后，但在安装或更新任何配方之前。

示例用法：使用环境变量

让我们创建测试配置文件

>>> write('requirements.txt',
... """
... some.egg
... -e http://some.package.git.url#egg=develop.egg
... --use-wheel
... http://sourceforge.net/projects/pychecker/files/latest/download?source=files#egg=pychecker==0.8.19
... fabric>=0.9b1
... # some comment
... xlrd # reading excel worksheets
... html5lib==0.95
... """)

>>> write('requirements-included.txt',
... """
... some.included.egg
... """)

>>> write('requirements-included2.txt',
... """
... some.included.egg2
... """)

>>> mkdir('file.package')
>>> write('file.package/setup.py',
... """
... from setuptools import setup
... setup(name='file.package')
... """)

>>> write('requirements2.txt',
... """
... -r requirements-included.txt
... --requirement requirements-included2.txt
... some2.egg
... django>=1.3,<1.4
... django-extensions #django extension requirements (not mandatory, but useful on dev)
... -e http://some2.package.git.url#egg=develop2.egg
... -e file.package
... --extra-index-url=http://some.index.url
... -f http://git.fabfile.org
... """)

我们首先创建一个使用该配方的构建

>>> write('buildout.cfg',
... r"""
... [buildout]
... parts = pip print
...
... [some-section]
... eggs = ${pip:eggs}
...
... [pip]
... recipe = collective.recipe.pip
... configs = requirements.txt
...           requirements2.txt
... versions = versions
...
... [versions]
...
... [print]
... recipe = mr.scripty
... install =
...     ... print(self.buildout['some-section']['eggs'])
...     ... print('\n[versions]')
...     ... print('\n'.join(i + ' = ' + k for i, k in sorted(self.buildout['versions'].items())))
...     ... print('\n[urls]')
...     ... print(self.buildout['pip']['urls'])
...     ... print('# done')
...     ... return []
... """)

使用 mr.scripty 脚本可以打印出 ${some-section:some-option} 选项的值。

运行 buildout 会得到以下内容

>>> import sys
>>> sys.stdout.write('start\n' + system(buildout))
start...
Installing pip.
Installing print.
develop.egg
develop2.egg
django-extensions
django>=1.3,<1.4
fabric>=0.9b1
html5lib==0.95
pychecker==0.8.19
some.egg
some.included.egg
some.included.egg2
some2.egg
xlrd
[versions]
django = >=1.3,<1.4
fabric = >=0.9b1
html5lib = 0.95
pychecker = 0.8.19
zc.buildout = ...
zc.recipe.egg = ...
[urls]
/sample-buildout/file.package
git+http://some.package.git.url#egg=develop.egg
git+http://some2.package.git.url#egg=develop2.egg
http://sourceforge.net/projects/pychecker/files/latest/download?source=files#egg=pychecker==0.8.19
...

贡献者

• Anatoly Bubenkov <bubenkoff@gmail.com>, 作者

• Abdul Kader Maliyakkal <ridha@github.com>, 贡献者

• Christophe Combelles <ccomb@github.com>, 贡献者

变更日志