supervisord-dependent-startup

What it is and what it does

supervisord-dependent-startup is an event listener plugin for Supervisor that solves the problem of coordinating service startup order when services have dependencies on one another. Supervisor's built-in priority system does not guarantee that a service waits for its dependencies to reach a running state before starting; this plugin fills that gap by listening to process state events and delaying dependent service startup until their prerequisites have reached the states you specify.

You configure it by adding an eventlistener block to your supervisor.conf and then marking services with dependency metadata. A service can declare which other services it depends on and what states those services must reach (running, exited, etc.) before it should start. The plugin does not start service groups directly, only individual services within groups.

Use it for:

• Ensure a database service is fully running before starting application servers that depend on it.
• Delay starting a web application until initialization scripts have completed and exited cleanly.
• Coordinate startup of microservices where later services depend on earlier ones reaching a stable state.
• Manage multi-stage startup sequences where some services must exit (not just run) before others begin.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

A Supervisor plugin that orchestrates service startup by waiting for dependent services to reach specified states before starting downstream services.

No. The package is abandoned (last release 2019-10-09) and targets Python 2.7 and early Python 3 versions. While it solves a real Supervisor coordination problem and has no known vulnerabilities, the lack of maintenance and uncertain compatibility with modern Python versions make it a risky choice for new projects. Consider whether your Supervisor version and Python environment align with its constraints, or evaluate alternatives.

Install

supervisord-dependent-startup on PyPI

pip install supervisord-dependent-startup

uv add supervisord-dependent-startup

poetry add supervisord-dependent-startup

Installing supervisord-dependent-startup

Before you install

Installation is straightforward with no runtime dependencies. However, the package is abandoned—last release was 2019-10-09, over six years ago. It targets Python 2.7 and early Python 3 versions (3.4–3.7), so compatibility with modern Python may be uncertain.

License in practice

Licensed under Apache Software License v2, a permissive license. You can use, modify, and distribute the package freely, including in commercial projects, provided you include a copy of the license and state any changes.

Quickstart

pip install supervisord-dependent-startup

Then add to supervisor.conf:
[eventlistener:dependentstartup]
command=python -m supervisord_dependent_startup
autostart=true
autorestart=unexpected
startretries=0
exitcodes=0,3
events=PROCESS_STATE

Configure service dependencies:
[program:child]
dependent_startup=true
autostart=false
dependent_startup_wait_for=parent:running

Requires Supervisor to be installed and running; the plugin runs as an event listener within Supervisor's process model.

Verify before relying

• Whether the plugin functions correctly with modern Python versions (3.8+) despite classifiers only listing up to 3.7.
• Current compatibility with recent Supervisor releases and whether any breaking changes have occurred since 2019.

Package facts

Evidence: supervisord_dependent_startup-1.4.0-py2.py3-none-any.whl

Tags

More Boot packages