Skip to main content

Lightweight in-process concurrent programming

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

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

greenlet-3.0.3.tar.gz (182.0 kB view hashes)

Uploaded source

Built Distributions

greenlet-3.0.3-cp312-cp312-win_amd64.whl (293.6 kB view hashes)

Uploaded cp312

greenlet-3.0.3-cp311-cp311-win_amd64.whl (292.8 kB view hashes)

Uploaded cp311

greenlet-3.0.3-cp310-cp310-win_amd64.whl (292.3 kB view hashes)

Uploaded cp310

greenlet-3.0.3-cp39-cp39-win_amd64.whl (290.8 kB view hashes)

Uploaded cp39

greenlet-3.0.3-cp39-cp39-win32.whl (273.0 kB view hashes)

Uploaded cp39

greenlet-3.0.3-cp38-cp38-win_amd64.whl (290.8 kB view hashes)

Uploaded cp38

greenlet-3.0.3-cp38-cp38-win32.whl (344.3 kB view hashes)

Uploaded cp38

greenlet-3.0.3-cp37-cp37m-win_amd64.whl (291.4 kB view hashes)

Uploaded cp37

greenlet-3.0.3-cp37-cp37m-win32.whl (345.7 kB view hashes)

Uploaded cp37

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