{"id":24863,"library":"zdaemon","title":"zdaemon","description":"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.","status":"active","version":"5.2.1","language":"python","source_language":"en","source_url":"https://github.com/zopefoundation/zdaemon","tags":["daemon","process control","zope","unix"],"install":[{"cmd":"pip install zdaemon","lang":"bash","label":"Default install"}],"dependencies":[{"reason":"Required at install time for entry points.","package":"setuptools","optional":false}],"imports":[{"note":"zdctl is a submodule; direct import fails in recent versions.","wrong":"import zdctl","symbol":"zdctl","correct":"from zdaemon import zdctl"},{"note":"zdrun is a submodule; direct import fails.","wrong":"import zdrun","symbol":"zdrun","correct":"from zdaemon import zdrun"}],"quickstart":{"code":"from zdaemon import zdctl\n# Show help for the zdctl command-line tool\nprint(zdctl.__file__)","lang":"python","description":"Basic import of the zdctl module to verify installation."},"warnings":[{"fix":"Update all imports to use the 'from zdaemon import ...' pattern.","message":"In version 5.0, the import paths changed. Top-level imports like 'import zdctl' no longer work. Use 'from zdaemon import zdctl'.","severity":"breaking","affected_versions":">=5.0"},{"fix":"Use 'zdaemon.zdctl' or 'zdaemon.zdrun' instead.","message":"The 'zdaemon.zdoptions' module is deprecated and may be removed in a future release.","severity":"deprecated","affected_versions":">=5.0"},{"fix":"Use: zdctl -C /path/to/zd.conf","message":"Running 'zdctl' without a proper configuration file will fail silently. Always specify a '--config' or '-C' option.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Use 'from zdaemon import zdctl'.","cause":"Attempting to import zdctl directly instead of from zdaemon.","error":"ModuleNotFoundError: No module named 'zdctl'"},{"fix":"Provide a valid subcommand, e.g., 'zdctl status' or 'zdctl -C config.conf start'.","cause":"Running zdctl without any subcommand or configuration.","error":"zdctl: error: too few arguments"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}