Skip to main content

File-based locks for Python for Linux and Windows

Project description

Locket implements a lock that can be used by multiple processes provided they use the same path.

import locket

# Wait for lock
with locket.lock_file("path/to/lock/file"):
    perform_action()

# Raise error if lock cannot be acquired immediately
with locket.lock_file("path/to/lock/file", timeout=0):
    perform_action()

# Raise error if lock cannot be acquired after thirty seconds
with locket.lock_file("path/to/lock/file", timeout=30):
    perform_action()

# Without context managers:
lock = locket.lock_file("path/to/lock/file")
try:
    lock.acquire()
    perform_action()
finally:
    lock.release()

Locks largely behave as (non-reentrant) Lock instances from the threading module in the standard library. Specifically, their behaviour is:

  • Locks are uniquely identified by the file being locked, both in the same process and across different processes.

  • Locks are either in a locked or unlocked state.

  • When the lock is unlocked, calling acquire() returns immediately and changes the lock state to locked.

  • When the lock is locked, calling acquire() will block until the lock state changes to unlocked, or until the timeout expires.

  • If a process holds a lock, any thread in that process can call release() to change the state to unlocked.

  • Behaviour of locks after fork is undefined.

Project details


Download files

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

Source Distribution

locket-0.2.0.tar.gz (3.5 kB view details)

Uploaded Source

File details

Details for the file locket-0.2.0.tar.gz.

File metadata

  • Download URL: locket-0.2.0.tar.gz
  • Upload date:
  • Size: 3.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for locket-0.2.0.tar.gz
Algorithm Hash digest
SHA256 1fee63c1153db602b50154684f5725564e63a0f6d09366a1cb13dffcec179fb4
MD5 fe870949c513d8f7079ba352463833ca
BLAKE2b-256 d0223c0f97614e0be8386542facb3a7dcfc2584f7b83608c02333bced641281c

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page