Metadata-Version: 1.1
Name: etcd3
Version: 0.2.2
Summary: Python client for the etcd3 API
Home-page: https://github.com/kragniz/python-etcd3
Author: Louis Taylor
Author-email: louis@kragniz.eu
License: Apache Software License 2.0
Description: ============
        python-etcd3
        ============
        
        
        .. image:: https://img.shields.io/pypi/v/etcd3.svg
                :target: https://pypi.python.org/pypi/etcd3
        
        .. image:: https://img.shields.io/travis/kragniz/python-etcd3.svg
                :target: https://travis-ci.org/kragniz/python-etcd3
        
        .. image:: https://readthedocs.org/projects/python-etcd3/badge/?version=latest
                :target: https://python-etcd3.readthedocs.io/en/latest/?badge=latest
                :alt: Documentation Status
        
        .. image:: https://pyup.io/repos/github/kragniz/python-etcd3/shield.svg
             :target: https://pyup.io/repos/github/kragniz/python-etcd3/
             :alt: Updates
        
        .. image:: https://codecov.io/github/kragniz/python-etcd3/coverage.svg?branch=master
                :target: https://codecov.io/github/kragniz/python-etcd3?branch=master
        
        
        Python client for the etcd API v3.
        
        **Warning: this is a work in progress, many basic features do not have a stable
        API.**
        
        If you're interested in using this library, please get involved.
        
        * Free software: Apache Software License 2.0
        * Documentation: https://python-etcd3.readthedocs.io.
        
        This project is developed using Readme Driven Development, the most hip
        development methodology.
        
        Fictitious example of api usage:
        
        .. code-block:: python
        
            import etcd3
        
            etcd = etcd3.client()
            # or
            etcd = etcd3.client(username='root',
                                password='hunter2',
                                host='127.0.0.1',
                                port=1234)
        
            etcd.get('foo')
            etcd.put('bar', 'doot')
            etcd.delete('bar')
        
            # locks
            lock = etcd.lock('thing')
            # do something
            lock.release()
        
            with etcd.lock('doot-machine') as lock:
                # do something
        
            # watching
            for event in etcd.watch('some-key'):
                print(event)
        
            # transactions
            etcd.transaction(
                compare=[
                    etcd.transactions.value('/doot/testing') == 'doot',
                    etcd.transactions.version('/doot/testing') > 0,
                ],
                success=[
                    etcd.transactions.put('/doot/testing', 'success'),
                ],
                failure=[
                    etcd.transactions.put('/doot/testing', 'failure'),
                ]
            )
        
            # admin stuff
            member_id = etcd.add_member('newMember', peer_urls=['https://127.0.0.1:12345'])
            etcd.update_member(member_id, peer_urls=['https://127.0.0.1:12345'])
            etcd.remove_member(member_id)
            for member in etcd.members:
                print(member.id, member.name, member.peer_addresses)
                member.remove()
        
        
        Generating protobuf stuff
        -------------------------
        
        I ran::
        
            python -m grpc.tools.protoc -Ietcd3/proto --python_out=etcd3/etcdrpc/ --grpc_python_out=etcd3/etcdrpc/ etcd3/proto/*.proto
        
        from inside the python-etcd3 repo and it did stuff. Not sure if it did the
        correct stuff, but it output some python.
        
        
        =======
        History
        =======
        
        0.1.0 (2016-09-30)
        ------------------
        
        * First release on PyPI.
        
Keywords: etcd3
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Natural Language :: English
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
