Metadata-Version: 1.1
Name: etcd3
Version: 0.8.1
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-Content-Type: UNKNOWN
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, supported under python 2.7, 3.4 and 3.5.
        
        **Warning: the API is mostly stable, but may change in the future**
        
        If you're interested in using this library, please get involved.
        
        * Free software: Apache Software License 2.0
        * Documentation: https://python-etcd3.readthedocs.io.
        
        Basic usage:
        
        .. code-block:: python
        
            import etcd3
        
            etcd = etcd3.client()
        
            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
        
            # 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'),
                ]
            )
        
            # watch key
            watch_count = 0
            events_iterator, cancel = etcd.watch("/doot/watch")
            for event in events_iterator:
                print(event)
                watch_count += 1
                if watch_count > 10:
                    cancel()
        
            # watch prefix
            watch_count = 0
            events_iterator, cancel = etcd.watch_prefix("/doot/watch/prefix/")
            for event in events_iterator:
                print(event)
                watch_count += 1
                if watch_count > 10:
                    cancel()
        
            # recieve watch events via callback function
            def watch_callback(event):
                print(event)
        
            watch_id = etcd.add_watch_callback("/anotherkey", watch_callback)
        
            # cancel watch
            etcd.cancel_watch(watch_id)
        
        
        =======
        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
Classifier: Programming Language :: Python :: 3.6
