caravan 0.1.2

Project

• Code on Github

• PyPi

• Doc: TODO

• Tests:

Focus of this project

Similar projects exists (like Simpleflow which seems mature). Here is where Caravan differs from existing projects:

• Support of AWS Lambda tasks

• Boto3

• KISS

• Bring your own workflow framework (standard implementations as contribs)

• No coupling between Decider code and Activity code

• Paster compatible config file

Features

• Decider worker

• Activity task worker

• Commands to start/signal/terminate an arbitrary workflow execution

• Command to list open workflow execution

• Command to register a domain

Usage

Setup a SWF for the example:

$ caravan-domain-register -n CaravanExample --retention-days 1

List open execution for last 24h:

$ caravan-list -d CaravanExample

List open execution for year 2015:

$ caravan-list -d CaravanExample --oldest 2015-01-01

Run the decider:

$ caravan-decider -d CaravanExample -m caravan.examples.demo -t default

Start an execution:

$ caravan-start -d CaravanExample -n Demo -v 0.1 -i 1

Send a signal to an execution:

$ caravan-signal -d CaravanExample -i 1 -s PAYMENT_CONFIRMED

Terminate an execution:

$ caravan-terminate -d CaravanExample -i 1

Similar projects

Python:

• Simpleflow: https://github.com/botify-labs/simpleflow

• Flowy: https://github.com/severb/flowy

• Garcon: https://github.com/xethorn/garcon

Ruby:

• AWS Flow: https://github.com/aws/aws-flow-ruby

Development

Clone and install development dependencies:

$ git clone git@github.com:pior/caravan.git
$ cd caravan
$ pip install -e .[dev]

Run tests:

$ py.test

Release

The release process use zest.releaser:

$ fullrelease

License

MIT licensed. See the bundled LICENSE file for more details