zdaemon

library5.2.1pypypi✓ verified 83d ago

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.

devops

pip install zdaemon

github ↗package ↗

INSTALL

IMPORT

SIG · ZDAEMON

zdaemon

devopspythonv5.2.1

Install

1.7s avg

Import

181ms

Disk

18MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v5.2.1 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.190s · 19.4MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 1.7s · import 0.172s · 20MB

18MB installed

● package 18MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

zdctl

✓ from zdaemon import zdctl

✗ import zdctl

zdctl is a submodule; direct import fails in recent versions.

zdrun

✓ from zdaemon import zdrun

✗ import zdrun

zdrun is a submodule; direct import fails.

Basic import of the zdctl module to verify installation.

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

zdaemon --version

Debug

Known issues

breakingIn 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.

affects: >=5.0

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

fix

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

affects: >=5.0

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

fix

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

affects: all

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'zdctl'

Attempting to import zdctl directly instead of from zdaemon.

fix

Use 'from zdaemon import zdctl'.

zdctl: error: too few arguments

Running zdctl without any subcommand or configuration.

fix

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

Upgrade

Version history

5.2.1latest on PyPI · released Jul 23, 2025

Audit

Dependencies

setuptoolsrequiredRequired at install time for entry points.

Agent activity

33 hits · last 30 days

node

Resources

githubhttps://github.com/zopefoundation/zdaemon ↗

packagehttps://pypi.org/project/zdaemon/ ↗