loon 0.1.3

A Python toolkit for operating remote host based on SSH

loon

A Python toolkit for operating remote host based on SSH.

Description

Idea for developing loon comes from sync-deploy, which help me run commands, copy and download files on/to/from remote host. This toolkit is built on the top of ssh2-python library.

Installation

Install from pypi:

pip install loon

Usage

Host management

• Add a remote host

$ loon add -U wsx -H 127.0.0.1 -P 22
=> Added successfully!
# Default port is 22, so don't need to specify it
# And we can create a host alias, otherwise
# it is same as username of remote host
$ loon add -U wsx -H 127.0.0.2 -N host2      
=> Added successfully!

• List all remote hosts

$ loon list

Active host
============
['wsx', 'wsx', '127.0.0.1', 22]

Available hosts
===============
[['wsx', 'wsx', '127.0.0.1', 22],
 ['host2', 'wsx', '127.0.0.2', 22]]

The list is ordered by host alias, username, ip and port.

• Rename alias

$ loon rename wsx host1
$ loon list

Active host
============
['host1', 'wsx', '127.0.0.1', 22]

Available hosts
===============
[['host1', 'wsx', '127.0.0.1', 22],
 ['host2', 'wsx', '127.0.0.2', 22]]

• Switch active remote host

$ loon switch -N host2
=> Activated.
$ loon list

Active host
============
['host2', 'wsx', '127.0.0.2', 22]

Available hosts
===============
[['host1', 'wsx', '127.0.0.1', 22],
 ['host2', 'wsx', '127.0.0.2', 22]]

• Delete a host

$ loon delete -N host2
=> Removing host from available list...
=> Removing active host...
=> Changing active host to host1
$ loon list

Active host
============
['host1', 'wsx', '127.0.0.1', 22]

Available hosts
===============
[['host1', 'wsx', '127.0.0.1', 22]]

Common tasks

• Run commands

$ loon run 'ls -l ~'
total 168
drwxr-xr-x     2 wsx liulab     25 Apr  7 23:26 bin
drwxr-xr-x.    2 wsx liulab      6 Apr  4 10:36 Desktop
drwxr-xr-x.    2 wsx liulab      6 Apr  4 10:36 Documents
drwxr-xr-x.    3 wsx liulab     69 Jun 10 16:57 Downloads
drwxr-xr-x     2 wsx liulab      6 Sep 30 10:23 facet
drwxr-xr-x    11 wsx liulab   4096 Sep 22 20:13 metawho
drwxr-xr-x.    2 wsx liulab      6 Apr  4 10:36 Music
drwxr-xr-x     3 wsx liulab     60 Apr 30 17:50 Notebooks
drwxr-xr-x.    2 wsx liulab      6 Apr  4 10:36 Pictures
drwxr-xr-x     6 wsx liulab    114 Sep 27 17:33 projects
drwxr-xr-x     6 wsx liulab     96 Jun 27 16:50 projects_bk
drwxr-xr-x.    2 wsx liulab      6 Apr  4 10:36 Public
drwxr-xr-x.    2 wsx liulab      6 Apr  4 10:36 Templates
drwxr-xr-x     5 wsx liulab   4096 Oct  3 12:24 test
drwxr-xr-x  3480 wsx liulab 114688 Oct  3 13:44 tmp
drwxr-xr-x     3 wsx liulab     32 Aug 22 17:13 tools
drwxr-xr-x.    2 wsx liulab      6 Apr  4 10:36 Videos

• Upload files (not fully supported)

TODO

PBS management and tasks

TODO

Current usage info

usage: loon [-h] [--version] [--author]
            {add,delete,switch,list,rename,run,upload} ...

Be an efficient loon.

optional arguments:
  -h, --help            show this help message and exit
  --version             show program's version number and exit
  --author              show info of program's author

subcommands:
  {add,delete,switch,list,rename,run,upload}
                        description
    add                 Add a remote host
    delete              Delete a remote host
    switch              Switch active remote host
    list                List all remote hosts
    rename              Rename host alias
    run                 Run commands on the active remote host
    upload              Upload files to active remote host

Note

This project has been set up using PyScaffold 3.2.2. For details and usage information on PyScaffold see https://pyscaffold.org/.