semvec/pypi-packages huggingface dataset:
pyrcmd3 0.1.0
Python3 Remote Commands toolkit
License: BSD
Keywords: Python3 Remote Command Commands SSH Toolkit

pyrcmd3
#######

Python3 Remote Commands


.. image:: https://travis-ci.org/marreta-sources/pyrcmd3.svg?branch=master
    :target: https://travis-ci.org/marreta-sources/pyrcmd3

:PyStorage:   Python3 Remote Commands toolkit
:Copyright:   Copyright (c) 2016 Bruno Costa, Kairo Araujo <coder@marreta.org>
:License:     BSD
:Development: https://github.com/marreta-sources/pyrcmd3

.. contents::
    :local:
    :depth: 2
    :backlinks: none



Installing
==========

Using PIP
---------

Just run the PIP

.. code-block:: bash

    $ sudo pip install pyrcmd3

From local
----------

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

.. code-block:: bash

    $ python setup.py install


Using
=====

At the moment the pyrcmd3 supports commands over SSH.

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.

Contributing
============

1. Make the for from  https://github.com/marreta-sources/pyrcmd3

2. Change the code

3. Test the code
    1. First check all the PEP8 recommendations and possible spells.

    2. Run tests with tox

    3. Create a http://travis-ci.com for your fork and verify the tests

4. Submit your code doing a pull request
    1. try to give us details about the code. We are newbies with Python and it
    will be help us.