SDog 0.2.2

sdog
====

A process monitor using an extremely limited (but still useful enough for me)
subset of the systemd watchdog protocol

"450 downloads in the last week" -- are people actually using this, or is pypi
just full of bots? o.o;; I welcome your feedback if you are actually a person :)

```
Usage: sdog [options] -- daemon-to-run [daemon options]

Options:
-h, --help show this help message and exit
-t N, --timeout=N Maximum seconds between pings
-r N, --respawn=N Delay between respawns
-s FILE, --socket=FILE Path to socket
-T NAME, --title=NAME Daemon name (defaults to the first param after "--")
(Requires setproctitle module)
-v, --verbose Verbose mode
```

For Daemons
===========

There is the sdog.notifier module

```
from sdog.notifier import SDNotifier

def main():
# Create the notifier
sd = SDNotifier()

# Connect to the work queue and signal that we're ready to go
work_queue = WorkQueue("localhost:1234")
sd.ready()

while True:
# Get some work and signal that we're working on it
item = work_queue.get()
sd.status("Processing %s" % item.name)

# Do the work then signal that we are alive and running successfully
do_some_work(item)
sd.watchdog()
```

Protocol
========

The daemon will be launched with `NOTIFY_SOCKET=/some/path.sock` in its
environment; it should then write datagram packets into this socket:

```
READY=1 -- signal that the daemon has loaded, and to start monitoring
WATCHDOG=1 -- must be sent at least once every $timeout seconds
STATUS=blah -- update the current status message
```