skip to navigation
skip to content

supervise 1.1.1

Tools for communicating with runit / daemontools supervisors.

This module provide a methods to handle runit or daemontools based supervised services, using the control file provided. Here is a small example:

>>> import supervise
>>> s = supervise.Service('test')
>>> print s.status()
{'action': None, 'status': 0, 'uptime': 300L, 'pid': None}
>>> s.start()
>>> print s.status()
{'action': None, 'status': 1, 'uptime': 3L, 'pid': 27450}

Read the manpage of runsv(8) for more information. Also read the documentation for ServiceStatus to known how to parse status information.


Last month I needed to install runit in some servers to supervise a couple of services. Unfortunately my management interface cannot handle the services anymore, so I decided to write a small module in python to solve this handicap, and that is the result!.

With this module you can handle in python environment a number of runit scripts. I think that this might be work for daemontools too, but I do not test yet. Let’s see an example:

>>> import supervise
>>> c = supervise.Service("/var/service/httpd")
>>> print s.status()
{'action': 'normal', 'status': 'up', 'uptime': 300L, 'pid': None}
>>> if s.status()['status'] == supervise.STATUS_DOWN: print "service down"
service down
>>> s.start()
>>> if s.status()['status'] == supervise.STATUS_UP: print "service up"
service up

Personally I use this module with rpyc library to manage remotely the services running in a host, but it too easy making a web interface, for example using bottle:

import supervise
import simplejson
from bottle import route, run

def service_status(name):
    return simplejson.dumps( supervise.Service("/var/service/" +
        name).status() )

def service_up(name):
    c = supervise.Service("/var/service/" + name)
    return "OK UP"

def service_down(name):
    c = supervise.Service("/var/service/" + name)
    return "OK DOWN"

if __name__ == "__main__":

Now you can stop your service just only point your browser http://localhost/service/down/httpd (to down http service in this case).


author:Andres J. Diaz <>
maintainer:Peter Ruibal <>
File Type Py Version Uploaded on Size
supervise-1.1.1-py2.6.egg (md5) Python Egg 2.6 2014-05-10 9KB
supervise-1.1.1-py2.7.egg (md5) Python Egg 2.7 2014-05-10 9KB
supervise-1.1.1.tar.gz (md5) Source 2014-05-10 4KB
  • Downloads (All Versions):
  • 90 downloads in the last day
  • 586 downloads in the last week
  • 3355 downloads in the last month