remoting 0.2.8

data/Gemfile

@@ -0,0 +1,8 @@
+source 'https://rubygems.org'
+
+gem 'rails', '~> 3.0'
+gem 'net-ssh'
+
+group :development do
+  gem "jeweler", "~> 1.8.3"
+end

data/Gemfile.lock

@@ -0,0 +1,94 @@
+GEM
+  remote: https://rubygems.org/
+  specs:
+    actionmailer (3.2.3)
+      actionpack (= 3.2.3)
+      mail (~> 2.4.4)
+    actionpack (3.2.3)
+      activemodel (= 3.2.3)
+      activesupport (= 3.2.3)
+      builder (~> 3.0.0)
+      erubis (~> 2.7.0)
+      journey (~> 1.0.1)
+      rack (~> 1.4.0)
+      rack-cache (~> 1.2)
+      rack-test (~> 0.6.1)
+      sprockets (~> 2.1.2)
+    activemodel (3.2.3)
+      activesupport (= 3.2.3)
+      builder (~> 3.0.0)
+    activerecord (3.2.3)
+      activemodel (= 3.2.3)
+      activesupport (= 3.2.3)
+      arel (~> 3.0.2)
+      tzinfo (~> 0.3.29)
+    activeresource (3.2.3)
+      activemodel (= 3.2.3)
+      activesupport (= 3.2.3)
+    activesupport (3.2.3)
+      i18n (~> 0.6)
+      multi_json (~> 1.0)
+    arel (3.0.2)
+    builder (3.0.0)
+    erubis (2.7.0)
+    git (1.2.5)
+    hike (1.2.1)
+    i18n (0.6.0)
+    jeweler (1.8.3)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+      rdoc
+    journey (1.0.3)
+    json (1.7.0)
+    mail (2.4.4)
+      i18n (>= 0.4.0)
+      mime-types (~> 1.16)
+      treetop (~> 1.4.8)
+    mime-types (1.18)
+    multi_json (1.3.4)
+    net-ssh (2.3.0)
+    polyglot (0.3.3)
+    rack (1.4.1)
+    rack-cache (1.2)
+      rack (>= 0.4)
+    rack-ssl (1.3.2)
+      rack
+    rack-test (0.6.1)
+      rack (>= 1.0)
+    rails (3.2.3)
+      actionmailer (= 3.2.3)
+      actionpack (= 3.2.3)
+      activerecord (= 3.2.3)
+      activeresource (= 3.2.3)
+      activesupport (= 3.2.3)
+      bundler (~> 1.0)
+      railties (= 3.2.3)
+    railties (3.2.3)
+      actionpack (= 3.2.3)
+      activesupport (= 3.2.3)
+      rack-ssl (~> 1.3.2)
+      rake (>= 0.8.7)
+      rdoc (~> 3.4)
+      thor (~> 0.14.6)
+    rake (0.9.2.2)
+    rdoc (3.12)
+      json (~> 1.4)
+    sprockets (2.1.3)
+      hike (~> 1.2)
+      rack (~> 1.0)
+      tilt (~> 1.1, != 1.3.0)
+    thor (0.14.6)
+    tilt (1.3.3)
+    treetop (1.4.10)
+      polyglot
+      polyglot (>= 0.3.1)
+    tzinfo (0.3.33)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  jeweler (~> 1.8.3)
+  net-ssh
+  rails (~> 3.0)

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2012 Maurizio Casimirri
+
+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.md

@@ -0,0 +1,157 @@
+# Remoting
+
+*Remoting* is a great way to turn plain rake tasks in scripts to administer the server remotingly. It provides a little framework to run remoting commands over SSH along with a DSL to define remoting scripts.
+
+Install
+
+    gem 'remoting'
+    
+Update your bundle
+  
+    bundle install
+
+Generate `remote.yml` stub
+
+    rails g remoting:install
+
+Edit `config/remote.yml`
+
+``` yml
+    remote:
+      any_setting_you_like: Here you can define properties that will be available in 'config' struct inside rake tasks!
+      example: Below are some tipical configuration settings you may wish to define ...
+      login: user@server
+      dest: /var/ror/myapp
+      repo: git@gitserver:myapp.git
+      ruby: 1.9.3
+      gemset: myapp
+```       
+
+## Usage
+
+Just require `remoting/task` inside your tasks. NOTE: you can also require it globally but is not recommended cause here `String` is patched to enable bash-flavoured syntax.
+
+_ex._
+
+    desc "Restart the server"
+    task :restart do
+      require 'remoting/task'
+    
+      remote('restart', config.login) do
+       mkdir '-p', config.dest.join('tmp')
+       touch config.dest.join('tmp', 'restart.txt') 
+      end
+    
+    end
+ 
+Methods invoked inside the `remote` block are executed inside a ssh session. `remote` takes two arguments: `name` and `login`. `name` serves only for logging purposal while `login` is the login string to access the server supplied in the form of `user@host`
+
+### DSL
+
+By examples
+  
+    remote("my task", config.login) do 
+
+      ps("aux") | grep("mysql") 
+      echo 'noise' > "/dev/null"
+      echo 'setting=value' >> "settings.conf"
+      tail -100 config.dir.join('log', 'logfile.log')
+      command("[[ -f \"path\" ]] && run_a_command")
+
+    end
+
+### Local Tasks using DSL
+
+You can also define local tasks using the same DSL
+
+    desc "Setup git origin"
+    task :init do
+      require 'remoting/task'
+    
+      local('init') do
+        git :init
+        git :remote, :add, :origin, config.repo
+      end  
+    end
+
+Methods invoked inside the `local` block are executed locally. `local` takes only the `name` parameter.
+
+
+### Interactive tasks
+
+Invoking `remote` with `:interactive => true` will tell `remote` to yield the process to ssh, this way you will remotely interact with the server. On the other side everithing that is supposed to be executed after `remote` wont run. Despite this interactive tasks are very useful.
+
+#### Example 1. Rails remote console (by popular demand):
+  
+    # my_remote_task.rake
+
+    desc "Open rails console on server"
+    task :console do
+      require 'remoting/task'
+
+      remote('console', config.login, :interactive => true) do
+        cd config.dest
+        source '$HOME/.rvm/scripts/rvm'
+        bundle :exec, "rails c production"
+      end
+    end
+    
+####  Example 2. Reloading Apache configuration (involves sudo):
+    
+    task :reload do
+      require 'remoting/task'
+
+      remote('reload', config.login, :interactive => true) do
+        sudo "/etc/init.d/apache2 reload"
+      end
+    end
+        
+
+## A note on modularity
+
+A complete deployment manager (like Capistrano even if probably not as good as it is) can be easily built over *remoting*. Capistrano recipes can be ordinary rake tasks packed as gems. Plus various _deployment strategies_ can be assembled as dependencies of a main `deploy` task.
+
+    # Gemfile
+    gem 'remoting_scm_git'          # provides 'remoting:scm:push, remoting:scm:update_remoting_code'
+    gem 'remoting_server_passenger' # provides 'remoting:server:restart'
+
+    # remoting.rake
+    desc "Deploy application on server"
+    task :deploy => ["remoting:scm:push", "remoting:scm:update_remoting_code", "remoting:bundle", "remoting:server:restart"] do
+    end
+
+
+## Examples
+
+You can find more examples under `examples` source directory
+
+
+## Coming Soon
+
+* Ability to define bunch of commands as functions
+* Pre-packed strategies     
+
+---
+
+Copyright (c) 2012 mcasimir
+
+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/Rakefile

@@ -0,0 +1,26 @@
+# encoding: utf-8
+
+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 '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.name = "remoting"
+  gem.homepage = "http://github.com/mcasimir/remoting"
+  gem.license = "MIT"
+  gem.summary = %Q{Turn plain rake tasks in scripts to administer the server remote.}
+  gem.description = %Q{Remoting is a great way to turn plain rake tasks in scripts to administer the server remote. It provides a little framework to run remoting commands over SSH along with a DSL to define remoting scripts.}
+  gem.email = "maurizio.cas@gmail.com"
+  gem.authors = ["mcasimir"]
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new

data/VERSION

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

data/examples/remote.rake

@@ -0,0 +1,243 @@
+namespace :remote do
+
+  task :info do
+    require 'remoting/task'
+    
+    remote('info', config.login) do
+      source "~/.profile"
+      source "$HOME/.rvm/scripts/rvm"
+      
+      which :ruby
+      echo "RUBY    VERSION: `ruby --version`"
+      echo "RUBYGEM VERSION: `gem --version`"
+      command "RVM_VER=`rvm --version`"
+      echo "RVM     VERSION: $RVM_VER"
+    end
+  end
+
+  desc "Setup git origin"
+  task :init do
+    require 'remoting/task'
+    
+    local('init') do
+      git :init
+      git :remote, :add, :origin, config.repo
+    end  
+  end
+  
+  desc "Initialize remote"
+  task :setup do
+    require 'remoting/task'
+    
+    remote('setup', config.login) do
+      git :clone, config.repo, config.dest
+    end
+  end
+
+  desc "Commit everything to remote git repository"
+  task :push, [:message] do |t, args|
+    require 'remoting/task'
+    
+    message = args[:message] || "commit #{Time.now}"
+
+    local('push') do
+      git :add, "."
+      git :commit, "-a", "-m", "\"#{message}\""
+      git :push
+    end
+  end
+  
+  desc "Update remote code pulling from repository"
+  task :pull_on_remote do
+    require 'remoting/task'
+    
+    schema        = config.dest.join('db', 'schema.rb')
+    tmp_schema    = config.tmp.join("#{config.app}_#{Time.now.to_i}_schema.rb.tmp")
+
+    remote('pull_on_remote', config.login) do
+      cd  config.dest      
+      command("[[ -f \"#{schema}\" ]] && cp #{schema} #{tmp_schema}")
+      rm schema
+      git :checkout, 'db/schema.rb'
+      git :pull
+      command("[[ -f \"#{tmp_schema }\" ]] && mv #{tmp_schema} #{schema}")
+    end
+
+  end
+  
+  desc "Restart the server"
+  task :restart do
+    require 'remoting/task'
+    
+    remote('restart', config.login) do
+      mkdir '-p', config.dest.join('tmp')
+      touch config.dest.join('tmp', 'restart.txt') 
+    end
+    
+  end
+  
+  desc "Hard reset repo on server"
+  task :reset do
+    require 'remoting/task'
+
+    remote('reset', config.login) do
+      cd  config.dest
+      git :reset , "--hard HEAD"
+      git :clean, "-f", "-d"
+    end    
+
+  end
+  
+  desc "Run bundle install on the server"
+  task :bundle do
+    require 'remoting/task'
+
+    remote('bundle', config.login) do
+      source "~/.profile"
+      source "$HOME/.rvm/scripts/rvm"
+      rvm :use, config.ruby
+
+      cd  config.dest
+      export "LANG=en_US.UTF-8"
+      command "RAILS_ENV=production", "bundle install", "--without development test", "--deployment"
+    end
+  end
+  
+  desc "Deploy application on server"
+  task :deploy => [:push, :pull_on_remote, :bundle, :restart] do
+  end
+
+  desc "Run rake tasks on server"
+  task :rake, [:invocation] do |t, args|
+    require 'remoting/task'
+
+    invocation = args[:invocation]
+
+    remote('rake', config.login, :interactive => true) do 
+      source "$HOME/.rvm/scripts/rvm"
+      rvm :use, config.ruby
+
+      cd  config.dest
+      command("RAILS_ENV=production bundle exec rake #{invocation}")
+    end        
+    
+  end
+
+  desc "Open a remote shell session on server"
+  task :ssh do
+    require 'remoting/task'
+    remote('ssh', config.login, :interactive => true) do
+    end
+  end
+  
+  desc "Dump a remote logfile"
+  task :log, [:lines, :filename] do |t, args|
+    require 'remoting/task'
+
+    filename, lines = args.values_at(:lines, :filename)
+    filename ||= "production"
+    filename = "#{filename}.log" unless filename =~ /\.[a-z]+$/
+    
+    lines ||= 100
+    
+    remote('log', config.login) do
+      cd config.dest
+      tail "-#{lines} log/#{filename}"
+    end
+  end
+
+  task :logs => [:log] do
+  end
+  
+  
+  desc "Run tail -f on logfile"
+  task :logtail, [:filename] do |t, args|
+    require 'remoting/task'
+
+    filename=  args[:filename]
+    filename ||= "production"
+    filename = "#{filename}.log" unless filename =~ /\.[a-z]+$/
+        
+    remote('logtail', config.login) do
+      cd config.dest
+      tail "-f log/#{filename}"
+    end
+  end
+
+  desc "Open a remote console"
+  task :console do
+    require 'remoting/task'
+
+    remote('console', config.login, :interactive => true) do
+      cd config.dest
+      source '$HOME/.rvm/scripts/rvm'
+      bundle :exec, "rails c production"
+    end
+  end
+
+  desc "Update crontab with whenever schedule"
+  task :whenever do
+    require 'remoting/task'
+
+    remote('whenever', config.login) do
+      cd  config.dest
+      whenever "-w"
+    end    
+  end
+  
+  
+  namespace :apache do
+    task :ensite do
+      require 'remoting/task'
+      remote('ensite', config.login, :interactive => true) do
+        cd "/etc/apache2/sites-enabled"
+        sudo "ln -s #{config.dest.join('config', 'apache.conf')} #{config.app}"
+      end
+    end
+    
+    task :reload do
+      require 'remoting/task'
+
+      remote('reload', config.login, :interactive => true) do
+        sudo "/etc/init.d/apache2 reload"
+      end
+    end
+    
+  end
+  
+  namespace :assets do
+
+    desc 'Precompile assets'
+    task :precompile do
+      require 'remoting/task'
+
+      remote('rake assets:precompile', config.login) do
+      
+          source "$HOME/.rvm/scripts/rvm"
+          rvm :use, config.ruby
+          cd  config.dest
+          command("RAILS_ENV=production bundle exec rake assets:precompile")
+          echo 'restarting ...'
+          mkdir '-p', config.dest.join('tmp')
+          touch config.dest.join('tmp', 'restart.txt') 
+          
+      end      
+    end
+  end
+  
+  namespace :db do
+
+      desc "Migrate remote database"
+      task :migrate do |t, args|
+        require 'remoting/task'
+    
+        remote('rake db:migrate', config.login) do
+          source "$HOME/.rvm/scripts/rvm"
+          rvm :use, config.ruby
+          cd  config.dest
+          command("RAILS_ENV=production bundle exec rake db:migrate")
+        end    
+      end
+  end
+
+end

data/examples/remote.yml

@@ -0,0 +1,7 @@
+remote:
+  login: user@server
+  dest: /var/ror/myapp
+  repo: git@gitserver:myapp.git
+  ruby: 1.9.3
+  tmp: /tmp
+  app: appname

data/lib/generators/remoting/install_generator.rb

@@ -0,0 +1,20 @@
+module Remoting
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      def create_remote_yml
+        
+        stub = <<-STUB
+remote:
+  login: user@server
+  dest: /var/ror/myapp
+  repo: git@gitserver:myapp
+  ruby: 1.9.3
+  gemset: myapp        
+        STUB
+        
+        create_file "config/remote.yml", stub
+        
+      end
+    end
+  end
+end

data/lib/remoting/commander.rb

@@ -0,0 +1,9 @@
+module Remoting
+  class Commander
+
+    def exec(commands)
+      do_exec(commands)
+    end
+
+  end
+end

data/lib/remoting/config.rb

@@ -0,0 +1,18 @@
+require 'yaml'
+require 'ostruct'
+
+module Remoting
+  class Config < OpenStruct
+
+    def initialize
+      hash = YAML.load_file(Rails.root.join('config', 'remote.yml'))
+      super(hash["remote"])
+    end
+
+  end
+  
+  def config
+    @config ||= Config.new
+  end
+  module_function :config
+end

data/lib/remoting/dsl/script_builder.rb

@@ -0,0 +1,52 @@
+require 'remoting/dsl/string'
+
+module Remoting
+  module Dsl
+    
+    class ScriptBuilder
+      shadow_methods = %w(gem cd chdir chmod chmod_R chown chown_R cmp compare_file compare_stream copy copy_entry copy_file copy_stream cp cp_r getwd identical? install link ln ln_s ln_sf makedirs mkdir mkdir_p mkpath move mv pwd remove remove_dir remove_entry remove_entry_secure remove_file rm rm_f rm_r rm_rf rmdir rmtree safe_unlink symlink touch uptodate?)
+
+      shadow_methods.each do |name|
+        define_method name do |*args|
+          self.command(name, *args)
+        end
+      end
+
+      class << self
+        def build(&block)  
+          instance = self.new
+          instance.instance_eval(&block)
+          instance.commands
+        end
+      end
+    
+      def initialize
+        @commands = []
+      end
+
+      def commands()
+          @commands.flatten.map! do |c|
+            c.split(/[\r\n]/).map{|l|
+              line = l.strip
+              line.empty? ? nil : line
+            }
+          end.flatten.compact.delete_if(&:empty?)
+      end
+
+      def command(*args)
+        cmd = args.map(&:to_s).join(" ")
+        @commands << cmd
+        cmd
+      end
+    
+      private
+
+      def method_missing(*args)
+        command(*args)       
+      end
+
+
+    end
+    
+  end
+end

data/lib/remoting/dsl/string.rb

@@ -0,0 +1,24 @@
+class String
+  def > (arg)
+    self << " > " << "#{arg}"  
+    arg.clear
+    self
+  end
+
+  def >> (arg)
+    self << " >> " << "#{arg}"  
+    arg.clear
+    self
+  end
+  
+  def | (arg)
+    self << " | " << "#{arg}"  
+    arg.clear
+    self
+  end
+
+  def join(*args)
+    Pathname.new(self).join(*args).to_s
+  end
+  
+end

data/lib/remoting/engine.rb

@@ -0,0 +1,5 @@
+module Remoting
+  class Engine < Rails::Engine
+  
+  end
+end

data/lib/remoting/local_commander.rb

@@ -0,0 +1,18 @@
+require 'remoting/commander'
+
+module Remoting
+  class LocalCommander < Commander
+    
+    #overrides
+    def do_exec(cmds)
+      local(cmds)
+    end
+    
+    def local(cmds)
+      runline = cmds.map{|c| "#{c} 2>&1"}.join(";")
+#      puts "[LOCAL]  Executing '#{runline}' ..."
+      puts `#{runline}`
+    end 
+    
+  end
+end

data/lib/remoting/remote_commander.rb

@@ -0,0 +1,32 @@
+require 'remoting/commander'
+require 'remoting/ssh'
+
+module Remoting
+  class RemoteCommander < Commander
+    
+    attr_reader :login, :interactive
+    def initialize(login, *args)
+      options = args.extract_options!
+      @login = login
+      @interactive = !!options[:interactive]
+    end
+    
+    #overrides
+    def do_exec(cmds)
+      remote(cmds)
+    end
+       
+    def remote(cmds)
+      user, host = login.split("@")
+      
+      ssh = ::remoting::Ssh.new(
+        :user => user,
+        :host => host,
+        :interactive => interactive
+      )
+      
+      ssh.exec(cmds)
+    end
+
+  end
+end

data/lib/remoting/shell.rb

@@ -0,0 +1,37 @@
+require 'thor'
+
+module Remoting
+  class Shell < Thor::Shell::Color
+    def ask_password(*args)
+      system "stty -echo" 
+      res = ask(*args)
+      system "stty echo"
+      puts("\n") 
+      res
+    end
+  
+    def continue?(message)
+      res = yes?(message << " (y/yes)")
+      if !res
+        say("Cancelled", BLUE)
+      end
+      res
+    end
+  
+    def bold(message)
+      say(message, BOLD)
+    end
+  
+    def no?(message)
+      super(message << " (n/no)")
+    end
+    
+    def success(message)
+      say(message, GREEN)
+    end
+  
+    def error(message)
+      say(message, RED)
+    end
+  end
+end

data/lib/remoting/ssh.rb

@@ -0,0 +1,57 @@
+require 'net/ssh'
+require 'remoting/shell'
+
+module Remoting
+  class Ssh
+    attr_reader  :host, :user
+
+    def initialize(*args)
+      options = args.extract_options!
+      @host, @user, @interactive = options.values_at(:host, :user, :interactive)  
+    end
+
+
+    def shell
+      @shell ||= ::remoting::Shell.new
+    end
+    
+    def exec(commands)
+
+      if interactive?
+        ssh = %(ssh #{user}@#{host})
+        Kernel.exec ssh + %( -t '#{commands.join("; ")}')  # this will replace the current process and will never return the shell back
+      else
+        Net::SSH.start(host, user) do |ssh|
+      
+          ssh.open_channel do |channel|
+            channel.exec(commands.join(";")) do |ch, success|
+              unless success
+                abort
+              end
+            
+              channel.on_data do |ch, data|
+                say "#{data}"
+              end
+
+              channel.on_extended_data do |ch, type, data|
+                shell.error "#{data}"
+              end
+
+              channel.on_close do |ch|
+                shell.bold "channel is closing!\n"
+              end
+            end
+          end
+
+          ssh.loop 
+        end        
+      end
+  
+    end # ~ exec
+        
+    def interactive?
+      !!@interactive
+    end
+
+  end
+end

data/lib/remoting/task.rb

@@ -0,0 +1,50 @@
+require 'remoting/dsl/script_builder'
+require 'remoting/local_commander'
+require 'remoting/remoting_commander'
+require 'remoting/shell'
+
+module Remoting
+  module Task
+    
+    def _remoting_task_included
+    end
+    
+    def config
+      remoting.config
+    end
+    
+    def local(name, *args, &block)
+      bold("Executing '#{name}' on local ...")
+      commands  = ::remoting::Dsl::ScriptBuilder.build(&block)
+      commander = LocalCommander.new(*args)
+      run(commander, commands) 
+    end 
+
+    def remote(name, login, *args, &block)
+      bold("Executing '#{name}' on '#{login}' ...")
+      commands = ::remoting::Dsl::ScriptBuilder.build(&block)      
+      commander = RemoteCommander.new(login, *args)
+      run(commander, commands)
+    end
+    
+    def run(commander, commands)
+      commander.exec(commands)
+    end
+
+    def shell
+      @shell ||= ::remoting::Shell.new
+    end
+
+    %w(bold error success yes? no? say continue?).each do |meth|
+      eval("def #{meth}(*args);shell.#{meth}(*args);end")
+    end
+
+  end
+end
+
+unless self.respond_to?(:_remoting_task_included)
+  include remoting::Task
+end
+
+
+

data/lib/remoting.rb

@@ -0,0 +1,7 @@
+module Remoting
+end
+
+require 'remoting/config'
+require 'remoting/engine'
+
+

data/remoting.gemspec

@@ -0,0 +1,66 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = "remoting"
+  s.version = "0.2.8"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["mcasimir"]
+  s.date = "2012-05-08"
+  s.description = "Remoting is a great way to turn plain rake tasks in scripts to administer the server remote. It provides a little framework to run remoting commands over SSH along with a DSL to define remoting scripts."
+  s.email = "maurizio.cas@gmail.com"
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.md"
+  ]
+  s.files = [
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.md",
+    "Rakefile",
+    "VERSION",
+    "examples/remote.rake",
+    "examples/remote.yml",
+    "lib/generators/remoting/install_generator.rb",
+    "lib/remoting.rb",
+    "lib/remoting/commander.rb",
+    "lib/remoting/config.rb",
+    "lib/remoting/dsl/script_builder.rb",
+    "lib/remoting/dsl/string.rb",
+    "lib/remoting/engine.rb",
+    "lib/remoting/local_commander.rb",
+    "lib/remoting/remote_commander.rb",
+    "lib/remoting/shell.rb",
+    "lib/remoting/ssh.rb",
+    "lib/remoting/task.rb",
+    "remoting.gemspec"
+  ]
+  s.homepage = "http://github.com/mcasimir/remoting"
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = "1.8.24"
+  s.summary = "Turn plain rake tasks in scripts to administer the server remote."
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<rails>, ["~> 3.0"])
+      s.add_runtime_dependency(%q<net-ssh>, [">= 0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.8.3"])
+    else
+      s.add_dependency(%q<rails>, ["~> 3.0"])
+      s.add_dependency(%q<net-ssh>, [">= 0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.8.3"])
+    end
+  else
+    s.add_dependency(%q<rails>, ["~> 3.0"])
+    s.add_dependency(%q<net-ssh>, [">= 0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.8.3"])
+  end
+end
+

metadata

@@ -0,0 +1,121 @@
+--- !ruby/object:Gem::Specification
+name: remoting
+version: !ruby/object:Gem::Version
+  version: 0.2.8
+  prerelease: 
+platform: ruby
+authors:
+- mcasimir
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-05-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !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: jeweler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.8.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.8.3
+description: Remoting is a great way to turn plain rake tasks in scripts to administer
+  the server remote. It provides a little framework to run remoting commands over
+  SSH along with a DSL to define remoting scripts.
+email: maurizio.cas@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- README.md
+files:
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- VERSION
+- examples/remote.rake
+- examples/remote.yml
+- lib/generators/remoting/install_generator.rb
+- lib/remoting.rb
+- lib/remoting/commander.rb
+- lib/remoting/config.rb
+- lib/remoting/dsl/script_builder.rb
+- lib/remoting/dsl/string.rb
+- lib/remoting/engine.rb
+- lib/remoting/local_commander.rb
+- lib/remoting/remote_commander.rb
+- lib/remoting/shell.rb
+- lib/remoting/ssh.rb
+- lib/remoting/task.rb
+- remoting.gemspec
+homepage: http://github.com/mcasimir/remoting
+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: -1608284933107565365
+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: Turn plain rake tasks in scripts to administer the server remote.
+test_files: []