eggs/zc.buildout-1.5.2-py2.6.egg/zc/buildout/unzip.txt
author Nishanth Amuluru <nishanth@fossee.in>
Sat, 08 Jan 2011 11:20:57 +0530
changeset 307 c6bca38c1cbf
permissions -rw-r--r--
Added buildout stuff and made changes accordingly

Always unzipping eggs
=====================

By default, zc.buildout doesn't unzip zip-safe eggs.

    >>> write('buildout.cfg',
    ... '''
    ... [buildout]
    ... parts = eggs
    ... find-links = %(link_server)s
    ...
    ... [eggs]
    ... recipe = zc.recipe.egg
    ... eggs = demo
    ... ''' % globals())

    >>> _ = system(buildout)
    >>> ls('eggs')
    -  demo-0.4c1-py2.4.egg
    -  demoneeded-1.2c1-py2.4.egg
    d  setuptools-0.6c8-py2.4.egg
    -  zc.buildout.egg-link

This follows the policy followed by setuptools itself.  Experience shows
this policy to to be inconvenient.  Zipped eggs make debugging more
difficult and often import more slowly.

You can include an unzip option in the buildout section to change the
default unzipping policy.

    >>> write('buildout.cfg',
    ... '''
    ... [buildout]
    ... parts = eggs
    ... find-links = %(link_server)s
    ... unzip = true
    ...
    ... [eggs]
    ... recipe = zc.recipe.egg
    ... eggs = demo
    ... ''' % globals())


    >>> import os
    >>> for name in os.listdir('eggs'):
    ...     if name.startswith('demo'):
    ...         remove('eggs', name)

    >>> _ = system(buildout)
    >>> ls('eggs')
    d  demo-0.4c1-py2.4.egg
    d  demoneeded-1.2c1-py2.4.egg
    d  setuptools-0.6c8-py2.4.egg
    -  zc.buildout.egg-link