Skip to content

parkouss/rcontrol

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

67 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

rcontrol

image

image

Documentation Status

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", on_stdout=log)
    sessions.nazgul.execute("uname -a && sleep 3", on_stdout=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 and directories 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
  • love

How to install

Use pip. :

pip install -U rcontrol

Changelog

See the CHANGELOG.rst file.

About

python library to execute asynchronous remote tasks with ssh

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages