minitage.recipe.common 1.47

zc.buildout recipes to compile and install software or python packages and generate scripts or configuration files.

Contents

• Introduction

• Options shared by all the recipes

  • Notes

  • Options

  • Options incidences

  • Patches

• minitage.recipe API tests

• CHANGELOG

  • ->UP

  • 1.42

  • 1.41

  • -> 1.40

  • 1.36

  • 1.35

  • .34

  • -> 1.20

  • 1.14

  • 1.13

  • 1.11 - 1.12

  • 1.-1.10

  • 1.8

  • 1.4->1.7

  • 1.3

  • 1.2

  • 1.1

  • 1.0

  • 0.33->0.34

  • 0.32

  • 0.29

  • 0.28

  • 0.27

  • 0.26

  • 0.25

  • 0.23->0.24

  • 0.22

  • 0.21

  • 0.20

  • 0.19

  • 0.18

  • 0.16

  • 0.14 -> 0.15

  • 0.13

  • 0.12

  • 0.11

  • 0.10

  • 0.9

  • 0.7 -> 0.8

  • 0.6

  • 0.2 -> 0.5

  • 0.1

  • 0.0.13

  • 0.0.11

  • 0.0.10

  • 0.0.9

  • 0.0.8

  • 0.0.7

  • 0.0.6

  • 0.0.3

  • 0.0.2

  • 0.0.1

Introduction

minitage.core.common is an abstract recipe extendended by much of minitage.recipe.*

That’s why many options of the descendant recipes are from there.

Options shared by all the recipes

Notes

• All recipes inherit all these options, depending which you are using, those options will have an incidence on the build.

• Useless to say that the recipes code is not difficult, and as a deployer, its your job to have a look at the code to avoid surprises.

• If you are inside a minitage all recipes will look on your minibuild dependencies section to get things into the environment at execution time. Like feeding CFLAGS, pkgconfig, ldflags and so on.

• All recipes look for a minitage section in your buildout file and take dependencies and eggs as minitage projects to get into the environnment too:

  ...
  [minitage]
  dependencies = postgresql-8.3
  eggs = py-libxslt-1.1

Options

• urls A set of urls to checkout in the form

  • The last part or the urls will be the name of your checkout dir unless you have precised the name in “destination directory name”

  • If you don’t specify any scm_type, it will be static unless you specify it in options (see scm)

  • If you don’t specify any revision, it will be not set unless you specify it in options (see scm_revision)

  • The form is a New line separated list of urls to fetcha in the following form (the | is part of the line ;)):

    url to checkout | fetch_type | revision | destination directory name | fetcher_args

  Here are valid inputs

  svn://toto | svn | 666 | mydirectoryname | --ignore-externals
  svn://toto | svn | 666 | mydirectoryname
  svn://toto | svn | 666
  svn://toto | svn | | | --ignore-externals
  svn://toto | svn
  file://toto
  http://tata/toto.tgz

  Where:

  fetch_type ::= bzr | hg | git | static (for ftp://, file://, http:// and local files) | svn

• executable

  python executable to use

• url (backward cmpatibility)

  url to get the source from, in the previous urls syntax

• scm

  default scm to use (a valid minitage fetch factory to use (static, git, svn, bzr, hg).) defaults to static.

• scm_revision

  default revision to checkout if scm is not static

• md5sum

  md5sum of the checkouted source [see cmmi recipe for documentation]

• patch-binary

  path to the patch program

• patch-options

  options to feed the patch program with [see cmmi recipe for documentation]

• patches

  patches to apply [see cmmi recipe for documentation]

• patch

  A patch to apply, compatibility with zc.recipe.cmmi

• location

  where to put the build result. (default to parts/PART_NAME)

• includes:

  directories to add to the include search (compatibility)

• ldflags

  LDFLAGS to set at compilation time

• cflags

  CFLAGS to give to the compiler

• includes-dirs

  Directories to add to the include paths [see cmmi recipe for documentation]

• libraries:

  libraries to give to the linker eg: libiconv

• library-dirs

  Directories to add to the linker, and they will be added as -rpath too. [see cmmi recipe for documentation]

• skip-flags: do not set CFLAGS/LDFLAGS/LD_RUN_PATH at all.

• environment

  a part name where we can get key/values to add to the build environment [see cmmi recipe for documentation]

• path

  line separated list of paths to append to $PATH during build

• pkgconfigpath

  line separated list of paths to append to $PKGCONFIGPATH during build [see cmmi recipe for documentation]

• pythonpath

  line separated list of paths to append to $PYTHONPATH during build

Options incidences

• minitage.recipe:cmmi

  executable is not taken in account.

• minitage.recipe:fetch

  only the download related options are used.

• minitage.recipe:eggs, minitage.recipe:wsgi, minitage.recipe:scripts, minitage.recipe:printer

  the configure-, and make-, and extra_options are not used

Patches

• They can be either a file or an url.

• You have means to specify options to the patch program, like -pXXX, abuses of it.

minitage.recipe API tests

The divide url function

• If you dont precise the directory, its the basename of the url:

  >>> divide_url ('http://foo/bar|svn|666||--ignore-externals')
  ('http://foo/bar', 'svn', '666', 'http.foo.bar', '--ignore-externals')

• Static as a default:

  >>> divide_url ('')
  ('', 'static', '', '', '')

• arguements can be optionnal:

  >>> divide_url ('http://foo/bar')
  ('http://foo/bar', 'static', '', 'http.foo.bar', '')

CHANGELOG

->UP

• API fix

• indentation fix

• make things shut up

1.42

• API compatibility for cmmi

1.41

• splitting cmmi stuff

-> 1.40

• remove deprecationwarning

1.36

• re namespacing

1.35

• split all recipes into singles ones.

.34

all:

• fix rst doc

• add ldflags and ldflags options

minitage.recipe.cmmi:

• install-in-place option added and pivot on make install slightly modified

• skip-flags option added

• prefix option added

minitage.recipe.fetch:

• unpack option added

• md5sum un revision for static fetcher check added

minitage.recipe.printer:

• remove fake eggs and develop eggs from fixed versions.

-> 1.20

Minitage.recipe.egg:

• better errors handling

• In particular for eggs and url, now md5 urls are preferred.

• Also when we can’t download a distribution from somewhere, we try to fallback to other distributions which achieve the desired requirement

• In the same way, try to compile eggs from any other sdist fullfilling the requirement if an error occurs on the first found.

Minitage.recipe.cmmi:

• new patch selection for freebsd:

  freebsd-patches

• Fix some double spaces left in compilation flags which broke some exotic system builders.

1.14

• add enrionment file generation to the scripts recipe

1.13

• cmmi buggy update methods

1.11 - 1.12

• rescan egg direcrectories at install time because there may be new develop eggs or eggs installed by buildout extensions (mr.developer)

• fix for interaction with buildout.minitagificator and zc.buildout.easy_install..*script

1.-1.10

• bugfix with cache and static distributions.

1.8

• make patches go in a personnal directory with some md5 mecanism to redownload them.

1.4->1.7

• x64 fixes

• bugfix in static distribution install when you have patches to apply.

1.3

• release uncomitted unittests updates

1.2

• make it compatible with zc.buildout 1.0

1.1

• md5 bug

1.0

• first stable release.

• All recipe are documented and well tested.

• buildout.minitagificator is completed.

• stabilized and synced with other minitage components

• minitage.recipe:eggs has been drasticly improved in term of algorythms and speed.

0.33->0.34

• Fix python executable computation

0.32

• Documentation and tests release

0.29

• Fix bug in recipes initialization because of buildout auto-ordering

0.28

• Add another hook to the cmmi recipe: post-download

0.27

• Fix an annoying bug when you are using virtualenv and a classical python as executable in your recipe, it may occur that sometimes, the virtualenv site-packages is appended to PYTHONPATH. As a fix, we now filter all python core lib directories and site packages that are not relevant to the python used by the recipe.

0.26

• Introduce the minitage.recipe:wsgi recipe wich wraps a paste wsgi application in a script eatable by mod_wsgi

0.25

• stop lowering project_name

0.23->0.24

• Fix small bugs in printer

0.22

• Introduce a new recipe : minitage.recipe:printer which prints/dumps to a file all versions eggs needed to achieve requirements.

0.21

• Fix bug in compilation directory guessing

0.20

• Fix bug in distribution reloading

• Better handling of pkg_resources’s working set

0.19

• add a post build hook

0.18

• Change installation order

0.16

• Fix index and find links options

0.14 -> 0.15

• logging output improved

• newest mode handling

0.13

• fix static dist install

0.12

• bugfix for zipped eggs

0.11

• import bugfix for minitagificator

0.10

• Change some logging options

• follow allow host option from buildout for eggs installation

0.9

• Do not rely anymore on zc.buildout ez for script generation

0.7 -> 0.8

• egg and scripts recipes were rewritten a lot to adapt their api to zc.recipe.egg

• Common to all recipes: all arguements are now identicak to zc.recipe.cmmi or zc.recipe.egg

• Dependencies resolver has been improved a lot

• For static distribution, you can know speicify multiple urls with ‘urls’

0.6

• fix bug in path generation in minitage.recipe:scripts

0.2 -> 0.5

• add make-options for make option in minitage.recipe.cmmi

• multiple bugfixes

• make things append in subprocess for environment conversation

• add initiaiization code for generated python interpreter in minitage.recipe:scripts

0.1

• add fetch recipe

0.0.13

• fix zip safe flag

0.0.11

• Include eggs dependencies by default

• Modulate the script recipe to append in the PYTHONPATH all egg dependencies found into the local eggs cache.

0.0.10

• Add pyc regeneration feature stolen from zc.buildout

0.0.9

• minor fix for run without minitage

• fix for long path/compilation flags

0.0.8

• minor fix for scm check outs

0.0.7

• add C compiler cflags/ldflags/makeopts customistation options

0.0.6

• Change the eggs installation way to do, now using easy_install everywhere Also include a buildout option to allow to include eggs dependencies (ez-dependencies-true)

• Set the __doc__ variable in scripts to fix some scripts like bzr.

0.0.3

• fix scm choice when there are eggs and url in the same part

0.0.2

• bugfix version

• fix linking problem

0.0.1

• Initial version