Works around Buildout recipes for rapid Amara+Akara deployment ticket (http://trac.xml3k.org/ticket/17)

Docs

• http://us.pycon.org/2009/tutorials/schedule/1PM3/

  • http://www.timecastle.net/static/3-python-buildout.pdf

• http://www.buildout.org/

• http://pypi.python.org/pypi/zc.buildout

• http://pinaxproject.com/docs/dev/buildout.html

• http://ar.pycon.org/2009/conference/schedule/event/42/

• http://www.blueskyonmars.com/2009/08/28/python-packaginginstall-what-i-want/

• Eggs, VirtualEnv, and Apt - best practices?

• Using buildout on Windows - mostly Zope/Plone focused, but also more generally useful info, Including MinGW

• buildout vs pip. Why I choose buildout

• http://rhodesmill.org/brandon/buildout/ - a page with many useful hints on using buildout

• http://mg.pov.lt/blog/pylons-with-buildout

• http://plone.org/documentation/tutorial/buildout

Other docs (django related)

• http://www.saltycrane.com/blog/2009/05/notes-using-pip-and-virtualenv-django/

• http://jacobian.org/writing/django-apps-with-buildout/

• http://blog.haydon.id.au/2009/07/django-development-workflow.html

minitage

• http://minitage.org/

• http://www.mail-archive.com/distutils-sig@python.org/msg08918.html

Prerequisites

• A complete Python distro: http://www.python.org/doc/faq/extending/#i-want-to-compile-a-python-module-on-my-linux-system-but-some-files-are-missing-why

• Setuptools. Download ez_setup.py file into a temporary directory and run it with Administrator privileges.

• A compatible C compiler. You can install build-essential on ubuntu, mingw with g++ and Make on windows.

First Buildout

Preparing infrastructure ...

$ mkdir amaraBuildout
$ cd amaraBuildout
$ wget http://svn.zope.org/*checkout*/zc.buildout/trunk/bootstrap/bootstrap.py

Create builout.cfg

[buildout]
parts = amara2

[amara2]
recipe = zc.recipe.egg
interpreter = python
eggs = Amara

Preparing sandbox

$ python bootstrap.py
$ ./bin/buildout

Ready!

$ bin/python
>>> import amara
>>> amara.__version__
'2.0a1'

Buildout + virtualenv

If you need more isolated build environment ... use virtualenv

$ virtualenv --no-site-packages amaraTestingVE
$ cd amaraTestingVE/
$ bin/easy_install zc.buildout
$ bin/buildout init
$ nano buildout.cfg

buildout.cfg

[buildout]
parts = amara2

[amara2]
recipe = zc.recipe.egg
eggs = Amara
interpreter = python

$ bin/buildout -v -v -c buildout.cfg buildout:unzip=true
$ bin/python
>>>

Building from source

buildout.cfg

[buildout]
develop = amara_hg
parts = amara2

[amara2]
recipe = zc.recipe.egg
interpreter = amara_py
eggs = Amara
extra-paths = ${buildout:develop}/dist

Problems

Interpreter can't import new egg ...

Using Mercurial TODO

buildout.cfg

[buildout]
parts = amarahg amara2 entorno
eggs = Amara

[amarahg]
recipe = MercurialRecipe
repository =  http://bitbucket.org/uche/amara/

[amara2]
recipe = zc.recipe.egg:develop
egg = amara
setup = ${amarahg:location}/setup.py

[entorno]
recipe = zc.recipe.egg
interpreter = ampython
extra-paths = ${amarahg:location}/lib
eggs = ${buildout:eggs}

Problem

Mercurial part works fine, buildout builds the module amara but I can't use/import amara into my new shell

Testing minitage

[buildout]
parts = 
      amara
extensions = mr.developer
sources = amarahg
auto-checkout = *
download-directory = /tmp

[amarahg]
amara = hg http://bitbucket.org/uche/amara 
akara = hg http://bitbucket.org/uche/akara 

[amara]
recipe = minitage.recipe.scripts
interpreter = mypython
eggs =
    amara
    akara

A first installer: install_amara.py

I must investigate