runssh 0.1.0 → 0.1.1
Sign up to get free protection for your applications and to get access to all the features.
- data/README.rdoc +43 -1
- data/lib/runsshlib/cli.rb +8 -3
- data/lib/runsshlib.rb +1 -1
- metadata +4 -4
data/README.rdoc
CHANGED
@@ -2,7 +2,10 @@
|
|
2
2
|
A CLI utility to bookmark ssh connections with hierarchy and act upon
|
3
3
|
these bookmarks. Currently only opens a shell.
|
4
4
|
|
5
|
-
|
5
|
+
=== Installation
|
6
|
+
You must have ruby[http://www.ruby-lang.org/] and
|
7
|
+
rubygems[http://rubygems.org/] installed and then run:
|
8
|
+
gem install runssh
|
6
9
|
|
7
10
|
=== Bash Completion
|
8
11
|
For bash completion I added a simple <tt>runssh_comp.sh</tt> file which completes
|
@@ -21,6 +24,39 @@ the following to your .zshrc file:
|
|
21
24
|
This works for me, but I'm only starting with zsh so I hope it will work for you
|
22
25
|
as well.
|
23
26
|
|
27
|
+
== Usage
|
28
|
+
For usage run _runssh_ without arguments.
|
29
|
+
|
30
|
+
=== Host Definition
|
31
|
+
Host definition is a collection of attributes that help us define a host
|
32
|
+
bookmark. As of version 0.1.0 only _hostname_ and <i>remote user</i> are supported,
|
33
|
+
but more attributes (e.g, tunnel definition) will be added on later versions.
|
34
|
+
|
35
|
+
=== Bookmarks
|
36
|
+
The bookmarks consists of a host definition inside nested groups. These
|
37
|
+
groups could hold other groups or host definitions. Here is an example
|
38
|
+
of bookmarks:
|
39
|
+
|
40
|
+
customer1:
|
41
|
+
location1:
|
42
|
+
host1
|
43
|
+
host2
|
44
|
+
location2:
|
45
|
+
host3
|
46
|
+
host4
|
47
|
+
sublocation:
|
48
|
+
host5
|
49
|
+
customer2:
|
50
|
+
office:
|
51
|
+
host1
|
52
|
+
...
|
53
|
+
|
54
|
+
You can decide to arrange your bookmarks by customers and/or location
|
55
|
+
and/or internal/external addresses etc. To access a host definition you
|
56
|
+
specify the full path to that host. In the above example to access _host2_
|
57
|
+
(e.g, print it's definition) run:
|
58
|
+
runssh print customer1 location1 host2
|
59
|
+
|
24
60
|
== requirements:
|
25
61
|
(versions are specified in the gem definition in the Rakefile)
|
26
62
|
|
@@ -33,6 +69,12 @@ Development:
|
|
33
69
|
== License
|
34
70
|
This program is distributed under the GPL v2 license.
|
35
71
|
|
72
|
+
== History
|
73
|
+
|
74
|
+
[0.1.0] Initial release. Simple bookmarks (host and user),
|
75
|
+
only _shell_ operation supported.
|
76
|
+
[0.1.1] Improved docs.
|
77
|
+
|
36
78
|
== TODO
|
37
79
|
* Create a _proper_ zsh completion script.
|
38
80
|
* Add scp capabilities
|
data/lib/runsshlib/cli.rb
CHANGED
@@ -67,11 +67,14 @@ module RunSSHLib
|
|
67
67
|
Usage: runssh [global_options] COMMAND [options] <path>
|
68
68
|
|
69
69
|
A utility to bookmark multiple ssh connections in heirarchial order.
|
70
|
+
For a better understanding of host definitions and bookmarks, Read
|
71
|
+
the provided README.rdoc or go to http://github.com/babysnakes/runssh.
|
70
72
|
|
71
73
|
COMMAND : One of the commands mentioned below. It's possible to
|
72
74
|
type only part of the command as long as it's not ambiguous.
|
73
|
-
<path> : A space
|
74
|
-
|
75
|
+
<path> : A space-separated list of names (e.g, one two three) that
|
76
|
+
leads to a host definition. For available completions
|
77
|
+
append " ?" to the end of path.
|
75
78
|
|
76
79
|
Available commands:
|
77
80
|
* shell : Open ssh shell on remote host
|
@@ -134,7 +137,9 @@ EOS
|
|
134
137
|
banner <<-EOS
|
135
138
|
Usage: runssh [global_options] add [options] <path>
|
136
139
|
|
137
|
-
Add a new host definition at the supplied <path>. <path> must not
|
140
|
+
Add a new host definition at the supplied <path>. <path> must not exist!
|
141
|
+
A host definition can have a hostname (required) and a remote user
|
142
|
+
(optional).
|
138
143
|
|
139
144
|
<path> : See main help for description of path.
|
140
145
|
|
data/lib/runsshlib.rb
CHANGED
metadata
CHANGED
@@ -1,13 +1,13 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: runssh
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
hash:
|
4
|
+
hash: 25
|
5
5
|
prerelease: false
|
6
6
|
segments:
|
7
7
|
- 0
|
8
8
|
- 1
|
9
|
-
-
|
10
|
-
version: 0.1.
|
9
|
+
- 1
|
10
|
+
version: 0.1.1
|
11
11
|
platform: ruby
|
12
12
|
authors:
|
13
13
|
- Haim Ashkenazi
|
@@ -15,7 +15,7 @@ autorequire:
|
|
15
15
|
bindir: bin
|
16
16
|
cert_chain: []
|
17
17
|
|
18
|
-
date: 2010-10-
|
18
|
+
date: 2010-10-31 00:00:00 +02:00
|
19
19
|
default_executable:
|
20
20
|
dependencies:
|
21
21
|
- !ruby/object:Gem::Dependency
|