slapos.recipe.build 0.57

option: environment

Customizing environment variables can be easier with the this option. Values are expanded with Python %-dict formatting, using os.environ. The resulting environ dict is computed on first access of self.environ. Environment variables can be either inlined:

>>> base = """
... [buildout]
... parts = script
...
... [script]
... recipe = slapos.recipe.build
... update =
...   import os
...   os.environ["FOO"] = "1"
...   print("%(FOO)s %(BAR)s" % self.environ)
...   os.environ["FOO"] = "2"
...   print("%(FOO)s %(BAR)s" % self.environ)
... """
>>> write(sample_buildout, 'buildout.cfg', base + """
... environment =
...   BAR=%(FOO)s:%%
... """)
>>> print(system(buildout))
Installing script.
script: [ENV] BAR = 1:%
1 1:%
1 1:%

or put inside a separate section:

>>> write(sample_buildout, 'buildout.cfg', base + """
... environment = env
... [env]
... BAR=%(FOO)s:%%
... """)
>>> print(system(buildout))
Uninstalling script.
Installing script.
script: [ENV] BAR = 1:%
1 1:%
1 1:%

This option works the same way in other recipes that support it, in which case the resulting environ dict is computed at install/update.

option: shared

Boolean (false by default, or true), this option specifies that the part can be installed in a shared mode. This is enabled if paths are listed in the shared-part-list option of the [buildout] section: the location of the part is <one of shared-part-list>/<part name>/<hash of options> and it contains a signature file .buildout-shared.json.

install option is required:

>>> del MD5SUM[:]
>>> base = """
... [buildout]
... parts = script
... shared-part-list =
...   ${:directory}/shared1
...   ${:directory}/shared2
...
... [script]
... recipe = slapos.recipe.build
... shared = true
... """
>>> write(sample_buildout, 'buildout.cfg', base + """
... init = pass
... """)
>>> print(system(buildout))
script: shared at .../shared2/script/<MD5SUM:0>
While:
  Installing.
  Getting section script.
  Initializing section script.
Error: When shared=true, option 'install' must be set

update option is incompatible:

>>> base += """
... install =
...   import os
...   os.makedirs(os.path.join(location, 'foo'))
...   print("directory created")
... """
>>> write(sample_buildout, 'buildout.cfg', base)
>>> print(system(buildout + ' script:update=pass'))
script: shared at .../shared2/script/<MD5SUM:1>
While:
  Installing.
  Getting section script.
  Initializing section script.
Error: When shared=true, option 'update' can't be set

A shared part is installed in the last folder that is listed by shared-part-list:

>>> print(system(buildout))
script: shared at .../shared2/script/<MD5SUM:2>
Uninstalling script.
Installing script.
directory created
>>> shared = 'shared2/script/' + MD5SUM[2]
>>> ls(shared)
-  .buildout-shared.json
l  .buildout-shared.signature
d  foo

.buildout-shared.signature is only there for backward compatibility.

Uninstalling the part leaves the shared part available:

>>> print(system(buildout + ' buildout:parts='))
Uninstalling script.
Unused options for buildout: 'shared-part-list'.
>>> ls(shared)
-  .buildout-shared.json
l  .buildout-shared.signature
d  foo

And reinstalling is instantaneous:

>>> print(system(buildout))
script: shared at .../shared2/script/<MD5SUM:2>
Installing script.
script: shared part is already installed

Setting location option is incompatible:

>>> write(sample_buildout, 'buildout.cfg', base + """
... init =
...   import os
...   options['location'] = os.path.join(
...     self.buildout['buildout']['parts-directory'], 'foo')
... """)
>>> print(system(buildout))
script: shared at .../shared2/script/<MD5SUM:3>
While:
  Installing.
  Getting section script.
  Initializing section script.
Error: When shared=true, option 'location' can't be set

option: location

If empty or unset, the value is initialized automatically according to rules defined above (shared option), and before the init code is executed. This way, it’s possible to initialize other values of the section depending on the actual value of location.

If not shared, the value can be customized in init. This is actually the only way to empty location, which is useful if there’s nothing file/directory to track but you need to distinguish install from update:

>>> write(sample_buildout, 'buildout.cfg', """
... [buildout]
... parts = script
...
... [script]
... recipe = slapos.recipe.build
... init =
...   options['location'] = ''
... install =
...   print("install")
... update =
...   print("update")
... """)

>>> print(system(buildout))
Uninstalling script.
Installing script.
install
>>> print(system(buildout))
Updating script.
update
>>> cat('.installed.cfg')
[buildout]
...
[script]
__buildout_installed__ =
__buildout_signature__ = ...

If install & update run the same code, install can be unset (or empty) and you can ignore location.

option: filename

In the part folder, the filename can be customized:

>>> write(sample_buildout, 'buildout.cfg', base + """
... filename = somefile
... """)
>>> print(system(buildout))
Uninstalling download.
Installing download.
Downloading ...
>>> ls('parts/download')
-  somefile

When an MD5 checksum is not given, updating the part downloads the file again:

>>> remove('parts/download/somefile')
>>> print(system(buildout))
Updating download.
Downloading ...
>>> ls('parts/download')
-  somefile

option: destination

Rather than having a file inside a part folder, a full path can be given:

>>> write(sample_buildout, 'buildout.cfg', base + """
... destination = ${buildout:parts-directory}/somepath
... """)
>>> print(system(buildout))
Uninstalling download.
Installing download.
Downloading ...
>>> ls('parts')
-  somepath

option: target

In any case, path to download file is exposed by the target option:

>>> cat('.installed.cfg')
[buildout]
...
[download]
__buildout_installed__ = .../parts/somepath
__buildout_signature__ = ...
destination = .../parts/somepath
recipe = slapos.recipe.build:download
target = .../parts/somepath
url = ...

option: md5sum

An MD5 checksum can be specified to check the contents:

>>> base += """
... md5sum = b90c12a875df544907bc84d9c7930653
... """
>>> write(sample_buildout, 'buildout.cfg', base)
>>> print(system(buildout))
Uninstalling download.
Installing download.
Downloading ...
>>> ls('parts/download')
-  download

In such case, updating the part does nothing:

>>> remove('parts/download/download')
>>> print(system(buildout))
Updating download.
>>> ls('parts/download')

In case of checksum mismatch:

>>> print(system(buildout
... + ' download:md5sum=00000000000000000000000000000000'
... ))
Uninstalling download.
Installing download.
Downloading ...
While:
  Installing download.
Error: MD5 checksum mismatch downloading '...'
>>> ls('parts')

option: offline

Boolean option that can be specified to override ${buildout:offline}.

option: alternate-url

Alternate URL. If supported by Buildout, it is used as fallback if the main URL (url option) fails at HTTP level.

Useful when a version of a resource can only be downloaded with a temporary URL as long as it’s the last version, and this version is then moved to a permanent place when a newer version is released: url shall be the final URL and alternate-url the temporary one.

option: shared

Works like the default recipe. Constraints on options are:

• md5sum option is required

• destination option is incompatible

Example:

>>> del MD5SUM[4:] # drop added values since previous shared test
>>> write(sample_buildout, 'buildout.cfg', base + """
... shared = true
...
... [buildout]
... shared-part-list =
...   ${:directory}/shared
... """)
>>> print(system(buildout))
download: shared at .../shared/download/<MD5SUM:4>
Installing download.
Downloading ...
>>> shared = 'shared/download/' + MD5SUM[4]
>>> ls(shared)
-  .buildout-shared.json
l  .buildout-shared.signature
-  download

option: destination

Similar to download recipe:

>>> write(sample_buildout, 'buildout.cfg', base + """
... destination = ${buildout:parts-directory}/somepath
... """)
>>> print(system(buildout))
Uninstalling download.
Installing download.
>>> ls('parts/somepath')
d  slapos

option: target

Like for download recipe, the installation path of the part is exposed by the target option:

>>> cat('.installed.cfg')
[buildout]
...
[download]
__buildout_installed__ = .../parts/somepath
__buildout_signature__ = ...
destination = .../parts/somepath
recipe = slapos.recipe.build:download-unpacked
target = .../parts/somepath
url = ...

option: strip-top-level-dir

Stripping can be enforced:

>>> print(system(buildout + ' download:strip-top-level-dir=true'))
Uninstalling download.
Installing download.
>>> ls('parts/somepath')
d  slapos

Or disabled:

>>> print(system(buildout + ' download:strip-top-level-dir=false'))
Uninstalling download.
Installing download.
>>> ls('parts/somepath')
d  slapos.recipe.build-master-slapos-recipe-build

option: md5sum

An MD5 checksum can be specified to check the downloaded file, like for the download recipe. However, if unset, updating the part does nothing.

option: alternate-url

See the download recipe.

option: environment

Like for the default recipe, environment variables can be customized, here for xzcat & lunzip subprocesses (e.g. PATH).

option: shared

Works like the default recipe. The only constraint on options is that the destination option is incompatible.

Example:

>>> del MD5SUM[5:] # drop added values since previous shared test
>>> write(sample_buildout, 'buildout.cfg', """
... [buildout]
... download-cache = download-cache
... parts = download
... shared-part-list = ${:directory}/shared
...
... [download]
... recipe = slapos.recipe.build:download-unpacked
... url = %s
... shared = true
... """ % URL)
>>> print(system(buildout))
download: shared at .../shared/download/<MD5SUM:5>
Uninstalling download.
Installing download.

Examples

Those examples use slapos.recipe.build repository as an example.

>>> write(sample_buildout, 'buildout.cfg',
... """
... [buildout]
... parts = git-clone
...
... [git-clone]
... recipe = slapos.recipe.build:gitclone
... repository = https://lab.nexedi.com/nexedi/slapos.recipe.build.git
... use-cache = true
... """)

>>> print(system(buildout))
Uninstalling download.
Installing git-clone.
Cloning into '/sample-buildout/parts/git-clone'...

>>> ls(sample_buildout, 'parts')
d git-clone

>>> print(system(buildout))
Updating git-clone.
Fetching origin
HEAD is now at ...

>>> write(sample_buildout, 'buildout.cfg',
... """
... [buildout]
... parts = git-clone
...
... [git-clone]
... recipe = slapos.recipe.build:gitclone
... repository = https://lab.nexedi.com/nexedi/slapos.recipe.build.git
... branch = build_remove_downloaded_files
... """)

>>> print(system(buildout))
Uninstalling git-clone.
Running uninstall recipe.
Installing git-clone.
Cloning into '/sample-buildout/parts/git-clone'...

>>> ls(sample_buildout, 'parts')
d git-clone

>>> import subprocess
>>> cd('parts', 'git-clone')
>>> print(subprocess.check_output(['git', 'branch'], universal_newlines=True))
* build_remove_downloaded_files

>>> cd(sample_buildout)
>>> print(system(buildout))
Updating git-clone.
Fetching origin
HEAD is now at ...

>>> cd(sample_buildout)
>>> write(sample_buildout, 'buildout.cfg',
... """
... [buildout]
... parts = git-clone
...
... [git-clone]
... recipe = slapos.recipe.build:gitclone
... repository = https://lab.nexedi.com/nexedi/slapos.recipe.build.git
... revision = 2566127
... """)

>>> print(system(buildout))
Uninstalling git-clone.
Running uninstall recipe.
Installing git-clone.
Cloning into '/sample-buildout/parts/git-clone'...
HEAD is now at 2566127 ...

>>> ls(sample_buildout, 'parts')
d git-clone

>>> import subprocess
>>> cd(sample_buildout, 'parts', 'git-clone')
>>> print(subprocess.check_output(['git', 'rev-parse', '--short', 'HEAD'], universal_newlines=True))
2566127

>>> cd(sample_buildout)
>>> print(system(buildout))
Updating git-clone.

>>> cd(sample_buildout)
>>> write(sample_buildout, 'buildout.cfg',
... """
... [buildout]
... parts = git-clone
...
... [git-clone-with-branch]
... recipe = slapos.recipe.build:gitclone
... repository = https://lab.nexedi.com/nexedi/slapos.recipe.build.git
... revision = 2566127
...
... [git-clone]
... <= git-clone-with-branch
... revision =
... branch = master
... """)

>>> print(system(buildout))
Uninstalling git-clone.
Running uninstall recipe.
Installing git-clone.
Cloning into '/sample-buildout/parts/git-clone'...

>>> cd(sample_buildout, 'parts', 'git-clone')
>>> print(system('git branch'))
* master

>>> cd(sample_buildout)
>>> write(sample_buildout, 'buildout.cfg',
... """
... [buildout]
... parts = git-clone
...
... [git-clone]
... recipe = slapos.recipe.build:gitclone
... repository = https://lab.nexedi.com/nexedi/slapos.recipe.build.git
... branch = mybranch
... revision = 2566127
... """)

>>> print(system(buildout))
Uninstalling git-clone.
Running uninstall recipe.
Installing git-clone.
Warning: "branch" parameter with value "mybranch" is ignored. Checking out to revision 2566127...
Cloning into '/sample-buildout/parts/git-clone'...
HEAD is now at 2566127 ...

>>> cd(sample_buildout, 'parts', 'git-clone')
>>> print(system('git branch'))
* master

[buildout]
parts = git-clone

[git-clone]
recipe = slapos.recipe.build:gitclone
repository = https://example.net/example.git/
develop = true

>>> cd(sample_buildout)
>>> write(sample_buildout, 'buildout.cfg',
... """
... [buildout]
... parts = git-clone
...
... [git-clone]
... recipe = slapos.recipe.build:gitclone
... repository = https://lab.nexedi.com/nexedi/slapos.recipe.build.git
... develop = true
... """)

>>> print(system(buildout))
Uninstalling git-clone.
Running uninstall recipe.
Installing git-clone.
Cloning into '/sample-buildout/parts/git-clone'...

>>> cd(sample_buildout, 'parts', 'git-clone')
>>> print(system('echo foo > setup.py'))

>>> cd(sample_buildout)
>>> print(system(buildout))
Updating git-clone.

>>> cd(sample_buildout, 'parts', 'git-clone')
>>> print(system('cat setup.py'))
foo

>>> cd(sample_buildout, 'parts', 'git-clone')
>>> print(system('echo kept > local_change'))

>>> print(system('git remote add broken http://git.erp5.org/repos/nowhere'))
...

>>> cd(sample_buildout)
>>> print(system(buildout))
Updating git-clone.

>>> cd(sample_buildout, 'parts', 'git-clone')
>>> print(system('cat local_change'))
kept

>>> cd(sample_buildout)
>>> write(sample_buildout, 'buildout.cfg',
... """
... [buildout]
... parts = git-clone
...
... [git-clone]
... recipe = slapos.recipe.build:gitclone
... repository = https://lab.nexedi.com/nexedi/slapos.recipe.build.git
... develop = true
... # Triggers uninstall/install because of section signature change
... foo = bar
... """)

>>> print(system(buildout))
Uninstalling git-clone.
Running uninstall recipe.
You have uncommitted changes in /sample-buildout/parts/git-clone. This folder will be left as is.
Installing git-clone.
destination directory already exists.
...
<BLANKLINE>

[buildout]
parts = git-clone

[git-clone]
recipe = slapos.recipe.build:gitclone
repository = https://example.net/example.git/
ignore-ssl-certificate = true

[buildout]
parts = git-clone

[git-clone]
recipe = slapos.recipe.build:gitclone
repository = https://lab.nexedi.com/tiwariayush/test_erp5
ignore-cloning-submodules = true

[buildout]
parts = git-clone

[git-binary]
recipe = hexagonit.recipe.cmmi
url = http://git-core.googlecode.com/files/git-1.7.12.tar.gz

[git-clone]
recipe = slapos.recipe.build:gitclone
repository = http://example.net/example.git/
git-command = ${git-binary:location}/bin/git
revision = 0123456789abcdef

Common options

location

Folder where the recipe stores any produced file. Default: ${buildout:parts-directory}/<section_name>

environment

Extra environment to spawn executables. See the default recipe.

mem

Python expression evaluating to an integer that specifies the RAM size in MB for the VM.

smp

Number of CPUs for the VM. Default: 1

[vm-run-environment]
PATH = ${openssh:location}/bin:${qemu:location}/bin:%(PATH)s

[vm-run-base]
recipe = slapos.recipe.build:vm.run
environment = vm-run-environment
mem = 256 * (${:smp} + 1)
smp = 4

slapos.recipe.build:vm.install-debian

Install Debian from an ISO image. Additional required binaries:

• 7z (from 7zip), to extract kernel/initrd from the ISO;

• file, which is used to test that the VM image is bootable.

Currently, it only produces raw images, in discard mode (see -drive QEMU option): combined the use of discard mount option, this minimizes the used space on disk.

[vm-install-environment]
# vm-run-environment refers to the section in common options
PATH = ${file:location}/bin:${p7zip:location}/bin:${vm-run-environment:PATH}

[vm-debian]
recipe = slapos.recipe.build:vm.install-debian
environment = vm-install-environment
dists = debian-jessie debian-stretch
size = 2Gi
late-command =
# rdnssd causes too much trouble with QEMU 2.7, because the latter acts as
# a DNS proxy on both IPv4 and IPv6 without translating queries to what the
# host supports.
  dpkg -P rdnssd
debconf.debconf =
  debconf/frontend noninteractive
  debconf/priority critical
# minimal size
preseed.apt-setup/enable-source-repositories = false
preseed.recommends = false
preseed.tasks =

[debian-jessie]
x86_64.iso = debian-amd64-netinst.iso
x86_64.kernel = install.amd/vmlinuz
x86_64.initrd = install.amd/initrd.gz

[debian-stretch]
<= debian-jessie
x86_64.iso = debian-amd64-testing-netinst.iso

[debian-amd64-netinst.iso]
...

slapos.recipe.build:vm.run

Execute shell commands inside a VM, in snapshot mode (the VM image is not modified).

${buildout:directory} is always mounted as /mnt/buildout inside the VM.

Mount points use the 9p file-system. Make sure that:

• QEMU is built with –enable-virtfs;

• the VM runs a kernel that is recent enough (Debian Squeeze kernel 2.6.32 is known to fail, and you’d have to use the one from squeeze-backports).

[vm-run-base]
# extends above example in common options
vm = ${vm-debian:location}
dist = debian-jessie

[vm-debian]
# extends above example in vm.install-debian
packages += build-essential devscripts equivs git

[userhosts-repository]
recipe = slapos.recipe.build:gitclone
repository = https://lab.nexedi.com/nexedi/userhosts.git
# we don't need a working directory on the host
sparse-checkout = /.gitignore

[build-userhosts-map]
<= vm-run-base
repository = `map ${userhosts-repository:location}`
command =
  git clone -s ${:repository} userhosts
  cd userhosts
  mk-build-deps -irs sudo -t 'apt-get -y'
  dpkg-buildpackage -uc -b -jauto
  cd ..
  mv *.changes *.deb $PARTDIR

# Alternate way, which is required if [userhosts-repository] is extended
# in such way that the repository is outside ${buildout:directory}.
[build-userhosts-mount]
<= build-userhosts-map
mount.userhosts = ${userhosts-repository:location}
repository = /mnt/userhosts

[test-reboot]
<= vm-run-base
commands = hello world
hello =
  uptime -s
  echo Hello ...
  reboot
world =
  uptime -s
  echo ... world!

0.57 (unreleased)

• move non-trivial code from namespace __init__.py

0.56 (2022-11-10)

• drop slapos.recipe.build:npm

• gitclone: support git 2.38.1 when using submodules

0.55 (2022-06-07)

• downloadunpacked: fix extraction of symlinks when using an external decompressor

0.54 (2022-02-11)

• default: allow ‘install’ to install no file/dir

• default: fix case where ‘location’ does not contain any directory separator

0.53 (2022-01-11)

• default: execute ‘init’ after the ‘location’ option is automatically set.

• Drop multiarch support: see new ‘multiarch’ value in conditional configuration sections since SlapOS fork of zc.buildout version 2.7.1+slapos015.

• default: make ‘self.download’ use url&md5sum options if called without url.

• default: add support for xz/lz archives to ‘self.extract’.

• download*: new ‘offline’ option to override ${buildout:offline}.

0.52 (2021-12-10)

• default, download-unpacked: improve multiarch support (for the default recipe, multiarch() replaces guessPlatform()).

• shared: fix trailing whitespace in signature file on Python 2.

0.51 (2021-12-08)

• download: only take basename of ‘filename’ when the latter is used to calculate destination path

• download: drop ‘mode’ option

• gitclone: new ‘depth’ option

0.50 (2021-11-29)

• download-unpacked: drop unused environment-section option

0.49 (2021-10-04)

• download-unpacked: fix strip-top-level-dir if unset and nothing should be stripped.

• Work around circular imports inside slapos.buildout.

• default: preserve symlinks in copyTree() & extract().

• default: fix error handling in pipeCommand().

• shared: change JSON serialization of signature to indent with 2 spaces (instead of 0) and to save non-ascii chars as utf-8 (rather than escaped).

0.48 (2021-09-25)

• New API to share parts:

  • new Shared class that should be used by recipes to make a part shared;

  • the signature file is in JSON format and it is named .buildout-shared.signature.

• download*: fix shared=true using new Shared class.

• download*: new alternate-url option.

• download-unpacked: decompress directly within target folder to avoid copies accross different file systems.

• default: add support for shared parts.

• download-unpacked: environment-section option is deprecated.

• download-unpacked: extract-directory option is dropped.

• For some boolean options, the value must be either ‘false’ or ‘true’.

0.47 (2021-07-26)

• default: Include current line in the tracebacks on error

0.46 (2020-09-11)

• gitclone: let errors on update propagate

0.45 (2020-04-20)

• default: only set default ‘location’ option if there’s an install script

0.44 (2020-03-20)

This release contains several backward-incompatible changes.

• default: remove useless globals & ‘self’ methods

• default: ‘script’ renamed to ‘install’, new ‘update’, clean up globals/locals

• default: remove ‘format’ option

• default: check that ‘install’ script creates ‘location’

• default: do not warn if slapos_promise is not set

• default: update doc

0.43 (2020-02-28)

• default: new ‘init’ option.

• default: do not strip ‘url’, ‘md5sum’, ‘path’ automatically (these options are not used by the recipe).

• default: drop workaround for script starting with indentation.

• shared: don’t touch symlink targets when making read-only recursively.

• vm: no empty floppy/cdrom drives.

• vm: always use GPT.

• vm: switch to XFS.

0.42 (2019-10-16)

• vm: use virtio-rng with host’s /dev/urandom to fix boot delays with recent OS

• vm.run: use -cpu host

• vm.run: new ‘drives’ option

0.41 (2019-06-19)

• gitclone: add support for submodules, enabled by default.

0.40 (2018-10-29)

• shared: fix signature test under Python 3.

0.39 (2018-10-26)

• More Py3 fixes.

0.38 (2018-09-13)

• download: fix regression in 0.37 breaking support for Python 3

0.37 (2018-08-27)

• Drop slapos.recipe.build:cpan, use perl-CPAN-package macro instead.

• downloadunpacked, download: add shared feature.

0.36 (2017-06-29)

• Do not depend on slapos.libnetworkcache, which is optional.

0.35 (2017-06-21)

• download: fix default permission of installed files.

• download: do nothing on update if we’re sure that the source hasn’t changed.

0.34 (2017-06-05)

• downloadunpacked: make compatible with Python 2.6, now that slapos.recipe.cmmi uses it, and we still want to bootstrap SlapOS on old OS.

• downloadunpacked: fix clean up of temporary files

• gitclone: assume unclean on uninstall when git-executable cannot be found.

• Add support for Python 3, at least to bootstrap SlapOS from Python 3.

0.33 (2017-04-07)

• download, downloadunpacked: remove downloaded files after unpacking.

0.32 (2017-03-08)

• downloadunpacked: fix an issue in extracting hard links.

0.31 (2017-03-08)

• downloadunpacked: support .xz and .lz archives.

• downloadunpacked: extract symlinks in a tar archive as symlinks.

0.30 (2017-02-23)

• script option: fix IndentationError with buildout 2, if some lines are indented.

0.28 (2016-11-08)

• vm.run: workaround for old versions of mount

• vm.install-debian:

  • No more limit on the number of preseed parameters, by placing a preseed.cfg file inside the initrd, instead of passing them all via the command line. The kernel is usually limited to 32 parameters and it panics when there are too many.

  • Dist-specific options.

  • Recognize preseed aliases.

  • late-command is run with ‘/bin/sh -e’ and it must exit with EX_OK (0), otherwise the installer stops.

0.27 (2016-10-30)

• vm: change how commands can be easily run with a normal user account on the guest

0.26 (2016-10-29)

• gitclone: new ‘shared’ option.

• vm.install-debian: workaround for spurious “No network interfaces detected”

• vm: use a normal user account by default

0.25 (2016-10-23)

• gitclone: new ‘sparse-checkout’ option.

• New vm.* recipes to build VM images and execute commands inside them.

0.24 (2016-10-10)

Improvements to default recipe:

• Remove location if script fails.

• If location already exists at install, warn instead of failing.

• location can be a file. Similarly, the use of self.cleanup_dir_list & self.cleanup_file_list in script is deprecated in favor of self.cleanup_list.

0.23 (2015-10-22)

• gitclone: We don’t have to fetch, if revision is already present in local git repository

0.22 (2015-10-19)

• Support zc.buildout 2.

0.21 (2015-04-10)

• Restore support for build scripts

0.20 (2015-03-06)

• rerelease because “missing release” was cached in shacache

0.19 (2015-03-06)

• gitclone: REVERT “when update(), if repository has local changes, don’t do anything but warn user.” With this commit, test nodes would not update the repository if it has local changes (eg. from pyc files)

0.18 (2015-02-05)

• gitclone: don’t do anything at update() if develop=true.

• gitclone: develop is false by default.

• gitclone: don’t raise when uninstall if location does not exist.

• gitclone: when update(), if repository has local changes, don’t do anything but warn user.

0.17 (2015-02-02)

• gitclone: keep local changes when there is an error during update

0.16 (2015-01-12)

• gitclone: fix option name for git-executable

0.15 (2014-11-28)

• build: Fixup! Remove downloaded files at the end.

0.14 (2014-10-23)

• build: Remove downloaded files at the end.

0.13 (2014-10-08)

• gitclone: do not delete the working copy if develop is set.

• gitclone: revision has priority over branch.

• gitclone: empty parameter equals no parameter.

0.12 (2013-09-05)

• gitclone: Do not upload to cache by default. ‘use-cache’ option replaces ‘forbid-download-cache’ and must be explicitely set in order to use cache.

• gitclone: Do not cache working copy, which just duplicate .git folder.

• gitclone: do not force to use ‘master’ branch when not specified.

• gitclone: add git ‘ignore-ssl-certificate’ option.

• gitclone: if directory is no longer present, install, never update.

0.11.6 (2013-02-25)

• Cleanup pyc and pyo files when updating git repository [Sebastien Robin]

0.11.5 (2012-10-01)

• Use @{upstream} git magic value, allow to fix update bugs. [Cedric de Saint Martin]

0.11.4 (2012-09-11)

• libnetworkcache is added back as a dependency. gitclone has no sense without it in SlapOS context. [Cedric de Saint Martin]

0.11.3 (2012-09-10)

• Removed explicit dependency of slapos.libnetworkcache. If not present, it will gracefully degrade. [Cedric de Saint Martin]

0.11.2 (2012-09-05)

• Add location to Buildout “options” dict, so that it is exposed to other Buildout parts. [Cedric de Saint Martin]

0.11.1 (2012-09-05)

• Add forbid-download-cache parameter, forbidding to fetch git from cache. [Cedric de Saint Martin]

• Sanitize instance attributes. [Cedric de Saint Martin]

0.11 (2012-09-04)

• Add slapos.recipe.build:gitclone recipe. [Cedric de Saint Martin]

0.10.2 (2012-08-02)

• Update manifest to include readme.rst [Cedric de Saint Martin]

0.10.1 (2012-08-02)

• Minor fix in ReST documentation formatting. [Cedric de Saint Martin]

0.10 (2012-07-02)

• Add format = yes|no option. [Antoine Catton]

0.9 (2012-06-07)

• Revert accidental release about upcoming version of slapos.recipe.build

0.8 (2012-06-07)

• Add support for “path” argument [Cedric de Saint Martin]

• Cleanup of download entry point [Vincent Pelletier]

• Add npm and cpan entry points [Cedric de Saint Martin]

0.7 (2011-11-8)

• Generic: Remove directory when needed, and only if it is wanted. [Cedric de Saint Martin]

• Add slapos.recipe.downloadunpacked script [Alain Takoudjou]

0.6 (2011-09-08)

• Cmmi: Support more compatibility with other recipes to build, especially hexagonit.recipe.cmmi. [Łukasz Nowak]

• Generic: A lot of small improvements (like supporting values with = in environment) [Łukasz Nowak]

• Generic: Use shlex to parse some options. [Antoine Catton]

• Generic: Fix patch, it was not working, as not using stdin. [Antoine Catton]

0.5 (2011-09-06)

• Download: Expose location too for compatiblity. [Łukasz Nowak]

0.4 (2011-09-06)

• Cmmi: Provide more features to control build process. [Łukasz Nowak]

0.3 (2011-09-05)

• Provide slapos.recipe.build:download utility. [Łukasz Nowak]

0.2 (2011-09-05)

• Bugfix: Support buildout’s download cache during downlading. [Łukasz Nowak]

• Bugfix: Honour correctly passed md5sum to download method. [Łukasz Nowak]

• Feature: Utility methods pipeCommand and failIfPathExists. [Łukasz Nowak]

• Bugfix: Rename promisee to promise. [Łukasz Nowak]

• Feature: Just warn in case of lack of promise. [Łukasz Nowak]

0.1 (2011-08-26)

• Add copyTree method to recursively copy [Cedric de Saint Martin]

• add guessPlatform function to guess architecture in case of multi-architecture installation [Cedric de Saint Martin]