您如何按照文档规定的方式使用 python-daemon?

How do you use python-daemon the way that it's documentation dictates?

我正在尝试在 python 中创建一个守护程序,我遇到了 python-守护程序包。有趣的是,我见过它使用的最常见的方式甚至不是documentation,非常稀疏,告诉你做什么

import os
import grp
import signal
import daemon
import lockfile

from spam import (
    initial_program_setup,
    do_main_program,
    program_cleanup,
    reload_program_config,
    )

context = daemon.DaemonContext(
    working_directory='/var/lib/foo',
    umask=0o002,
    pidfile=lockfile.FileLock('/var/run/spam.pid'),
    )

context.signal_map = {
    signal.SIGTERM: program_cleanup,
    signal.SIGHUP: 'terminate',
    signal.SIGUSR1: reload_program_config,
    }

mail_gid = grp.getgrnam('mail').gr_gid
context.gid = mail_gid

important_file = open('spam.data', 'w')
interesting_file = open('eggs.data', 'w')
context.files_preserve = [important_file, interesting_file]

initial_program_setup()

with context:
    do_main_program()

相反,人们是这样使用它的:

#!/usr/bin/python
import time
from daemon import runner

class App():
    def __init__(self):
        self.stdin_path = '/dev/null'
        self.stdout_path = '/dev/tty'
        self.stderr_path = '/dev/tty'
        self.pidfile_path =  '/tmp/foo.pid'
        self.pidfile_timeout = 5
    def run(self):
        while True:
            print("Howdy!  Gig'em!  Whoop!")
            time.sleep(10)

app = App()
daemon_runner = runner.DaemonRunner(app)
daemon_runner.do_action()

例子here and in this thread How do you create a daemon in Python?

所以谁能告诉我这个包应该如何按预期使用?找到 0 个按照文档指定的方式使用它的示例。

首先,您找不到好的文档的原因是,据我所知,从来没有人写过它。当 Ben Finney 提出 PEP 时,引起了很多兴趣,但是当他要求其他人接管该项目并支持它时,没有人这样做,所以......除了 PEP 之外,还有项目文档目录中的稀疏文档, 真的只有出处才能解释。

A DaemonContext 是您创建守护程序的方式。它的 API 被广泛使用,并且是唯一被提议成为 stdlib 中 public 接口的一部分。来自 Debian、Ubuntu 和 RedHat/Fedora 项目的人员参与了最初的讨论,并且根据他们将发行版转移到 systemd.

的经验进行了更改。

A DaemonRunner 包含一个基于 DaemonContext 的守护进程和一个控制工具(ala apachectl)。这实现了一个“服务”,这只是 运行 守护进程在许多其他不同方式中的一种方式。

通常,你不希望这样——如果你想构建一个 "service",你通常只想使用 daemon.DaemonContext 实现守护进程,让 systemdlaunchd 或他们的前任通过调用该守护进程来管理服务。因此,为了简单起见,PEP 明确表示服务超出了 daemon 模块应该尝试的范围。

但是 python-daemon 发行版中有服务代码。它没有完整的文档,因为它只是使用守护进程的一种方式的示例。

它看起来确实有效,而且多年来一直在维护和更新。所以,如果你想要一个 apachectl 类型的工具,我认为使用 DaemonRunner 是有意义的;只需确保您阅读了文档字符串并编写了一些测试以确保它正在执行您想要的操作。

一样,python-daemon 文档旨在展示如何编写守护进程:一个从控制终端中分离出来并且没有父进程的程序 运行 s 在后台。

python-daemon 代码没有规定如何在服务中使用该守护程序。要实施该服务,您需要 运行 该守护程序systemdinitupstartlaunchd都能胜任。

作为一个(未记录的)示例,python-daemon 代码库包含一个简单示例 运行ner。它不是编写守护进程的一部分,并且存在更好的工具。

使用 daemon.daemon API 编写守护程序,并 运行 使用操作系统附带的 运行ner 编写守护程序。