Process executor for tests.
Maybe you want to be able to start database only when you start your program, or maybe you need just to set up additional processes for your tests, this is where you should consider using mirakuru, to add superpowers to your program, or tests.
As developers, we have to work on project that rely on multiple processes to run. We guard ourselves with tests. But sometimes it’s not enough what one process sends, and the other receives. Sometimes there’s need to actually exchange data between processes. Or write selenium tests. Or maybe write a program that takes care of starting databases or other required services itself.
If so, then mirakuru is what you need.
Mirakuru starts your required process, and wait for clear indication, that it’s running. There are three basic executors with predefined conditions:
- Executor - simply starts
- OutputExecutor - awaits for specified output to be given by process
- TCPExecutor - waits for ability to connect through tcp with process
- HTTPExecutor - waits for successful HEAD request (and tcp before)
- PidExecutor - waits for a specified file to exist
from mirakuru import HTTPExecutor from httplib import HTTPConnection, OK def test_it_works(): executor = HTTPExecutor("./server", url="http://localhost:6543/") # start and wait for it to run executor.start() # should be running! conn = HTTPConnection("localhost", 6543) conn.request('GET', '/') assert conn.getresponse().status is OK executor.stop()
The server command in this case is just a bash script that sleeps for some time and then launches the builtin SimpleHTTPServer on port 6543.
Command by which executor spawns a process, can be either string or list.
# command as string TCPExecutor('python -m smtpd -n -c DebuggingServer localhost:1025', host='localhost', port=1025) # command as list TCPExecutor( ['python, '-m', 'smtpd', '-n', '-c', 'DebuggingServer', 'localhost:1025'], host='localhost', port=1025 )
mirakuru is licensed under LGPL license, version 3.
- Corrected code to conform with W503, D210 and E402 linters errors as reported by pylama 6.3.1
- [feature] introduces a hack that kills all subprocesses of executor process. It requires ‘ps xe -ww’ command being available in OS otherwise logs error.
- [refactoring] Classes name convention change. Executor class got renamed into SimpleExecutor and StartCheckExecutor class got renamed into Executor.
- [feature] ability to set up custom signal for stopping and killing proceses managed by executors
- [feature] replaced explicit parameters with keywords for kwargs handled by basic Executor init method
- [feature] Executor now accepts both list and string as a command
- [fix] even it’s not recommended to import all but from mirakuru import * didn’t worked. Now it’s fixed.
- [tests] increased tests coverage.
- Even test cover 100% of code it doesn’t mean they cover 100% of use cases!
- [code quality] increased pylint code evaluation.
- [feature] PidExecutor that waits for specified file to be created.
- pypy compatibility
- [fix] closing all resources explicitly
- [fix] - kill all children processes of Executor started with shell=True
- [feature] executors are now context managers - to start executors for given context
- [feature] Executor.stopped - context manager for stopping executors for given context
- [feature] HTTPExecutor and TCPExecutor before .start() check whether port is already used by other processes and raise AlreadyRunning if detects it
- moved python version conditional imports into compat.py module
- fix issue where setting shell to True would execute only part of the command.
- fix issue where OutputExecutor would hang, if started process stopped producing output
- [fix] removed leftover sleep from TCPExecutor._wait_for_connection
- fixed MANIFEST.in
- updated packaging options
- exposed process attribute on Executor
- exposed port and host on TCPExecutor
- exposed url on HTTPExecutor
- simplified package structure
- simplified executors operating api
- updated documentation
- added docblocks for every function
- applied license headers
- stripped orchestrators
- forked off from summon_process
Release history Release notifications
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size & hash SHA256 hash help||File type||Python version||Upload date|
|mirakuru-0.5.0-py2.py3-none-any.whl (28.3 kB) Copy SHA256 hash SHA256||Wheel||2.7|
|mirakuru-0.5.0.tar.gz (21.9 kB) Copy SHA256 hash SHA256||Source||None|