Common options

• symlink_base option may contain a common (source) base directory for symlinking,

  when links are created for many items from the same directory.

• symlink_target may contain common target directory, when links are created in the

  same directory.

• autocreate causes a target directory to be created if it does not exist

Specifying individual links

• symlink option contains one or more values in format source=target

Example 1:

[symlinks]
symlink = ~/work/MyProj = ${buildout:directory}/products
autocreate = true

If a common symlink_target is specified, symlink can be in format: source= (omitting target directory)

Specifying links in bulk

Links can be created for all items in a directory given via symlink_base, all buildout eggs, and all development eggs. When links are created in bulk, they are always created in directory given by symlink_target.

There's also a special option to constrain bulk link creation:

• ignore option contains one or more wildcard expressions for choosing items that will

  be ignored, ie. no links will be created for them

[symlinks]
symlink_base = ~/work/
symlink_target = ${buildout:directory}/products
ignore = *.tmp

eggs = true
develop = true
ignore = *.tar.gz
         *.zip
symlink_target = ${buildout:directory}/products

Contributors

Radim Novotny, original author; Petri Savolainen, contributor

Change history

Download