etcd-py

A python client to etcd (https://github.com/coreos/etcd)

Installation

etcd-py has a single dependency: https://github.com/kennethreitz/requests

# pip install etcd-py requests

Getting Started

Set, Get, Delete

>>> import etcd
>>> e = etcd.Etcd()
>>> e.set("message", "Hello, World!")
set(index=48, newKey=True, prevValue=None, expiration=None)
>>> e.get("message")
get(index=48, value=u'Hello, World!')
>>> e.delete("message")
delete(index=49, prevValue=u'Hello, World!')

Setting a key with a TTL of 3 seconds and watching it with an optional timeout of 5 seconds

>>> set("message", "HELLO WORLD!!", 3)
set(index=35, newKey=True, prevValue=None, expiration=u'2013-09-05T05:57:33.922332303Z')
>>> print e.watch("message", timeout=5)
watch(action=u'DELETE', value=None, key=u'/message', index=35, newKey=False)

Test and set

>>> e.testandset("message", "hello world", "goodbye world")
testandset(index=37, key=u'/message', prevValue=u'hello world', expiration=None)

Servers

>>> e.machines()
[u'https://127.0.0.1:4001']
>>> e.leader()
http://127.0.0.1:7001

Client certificates

>>> e = etcd.Etcd(ssl_cert="mycert.pem")
or
>>> e = etcd.Etcd(ssl_cert="my.crt", ssl_key="my.key")

List keys in a path:

>>> e.set("path/message1", 1)
EtcdSet(index=48, newKey=True, prevValue=None, expiration=None)
>>> e.set("path/message2", 2)
EtcdSet(index=49, newKey=True, prevValue=None, expiration=None)
>>> for key in e.list("path"):
...     print key
EtcdList(key=u'path/message1', index=49, value=u'1', dir=False)
EtcdList(key=u'path/message2', index=49, value=u'2', dir=False)

Get recursive:

>>> e.set("path/another/message", "three")
EtcdSet(index=50, newKey=True, prevValue=None, expiration=None)
>>> e.get_recursive("path")
{u'path/message2': u'2', u'path/message1': u'1', u'path/another/message': u'three'}

TODO

See issues reported on Github.

Author

etcd-py is developed and maintained by Kris Foster (kris.foster@gmail.com). All contributors can be found here: https://github.com/transitorykris/etcd-py/graphs/contributors