Metadata-Version: 1.0
Name: z3c.checkversions
Version: 0.3
Summary: Find newer package versions on PyPI
Home-page: http://pypi.python.org/pypi/z3c.checkversions
Author: Christophe Combelles and the Zope Community
Author-email: zope-dev@zope.org
License: ZPL 2.1
Description: Introduction
        ============
        
        Find newer versions of your installed Python packages, or newer versions of
        packages in a buildout file.
        
        This package provides a console script named ``checkversions``.
        
        Install
        =======
        
        you can install this package either in a virtualenv::
        
            $ virtualenv sandbox
            $ sandbox/bin/pip install z3c.checkversions
            $ sandbox/bin/checkversions --help
        
        or in your system::
        
            $ sudo pip install z3c.checkversions
            $ checkversions --help
        
        or in a buildout::
        
            [buildout]
            parts = checkversions
            
            [checkversions]
            recipe=zc.recipe.egg
            eggs=z3c.checkversions [buildout]
        
        Note that buildout support is optional and must be enabled with [buildout] so
        that zc.buildout is installed as well.
        
        Usage
        =====
        
        ::
        
            $ checkversions -h
            Usage: checkversions [-v] [-l LEVEL] [-i INDEX] [buildout_file]
            
            This script will check new package versions of either your current installed
            distributions or a buildout file if provided. It can detect major or minor
            versions availability: level 0 gets the highest version (X.y.z), level 1 gets
            the highest intermediate version (x.Y.z), level 2 gets the highest minor
            version (x.y.Z).  Using level 2, you can automatically retrieve all bugfix
            versions of a buildout.
            
            Options:
              -h, --help            show this help message and exit
              -l LEVEL, --level=LEVEL
                                    Version level to check
              -i INDEX, --index=INDEX
                                    Alternative package index URL
              -v, --verbose         Verbose mode (prints old versions too)
        
        
        Examples
        ========
        
        For installed packages
        ----------------------
        
        Example with a virtualenv::
        
            $ virtualenv --no-site-packages sandbox
            $ sandbox/bin/pip install z3c.checkversions
            $ sandbox/bin/checkversions -v -l 1
            # Checking your installed distributions
            pip=0.7.1 # was: 0.6.3
        
        For a buildout
        --------------
        
        It can work either with a full buildout.cfg or with a simple versions.cfg file.
        
        Here is a sample `versions.cfg` file::
        
            [versions]
            pip=0.6.3
        
        You can create a new versions.cfg with the output ::
        
            $ checkversions -v -l 1 versions.cfg
            # Checking buildout file versions.cfg
            pip=0.7.1 # was: 0.6.3
        
        
        
        
        Changelog
        =========
        
        0.3 (2010-07-09)
        ----------------
        
        - don't accumulate old comments
        - prefer final versions
        
        0.2 (2010-05-22)
        ----------------
        
        - added a verbose option to print old versions as well
        - updated metadata, doc and license
        
        0.1 (2010-05-16)
        ----------------
        
        - Initial release
        
Keywords: version,buildout,packages,upgrade,zope,ztk
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Zope Public License
Classifier: Programming Language :: Python
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Framework :: Zope2
Classifier: Framework :: Zope3
Classifier: Framework :: Buildout
