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

Cotyledon provides a framework for defining long-running services.

Project description

Latest Version Downloads https://travis-ci.org/sileht/cotyledon.png?branch=master https://tea-ci.org/api/badges/sileht/cotyledon/status.svg

Cotyledon provides a framework for defining long-running services.

It provides handling of Unix signals, spawning of workers, supervision of children processes, daemon reloading, sd-notify, rate limiting for worker spawning, and more.

Why Cotyledon

This library is mainly used in Openstack Telemetry projects for now. In the past oslo.service was used. But our projects don’t want to use eventlet anymore.

oslo.service is written on top of eventlet to provide two main features:

  • periodic tasks
  • workers processes management

The first one was replaced by another Oslo lib called futurist and the second part by Cotyledon.

Our main issue was greenlet that doesn’t run in timely fashion because we don’t monkeypatch the python stdlib anymore. Making Tooz/Oslo.messaging hearbeats to fail. And processes that doesn’t exists as expected due to greenpipe never processed.

Unlike oslo.service, cotyledon have:

  • The same code path when workers=1 and workers>=2
  • reload API (on SIGHUP) hooks work in case of you don’t want to restarting children
  • a separated API for children process termination and for master process termination
  • seatbelt to ensure only one service workers manager run at a time.
  • Is signal concurrency safe.
  • Support non posix platform, because it’s built on top of multiprocessing module instead of os.fork

And doesn’t:

  • facilitate the creation of wsgi application (sockets sharing between parent and children process). Because too many wsgi webserver already exists.

So these toohard to fix issues and the heavy eventlet dependencies make this library to appear.

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 cotyledon, version 1.6.2
Filename, size File type Python version Upload date Hashes
Filename, size cotyledon-1.6.2-py2.py3-none-any.whl (21.6 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size cotyledon-1.6.2.tar.gz (23.8 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page