rcmd 1.6.1 → 1.6.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: e4563953aff83897f4899328c3f000498ab4f100
-  data.tar.gz: d2bb4812cc89cd48309d2a7ed7064cb15b1b8141
+  metadata.gz: b8542fc87d941f9ed35d452d2ec13e2768d64ab7
+  data.tar.gz: ec6a1802464731852d3abcb4f19885e290f28940
 SHA512:
-  metadata.gz: 45e1753421d2c0bb26679f0415952dc8a4c359911746a9b55e341a61b5192107c7a970615be82043f7b4855543c895bf65ab720ee05a117ea8b61abd156f957f
-  data.tar.gz: f278680296d128fce092b4f1d3472bf55a5bbf01cd14b900a6d9e84a297aafa193ffca5797909878bedaa5ce5520f29199d584d71ca400da4912d50b6b3afc40
+  metadata.gz: 520f19d927f6a119f45055d231684549448b9d53091c18fc395dc02cdc1ca8e655516b8342b3b073b75b2125bc53ea308eb5e9f2c3d63366207718c5dddff4f4
+  data.tar.gz: 040ae8d280f7b230a636827db280910b86e29e5ebfc98663972e0bcc305d37e1ffa3f99bc1bf476afb84904318b3374f2dc8b370c3d9963e496b0053de20e1ad

data/Gemfile.lock

@@ -1,8 +1,9 @@
 PATH
   remote: .
   specs:
-    rcmd (1.6.1)
-      activerecord (= 4.0.0)
+    rcmd (1.6.2)
+      activerecord (= 4.2.6)
+      activesupport (= 4.2.6)
       io-console
       net-ssh
       regexp-examples
@@ -12,30 +13,28 @@ PATH
 GEM
   remote: https://rubygems.org/
   specs:
-    activemodel (4.0.0)
-      activesupport (= 4.0.0)
-      builder (~> 3.1.0)
-    activerecord (4.0.0)
-      activemodel (= 4.0.0)
-      activerecord-deprecated_finders (~> 1.0.2)
-      activesupport (= 4.0.0)
-      arel (~> 4.0.0)
-    activerecord-deprecated_finders (1.0.4)
-    activesupport (4.0.0)
-      i18n (~> 0.6, >= 0.6.4)
-      minitest (~> 4.2)
-      multi_json (~> 1.3)
-      thread_safe (~> 0.1)
-      tzinfo (~> 0.3.37)
-    arel (4.0.2)
-    builder (3.1.4)
+    activemodel (4.2.6)
+      activesupport (= 4.2.6)
+      builder (~> 3.1)
+    activerecord (4.2.6)
+      activemodel (= 4.2.6)
+      activesupport (= 4.2.6)
+      arel (~> 6.0)
+    activesupport (4.2.6)
+      i18n (~> 0.7)
+      json (~> 1.7, >= 1.7.7)
+      minitest (~> 5.1)
+      thread_safe (~> 0.3, >= 0.3.4)
+      tzinfo (~> 1.1)
+    arel (6.0.4)
+    builder (3.2.3)
     diff-lcs (1.3)
     equatable (0.5.0)
     hitimes (1.2.6)
     i18n (0.8.6)
     io-console (0.4.6)
-    minitest (4.7.5)
-    multi_json (1.12.2)
+    json (1.8.6)
+    minitest (5.10.3)
     necromancer (0.4.0)
     net-ssh (4.2.0)
     pastel (0.7.1)
@@ -70,14 +69,15 @@ GEM
       tty-reader (~> 0.1.0)
     tty-reader (0.1.0)
       wisper (~> 2.0.0)
-    tzinfo (0.3.53)
+    tzinfo (1.2.3)
+      thread_safe (~> 0.1)
     wisper (2.0.0)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
-  bundler (~> 1.15)
+  bundler (>= 1.0)
   rake (~> 10.0)
   rcmd!
   rspec (~> 3.0, >= 2.0.0)

data/README.md

@@ -30,6 +30,12 @@ Usage: rcmd [options]
     -q, --quiet                      Suppress stdout of commands.  stderr will still be displayed
     -v, --version                    Print what version of the command is in use
     -D, --debug                      Print debug information
+ 
+Database Options
+    -C, --create-config              Create template dbconfig file in ~/.rcmd
+    -T, --type server-type           Database query on server type
+    -H, --host hostname-pattern      Database query on hostname (sql like query)
+    -O, --os operating-system        Database query on Operating System string
 ```
 
 ## Specifying nodes manually
@@ -73,6 +79,71 @@ node9 :: node9.example.com
 node12 :: node12.example.com
 ```
 
+## Database backend support
+The database backend support is provided by ActiveRecord and thus
+compatible with databases which are supported by ActiveRecord.
+Currently the ActiveRecord version is locked to 4.0.0 in the Gemspec
+due to compatibilty issues with RHEL, CentOS, and Mac OSx to name a
+few.
+
+To set up the database backend run rcmd with the '-C' switch first.
+This will create a database configuration file in ~/.rcmd named
+dbconfig.yml.  In this file you can specify the adapter, and various
+other soptions for the database backend.  For the queries to work
+properly, the :host_field: *MUST* be set so the command knows what
+column contains the host name.
+
+Two optional fields exist as well, which are type_field and os_field.
+While these are meant to represent "Server type (I.e. Web, DB, etc)
+and Operating System Name/version, you can map these to whatever
+fields you would like to be able to sort by.  If these fields are not
+specified then using the associated command line options will result
+in a run time error.
+
+To minimize the size and possible issues with various backend
+adapters, no adapters are listed/installed when installing this Gem.
+It is up to you to install the correct adapter for the database you
+are wanting to connect to.
+
+The '-T' and '-O' options use strict matching in their queries where
+as the '-H' option uses a 'LIKE' query.
+
+### Database backend examples
+
+Hostname query (Match all systems whose hostname starts with node and contains at least two additional charectors):
+```bash
+daibhidh@darkstar:~/$ rcmd -H 'node%_' -c 'hostname -f'
+node20 :: node20.example.com
+node10 :: node10.example.com
+node12 :: node12.example.com
+node13 :: node13.example.com
+node15 :: node15.example.com
+node16 :: node16.example.com
+node18 :: node18.example.com
+node17 :: node17.example.com
+node11 :: node11.example.com
+node19 :: node19.example.com
+node14 :: node14.example.com
+```
+
+Type query (Match all hosts listed as web servers):
+```bash
+daibhidh@darkstar:~/$ rcmd -T 'web' -c 'hostname -f'
+node11 :: node11.example.com
+node19 :: node19.example.com
+node14 :: node14.example.com
+```
+
+OS query (Match all hosts listed as running slackware):
+```bash
+daibhidh@darkstar:~/$ rcmd -o 'slackware' -c 'hostname -f'
+node10 :: node10.example.com
+node12 :: node12.example.com
+node18 :: node18.example.com
+node17 :: node17.example.com
+node11 :: node11.example.com
+```
+
 # Development
 
 If you are wanting to modify the code by all means do so.  If you clone this repository you can then run `bundle install` to install the dependencies needed.  Tests are performed with *rspec* and can be run with *rake*. 

data/doc/rdocs/README_md.html

@@ -64,6 +64,8 @@
     <li><a href="#label-Specifying+nodes+manually">Specifying nodes manually</a>
     <li><a href="#label-Piping+list+of+nodes">Piping list of nodes</a>
     <li><a href="#label-Using+regex+to+build+node+list">Using regex to build node list</a>
+    <li><a href="#label-Database+backend+support">Database backend support</a>
+    <li><a href="#label-Database+backend+examples">Database backend examples</a>
     <li><a href="#label-Development">Development</a>
   </ul>
 </div>
@@ -125,7 +127,13 @@ rcmd</code></p>
     -c, --command &lt;command&gt;          Quoted string containing the command to be run
     -q, --quiet                      Suppress stdout of commands.  stderr will still be displayed
     -v, --version                    Print what version of the command is in use
-    -D, --debug                      Print debug information</pre>
+    -D, --debug                      Print debug information
+ 
+Database Options
+    -C, --create-config              Create template dbconfig file in ~/.rcmd
+    -T, --type server-type           Database query on server type
+    -H, --host hostname-pattern      Database query on hostname (sql like query)
+    -O, --os operating-system        Database query on Operating System string</pre>
 
 <h2 id="label-Specifying+nodes+manually">Specifying nodes manually<span><a href="#label-Specifying+nodes+manually">&para;</a> <a href="#top">&uarr;</a></span></h2>
 
@@ -166,6 +174,56 @@ node11 :: CONNECT ERROR :: Unable to connect to host!
 node9 :: node9.example.com
 node12 :: node12.example.com</pre>
 
+<h2 id="label-Database+backend+support">Database backend support<span><a href="#label-Database+backend+support">&para;</a> <a href="#top">&uarr;</a></span></h2>
+
+<p>The database backend support is provided by ActiveRecord and thus
+compatible with databases which are supported by ActiveRecord. Currently
+the ActiveRecord version is locked to 4.0.0 in the Gemspec due to
+compatibilty issues with RHEL, CentOS, and Mac OSx to name a few.</p>
+
+<p>To set up the database backend run rcmd with the &#39;-C&#39; switch first.
+This will create a database configuration file in ~/.rcmd named
+dbconfig.yml. In this file you can specify the adapter, and various other
+soptions for the database backend. For the queries to work properly, the
+:host_field: <em>MUST</em> be set so the command knows what column contains
+the host name.</p>
+
+<p>Two optional fields exist as well, which are type_field and os_field. While
+these are meant to represent “Server type (I.e. Web, DB, etc) and Operating
+System Name/version, you can map these to whatever fields you would like to
+be able to sort by. If these fields are not specified then using the
+associated command line options will result in a run time error.</p>
+
+<p>To minimize the size and possible issues with various backend adapters, no
+adapters are listed/installed when installing this Gem. It is up to you to
+install the correct adapter for the database you are wanting to connect to.</p>
+
+<p>The &#39;-T&#39; and &#39;-O&#39; options use strict matching in their
+queries where as the &#39;-H&#39; option uses a &#39;LIKE&#39; query.</p>
+
+<h3 id="label-Database+backend+examples">Database backend examples<span><a href="#label-Database+backend+examples">&para;</a> <a href="#top">&uarr;</a></span></h3>
+
+<p>Hostname query (Match all systems whose hostname starts with node and
+contains at least two additional charectors): <code>bash
+daibhidh@darkstar:~/$ rcmd -H &#39;node%_&#39; -c &#39;hostname -f&#39;
+node20 :: node20.example.com node10 :: node10.example.com node12 ::
+node12.example.com node13 :: node13.example.com node15 ::
+node15.example.com node16 :: node16.example.com node18 ::
+node18.example.com node17 :: node17.example.com node11 ::
+node11.example.com node19 :: node19.example.com node14 ::
+node14.example.com </code></p>
+
+<p>Type query (Match all hosts listed as web servers): <code>bash
+daibhidh@darkstar:~/$ rcmd -T &#39;web&#39; -c &#39;hostname -f&#39; node11
+:: node11.example.com node19 :: node19.example.com node14 ::
+node14.example.com </code></p>
+
+<p>OS query (Match all hosts listed as running slackware): <code>bash
+daibhidh@darkstar:~/$ rcmd -o &#39;slackware&#39; -c &#39;hostname -f&#39;
+node10 :: node10.example.com node12 :: node12.example.com node18 ::
+node18.example.com node17 :: node17.example.com node11 ::
+node11.example.com </code></p>
+
 <h1 id="label-Development">Development<span><a href="#label-Development">&para;</a> <a href="#top">&uarr;</a></span></h1>
 
 <p>If you are wanting to modify the code by all means do so. If you clone this

data/doc/rdocs/created.rid

@@ -1,6 +1,6 @@
-Fri, 06 Oct 2017 20:18:52 +0000
-README.md	Wed, 04 Oct 2017 13:14:39 +0000
-lib/rcmd.rb	Fri, 06 Oct 2017 19:05:45 +0000
-lib/rcmd/db.rb	Fri, 06 Oct 2017 20:07:48 +0000
-lib/rcmd/version.rb	Fri, 06 Oct 2017 19:04:22 +0000
-exe/rcmd	Fri, 06 Oct 2017 19:36:13 +0000
+Fri, 06 Oct 2017 22:12:36 +0000
+README.md	Fri, 06 Oct 2017 22:09:32 +0000
+lib/rcmd.rb	Fri, 06 Oct 2017 20:23:25 +0000
+lib/rcmd/db.rb	Fri, 06 Oct 2017 20:23:25 +0000
+lib/rcmd/version.rb	Fri, 06 Oct 2017 22:10:08 +0000
+exe/rcmd	Fri, 06 Oct 2017 21:52:54 +0000

data/doc/rdocs/index.html

@@ -123,7 +123,13 @@ rcmd</code></p>
     -c, --command &lt;command&gt;          Quoted string containing the command to be run
     -q, --quiet                      Suppress stdout of commands.  stderr will still be displayed
     -v, --version                    Print what version of the command is in use
-    -D, --debug                      Print debug information</pre>
+    -D, --debug                      Print debug information
+ 
+Database Options
+    -C, --create-config              Create template dbconfig file in ~/.rcmd
+    -T, --type server-type           Database query on server type
+    -H, --host hostname-pattern      Database query on hostname (sql like query)
+    -O, --os operating-system        Database query on Operating System string</pre>
 
 <h2 id="label-Specifying+nodes+manually">Specifying nodes manually<span><a href="#label-Specifying+nodes+manually">&para;</a> <a href="#top">&uarr;</a></span></h2>
 
@@ -164,6 +170,56 @@ node11 :: CONNECT ERROR :: Unable to connect to host!
 node9 :: node9.example.com
 node12 :: node12.example.com</pre>
 
+<h2 id="label-Database+backend+support">Database backend support<span><a href="#label-Database+backend+support">&para;</a> <a href="#top">&uarr;</a></span></h2>
+
+<p>The database backend support is provided by ActiveRecord and thus
+compatible with databases which are supported by ActiveRecord. Currently
+the ActiveRecord version is locked to 4.0.0 in the Gemspec due to
+compatibilty issues with RHEL, CentOS, and Mac OSx to name a few.</p>
+
+<p>To set up the database backend run rcmd with the &#39;-C&#39; switch first.
+This will create a database configuration file in ~/.rcmd named
+dbconfig.yml. In this file you can specify the adapter, and various other
+soptions for the database backend. For the queries to work properly, the
+:host_field: <em>MUST</em> be set so the command knows what column contains
+the host name.</p>
+
+<p>Two optional fields exist as well, which are type_field and os_field. While
+these are meant to represent “Server type (I.e. Web, DB, etc) and Operating
+System Name/version, you can map these to whatever fields you would like to
+be able to sort by. If these fields are not specified then using the
+associated command line options will result in a run time error.</p>
+
+<p>To minimize the size and possible issues with various backend adapters, no
+adapters are listed/installed when installing this Gem. It is up to you to
+install the correct adapter for the database you are wanting to connect to.</p>
+
+<p>The &#39;-T&#39; and &#39;-O&#39; options use strict matching in their
+queries where as the &#39;-H&#39; option uses a &#39;LIKE&#39; query.</p>
+
+<h3 id="label-Database+backend+examples">Database backend examples<span><a href="#label-Database+backend+examples">&para;</a> <a href="#top">&uarr;</a></span></h3>
+
+<p>Hostname query (Match all systems whose hostname starts with node and
+contains at least two additional charectors): <code>bash
+daibhidh@darkstar:~/$ rcmd -H &#39;node%_&#39; -c &#39;hostname -f&#39;
+node20 :: node20.example.com node10 :: node10.example.com node12 ::
+node12.example.com node13 :: node13.example.com node15 ::
+node15.example.com node16 :: node16.example.com node18 ::
+node18.example.com node17 :: node17.example.com node11 ::
+node11.example.com node19 :: node19.example.com node14 ::
+node14.example.com </code></p>
+
+<p>Type query (Match all hosts listed as web servers): <code>bash
+daibhidh@darkstar:~/$ rcmd -T &#39;web&#39; -c &#39;hostname -f&#39; node11
+:: node11.example.com node19 :: node19.example.com node14 ::
+node14.example.com </code></p>
+
+<p>OS query (Match all hosts listed as running slackware): <code>bash
+daibhidh@darkstar:~/$ rcmd -o &#39;slackware&#39; -c &#39;hostname -f&#39;
+node10 :: node10.example.com node12 :: node12.example.com node18 ::
+node18.example.com node17 :: node17.example.com node11 ::
+node11.example.com </code></p>
+
 <h1 id="label-Development">Development<span><a href="#label-Development">&para;</a> <a href="#top">&uarr;</a></span></h1>
 
 <p>If you are wanting to modify the code by all means do so. If you clone this

data/doc/rdocs/table_of_contents.html

@@ -37,6 +37,8 @@
       <li><a href="README_md.html#label-Specifying+nodes+manually">Specifying nodes manually</a>
       <li><a href="README_md.html#label-Piping+list+of+nodes">Piping list of nodes</a>
       <li><a href="README_md.html#label-Using+regex+to+build+node+list">Using regex to build node list</a>
+      <li><a href="README_md.html#label-Database+backend+support">Database backend support</a>
+      <li><a href="README_md.html#label-Database+backend+examples">Database backend examples</a>
       <li><a href="README_md.html#label-Development">Development</a>
     </ul>
   </li>

data/exe/rcmd

@@ -36,7 +36,7 @@ opts.separator "Database Options"
 opts.on('-C', '--create-config', "Create template dbconfig file in ~/.rcmd") { |v| options[:config] = v}
 opts.on('-T server-type ', '--type server-type', "Database query on server type") { |v| options[:type] = v}
 opts.on('-H hostname-pattern', '--host hostname-pattern', "Database query on hostname (sql like query)") { |v| options[:host] = v}
-opts.on('-O operating-system', '--os operating-system", "Database query on Operating System string') { |v| options[:os] = v}
+opts.on('-O operating-system', '--os operating-system', "Database query on Operating System string") { |v| options[:os] = v}
 
 # Process options
 begin

data/lib/rcmd/version.rb

@@ -1,4 +1,4 @@
 module Rcmd # :notnew:
   # +VERSION+ - Version number string
-  VERSION = "1.6.1"
+  VERSION = "1.6.2"
 end

data/rcmd.gemspec

@@ -36,9 +36,10 @@ Gem::Specification.new do |spec|
   spec.add_runtime_dependency('io-console')
   spec.add_runtime_dependency('thread')
   spec.add_runtime_dependency('tty-prompt')
-  spec.add_runtime_dependency('activerecord', '= 4.0.0')
+  spec.add_runtime_dependency('activesupport', '= 4.2.6')
+  spec.add_runtime_dependency('activerecord', '= 4.2.6')
   spec.add_runtime_dependency('regexp-examples')
   spec.add_development_dependency('rspec', '~> 3.0', '>= 2.0.0')
-  spec.add_development_dependency "bundler", "~> 1.15"
+  spec.add_development_dependency "bundler", ">= 1.0"
   spec.add_development_dependency "rake", "~> 10.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rcmd
 version: !ruby/object:Gem::Version
-  version: 1.6.1
+  version: 1.6.2
 platform: ruby
 authors:
 - David Rose
@@ -66,20 +66,34 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 4.2.6
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 4.2.6
 - !ruby/object:Gem::Dependency
   name: activerecord
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 4.0.0
+        version: 4.2.6
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 4.0.0
+        version: 4.2.6
 - !ruby/object:Gem::Dependency
   name: regexp-examples
   requirement: !ruby/object:Gem::Requirement
@@ -118,16 +132,16 @@ dependencies:
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.15'
+        version: '1.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.15'
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement