Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

papavisor package.

Project Description


A control script for supervisor’s - the Papa (german Dad) of supervisors.

With papavisor you can:

  • Get the status of all supervisors one a machine (you can configure remote supervisor though).
  • Start/stop/restart grouped supervisor programs with priorities and startsecs in between.
  • Talk to multiple supervisors in parallel (by using asyncio).
  • apapavisor finds supervisord.cfg files himself - no need to configure each instance.


  • Unix like System
  • Python >3.4.0


papavisor is available over pypi:

$ pip3 install papavisor


On the first start papavisor copies config files to ~/.config/papavisor/ if theres no /etc/papavisor directory. Papavisor reads all .json files sorted and merges them into one big configuration OrderedDict.

papavisor files:

  • 00_default.json - Contains the defaults for each project, they will get copied and then overwritten by the per project values.
  • 01_template.json - An template for “manual” project witch overwrites the defaults above.

apapavisor - The Auto papavisor reads only.


When you install this package you get two excecutables:

  • papavisor - The supervisord control script.
  • apapavisor - A wrapper witch searches for supervisord.conf files and passes them to papavisor, its the Auto papavisor as you need nearly no configuration for that.

General usage:

$ (a)papavisor [project-or-all] [action] [group-or-program]

The default is:

$ (a)papavisor all status all

For example, to restart all zope instances:

$ apapavisor all restart zopes

To restart all python stuff on project ploneconf:

$ apapavisor plonec restart python

All actions:

$ apapvaisor <project-or-all> status <group-or-program>
$ apapavisor <project-or-all> start <group-or-program>
$ apapavisor <project-or-all> stop <group-or-program>
$ apapavisor <project-or-all> restart <group>



papavisor is licensed under the MIT license.


If you are having issues, please let us know.


0.1.0 (2016-02-14)

  • Also wait on TCP Check if startsecs have been given. [pcdummy]
  • Add TCP Check and start_extra. [pcdummy]
  • Reverse the priority on start. [pcdummy]

0.0.1a3 (2016-02-11)

  • Fix apapvisor config path detection. [pcdummy]

0.0.1a2 (2016-02-10)

  • Fix package installation, move config to ~/.config. [pcdummy]
  • Add texttable for the status output and psutil for memory info. [pcdummy]
  • Link pypi, cleanup main(). [pcdummy]
  • Use argparser and smaller bugfixes. [pcdummy]
  • Use sys.prefix for config files. [pcdummy]
  • Added support for connecting to ‘unix://’ sockets. [pcdummy]
  • Add an option ‘enable’ to disable projects. [pcdummy]
  • README.rst, papavisor is available over pip. [pcdummy]
  • Fix “python3 develop”. [pcdummy]

0.0.1a (2016-02-10)

  • papavisor was born. [pcdummy]
Release History

Release History

This version
History Node


History Node


History Node


History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
papavisor-0.1.0.tar.gz (11.6 kB) Copy SHA256 Checksum SHA256 Source Feb 14, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting