Install & Compatibility
Where this runs
No compatibility data collected yet for this library.
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
ArbiterHandler
✓ from circus import ArbiterHandler
✗ from kantoku.circus import ArbiterHandler
get_arbiter
✓ from circus import get_arbiter
✗ from kantoku.circus import get_arbiter
Create a simple watcher and start the arbiter. Replace cmd with your own command.
from kantoku import Arbiter, Watcher
watcher = Watcher(
name="my_app",
cmd="python -m http.server 8000",
numprocesses=1,
)
arbiter = Arbiter(
watchers=[watcher],
)
arbiter.start()
kantoku --version
Debug
Known issues
breakingIn version 0.18.0, the arbitter's quit_on_failure behavior changed to quit when any watcher fails. Previous versions allowed continued operation.fixUpgrade to >=0.18.2 or set `quit_on_failure=False` on the Arbiter.
affects: >=0.18.0,<0.18.2
gotchaWatcher commands are run as shell commands (via subprocess). Ensure proper quoting and escaping to avoid injection or argument parsing issues.fixUse lists or shlex.quote() for commands with arguments, e.g., cmd=['python', '-m', 'http.server', '8000'] instead of a string.
affects: all
Upgrade
Version history
0.18.3latest on PyPI · released Mar 11, 2025
Audit
Dependencies
circusrequiredCore dependency for process management