rcmd 1.5.6

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 1b72a21c020c10acb74666026f1e467897d46c73
+  data.tar.gz: 429163584d6ac0aab5b86ac47be0c1b8f3d57e6e
+SHA512:
+  metadata.gz: 931dc47e776a37e65df2a2e41c491e576a5e4772825a8656aaa00d20989fef2e0e6ac59c763a490925875e309585e77014ab9750fb8e30358fa5f83efad49b8b
+  data.tar.gz: f051f803433b11282bf47cfaac31278b9c7058e3046546dea76bac599c227d8bedde48f4a36c3e99055a69a90cab968c9a0a0da0f2705e26b9ffdb1282989166

data/.bundle/config

@@ -0,0 +1 @@
+---

data/.gitignore

@@ -0,0 +1 @@
+pkg/*

data/.rspec_status

@@ -0,0 +1,9 @@
+example_id               | status | run_time        |
+------------------------ | ------ | --------------- |
+./spec/rcmd_spec.rb[1:1] | passed | 0.00046 seconds |
+./spec/rcmd_spec.rb[1:2] | passed | 0.00089 seconds |
+./spec/rcmd_spec.rb[1:3] | passed | 0.00056 seconds |
+./spec/rcmd_spec.rb[1:4] | passed | 0.00009 seconds |
+./spec/rcmd_spec.rb[1:5] | passed | 0.00007 seconds |
+./spec/rcmd_spec.rb[1:6] | passed | 0.0008 seconds  |
+./spec/rcmd_spec.rb[1:7] | passed | 0.0001 seconds  |

data/.ruby-gemset

@@ -0,0 +1 @@
+rcmd

data/.ruby-version

@@ -0,0 +1 @@
+ruby-2.0.0-p648

data/Gemfile

@@ -0,0 +1,4 @@
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in rcmd.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,55 @@
+PATH
+  remote: .
+  specs:
+    rcmd (1.5.6)
+      io-console
+      net-ssh
+      thread
+      tty-prompt
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    diff-lcs (1.3)
+    equatable (0.5.0)
+    io-console (0.4.2)
+    necromancer (0.4.0)
+    net-ssh (4.1.0)
+    pastel (0.7.1)
+      equatable (~> 0.5.0)
+      tty-color (~> 0.4.0)
+    rake (10.5.0)
+    rspec (3.6.0)
+      rspec-core (~> 3.6.0)
+      rspec-expectations (~> 3.6.0)
+      rspec-mocks (~> 3.6.0)
+    rspec-core (3.6.0)
+      rspec-support (~> 3.6.0)
+    rspec-expectations (3.6.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.6.0)
+    rspec-mocks (3.6.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.6.0)
+    rspec-support (3.6.0)
+    thread (0.2.2)
+    tty-color (0.4.2)
+    tty-cursor (0.4.0)
+    tty-prompt (0.12.0)
+      necromancer (~> 0.4.0)
+      pastel (~> 0.7.0)
+      tty-cursor (~> 0.4.0)
+      wisper (~> 1.6.1)
+    wisper (1.6.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.15)
+  rake (~> 10.0)
+  rcmd!
+  rspec (~> 3.0, >= 2.0.0)
+
+BUNDLED WITH
+   1.15.1

data/README.md

@@ -0,0 +1,84 @@
+# Description
+
+rcmd (remote command) is a command line utility written in Ruby for executing the same command on
+multiple systems through ssh.  This is done by assigning a host to a
+thread and creating the ssh sessions in those threads.
+
+## Features
+
+- Command line switch for setting number of threads to be used at a time. (Default is 4)
+- A comma seperated list of hosts piped from another command can be used as the node list.
+- Username can be specified.  (Default is root.  Requires valid ssh-key in ~/.ssh)
+- Output shows which host the output is from
+- Stdout can be suppressed, only allowing for stderr to be shown
+
+## Installation
+rcmd is available as a gem and kan be installed with `gem install rcmd`
+
+
+# Usage Examples
+
+## Help Screen
+
+```bash
+daibhidh@darkstar:~/$ rcmd --help
+Usage: rcmd [options]
+    -u, --username username          Username for SSH connections
+    -n, --nodes x,y,z                Comma seperated list of nodes. use '-' for a space seperated list piped from another command
+    -t, --threads threads            Number of threads to run
+    -c, --command <command>          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
+```
+
+## Specifying nodes manually
+Specifying a comma seperated list of hosts and timing the total execution time.
+```bash 
+daibhidh@darkstar:~/$ time rcmd -n node1,node2,node3,node4 -c 'cat /etc/redhat-release'
+node2 :: Red Hat Enterprise Linux ComputeNode release 6.8 (Santiago)
+node1 :: Red Hat Enterprise Linux ComputeNode release 6.8 (Santiago)
+node4 :: Red Hat Enterprise Linux ComputeNode release 6.9 (Santiago)
+node3 :: Red Hat Enterprise Linux ComputeNode release 6.9 (Santiago)
+
+
+real	0m2.749s
+user	0m0.272s
+sys	    0m0.050s
+```
+
+## Piping list of nodes
+Using the hammer cli to get a list of hosts from a RedHat Satellite and providing it to rcmd as the node list.
+```bash
+daibhidh@darkstar:~/$ hammer --output base host list --organization org | awk '/Name:/ {print $2}' | rcmd -n - -c 'cat /etc/redhat-release'
+node1.example.com :: Red Hat Enterprise Linux ComputeNode release 6.8 (Santiago)
+node3.example.com :: Red Hat Enterprise Linux ComputeNode release 6.9 (Santiago)
+node2.example.com :: Red Hat Enterprise Linux ComputeNode release 6.8 (Santiago)
+node4.example.com :: Red Hat Enterprise Linux ComputeNode release 6.9 (Santiago)
+```
+
+## Using a database for obtaining nodes
+TODO
+
+# 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*. 
+
+Available Rake tasks are:
+
+```bash
+rake build            # Build rcmd-1.5.5.gem into the pkg directory
+rake clean            # Remove any temporary products
+rake clobber          # Remove any generated files
+rake clobber_rdoc     # Remove RDoc HTML files
+rake console          # Open an IRB console with this gem loaded
+rake install          # Build and install rcmd-1.5.5.gem into system gems
+rake install:local    # Build and install rcmd-1.5.5.gem into system gems without network access
+rake rdoc             # Build RDoc HTML files
+rake reinstall        # Remove, build, and install gem
+rake release[remote]  # Create tag v1.5.5 and build and push rcmd-1.5.5.gem to Rubygems
+rake rerdoc           # Rebuild RDoc HTML files
+rake spec             # Run RSpec code examples
+```
+
+
+

data/Rakefile

@@ -0,0 +1,37 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+require 'rdoc/task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec
+
+desc "Open an IRB console with this gem loaded"
+task :console do
+  require 'irb'
+  require 'irb/completion'
+  require 'rcmd' # You know what to do.
+  ARGV.clear
+  IRB.start
+end
+
+desc "Remove, build, and install gem"
+task :reinstall do
+  puts "Uninstalling #{`gem list rcmd`}"
+  `gem uninstall -x rcmd`
+  Rake::Task["install"].reenable
+  Rake::Task["install"].invoke
+end
+
+desc 'generate API documentation to doc/rdocs/index.html'
+
+Rake::RDocTask.new do |rd|
+  rd.rdoc_dir = 'doc/rdocs'
+  rd.main = 'README.md'
+  rd.rdoc_files.include 'README.md', "lib/**/*\.rb", "exe/**/*"
+
+  rd.options << '--inline-source'
+  rd.options << '--line-numbers'
+  rd.options << '--all'
+end
+

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "rcmd"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/doc/rdocs/OptionParser.html

@@ -0,0 +1,124 @@
+<!DOCTYPE html>
+
+<html>
+<head>
+<meta content="text/html; charset=UTF-8" http-equiv="Content-Type">
+
+<title>module OptionParser - RDoc Documentation</title>
+
+<link type="text/css" media="screen" href="./rdoc.css" rel="stylesheet">
+
+<script type="text/javascript">
+  var rdoc_rel_prefix = "./";
+</script>
+
+<script type="text/javascript" charset="utf-8" src="./js/jquery.js"></script>
+<script type="text/javascript" charset="utf-8" src="./js/navigation.js"></script>
+<script type="text/javascript" charset="utf-8" src="./js/search_index.js"></script>
+<script type="text/javascript" charset="utf-8" src="./js/search.js"></script>
+<script type="text/javascript" charset="utf-8" src="./js/searcher.js"></script>
+<script type="text/javascript" charset="utf-8" src="./js/darkfish.js"></script>
+
+
+<body id="top" class="module">
+<nav id="metadata">
+  <nav id="home-section" class="section">
+  <h3 class="section-header">
+    <a href="./index.html">Home</a>
+    <a href="./table_of_contents.html#classes">Classes</a>
+    <a href="./table_of_contents.html#methods">Methods</a>
+  </h3>
+</nav>
+
+
+  <nav id="search-section" class="section project-section" class="initially-hidden">
+  <form action="#" method="get" accept-charset="utf-8">
+    <h3 class="section-header">
+      <input type="text" name="search" placeholder="Search" id="search-field"
+             title="Type to search, Up and Down to navigate, Enter to load">
+    </h3>
+  </form>
+
+  <ul id="search-results" class="initially-hidden"></ul>
+</nav>
+
+
+  
+
+  <div id="file-metadata">
+    <nav id="file-list-section" class="section">
+  <h3 class="section-header">Defined In</h3>
+  <ul>
+    <li>exe/rcmd
+  </ul>
+</nav>
+
+    
+  </div>
+
+  <div id="class-metadata">
+    
+    
+    
+    
+    
+  </div>
+
+  <div id="project-metadata">
+    <nav id="fileindex-section" class="section project-section">
+  <h3 class="section-header">Pages</h3>
+
+  <ul>
+  
+    <li class="file"><a href="./README_md.html">README</a>
+  
+  </ul>
+</nav>
+
+    <nav id="classindex-section" class="section project-section">
+  <h3 class="section-header">Class and Module Index</h3>
+
+  <ul class="link-list">
+  
+    <li><a href="./OptionParser.html">OptionParser</a>
+  
+    <li><a href="./Rcmd.html">Rcmd</a>
+  
+  </ul>
+</nav>
+
+  </div>
+</nav>
+
+<div id="documentation">
+  <h1 class="module">module OptionParser</h1>
+
+  <div id="description" class="description">
+    
+  </div><!-- description -->
+
+  
+  
+  
+  <section id="5Buntitled-5D" class="documentation-section">
+    
+
+    
+
+    
+
+    
+
+    <!-- Methods -->
+    
+  </section><!-- 5Buntitled-5D -->
+
+</div><!-- documentation -->
+
+
+<footer id="validator-badges">
+  <p><a href="http://validator.w3.org/check/referer">[Validate]</a>
+  <p>Generated by <a href="https://github.com/rdoc/rdoc">RDoc</a> 4.0.0.
+  <p>Generated with the <a href="http://deveiate.org/projects/Darkfish-Rdoc/">Darkfish Rdoc Generator</a> 3.
+</footer>
+

data/doc/rdocs/README_md.html

@@ -0,0 +1,212 @@
+<!DOCTYPE html>
+
+<html>
+<head>
+<meta content="text/html; charset=UTF-8" http-equiv="Content-Type">
+
+<title>README - RDoc Documentation</title>
+
+<link type="text/css" media="screen" href="./rdoc.css" rel="stylesheet">
+
+<script type="text/javascript">
+  var rdoc_rel_prefix = "./";
+</script>
+
+<script type="text/javascript" charset="utf-8" src="./js/jquery.js"></script>
+<script type="text/javascript" charset="utf-8" src="./js/navigation.js"></script>
+<script type="text/javascript" charset="utf-8" src="./js/search_index.js"></script>
+<script type="text/javascript" charset="utf-8" src="./js/search.js"></script>
+<script type="text/javascript" charset="utf-8" src="./js/searcher.js"></script>
+<script type="text/javascript" charset="utf-8" src="./js/darkfish.js"></script>
+
+
+<body class="file">
+<nav id="metadata">
+  <nav id="home-section" class="section">
+  <h3 class="section-header">
+    <a href="./index.html">Home</a>
+    <a href="./table_of_contents.html#classes">Classes</a>
+    <a href="./table_of_contents.html#methods">Methods</a>
+  </h3>
+</nav>
+
+
+  <nav id="search-section" class="section project-section" class="initially-hidden">
+  <form action="#" method="get" accept-charset="utf-8">
+    <h3 class="section-header">
+      <input type="text" name="search" placeholder="Search" id="search-field"
+             title="Type to search, Up and Down to navigate, Enter to load">
+    </h3>
+  </form>
+
+  <ul id="search-results" class="initially-hidden"></ul>
+</nav>
+
+
+  
+<div id="table-of-contents">
+  <nav class="section">
+    <h3 class="section-header">Table of Contents</h3>
+    <ul>
+      <li><a href="#label-Description">Description</a>
+      <li><a href="#label-Features">Features</a>
+      <li><a href="#label-Installation">Installation</a>
+      <li><a href="#label-Usage+Examples">Usage Examples</a>
+      <li><a href="#label-Help+Screen">Help Screen</a>
+      <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+a+database+for+obtaining+nodes">Using a database for obtaining nodes</a>
+      <li><a href="#label-Development">Development</a>
+    </ul>
+  </nav>
+</div>
+
+
+  <div id="project-metadata">
+    <nav id="fileindex-section" class="section project-section">
+  <h3 class="section-header">Pages</h3>
+
+  <ul>
+  
+    <li class="file"><a href="./README_md.html">README</a>
+  
+  </ul>
+</nav>
+
+    <nav id="classindex-section" class="section project-section">
+  <h3 class="section-header">Class and Module Index</h3>
+
+  <ul class="link-list">
+  
+    <li><a href="./OptionParser.html">OptionParser</a>
+  
+    <li><a href="./Rcmd.html">Rcmd</a>
+  
+  </ul>
+</nav>
+
+  </div>
+</nav>
+
+<div id="documentation" class="description">
+  
+<h1 id="label-Description">Description<span><a href="#label-Description">&para;</a> <a href="#documentation">&uarr;</a></span></h1>
+
+<p>rcmd (remote command) is a command line utility written in Ruby for
+executing the same command on
+multiple systems through ssh. This is done by
+assigning a host to a
+thread and creating the ssh sessions in those
+threads.</p>
+
+<h2 id="label-Features">Features<span><a href="#label-Features">&para;</a> <a href="#documentation">&uarr;</a></span></h2>
+<ul><li>
+<p>Command line switch for setting number of threads to be used at a time.
+(Default is 4)</p>
+</li><li>
+<p>A comma seperated list of hosts piped from another command can be used as
+the node list.</p>
+</li><li>
+<p>Username can be specified. (Default is root. Requires valid ssh-key in
+~/.ssh)</p>
+</li><li>
+<p>Output shows which host the output is from</p>
+</li><li>
+<p>Stdout can be suppressed, only allowing for stderr to be shown</p>
+</li></ul>
+
+<h2 id="label-Installation">Installation<span><a href="#label-Installation">&para;</a> <a href="#documentation">&uarr;</a></span></h2>
+
+<p>rcmd is available as a gem and kan be installed with <code>gem install
+rcmd</code></p>
+
+<h1 id="label-Usage+Examples">Usage Examples<span><a href="#label-Usage+Examples">&para;</a> <a href="#documentation">&uarr;</a></span></h1>
+
+<h2 id="label-Help+Screen">Help Screen<span><a href="#label-Help+Screen">&para;</a> <a href="#documentation">&uarr;</a></span></h2>
+
+<pre>daibhidh@darkstar:~/$ rcmd --help
+Usage: rcmd [options]
+    -u, --username username          Username for SSH connections
+    -n, --nodes x,y,z                Comma seperated list of nodes. use &#39;-&#39; for a space seperated list piped from another command
+    -t, --threads threads            Number of threads to run
+    -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</pre>
+
+<h2 id="label-Specifying+nodes+manually">Specifying nodes manually<span><a href="#label-Specifying+nodes+manually">&para;</a> <a href="#documentation">&uarr;</a></span></h2>
+
+<p>Specifying a comma seperated list of hosts and timing the total execution
+time.
+```bash
+daibhidh@darkstar:~/$ time rcmd -n node1,node2,node3,node4 -c
+&#39;cat /etc/redhat-release&#39;
+node2 :: Red Hat Enterprise Linux
+ComputeNode release 6.8 (Santiago)
+node1 :: Red Hat Enterprise Linux
+ComputeNode release 6.8 (Santiago)
+node4 :: Red Hat Enterprise Linux
+ComputeNode release 6.9 (Santiago)
+node3 :: Red Hat Enterprise Linux
+ComputeNode release 6.9 (Santiago)</p>
+
+<p>real 0m2.749s
+user 0m0.272s
+sys 0m0.050s
+```</p>
+
+<h2 id="label-Piping+list+of+nodes">Piping list of nodes<span><a href="#label-Piping+list+of+nodes">&para;</a> <a href="#documentation">&uarr;</a></span></h2>
+
+<p>Using the hammer cli to get a list of hosts from a RedHat Satellite and
+providing it to rcmd as the node
+list.
+&lt;code&gt;bash
+daibhidh@darkstar:~/$ hammer --output base host list
+--organization org | awk &#39;/Name:/ {print $2}&#39; | rcmd -n - -c
+&#39;cat /etc/redhat-release&#39;
+node1.example.com :: Red Hat Enterprise
+Linux ComputeNode release 6.8 (Santiago)
+node3.example.com :: Red Hat
+Enterprise Linux ComputeNode release 6.9 (Santiago)
+node2.example.com ::
+Red Hat Enterprise Linux ComputeNode release 6.8
+(Santiago)
+node4.example.com :: Red Hat Enterprise Linux ComputeNode
+release 6.9 (Santiago)
+&lt;/code&gt;</p>
+
+<h2 id="label-Using+a+database+for+obtaining+nodes">Using a database for obtaining nodes<span><a href="#label-Using+a+database+for+obtaining+nodes">&para;</a> <a href="#documentation">&uarr;</a></span></h2>
+
+<p>TODO</p>
+
+<h1 id="label-Development">Development<span><a href="#label-Development">&para;</a> <a href="#documentation">&uarr;</a></span></h1>
+
+<p>If you are wanting to modify the code by all means do so. If you clone this
+repository you can then run <code>bundle install</code> to install the
+dependencies needed. Tests are performed with <em>rspec</em> and can be run
+with <em>rake</em>.</p>
+
+<p>Available Rake tasks are:</p>
+
+<pre>rake build            # Build rcmd-1.5.5.gem into the pkg directory
+rake clean            # Remove any temporary products
+rake clobber          # Remove any generated files
+rake clobber_rdoc     # Remove RDoc HTML files
+rake console          # Open an IRB console with this gem loaded
+rake install          # Build and install rcmd-1.5.5.gem into system gems
+rake install:local    # Build and install rcmd-1.5.5.gem into system gems without network access
+rake rdoc             # Build RDoc HTML files
+rake reinstall        # Remove, build, and install gem
+rake release[remote]  # Create tag v1.5.5 and build and push rcmd-1.5.5.gem to Rubygems
+rake rerdoc           # Rebuild RDoc HTML files
+rake spec             # Run RSpec code examples</pre>
+
+</div>
+
+
+
+<footer id="validator-badges">
+  <p><a href="http://validator.w3.org/check/referer">[Validate]</a>
+  <p>Generated by <a href="https://github.com/rdoc/rdoc">RDoc</a> 4.0.0.
+  <p>Generated with the <a href="http://deveiate.org/projects/Darkfish-Rdoc/">Darkfish Rdoc Generator</a> 3.
+</footer>
+