shexy 0.1

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/Gemfile

@@ -0,0 +1,18 @@
+source "http://rubygems.org"
+# Add dependencies required to use your gem here.
+# Example:
+#   gem "activesupport", ">= 2.3.5"
+
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+#
+gem "net-ssh"
+gem "net-scp"
+
+group :development do
+  gem "shoulda", ">= 0"
+  gem "rdoc", ">= 3.12"
+  gem "bundler", ">= 1.0.0"
+  gem "jeweler", ">= 1.8.4"
+  gem "simplecov", ">= 0"
+end

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2012 Sergio Rubio
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,42 @@
+# Shexy
+
+SSH, the way I like it.
+
+## Do it 
+
+    require 'shexy'
+
+    Shexy.user = 'test'
+    Shexy.password = 'test'
+    Shexy.host = 'test-host'
+    out, err = Shexy.exe 'ls -la'
+    out.empty? # no output
+    err.empty? # no error output
+
+    Shexy.exe 'la -la' do |out,err|
+      puts out
+      puts err
+    end
+
+Another way, assuming you are using SSH keys 
+and added them to the SSH agent (ssh-add ~/.ssh/my-priv-key):
+
+    Shexy.exe 'test@test-host', 'ls -la' do |out, err|
+      puts out
+    end
+    Shexy.exe 'echo hello' # no need to add host/user again
+
+Copying files (local -> remote):
+
+    Shexy.copy_to 'test@test-host', '/home/rubiojr/my-uber-file', '/tmp/'
+
+## Caution
+
+I was bored writing net-ssh boilerplate, so I created this highly 
+experimental sh*t (a small amount of it, but experimental).
+
+## Copyright
+
+Copyright (c) 2012 Sergio Rubio. See LICENSE.txt for
+further details.
+

data/Rakefile

@@ -0,0 +1,48 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+require './lib/shexy.rb'
+
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.version = Shexy::VERSION
+  gem.name = "shexy"
+  gem.homepage = "http://github.com/rubiojr/shexy"
+  gem.license = "MIT"
+  gem.summary = %Q{SSH, the way I like it}
+  gem.description = %Q{[extremely] thin wrapper around net-ssh and net-scp}
+  gem.email = "rubiojr@frameos.org"
+  gem.authors = ["Sergio Rubio"]
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+task :default => :build
+
+require 'rdoc/task'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "shexy #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/lib/shexy.rb

@@ -0,0 +1,154 @@
+require 'net/ssh'
+require 'net/scp'
+
+#
+# Execute commands in remote servers (SSH)
+#
+#     require 'shexy'
+#
+#     Shexy.user = 'test'
+#     Shexy.password = 'test'
+#     Shexy.host = 'test-host'
+#     out, err = Shexy.exe 'ls -la'
+#     out.empty? # no output
+#     err.empty? # no error output
+#
+#     Shexy.exe 'la -la' do |out,err|
+#       puts out
+#       puts err
+#     end
+#
+# Another way, assuming you are using SSH keys 
+# and added them to the SSH agent (ssh-add ~/.ssh/my-priv-key):
+#
+#     Shexy.exe 'test@test-host', 'ls -la' do |out, err|
+#       puts out
+#     end
+#     Shexy.exe 'echo hello' # no need to add host/user again
+#
+# Copying files (local -> remote):
+#
+#     Shexy.copy_to 'test@test-host', '/home/rubiojr/my-uber-file', '/tmp/'
+#
+module Shexy
+
+  VERSION = '0.1'
+
+  @flags = {}
+
+  def self.password=(password); flags[:password] = password; end
+  def self.password; flags[:password]; end
+  def self.key=(key); flags[:keys] = [File.expand_path(key)]; end
+  def self.key; flags[:keys]; end
+  def self.use_sudo; @sudo = true; end
+  def self.sudo?; @sudo ||= false; end
+
+  class << self
+    attr_accessor :host, :user, :flags
+    attr_reader :cmd
+  end
+
+  def self.exe(*args)
+    args.flatten!
+    if args.size > 1
+      @host = args[0]
+      if @host =~ /@/
+        @user, @host = @host.split '@'
+      end
+      @cmd = args[1]
+    else
+      @cmd = args[0]
+    end
+    Net::SSH.start(host, user, flags) do |sh|
+      sh.open_channel do |ch| 
+        if sudo?
+          ch.request_pty 
+          @cmd = "sudo #{@cmd}"
+        end
+        ch.exec cmd do
+          # FIXME: I don't think it's a good idea
+          # to implement access to stdout,stderr this way
+          stdout = ""
+          stderr = ""
+          ch.on_extended_data do |c2, type, data|
+            # ERROR output here
+            stderr << data
+            yield stdout, stderr if block_given?
+          end
+          ch.on_data do |c2, data|
+            stdout << data
+            yield stdout, stderr if block_given?
+          end
+          ch.on_close do |c2|
+            return stdout, stderr
+          end
+        end
+      end
+    end
+  end
+
+  #
+  # Shexy.copy_to 'root@foobar.com', 'source_file', 'dest_file'
+  #
+  # or
+  #
+  # Shexy.host = 'foobar.com'
+  # Shexy.user = 'root'
+  # Shexy.copy_to 'source_file', 'dest_file'
+  # 
+  def self.copy_to(*args)
+    if args.size > 2
+      # First arg assumed to be foo@host.net
+      @host = args[0]
+      if @host =~ /@/
+        @user, @host = @host.split '@'
+      end
+      from = args[1]
+      to = args[2]
+    else
+      # user, host already set via Shexy.host and
+      # Shexy.user
+      from = args[0]
+      to = args[1]
+    end
+    from = File.expand_path from
+    Net::SCP.start(host, user, flags) do |scp|
+      scp.upload! from, to
+    end
+  end
+
+  # 
+  # Detect distro version
+  #
+  def self.distro
+    issue.match(/fedora|centos|frameos|debian|ubuntu|scientific linux/i)[0].gsub(" ", "_").downcase.to_sym
+  end
+
+  #
+  # Detect distro release
+  #
+  def self.distro_release
+    case distro 
+    when :redhat,:centos,:frameos
+      issue.split[2]
+    when :fedora
+      issue.split[2]
+    when :ubuntu
+      issue.split[1]
+    when :debian
+      issue.split[2]
+    else
+      '0'
+    end
+  end
+
+  #
+  # Lame but short, and it works (most of the times)
+  #
+  def self.issue
+    issue, err = ((exe 'cat /etc/issue')[0].strip.chomp || Shexy.exe('lsb_release -i')[0].strip.chomp).lines.first
+    raise Exception.new "Error reading release info." unless (err.nil? or err.empty?)
+    issue
+  end
+
+end

data/test/helper.rb

@@ -0,0 +1,18 @@
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'test/unit'
+require 'shoulda'
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'shexy'
+
+class Test::Unit::TestCase
+end

data/test/test_shexy.rb

@@ -0,0 +1,7 @@
+require 'helper'
+
+class TestShexy < Test::Unit::TestCase
+  should "probably rename this file and start testing for real" do
+    flunk "hey buddy, you should probably rename this file and start testing for real"
+  end
+end

metadata

@@ -0,0 +1,170 @@
+--- !ruby/object:Gem::Specification
+name: shexy
+version: !ruby/object:Gem::Version
+  version: '0.1'
+  prerelease: 
+platform: ruby
+authors:
+- Sergio Rubio
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-09-07 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: net-ssh
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: net-scp
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: shoulda
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3.12'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.8.4
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.8.4
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: ! '[extremely] thin wrapper around net-ssh and net-scp'
+email: rubiojr@frameos.org
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- README.rdoc
+files:
+- .document
+- Gemfile
+- LICENSE.txt
+- README.rdoc
+- Rakefile
+- lib/shexy.rb
+- test/helper.rb
+- test/test_shexy.rb
+homepage: http://github.com/rubiojr/shexy
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 518133985048816115
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: SSH, the way I like it
+test_files: []