zdaemon

5.2.1 verified Fri May 01 auth: no python

zdaemon is a library and set of tools for controlling daemon processes on Unix-based systems. It provides a robust way to start, stop, and manage background processes, commonly used in Zope and Plone deployments. Current version is 5.2.1, released with a slow cadence.

pip install zdaemon

Common errors

error ModuleNotFoundError: No module named 'zdctl' ↓

cause Attempting to import zdctl directly instead of from zdaemon.

fix

Use 'from zdaemon import zdctl'.

error zdctl: error: too few arguments ↓

cause Running zdctl without any subcommand or configuration.

fix

Provide a valid subcommand, e.g., 'zdctl status' or 'zdctl -C config.conf start'.

Warnings

breaking In version 5.0, the import paths changed. Top-level imports like 'import zdctl' no longer work. Use 'from zdaemon import zdctl'. ↓

fix Update all imports to use the 'from zdaemon import ...' pattern.

deprecated The 'zdaemon.zdoptions' module is deprecated and may be removed in a future release. ↓

fix Use 'zdaemon.zdctl' or 'zdaemon.zdrun' instead.

gotcha Running 'zdctl' without a proper configuration file will fail silently. Always specify a '--config' or '-C' option. ↓

fix Use: zdctl -C /path/to/zd.conf

Imports

zdctl
wrong
```
import zdctl
```
correct
```
from zdaemon import zdctl
```
zdctl is a submodule; direct import fails in recent versions.
zdrun
wrong
```
import zdrun
```
correct
```
from zdaemon import zdrun
```
zdrun is a submodule; direct import fails.

Quickstart

Basic import of the zdctl module to verify installation.

from zdaemon import zdctl
# Show help for the zdctl command-line tool
print(zdctl.__file__)