Pidfile featuring stale detection and file-locking, can also be used as context-manager or decorator
Project description
PidFile class featuring:
stale detection
pidfile locking (fcntl)
chmod (default is 0o644)
chown
custom exceptions
Context Manager
PidFile can be used as a context manager:
from pid import PidFile
import os
with PidFile('foo') as p:
print(p.pidname) # -> 'foo'
print(p.piddir) # -> '/var/run' But you can modify it when initialize PidFile.
print(os.listdir('/var/run')) # -> ['foo.pid']
# pid file will delete after 'with' literal.
Decorator
PidFile can also be used a a decorator:
from pid.decorator import pidfile @pidfile() def main(): pass if __name__ == "__main__": main()
Exception Order
In default mode PidFile will try to acquire a file lock before anything else. This means that normally you get a PidFileAlreadyLockedError instead of the PidFileAlreadyRunningError when running a program twice.
If you just want to know if a program is already running its easiest to catch just PidFileError since it will capture all possible PidFile exceptions.
Behaviour
Changes in version 2.0.0 and going forward:
pid is now friendly with daemon context managers such as python-daemon where the PidFile context manager is passed as a parameter. The new corrected behaviour will ensure the process environment is determined at the time of acquiring/checking the lock. Prior behaviour would determine the process environment when instancing the class which may result in incorrect determination of the PID in the case of a process forking after instancing PidFile.
Cleanup of pidfile on termination is done using atexit module. The default SIGTERM handler doesn’t cleanly exit and therefore the atexit registered functions will not execute. A custom handler which triggers the atexit registered functions for cleanup will override the default SIGTERM handler. If a prior signal handler has been configured, then it will not be overridden.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file pid-3.0.0.tar.gz.
File metadata
- Download URL: pid-3.0.0.tar.gz
- Upload date:
- Size: 13.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/46.0.0 requests-toolbelt/0.9.1 tqdm/4.43.0 CPython/3.7.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | f6d1a96d3c17395d646395bfc8cd43496e63a4acffffaa19553d2f520344b75d |
|
| MD5 | 5dfdc40f2b85c80a074c7801df139cbc |
|
| BLAKE2b-256 | 8b96b7de183804fae398b970e87ff27c882e431eba0c2fcc895877fc635742fd |
File details
Details for the file pid-3.0.0-py2.py3-none-any.whl.
File metadata
- Download URL: pid-3.0.0-py2.py3-none-any.whl
- Upload date:
- Size: 11.5 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/46.0.0 requests-toolbelt/0.9.1 tqdm/4.43.0 CPython/3.7.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 4737d23a054f0ff2250668d7c23c438c5afdda003f63e3c875937e012effa9d6 |
|
| MD5 | 6710108b837382ff7ab817699747911f |
|
| BLAKE2b-256 | affd943f2e011d3a71e4937063ac29981e97a6a5bf7c3998bc4731e16ba991fc |
