Metadata-Version: 1.1
Name: SDog
Version: 0.2.2
Summary: SDog
Home-page: http://github.com/shish/sdog
Author: Shish
Author-email: webmaster+sdog@shishnet.org
License: UNKNOWN
Description: 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
        ```
        
        
        
Platform: UNKNOWN
Classifier: Programming Language :: Python
