Skip to main content

Process executor for tests.

Project description

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.

Latest PyPI version Number of PyPI downloads Wheel Status Egg Status License

Package status

Tests Coverage Status Requirements Status

About

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).
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.

Author

The project was first developed by Mateusz Lenik as summon_process. Later forked, renamed to mirakuru and tended to by The A Room @ Clearcode.

License

mirakuru is licensed under LGPL license, version 3.

Contributing and reporting bugs

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

When contributing, don’t forget to add your name to AUTHORS.rst file.

0.1.1

  • fixed MANIFEST.in
  • updated packaging options

0.1.0

  • 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

Project details


Release history Release notifications

History Node

1.0.0

History Node

0.9.0

History Node

0.8.3

History Node

0.8.2

History Node

0.8.1

History Node

0.8.0

History Node

0.7.0

History Node

0.6.1

History Node

0.6.0

History Node

0.5.0

History Node

0.4.0

History Node

0.3.0

History Node

0.2.0

History Node

0.1.4

History Node

0.1.3

History Node

0.1.2

This version
History Node

0.1.1

History Node

0.1.0

Download files

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.1.1-py2.py3-none-any.whl (12.4 kB) Copy SHA256 hash SHA256 Wheel 2.7 Jul 6, 2014
mirakuru-0.1.1.tar.gz (9.5 kB) Copy SHA256 hash SHA256 Source None Jul 6, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page