Conchoctopus

Version:

0.1a1

What's Conchocotpus?

It's an environment that simplifies working with multiple SSH servers in an asynchronous way.
This environment consists of a task class, a config class and an console utility for managing
tasks' execution.Task class provides API for running remote and local commands and it's a base
class for implementing tasks created by users.Config class contains information like a list
of hosts to run task on or keys to use when connecting to remote servers.Tasks are executed
using a console utility that let a user track tasks' execution progress.

The project was started as an attempt to simplify Twisted Conch API by implementing something similar
to the Fabric API on the top of it.

Installation

You can install Conchoctopus either via the Python Package Index (PyPI)
or from source.It requires at least Python 2.5, Twisted 8.2 and Urwid 0.9.9
(may also work with earlier version of Urwid).

To install using easy_install,:

$ easy_install conchocotpus

If you have downloaded a source tarball you can install it
by doing the following,:

# python setup.py install # as root

Running example modules

In the examples directory you can find python modules that contain an examples
of Task and Config classes.Have a look at the comments and when you're ready
you can run a given example by invoking in the examples directory:

$ copus.py exampleModule

For more examples please have a look at tests.

Running test suite

Conchoctopus has quite a lot of tests.To run the whole test suite run:

$ trial conchoctopus.test

If any test fail please report it to the Bug Tracker along with
Python, Twisted and Urwid versions that you use.

Contributing

You're welcome to contribute in any way you can.You can simply run the test suite
on your system and play around with some examples and tell me about your experience.