eggs/zc.buildout-1.5.2-py2.6.egg/zc/buildout/unzip.txt
author Nishanth Amuluru <nishanth@fossee.in>
Sat, 08 Jan 2011 22:37:31 +0530
changeset 333 eb3a191850a1
parent 307 c6bca38c1cbf
permissions -rw-r--r--
created a view for create task

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