zc.recipe.cmmi 4.0

通过configure/make/make install安装下载的配方

configure-make-make-install配方自动将基于configure的源代码分布安装到buildouts中。

发布历史

详细文档

我们有一个包含演示foo tar包的存档，并通过http发布，以便查看离线效果

>>> ls(distros)
-  bar.tgz
-  baz.tgz
-  foo.tgz

>>> distros_url = start_server(distros)

让我们更新一个示例构建，以便安装它

>>> write('buildout.cfg',
... """
... [buildout]
... parts = foo
...
... [foo]
... recipe = zc.recipe.cmmi
... url = %sfoo.tgz
... """ % distros_url)

我们使用url选项来指定存档的位置。

如果我们运行构建，存档中的配置脚本将被执行。它创建一个make文件，该文件也将被执行

>>> print(system('bin/buildout').strip())
Installing foo.
foo: Downloading https://#/foo.tgz
foo: Unpacking and configuring
configuring foo --prefix=/sample-buildout/parts/foo
echo building foo
building foo
echo installing foo
installing foo

配方还创建了部分目录

>>> import os.path
>>> os.path.isdir(join(sample_buildout, "parts", "foo"))
True

如果我们再次运行构建，将调用更新方法，但它不会做任何事情

>>> print(system('bin/buildout').strip())
Updating foo.

您可以提供额外的配置选项

>>> write('buildout.cfg',
... """
... [buildout]
... parts = foo
...
... [foo]
... recipe = zc.recipe.cmmi
... url = %sfoo.tgz
... extra_options = -a -b c
... """ % distros_url)

>>> print(system('bin/buildout').strip())
Uninstalling foo.
Installing foo.
foo: Downloading https://#/foo.tgz
foo: Unpacking and configuring
configuring foo --prefix=/sample-buildout/parts/foo -a -b c
echo building foo
building foo
echo installing foo
installing foo

配方将位置选项设置为部分安装的位置，该选项可以被其他配方读取

>>> cat('.installed.cfg')
[buildout]
installed_develop_eggs =
parts = foo
<BLANKLINE>
[foo]
    ...
location = /sample_buildout/parts/foo
    ...

在运行配置或make时，可能需要设置一些环境变量。这可以通过添加环境语句来完成

>>> write('buildout.cfg',
... """
... [buildout]
... parts = foo
...
... [foo]
... recipe = zc.recipe.cmmi
... url = %sfoo.tgz
... environment =
...   CFLAGS=-I/usr/lib/postgresql7.4/include
... """ % distros_url)

>>> print(system('bin/buildout').strip())
Uninstalling foo.
Installing foo.
foo: Downloading https://#/foo.tgz
foo: Unpacking and configuring
foo: Updating environment: CFLAGS=-I/usr/lib/postgresql7.4/include
configuring foo --prefix=/sample_buildout/parts/foo
echo building foo
building foo
echo installing foo
installing foo

在构建软件包之前，有时需要修补源代码。您可以指定要应用的补丁名称和（可选）补丁选项

首先，让我们编写一个补丁文件

>>> import sys
>>> mkdir('patches')
>>> write('patches/config.patch',
... """--- configure
... +++ /dev/null
... @@ -1,13 +1,13 @@
...  #!%s
...  import sys
... -print("configuring foo " + ' '.join(sys.argv[1:]))
... +print("configuring foo patched " + ' '.join(sys.argv[1:]))
...
...  Makefile_template = '''
...  all:
... -\techo building foo
... +\techo building foo patched
...
...  install:
... -\techo installing foo
... +\techo installing foo patched
...  '''
...
...  with open('Makefile', 'w') as f:
...      _ = f.write(Makefile_template)
...
... """ % sys.executable)

现在，让我们创建一个buildout.cfg文件。注意：如果没有传递补丁选项，默认会追加-p0。

>>> write('buildout.cfg',
... """
... [buildout]
... parts = foo
...
... [foo]
... recipe = zc.recipe.cmmi
... url = %sfoo.tgz
... patch = ${buildout:directory}/patches/config.patch
... patch_options = -p0
... """ % distros_url)

>>> print(system('bin/buildout').strip())
Uninstalling foo.
Installing foo.
foo: Downloading https://#/foo.tgz
foo: Unpacking and configuring
patching file configure
...
configuring foo patched --prefix=/sample_buildout/parts/foo
echo building foo patched
building foo patched
echo installing foo patched
installing foo patched

可以自动生成配置文件

>>> write('buildout.cfg',
... """
... [buildout]
... parts = foo
...
... [foo]
... recipe = zc.recipe.cmmi
... url = %s/bar.tgz
... autogen = autogen.sh
... """ % distros_url)

>>> print(system('bin/buildout').strip())
Uninstalling foo.
Installing foo.
foo: Downloading https://#//bar.tgz
foo: Unpacking and configuring
foo: auto generating configure files
configuring foo --prefix=/sample_buildout/parts/foo
echo building foo
building foo
echo installing foo
installing foo

还可以支持除“./configure”之外的其他配置命令

>>> write('buildout.cfg',
... """
... [buildout]
... parts = foo
...
... [foo]
... recipe = zc.recipe.cmmi
... url = %s/baz.tgz
... source-directory-contains = configure.py
... configure-command = ./configure.py
... configure-options =
...     --bindir=bin
... """ % distros_url)

>>> print(system('bin/buildout').strip())
Uninstalling foo.
Installing foo.
foo: Downloading https://#//baz.tgz
foo: Unpacking and configuring
configuring foo --bindir=bin
echo building foo
building foo
echo installing foo
installing foo

在下载源存档或补丁时，我们可以通过提供必须匹配的MD5校验和来选择性地确保其真实性。如果匹配，buildout的输出将不会打扰我们

>>> from hashlib import md5
>>> with open(join(distros, 'foo.tgz'), 'rb') as f:
...     foo_md5sum = md5(f.read()).hexdigest()

>>> write('buildout.cfg',
... """
... [buildout]
... parts = foo
...
... [foo]
... recipe = zc.recipe.cmmi
... url = %sfoo.tgz
... md5sum = %s
... """ % (distros_url, foo_md5sum))

>>> print(system('bin/buildout').strip())
Uninstalling foo.
Installing foo.
foo: Downloading https://#/foo.tgz
foo: Unpacking and configuring
configuring foo --prefix=/sample_buildout/parts/foo
echo building foo
building foo
echo installing foo
installing foo

但如果存档不匹配校验和，配方将拒绝安装

>>> write('buildout.cfg',
... """
... [buildout]
... parts = foo
...
... [foo]
... recipe = zc.recipe.cmmi
... url = %sbar.tgz
... md5sum = %s
... patch = ${buildout:directory}/patches/config.patch
... """ % (distros_url, foo_md5sum))

>>> print(system('bin/buildout').strip())
Uninstalling foo.
Installing foo.
foo: Downloading https://#:20617/bar.tgz
While:
  Installing foo.
Error: MD5 checksum mismatch downloading 'https://#/bar.tgz'

类似地，补丁的校验和不匹配将导致构建运行中断

>>> write('buildout.cfg',
... """
... [buildout]
... parts = foo
...
... [foo]
... recipe = zc.recipe.cmmi
... url = %sfoo.tgz
... patch = ${buildout:directory}/patches/config.patch
... patch-md5sum = %s
... """ % (distros_url, foo_md5sum))

>>> print(system('bin/buildout').strip())
Installing foo.
foo: Downloading https://#:21669/foo.tgz
foo: Unpacking and configuring
While:
  Installing foo.
Error: MD5 checksum mismatch for local resource at '/.../sample-buildout/patches/config.patch'.

>>> write('buildout.cfg',
... """
... [buildout]
... parts = foo
...
... [foo]
... recipe = zc.recipe.cmmi
... url = %sfoo.tgz
... patch = ${buildout:directory}/patches/config.patch
... """ % (distros_url))

如果构建失败，将记录tarball解压缩的临时目录到stdout，并保持不变以供调试目的

>>> write('patches/config.patch', "dgdgdfgdfg")

>>> res =  system('bin/buildout')
>>> print(res)
Installing foo.
foo: Downloading https://#/foo.tgz
foo: Unpacking and configuring
patch unexpectedly ends in middle of line
foo: cmmi failed: /.../...buildout-foo
patch: **** Only garbage was found in the patch input.
While:
  Installing foo.
<BLANKLINE>
An internal error occurred due to a bug in either zc.buildout or in a
recipe being used:
...
subprocess.CalledProcessError: Command 'patch -p0 < ...' returned non-zero exit status ...
<BLANKLINE>

>>> import re
>>> import os.path
>>> import shutil
>>> path = re.search('foo: cmmi failed: (.*)', res).group(1)
>>> os.path.exists(path)
True
>>> shutil.rmtree(path)

成功构建后，将删除此类临时目录

>>> import glob
>>> import tempfile

>>> old_tempdir = tempfile.gettempdir()
>>> tempdir = tempfile.tempdir = tempfile.mkdtemp(suffix='.buildout.build')
>>> dirs = glob.glob(os.path.join(tempdir, '*buildout-foo'))

>>> write('buildout.cfg',
... """
... [buildout]
... parts = foo
...
... [foo]
... recipe = zc.recipe.cmmi
... url = %sfoo.tgz
... """ % (distros_url,))

>>> print(system("bin/buildout"))
Installing foo.
foo: Downloading https://#:21445/foo.tgz
foo: Unpacking and configuring
configuring foo --prefix=/sample_buildout/parts/foo
echo building foo
building foo
echo installing foo
installing foo
<BLANKLINE>

>>> new_dirs = glob.glob(os.path.join(tempdir, '*buildout-foo'))
>>> len(dirs) == len(new_dirs) == 0
True
>>> tempfile.tempdir = old_tempdir

下载缓存

配方支持使用与zc.buildout相同的下载缓存方式。有关详细信息，请参阅downloadcache.txt