python API to execute asynchronous remote tasks with ssh
Project description
rcontrol
rcontrol is a python library based on paramiko intended to work with remote machines via ssh.
Unlike fabric, it is intended to perform tasks in an asynchronous way, and to work with python >= 2.7 (including python 3).
Please note that this is under development! I am waiting for feedback, ideas and contributors to make this tool evolve.
Basic example:
from rcontrol.ssh import SshSession, ssh_client
from rcontrol.core import SessionManager
def log(task, line):
print("%r: %s" % (task, line))
with SessionManager() as sessions:
# create sessions on two hosts
sessions.bilbo = SshSession(
ssh_client('http://bilbo.domain.com', 'user', 'pwd'))
sessions.nazgul = SshSession(
ssh_client('http://nazgul.domain.com', 'user', 'pwd'))
# run commands in parallel
sessions.bilbo.execute("uname -a && sleep 3", stdout_callback=log)
sessions.nazgul.execute("uname -a && sleep 3", stdout_callback=log)
This example just show you how rcontrol looks like. Look at the documentation on http://rcontrol.readthedocs.org/en/latest/ if you’re interested to see more!
What rcontrol can do
execute multiple commands on local and remote hosts in an asynchronous way (it is up to you to synchronize them)
define timeout and output timeout for the commands
attach callbacks when a line is read (stdout or stderr), on timeout and when the commands are finished
copy files from one host to another
What rcontrol needs (contributors, you’re welcome!)
be able to stop (kill) a command (local or remote)
more file operations (create dirs, recursively copy dirs, remove, …)
love
How to install
Use pip.
pip install -U rcontrol
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.