Metadata-Version: 1.0
Name: buildout.locallib
Version: 0.2.0
Summary: buildout.locallib use egg-packages installed on site-packages folder.
Home-page: http://bitbucket.org/shimizukawa/buildout.locallib/
Author: Takayuki SHIMIZUKAWA
Author-email: shimizukawa at gmail.com
License: PSL
Description: `buildout.locallib` use egg-packages installed on site-packages folder.
        
        `zc.buildout <http://pypi.python.org/pypi/zc.buildout>`_ check
        package installation by zc.buildout.easy_install.Installer that
        exclude /path/to/site-packages folder path for checking.
        
        When 'site-packages' folder include some easy-installed packages,
        We want to re-use these packages in some cases.
        
        Features
        --------
        
        * Extends zc.buildout functionality to search installed packages.
        * create dummy '*.egg-info' / '*.egg-link' for specified packages.
        
        
        Using sample: using buildout.locallib extension
        -------------------------------------------------
        
        site-packages include some eggs::
        
        $ ls /path/to/site-packages
        easy-install.pth
        pip-0.6.3-py2.6.egg/
        pastedeploy-1.3.3-py2.6.egg/
        pastescript-1.7.3-py2.6.egg/
        paste-1.7.4-py2.6.egg/
        setuptools-0.6c11-py2.6.egg
        setuptools.pth
        
        
        write buildout.cfg::
        
        [buildout]
        parts = foo
        
        [foo]
        recipe = zc.recipe.egg
        eggs =
        PasteScript
        
        
        run bootstrap and buildout::
        
        $ python bootstrap.py
        $ bin/buildout -U
        ...
        
        list eggs dir::
        
        $ ls eggs
        zc.recipe.egg-1.2.3b2-py2.6.egg
        pastescript-1.7.3-py2.6.egg
        pastedeploy-1.3.3-py2.6.egg
        paste-1.7.4-py2.6.egg
        
        (clean-up)::
        
        $ rm -R eggs
        
        Now update buildout.cfg to use `buildout.locallib` extension::
        
        [buildout]
        parts = foo
        extensions = buildout.locallib
        ...
        
        And run buildout again::
        
        $ bin/buildout -U
        ...
        
        Check your eggs folder again::
        
        $ ls eggs
        buildout.locallib-0.0.1-py2.6.egg
        zc.recipe.egg-1.2.3b2-py2.6.egg
        
        If package exists at site-packages folder, now using installed version
        packages.
        
        
        Using sample: specified dummy package information
        --------------------------------------------------
        
        site-packages include some libraries, but they are not installed by easy_insttall::
        
        $ ls /path/to/site-packages
        ...
        feedparser.py
        ...
        
        write buildout.cfg with `locallibs` key and section::
        
        [buildout]
        parts = foo
        newest = false #if you won't want to check newest version (network-access)
        extensions = buildout.locallib
        locallibs = locallibs
        
        [foo]
        recipe = zc.recipe.egg
        eggs =
        feedparser
        
        [locallibs]
        feedparser = feedparser==4.1
        
        'locallibs' section require `(dummy name) = (pkg name)==(version)` style
        key-value pairs. Then, buildout.locallib create dummy `feedparser-4.1.egg-info`
        into the develop-eggs directory. In this way, setuptools recognizes that a
        'feedparser' is installed and doesn't perform downloading.
        
        If target package have .egg-info file/directory, you don't need to write
        a `version` like below::
        
        [locallibs]
        PIL = PIL
        
        But, if you omit a version for no-egg-info package, buildout.locallib can't
        recognize package version, then it'll cause DistributionNotFound exception.
        
        
        Requirements
        ------------
        
        * Python 2.4 or later
        
        
        Dependencies
        ------------
        
        * `setuptools <http://pypi.python.org/pypi/setuptools>`_ or
        `distribute <http://pypi.python.org/pypi/distribute>`_
        
        * `zc.buildout <http://pypi.python.org/pypi/zc.buildout>`_
        
        
        Setup
        -----
        
        Write buildout.cfg with `extensions = buildout.locallib`::
        
        [buildout]
        parts = foo
        extensions = buildout.locallib
        ...
        
        
        ToDo
        -----
        * Write tests.
        * cleanup develop-eggs folder functionality.
        
        
        History
        -------
        
        0.2.0 (2010-7-12)
        ~~~~~~~~~~~~~~~~~~
        * Add: create dummy '*.egg-info' / '*.egg-link' for specified packages.
        
        0.1.0 (2010-6-27)
        ~~~~~~~~~~~~~~~~~~
        * first release
        
        
Keywords: zc.buildout
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Python Software Foundation License
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Software Development :: Libraries :: Python Modules
