Minimal SSH wrapper around paramiko

This project is maintained by cwood


sshed is a minimal paramiko/ssh2 wrapper that makes working with ssh through python just like working with it in normal SSH. It will use your configuration that you have already created first then any extra options can be passed in through the library that is using it. Servers are base objects that can be extended to do other tasks. Also the API is dead simple.


Creating a server from your ~/.ssh/config with ssh keys created. This also uses a host alias.

from sshed import servers
server = servers.from_conf('development')'whoami').output
>> ['cwood']'sudo whoami').output
>> ['root']'cd /var/www').returncode
>> 0'pwd').output
>> ['/var/www']

Creating a server from just a hostname

from sshed import servers
server = servers.from_conf('')'hostname').output
>> ['']

Uploading/Downloading from/to a server

from sshed import servers
server = servers.from_conf('development')
server.upload('/tmp/mytar.tar', '/var/tmp/mytar.tar')'/var/logs/httpd/error_log', '/tmp/remote/error_log')

Creating a new server without a ssh config

from sshed.servers import Server
server = Server(username='username', hostname='',
        password='supersecretpassword') ... )

Working with argparse. This sshed module also has a helper for working with argparse. You can import an action so that when a user puts in a --server it will create a new server instance for that server.


from sshed.argparse_actions import ServerAction

# some other argparse information
parser.add_argument('-s', '--server', action=ServerAction, dest='server')