This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

A simple framework for distributed task workflow using redis.

Project Description
========
T-A S.A.
========

A simple framework for distributed task workflow using redis. Designed
to be easily extensible with code, rather than excessively featureful
out of the box.

Getting Started
---------------

Tasa requires a version of Python 2.7. If you're using an older
version, now is an excellent time to upgrade. If you're running Python
3, compatibility patches are welcome.

Quickstart example for Debian:

#) sudo apt-get install redis-server python-pip nmap
#) sudo pip install -U tasa
#) wget https://raw.github.com/PaulMcMillan/tasa/master/examples/tnmap.py
#) mkdir out
#) tasa tnmap:Runner &
#) tasa tnamp:Results &
#) python tnmap.py 10.0.0.0/24

This quickstart installs tasa, downloads an example script for
distributed nmap, runs one task worker and one results worker, and
then inserts a job to scan a portion of your local net.

To actually use this example to distribute a task, on each worker node:

#) sudo apt-get install python-pip nmap
#) sudo pip install -U tasa
#) wget https://raw.github.com/PaulMcMillan/tasa/master/examples/tnmap.py
#) configure `/etc/tassa/tasa.conf` to contain a configuration line like
`redis='redis://password@example.org:6379/0'`
#) tasa tnmap:Runner

Then run the results worker and inject jobs from the master
machine. Experiment with changing values in the script - the example
is actually general enough to run any process, not just nmap.

Don't forget to configure your redis server to listen on an ip
accessible to your clients, and set a password even if you are on a
private network. If you're on an untrusted network, you're responsible
for encryption - either tunnel over an SSH port forward, or wrap redis
in TLS using stud/stunnel.

How does it work?
-----------------

Tasa is primarily a thin framework to help you build composable work
flows. Break your problem into small chunks, run workers on several
machines, and insert jobs into the worker's input queue, and consume
them from the output.

FAQ
---

* I get a traceback with "redis.exceptions.ResponseError: operation
not permitted"

Did you remember to set a `redis` setting in `/etc/tasa/tasa.conf`?
This will happen if you added a redis password and did not set a
connection string.

* What version of redis-server do I need?

Tasa is developed with redis 2.6.16. Older versions aren't explicitly
tested, though the 2.4 branch will probably work with reduced
functionality. Newer versions should work without trouble.

Security
--------

The security of tasa depends entirely on how you use it. If you use a
password and tunnel redis communications over an encrypted and
authenticated transport, you'll do pretty well. The easiest way to do
this is to use SSH port forwarding or ipsec to transport redis
traffic. You can also put stud in front of redis to do TLS, though
this is more complex.

The author uses tasa workers primary on disposable cloud hosts.
Release History

Release History

This version
History Node

0.3.2

History Node

0.3.1

History Node

0.3.0

History Node

0.2.4

History Node

0.2.3

History Node

0.2.2

History Node

0.2.1

History Node

0.2.0

History Node

0.1.4

History Node

0.1.3

History Node

0.1.2

History Node

0.1.1

Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
tasa-0.3.2.zip (12.7 kB) Copy SHA256 Checksum SHA256 Source Jan 13, 2014

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting