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:
importetcd3etcd=etcd3.client()
etcd.get('foo')
etcd.put('bar', 'doot')
etcd.delete('bar')
# lockslock=etcd.lock('thing')
# do somethinglock.release()
withetcd.lock('doot-machine') aslock:
# do something# transactionsetcd.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 keywatch_count=0events_iterator, cancel=etcd.watch("/doot/watch")
foreventinevents_iterator:
print(event)
watch_count+=1ifwatch_count>10:
cancel()
# watch prefixwatch_count=0events_iterator, cancel=etcd.watch_prefix("/doot/watch/prefix/")
foreventinevents_iterator:
print(event)
watch_count+=1ifwatch_count>10:
cancel()
# recieve watch events via callback functiondefwatch_callback(event):
print(event)
watch_id=etcd.add_watch_callback("/anotherkey", watch_callback)
# cancel watchetcd.cancel_watch(watch_id)