Metadata-Version: 1.1
Name: devpi-plumber
Version: 0.4.2
Summary: Mario, the devpi-plumber, helps to automate and test large devpi installations.
Home-page: https://github.com/blue-yonder/devpi-plumber
Author: Stephan Erb
Author-email: stephan.erb@blue-yonder.com
License: new BSD
Description: =======================
        Mario the Devpi Plumber
        =======================
        
        .. image:: https://travis-ci.org/blue-yonder/devpi-plumber.svg?branch=master
            :alt: Build Status
            :target: https://travis-ci.org/blue-yonder/devpi-plumber 
        .. image:: https://coveralls.io/repos/blue-yonder/devpi-plumber/badge.svg?branch=master
            :alt: Coverage Status
            :target: https://coveralls.io/r/blue-yonder/devpi-plumber?branch=master
        .. image:: https://badge.fury.io/py/devpi-plumber.svg
            :alt: Latest Version
            :target: https://pypi.python.org/pypi/devpi-plumber
        .. image:: https://requires.io/github/blue-yonder/devpi-plumber/requirements.svg?branch=master
            :alt: Requirements Status
            :target: https://requires.io/github/blue-yonder/devpi-plumber/requirements/?branch=master
        
        Mario, the devpi-plumber, helps to automate and test large devpi_ installations. It offers a simple python commandline wrapper
        around the devpi client binary and utilities for using devpi in a test harness. To get access to the latter, install Mario
        with the extra ``test`` requirement::
        
            pip install devpi-plumber[test]
        
        
        Mario by Example:
        =================
        
        Among others, it can be used to automate the upload of packages:
        
        .. code:: python
        
            with DevpiClient('https://devpi.company.com', 'user', 'secret') as devpi:
                devpi.use('user/testindex')
                devpi.upload('path/to/package-1.0.tar.gz')
        
        To make it easier to perform modifications on non-volatile indices, there is a context manager that temporarily toggles the volatile flag.
        
        .. code:: python
        
            with volatile_index(devpi, 'user/prodindex'):
                devpi.remove('broken_package==0.1.0')
        
        In order to simplify the testing of such plumbing scripts, it ships with a simple context manager for starting and stopping devpi servers in tests.
        
        .. code:: python
        
            def do_maintenance(devpi):
                """ My plumbing script """
                devpi.use('user/testindex')
                # ...
        
            users = { 
                'user': {'password': 'secret'},
            }
            indices = {
                'user/prodindex': {},
                'user/testindex': {'bases': 'user/prodindex'},
            }
            with TestServer(users, indices) as devpi:
                do_maintenance(devpi)
        
        
        License
        =======
        
        `New BSD`_
        
        
        .. _devpi: http://doc.devpi.net/latest/
        .. _New BSD: https://github.com/blue-yonder/devpi-builder/blob/master/COPYING
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: BSD License
Classifier: Topic :: System :: Archiving :: Packaging
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
