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

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page