Skip to main content

A small collection of supervisor event listeners.

Project description

# Supervisor Event Listeners
A small collection of supervisor event listeners that weren't available in the awesome [superlance](https://github.com/Supervisor/superlance).

## fseventwatcher
```shell
$ fseventwatcher --help
usage: fseventwatcher [-h] [-p [PROGRAM [PROGRAM ...]]] [-a] -f PATH
[PATH ...] [-r]
[--watched-events [{moved,created,deleted,modified} [{moved,created,deleted,modified} ...]]]
[--dither DITHER_MAX]

Supervisor TICK event listener which restarts processes if file system changes
occur between ticks.

optional arguments:
-h, --help show this help message and exit
-p [PROGRAM [PROGRAM ...]], --programs [PROGRAM [PROGRAM ...]]
Supervisor process name/s to be restarted if in
RUNNING state.
-a, --any-program Restart any supervisor processes in RUNNING state.
-f PATH [PATH ...], --paths PATH [PATH ...]
Path to watch for file system events.
-r, --recursive Watch path/s recursively.
--watched-events [{moved,created,deleted,modified} [{moved,created,deleted,modified} ...]]
Specify which file system events to watch, by default
all events will be watched.
--dither DITHER_MAX Add dither before restarting processes. Specify
maximum time to dither in seconds.
```

## eventexec
```shell
$ eventexec --help
usage: eventexec [-h] -e COMMAND [-p [PROGRAM [PROGRAM ...]]] [-a]
[--dither DITHER_MAX]

Supervisor event listener which executes a command when events are received
and optionally restarts processes on non-zero exit status.

optional arguments:
-h, --help show this help message and exit
-e COMMAND, --execute COMMAND
Command or script to execute on supervisor events.
-p [PROGRAM [PROGRAM ...]], --restart-programs [PROGRAM [PROGRAM ...]]
Supervisor process name/s to be restarted on non-zero
exit status if in RUNNING state.
-a, --restart-any-program
Restart any supervisor processes in RUNNING state on
non-zero exit status.
--dither DITHER_MAX Add dither before restarting processes. Specify
maximum time to dither in seconds.
```

## processrestarter
```shell
processrestarter --help
usage: processrestarter [-h] [-p [PROGRAM [PROGRAM ...]]] [-a]
[--dither DITHER_MAX]

Supervisor event listener which restarts processes on TICK events.

optional arguments:
-h, --help show this help message and exit
-p [PROGRAM [PROGRAM ...]], --programs [PROGRAM [PROGRAM ...]]
Supervisor process name/s to be restarted if in
RUNNING state.
-a, --any-program Restart any supervisor processes in RUNNING state.
--dither DITHER_MAX Add dither before restarting processes. Specify
maximum time to dither in seconds.
```

Project details


Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page