PyCon US is happening May 14th-22nd in Pittsburgh, PA USA.  Learn more

Lightweight in-process concurrent programming

Navigation

Verified details

These details have been verified by PyPI
Maintainers
Avatar for ambroff from gravatar.com ambroff Avatar for bob from gravatar.com bob Avatar for denik from gravatar.com denik Avatar for fzzzy from gravatar.com fzzzy Avatar for jamadden from gravatar.com jamadden Avatar for JaredKuolt from gravatar.com JaredKuolt Avatar for schmir from gravatar.com schmir Avatar for snaury from gravatar.com snaury Avatar for whichlinden from gravatar.com whichlinden
Meta

Unverified details

These details have not been verified by PyPI
Project links
Meta
  • License: MIT AND Python-2.0
  • Author: Alexey Borzenkov
  • Maintainer: Jason Madden
  • Tags greenlet, coroutine, concurrency, threads, cooperative
  • Requires: Python >=3.9
  • Provides-Extra: docs, test
Classifiers

Project description

Greenlets are lightweight coroutines for in-process concurrent programming.

The “greenlet” package is a spin-off of Stackless, a version of CPython that supports micro-threads called “tasklets”. Tasklets run pseudo-concurrently (typically in a single or a few OS-level threads) and are synchronized with data exchanges on “channels”.

A “greenlet”, on the other hand, is a still more primitive notion of micro-thread with no implicit scheduling; coroutines, in other words. This is useful when you want to control exactly when your code runs. You can build custom scheduled micro-threads on top of greenlet; however, it seems that greenlets are useful on their own as a way to make advanced control flow structures. For example, we can recreate generators; the difference with Python’s own generators is that our generators can call nested functions and the nested functions can yield values too. (Additionally, you don’t need a “yield” keyword. See the example in test_generator.py).

Greenlets are provided as a C extension module for the regular unmodified interpreter.

Who is using Greenlet?

There are several libraries that use Greenlet as a more flexible alternative to Python’s built in coroutine support:

Getting Greenlet

The easiest way to get Greenlet is to install it with pip:

pip install greenlet

Source code archives and binary distributions are available on the python package index at https://pypi.org/project/greenlet

The source code repository is hosted on github: https://github.com/python-greenlet/greenlet

Documentation is available on readthedocs.org: https://greenlet.readthedocs.io

Supported by

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