greenify

Make blocking C library work with gevent

Showing:

Popularity

Downloads/wk

0

GitHub Stars

414

Maintenance

Last Commit

1yr ago

Contributors

13

Package

Dependencies

1

License

Categories

Readme

greenify_

greenify can make Python extension modules having network operations in C code to be compatible with gevent.

greenify uses the Dynamic Function Redirecting technique same as ELF-Hook to patch blocking network operations at runtime, without the need modify the original modules.

Currently greenify_ only supports ELF format modules, and is tested on Linux.

Build status

  • Branch master : |travis_master|

.. |travis_master| image:: https://travis-ci.org/douban/greenify.svg?branch=master :target: https://travis-ci.org/douban/greenify

Install from source

greenify module is installed using setuptools or pip::

python setup.py install

or::

pip install greenify

Usage

  1. Active greenify_ before initiate environment::

    import greenify greenify.greenify()

  2. Make sure the dynamic module(e.g. libmemcached) is patched before using::

    assert greenify.patch_lib('/usr/lib/libmemcached.so')

  3. Import and use the corresponding module, which is now gevent_ compatible.

Thread Safety

Once activated, the green C functions will, on potentially blocking operation, pass control to gevent's main event loop, which may switch to other ready greenlet which is also in one of the green functions. So, make sure your C code can handle this kind of execution pause and resume. A thread safe program usually is ready for greenify, but remember that all the switches happen in a single thread.

License

greenify is written and maintained by douban and is licensed under New BSD license.

.. _gevent: http://www.gevent.org .. _greenify: https://github.com/douban/greenify .. _douban: http://www.douban.com .. _ELF-Hook: https://github.com/shoumikhin/ELF-Hook

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100