Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

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]

Project details

Download files

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

Files for papavisor, version 0.1.0
Filename, size File type Python version Upload date Hashes
Filename, size papavisor-0.1.0.tar.gz (11.6 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page