Skip to main content

gevent-cooperative child processes and inter-process communication.

Project description

Changelog | gipc @ PyPI | gipc @ GitHub

CI status (master branch): TRAVISCIBADGE

From 2012 to 2018 gipc’s home was at bitbucket.org/jgehrcke/gipc. Since then development has continued on GitHub.

Overview

gipc (pronunciation as in “gipsy”) provides reliable child process management and non-blocking inter-process communication in the context of gevent.

Using Python’s multiprocessing package in the context of a codebase that also uses gevent is error-prone and may break the application in various subtle ways.

With gipc, multiprocessing.Process-based child processes can safely be created anywhere within your gevent-powered application. The API of multiprocessing.Process objects is provided in a gevent-cooperative way. Also, gipc provides a pipe-based transport layer for gevent-cooperative inter-greenlet and inter-process communication. gipc is lightweight and easy to integrate.

Code examples

Individual example programs can be found in the examples directory.

Documentation

Visit https://gehrcke.de/gipc for installation instructions, API docs, code examples, and in-depth information.

Platform support

The current version of gipc works on CPython 3.6/3.7/3.8/3.9. It supports gevent versions 1.5 and newer and supports both, Unix-like systems as well as Windows. On Unix-like systems, gipc also works with PyPy2.7 and PyPy3.

gipc’s test suite is automatically executed on Linux, Darwin (macOS), and Windows.

Who uses it?

Are you successfully using gipc in your project? Please drop me a line!

How to run the tests?

gipc’s tests are written for pytest. With the repository’s root directory being the current working directory you can run the tests like this:

$ pip install -r requirements-tests.txt
$ cd test && pytest -vv --cov-report term --cov-report html --cov gipc

Contact & help

Your feedback and questions are highly appreciated. Please contact me via mail at jgehrcke@googlemail.com or use the GitHub issue tracker.

Author & license

gipc is written and maintained by Jan-Philip Gehrcke. It is licensed under the MIT license (see LICENSE file).

I am thankful for all contributions (bug reports, code, great questions) from:

  • Guy Rozendorn
  • John Ricklefs
  • Heungsub Lee
  • Alex Besogonov
  • Jonathan Kamens
  • Akhil Acharya
  • John Porter
  • James Addison
  • Oliver Margetts
  • … and others

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for gipc, version 1.3.0
Filename, size File type Python version Upload date Hashes
Filename, size gipc-1.3.0.tar.gz (34.6 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page