pyrcmd3 0.1.0

Using PIP

Just run the PIP

$ sudo pip install pyrcmd3

From local

Download the pyrcmd3 from PIP or from Marreta Github http://github.com/marreta-sources/pyrcmd3/ and uncompress

$ python setup.py install

SSH support

• Attributes:

  Address:

  IP or Hostname to client server

  User:

  User used to connect using ssh

  Passwd:

  Password used to connect to ssh

  timeout:

  Timeout to Connect (Hostname is valid and has route to host), default value for timeout is 30

• Return:

  returns:

  Dictionary (Array) with Return Code, Std output and Std Error

• Exceptions:

  AuthFailure:

  Client to Server Problem with Authentication

  BadHostKey:

  Host Key does not match

  SshProtocol:

  Problem of SSH2 Negotiation

  TimeOut:

  Timeout while trying to connect to a valid address

  TimeoutExecuting:

  Timeout while trying to execute command.

  • Sample:

  Simple use:

  >>> import pyrcmd3
  >>> remote = pyrcmd3.SSH('192.168.0.1', 'foobar', 'Password1')
  >>> remote_out = remote.execute('ls')
  >>> print remote_out
  {'return_code': 0, 'stderr': '', 'stdout': 'total 24\ndrwx------   3 kairo  users  512 Jan 30 11:31 .\ndrwx------  10 kairo  users  512 Jan 30 11:30 ..\n-rw-------   1 kairo  users    0 Jan 30 11:30 foobar.txt\ndrwx------   2 kairo  users  512 Jan 30 11:31 marretinha\n'}
  >>> print remote_out['return_code']
  0
  >>> print remote_out['stdout']
  total 24
  drwx------   3 kairo  users  512 Jan 30 11:31 .
  drwx------  10 kairo  users  512 Jan 30 11:30 ..
  -rw-------   1 kairo  users    0 Jan 30 11:30 foobar.txt
  drwx------   2 kairo  users  512 Jan 30 11:31 marretinha
  

  Working with exceptions

  >>> import pyrcmd3
  >>> server=pyrcmd3.SSH('localhost', 'foo', 'i dont remember', timeout=10)
  >>> try:
  ...     server.execute('ls')
  ... except pyrcmd3.exceptions.TimeoutExecutingException as e:
  ...     print(e)
  ...
  Timeout while trying to execute command.