Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

A distributed lock recipe for etcd

Project Description
## Python Lock library for ETCD 2.0

Since ETCD 0.4, all [the built in modules were removed](, including the locking module. The API still provides an atomic compare-and-swap method to implement locking, thus providing the core functionality to create semaphores and mutexes. This library is built on top of that, matching the API that was in [python-etcd]( before it was removed as much as possible.

[![Circle CI](](

#### Simple Usage

import etcd
from etcdlock import Lock

lock = Lock(etcd.Client(), 'path/to/my/key')
while lock
# lock is acquired
# lock will renew itself by default until released
# do work
request = ....

# check if we still have the lock
if lock.is_locked() is False:

#### Explicit Usage

import etcd
from etcdlock import Lock

client = client = etcd.Client(host='', protocol='https', port=443, version_prefix='/etcd')
lock = Lock(client, 'path/to/my/key', ttl=30, renewSecondsPrior=)
if lock.acquire(timeout=20):
t = Thread(target=someheavywork)
# some other work
lock.release() # not recommended, use a context manager
# failed to acquire the lock in 20 seconds

Please see [the tests]( while the documentation is lacking, thanks.
Release History

Release History

This version
History Node


History Node


History Node


History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
python_etcd_lock-0.0.4-py2.7.egg (6.2 kB) Copy SHA256 Checksum SHA256 2.7 Egg Jun 24, 2015
python-etcd-lock-0.0.4.tar.gz (3.7 kB) Copy SHA256 Checksum SHA256 Source Jun 24, 2015

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting