Python tool for orchestrating processes
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.



Current status: work in progress. The code is lacking proper documentation and is broken on Python 3.3.

Python process orchestration library.


As developers we have to work on project that rely on multiple processes to run their tests suites. Sometimes these processes need some time to boot.

The simple (and wrong) solution is to add time.sleep and pretend that it works. Unfortunately there is no way the estimate the amount of time to sleep and not loose too much time.

summon_process is an attempt to solve this problem. What you can see below is an example test that waits for a HTTP server to boot, and then it checks whether the returned status is OK.

from unittest import TestCase
from summon_process.executors import HTTPCoordinatedExecutor
from summon_process.utils import orchestrated
from httplib import HTTPConnection, OK

class TestServer(TestCase):
    def test_it_works(self):
        executor = HTTPCoordinatedExecutor("./server",

        with orchestrated(executor):
            conn = HTTPConnection("localhost", 8000)
            conn.request('GET', '/')
            assert conn.getresponse().status is OK

The server command in this case is just a bash script that sleeps for some time and then launches the builtin SimpleHTTPServer on port 8000.


The project was developed by Mateusz Lenik.


summon_process is licensed under LGPL license, version 3.

Contributing and reporting bugs

Source code is available at: mlen/summon_process. Issue tracker is located at GitHub Issues. Projects PyPi page.