py-filelock
This package contains a single module, which implements a platform independent file lock in Python, which provides a simple way of inter-process communication:
from filelock import Timeout, FileLock
lock = FileLock("high_ground.txt.lock")
with lock:
open("high_ground.txt", "a").write("You were the chosen one.")
Don't use a FileLock to lock the file you want to write to, instead create a separate .lock file as shown above.
Similar libraries
Perhaps you are looking for something like
- https://pypi.python.org/pypi/pid/2.1.1
- https://docs.python.org/3.6/library/msvcrt.html#msvcrt.locking
- or https://docs.python.org/3/library/fcntl.html#fcntl.flock
Installation
py-filelock is available via PyPi:
$ pip3 install filelock
Documentation
The documentation for the API is available on readthedocs.org.
Examples
A FileLock is used to indicate another process of your application that a resource or working directory is currently used. To do so, create a FileLock first:
from filelock import Timeout, FileLock
file_path = "high_ground.txt"
lock_path = "high_ground.txt.lock"
lock = FileLock(lock_path, timeout=1)
The lock object supports multiple ways for acquiring the lock, including the ones used to acquire standard Python thread locks:
with lock:
open(file_path, "a").write("Hello there!")
lock.acquire()
try:
open(file_path, "a").write("General Kenobi!")
finally:
lock.release()
The acquire() method accepts also a timeout parameter. If the lock cannot be acquired within timeout seconds, a Timeout exception is raised:
try:
with lock.acquire(timeout=10):
open(file_path, "a").write("I have a bad feeling about this.")
except Timeout:
print("Another instance of this application currently holds the lock.")
The lock objects are recursive locks, which means that once acquired, they will not block on successive lock requests:
def cite1():
with lock:
open(file_path, "a").write("I hate it when he does that.")
def cite2():
with lock:
open(file_path, "a").write("You don't want to sell me death sticks.")
# The lock is acquired here.
with lock:
cite1()
cite2()
# And released here.
FileLock vs SoftFileLock
The FileLock is platform dependent while the SoftFileLock is not. Use the FileLock if all instances of your application are running on the same host and a SoftFileLock otherwise.
The SoftFileLock only watches the existence of the lock file. This makes it ultra portable, but also more prone to dead locks if the application crashes. You can simply delete the lock file in such cases.
Contributions
Contributions are always welcome, please make sure they pass all tests before creating a pull request. Never hesitate to open a new issue, although it may take some time for me to respond.
License
This package is public domain.
2 maintainers
Metadata
2 maintainers
Release files for filelock 3.0.12
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| filelock-3.0.12.tar.gz | 8.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| filelock-3.0.12-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 16.1 kB
Release files / filelock-3.0.12.tar.gz
| Download URL | filelock-3.0.12.tar.gz |
|---|---|
| Size | 8.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
18d82244ee114f543149c66a6e0c14e9c4f8a1044b5cdaadd0f82159d6a6ff59
|
|
BLAKE2b-256 checksum How to use checksums |
14ec6ee2168387ce0154632f856d5cc5592328e9cf93127c5c9aeca92c8c16cb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.7.3rc1
|
Release files / filelock-3.0.12-py3-none-any.whl
| Download URL | filelock-3.0.12-py3-none-any.whl |
|---|---|
| Size | 7.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
929b7d63ec5b7d6b71b0fa5ac14e030b3f70b75747cef1b10da9b879fef15836
|
|
BLAKE2b-256 checksum How to use checksums |
938371a2ee6158bb9f39a90c0dea1637f81d5eef866e188e1971a1b1ab01a35a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.7.3rc1
|
