Metadata-Version: 1.1
Name: pur
Version: 5.2.2
Summary: Update packages in a requirements.txt file to latest versions.
Home-page: https://github.com/alanhamlett/pip-update-requirements
Author: Alan Hamlett
Author-email: alan.hamlett@gmail.com
License: BSD
Description: .. image:: https://travis-ci.org/alanhamlett/pip-update-requirements.svg?branch=master
            :target: https://travis-ci.org/alanhamlett/pip-update-requirements
            :alt: Tests
        
        .. image:: https://coveralls.io/repos/alanhamlett/pip-update-requirements/badge.svg?branch=master&service=github
            :target: https://coveralls.io/github/alanhamlett/pip-update-requirements?branch=master
            :alt: Coverage
        
        .. image:: https://img.shields.io/pypi/v/pur.svg
            :target: https://pypi.python.org/pypi/pur
            :alt: Version
        
        .. image:: https://img.shields.io/pypi/pyversions/pur.svg
            :target: https://pypi.python.org/pypi/pur
            :alt: Supported Python Versions
        
        
        pip-update-requirements
        =======================
        
        Update the packages in a ``requirements.txt`` file.
        
        .. image:: https://raw.githubusercontent.com/alanhamlett/pip-update-requirements/master/pur.gif
            :alt: Purring Cat
        
        
        Installation
        ------------
        
        ::
        
            pip install pur
        
        
        Usage
        -----
        
        Give pur your ``requirements.txt`` file and it updates all your packages to
        the latest versions.
        
        For example, given a ``requirements.txt`` file::
        
            flask==0.9
            sqlalchemy==0.9.10
            alembic==0.8.4
        
        Running pur on that file updates the packages to current latest versions::
        
            $ pur -r requirements.txt
            Updated flask: 0.9 -> 1.0.2
            Updated sqlalchemy: 0.9.10 -> 1.2.8
            Updated alembic: 0.8.4 -> 0.9.9
            All requirements up-to-date.
        
        
        Pur never modifies your environment or installed packages, it only modifies
        your ``requirements.txt`` file.
        
        You can also use Pur directly from Python::
        
            $ python
            Python 3.6.1
            >>> from pur import update_requirements
            >>> print([x[0]['message'] for x in update_requirements(input_file='requirements.txt').values()])
            ['Updated flask: 0.9 -> 1.0.2', 'Updated sqlalchemy: 0.9.10 -> 1.2.8', 'Updated alembic: 0.8.4 -> 0.9.9']
            >>> print(open('requirements.txt').read())
            flask==1.0.2
            sqlalchemy==1.2.8
            alembic==0.9.9
        
        
        Options
        -------
        
        -r, --requirement PATH   The requirements.txt file to update; Defaults to
                                 using requirements.txt from the current directory
                                 if it exist.
        -o, --output PATH        Output updated packages to this file; Defaults to
                                 overwriting the input requirements.txt file.
        -i, --interactive        Interactively prompts before updating each package.
        -f, --force              Force updating packages even when a package has no
                                 version specified in the input requirements.txt
                                 file.
        -d, --dry-run            Output changes to STDOUT instead of overwriting the
                                 requirements.txt file.
        -n, --no-recursive       Prevents updating nested requirements files.
        -s, --skip TEXT          Comma separated list of packages to skip updating.
        --only TEXT              Comma separated list of packages. Only these
                                 packages will be updated.
        -m, --minor TEXT         Comma separated list of packages to only update
                                 minor versions, never major. Use "*" to limit every
                                 package to minor version updates.
        -p, --patch TEXT         Comma separated list of packages to only update
                                 patch versions, never major or minor. Use "*" to
                                 limit every package to patch version updates.
        --pre TEXT               Comma separated list of packages to allow updating
                                 to pre-release versions. Use "*" to allow all
                                 packages to be updated to pre-release versions. By
                                 default packages are only updated to stable
                                 versions.
        -z, --nonzero-exit-code  Exit with status l0 when all packages up-to-date,
                                 11 when some packages were updated. Defaults to
                                 exit status zero on success and non-zero on
                                 failure.
        --version                Show the version and exit.
        --help                   Show this message and exit.
        
        
        Contributing
        ------------
        
        Before contributing a pull request, make sure tests pass::
        
            virtualenv venv
            . venv/bin/activate
            pip install tox
            tox
        
        Many thanks to all `contributors <https://github.com/alanhamlett/pip-update-requirements/blob/master/AUTHORS>`_!
        
Platform: any
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Software Development :: Build Tools
