Skip to main content

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

  • Provide functional testing

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.

Source Distribution

cotyledon-1.6.3.tar.gz (25.7 kB view details)

Uploaded Source

Built Distribution

cotyledon-1.6.3-py2.py3-none-any.whl (22.7 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file cotyledon-1.6.3.tar.gz.

File metadata

  • Download URL: cotyledon-1.6.3.tar.gz
  • Upload date:
  • Size: 25.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for cotyledon-1.6.3.tar.gz
Algorithm Hash digest
SHA256 38ac4b52f911b1ea9bc128207ff80f5b4c69e249c7cd2a6bc5b4b7219f23a9a7
MD5 1f8242920c67246b077849215fd02343
BLAKE2b-256 017ec5e13420f618015bdb040670225b9131821665c3c3a4306b63b40ea4ac5f

See more details on using hashes here.

File details

Details for the file cotyledon-1.6.3-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for cotyledon-1.6.3-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 e6f6fa308124d9c24b8ec76ddb72b28b988c488e07fe24c3a526445c4c2aa8d8
MD5 3fbd961f4ca085ab5f76eb098d44c221
BLAKE2b-256 fb833f1ea80086e0c29af27b93c5842613978c639cd25a176b0c250e2739cf07

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page