Skip to main content

Pidfile featuring stale detection and file-locking, can also be used as context-manager or decorator

Project description

https://travis-ci.org/trbs/pid.svg?branch=master https://coveralls.io/repos/trbs/pid/badge.png Latest PyPI version Number of PyPI downloads

PidFile class featuring:

  • stale detection

  • pidfile locking (fcntl)

  • chmod (default is 0o644)

  • chown

  • custom exceptions

Context Manager, Daemons and Logging

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.

Logging to file is also possible when using PidFile with a daemon context manager (e.g. python-daemon). This requires some care in handling the open files when the daemon starts to avoid closing them, which causes problems with the logging. In particular, the open handlers should be preserved:

import sys
import logging
import logging.config

import daemon
from pid impor PidFile

logging.config.fileConfig(fname="logging.conf", disable_existing_loggers=False)
log = logging.getLogger(__name__)

PIDNAME = "/tmp/mydaemon.pid"

def get_logging_handles(logger):
    handles = []
    for handler in logger.handlers:
        handles.append(handler.stream.fileno())
    if logger.parent:
        handles += get_logging_handles(logger.parent)
    return handles

def daemonize():
  file_preserve = get_logging_handles(logging.root)
  pid_file = PidFile(pidname=PIDNAME)

  with daemon.DaemonContext(stdout=sys.stdout,
                            stderr=sys.stderr,
                            stdin=sys.stdin,
                            pidfile=_pid_file,
                            files_preserve=files_preserve):

    run_daemon_job()
  print("DONE!")

if __name__ == "__main__":
  daemonize()

This assumes a logging.conf file has been created, see e.g. basic tutorial for logging.

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.

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

pid-3.0.4.tar.gz (16.2 kB view details)

Uploaded Source

Built Distribution

pid-3.0.4-py2.py3-none-any.whl (12.0 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file pid-3.0.4.tar.gz.

File metadata

  • Download URL: pid-3.0.4.tar.gz
  • Upload date:
  • Size: 16.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.2.0 requests-toolbelt/0.9.1 tqdm/4.47.0 CPython/3.8.3

File hashes

Hashes for pid-3.0.4.tar.gz
Algorithm Hash digest
SHA256 0e33670e83f6a33ebb0822e43a609c3247178d4a375ff50a4689e266d853eb66
MD5 af607e6e2a51129e3fef516b7994c85b
BLAKE2b-256 46459e551a0e30d68d18334bc6fd8971b3ab1485423877902eb4f26cc28d7bd5

See more details on using hashes here.

File details

Details for the file pid-3.0.4-py2.py3-none-any.whl.

File metadata

  • Download URL: pid-3.0.4-py2.py3-none-any.whl
  • Upload date:
  • Size: 12.0 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.2.0 requests-toolbelt/0.9.1 tqdm/4.47.0 CPython/3.8.3

File hashes

Hashes for pid-3.0.4-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 af2bf11c5d637bba8a80ce3368279c5eca28f08e201ac828538e1b9ad9e35ef9
MD5 4f60a922260748e5e414394f7af297cf
BLAKE2b-256 e0307ebdc66dff1611756d4b38340effdb470aa2693c8789a8fef0bd8dd9332a

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