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:
import etcd3 etcd = etcd3.client() etcd.get('foo') etcd.put('bar', 'doot') etcd.delete('bar') # locks lock = etcd.lock('thing') lock.acquire() # 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) # recieve watch events for a prefix via callback function def watch_callback(event): print(event) watch_id = etcd.add_watch_prefix_callback("/doot/watch/prefix/", watch_callback) # cancel watch etcd.cancel_watch(watch_id)