Overview

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.

Development of Conchoctopus happens at BitBucket:
http://bitbucket.org/jakamkon/conchoctopus

If you have any suggestions or bug reports please report them to issue tracker at http://bitbucket.org/jakamkon/conchoctopus/issues?status=new&status=open

You can also write to me directly at jakamkon at gmail dot com.

License

This software is licensed under the MIT License. See the LICENSE file in the top distribution directory for the full license text.