trooper 0.6.0.alpha1

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright 2011 Richard Adams
+
+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,96 @@
+# Trooper [![Build Status](https://secure.travis-ci.org/madwire/trooper.png?branch=master)](http://travis-ci.org/madwire/trooper)
+
+Trooper is designed to give you the flexibility to deploy your code to any server in any way you like.
+You design your deployment strategy to best fit your application and its needs. 
+Trooper comes with some built in actions that you can use in your own strategies or come up with entirely new ones.
+
+## Installation
+
+1. Super easy! `gem install trooper` or add it to your Gemfile `gem 'trooper'`
+2. Pop into your terminal and run `=> trooper init`
+3. Start building you deployment strategy :)
+
+## Usage
+
+`=> trooper deploy -e staging` or `=> trooper update`
+
+#### Define your own strategies and actions
+
+```ruby
+action :restart_server, 'Restarting the server' do
+  run 'touch tmp/restart.txt'
+  run "echo 'Restarted'"
+end
+
+strategy :restart, 'Restart application' do
+  actions :restart_server
+end
+
+strategy :update, 'Update the code base on the server' do
+  actions :update_repository, :install_gems
+  call :restart # call another strategy
+end
+```
+
+#### Example Troopfile
+
+```ruby
+user 'my_user'
+hosts 'production1.example.com', 'production2.example.com'
+repository 'git@git.foo.co.uk:bar.git'
+path "/fullpath/to/data/folder"
+
+set :my_value => 'something'
+
+env :stage do
+  hosts 'stage.example.com',
+  set :my_value => 'something_else'
+
+  action :restart do
+    run 'touch tmp/restert.txt'
+  end
+end
+
+action :restart do
+  run 'touch tmp/restert.txt'
+  run "echo 'Restarted'"
+end
+
+strategy :update, 'Update the code base on the server' do
+  actions :update_repository, :install_gems
+  call :restart
+end
+
+strategy :deploy, 'Full deployment to the server' do
+  call :update
+  actions :migrate_database
+  call :restart
+end
+
+strategy :restart, 'Restart application' do
+  actions :restart
+end
+```
+
+## LICENSE
+
+Copyright 2011 Richard Adams
+
+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,44 @@
+#!/usr/bin/env rake
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+
+begin
+  require 'rdoc/task'
+  require 'sdoc'
+rescue LoadError
+  require 'rdoc/rdoc'
+  require 'rake/rdoctask'
+  RDoc::Task = Rake::RDocTask
+end
+
+RDoc::Task.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'Trooper'
+  rdoc.options << '--line-numbers'
+  rdoc.options << '-f' << 'sdoc'
+  rdoc.options << '-c' << 'utf-8'
+  rdoc.options << '-t' << 'rails'
+  #rdoc.options << '-g' # SDoc flag, link methods to GitHub
+  rdoc.rdoc_files.include('README.md')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+
+Bundler::GemHelper.install_tasks
+
+
+ENV["COVERAGE"] = "true"
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+desc 'Default: Run all specs.'
+task :default => :spec
+

data/bin/trooper

@@ -0,0 +1,9 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+$:.push File.expand_path("../../lib", __FILE__)
+
+require 'trooper'
+require 'trooper/cli'
+
+Trooper::CLI.start

data/lib/trooper/action.rb

@@ -0,0 +1,56 @@
+require 'trooper/dsl/folders'
+require 'trooper/dsl/rake'
+require 'trooper/dsl/bundler'
+
+module Trooper
+  class Action
+    include Trooper::DSL::Folders
+    include Trooper::DSL::Rake
+    include Trooper::DSL::Bundler
+
+    attr_reader :name, :description, :config, :block
+    attr_accessor :commands
+
+    # expects a name, description and a block
+    #   Action.new(:my_action, 'Does great things') { run 'touch file' }
+    def initialize(name, description, &block)
+      @name, @description, @config = name, description, {}
+      @commands, @block = [], block
+    end
+
+    # eval's the block passed on initialize and returns the command array
+    def call(configuration)
+      @config = configuration
+      eval_block(&block)
+      commands
+    end
+    alias :execute :call
+
+    # validates the action 
+    def ok?
+      true
+    end
+
+    # run is the base run command used by the dsl
+    def run(command)
+      commands << command if command != ''
+    end
+
+    def method_missing(method_sym, *arguments, &block) # :nodoc:
+      config[method_sym] || super
+    end
+
+    private
+
+    def eval_block(&block) # :nodoc:
+      if block_given?
+        if block.arity == 1
+          block.call self
+        else
+          instance_eval &block
+        end
+      end
+    end
+
+  end
+end

data/lib/trooper/actions/clone_repository_action.rb

@@ -0,0 +1,31 @@
+require 'trooper/action'
+
+module Trooper
+  module Actions
+
+    class CloneRepositoryAction < Action
+
+      def initialize(config = {})
+        @name = :clone_repository
+        @description = "Cloning repository as 'application'"
+        @config = config
+        @commands = []
+      end
+
+      def call(configuration)
+        @config = configuration
+        build_commands
+        commands
+      end
+
+      private
+
+      def build_commands
+        cd path
+        run "git clone #{repository} application"
+      end
+      
+    end
+
+  end
+end

data/lib/trooper/actions/install_gems_action.rb

@@ -0,0 +1,31 @@
+require 'trooper/action'
+
+module Trooper
+  module Actions
+
+    class InstallGemsAction < Action
+
+      def initialize(config = {})
+        @name = :install_gems
+        @description = "Installing Gems with Bundler"
+        @config = config
+        @commands = []
+      end
+
+      def call(configuration)
+        @config = configuration
+        build_commands
+        commands
+      end
+
+      private
+
+      def build_commands
+        cd application_path
+        bundle_install
+      end
+      
+    end
+    
+  end
+end

data/lib/trooper/actions/migrate_database_action.rb

@@ -0,0 +1,31 @@
+require 'trooper/action'
+
+module Trooper
+  module Actions
+
+    class MigrateDatabaseAction < Action
+
+      def initialize(config = {})
+        @name = :migrate_database
+        @description = "Migrating database"
+        @config = config
+        @commands = []
+      end
+
+      def call(configuration)
+        @config = configuration
+        build_commands
+        commands
+      end
+
+      private
+
+      def build_commands
+        cd application_path
+        rake "db:migrate RAILS_ENV=#{environment}"
+      end
+      
+    end
+
+  end
+end

data/lib/trooper/actions/restart_server_action.rb

@@ -0,0 +1,33 @@
+require 'trooper/action'
+
+module Trooper
+  module Actions
+
+    class RestartServerAction < Action
+
+      def initialize(config = {})
+        @name = :restart_server
+        @description = "Restart server"
+        @config = config
+        @commands = []
+      end
+
+      def call(configuration)
+        @config = configuration
+        build_commands
+        commands
+      end
+
+      private
+
+      def build_commands
+        cd application_path
+        create_folder 'tmp'
+        run 'touch tmp/restart.txt'
+        run 'echo "Server restarted!"'
+      end
+      
+    end
+
+  end
+end

data/lib/trooper/actions/rollback_migrate_action.rb

@@ -0,0 +1,31 @@
+require 'trooper/action'
+
+module Trooper
+  module Actions
+
+    class RollbackMigrateAction < Action
+
+      def initialize(config = {})
+        @name = :rollback_migrate
+        @description = "Rollback database"
+        @config = config
+        @commands = []
+      end
+
+      def call(configuration)
+        @config = configuration
+        build_commands
+        commands
+      end
+
+      private
+
+      def build_commands
+        cd application_path
+        rake "db:rollback RAILS_ENV=#{environment}"
+      end
+      
+    end
+
+  end
+end

data/lib/trooper/actions/setup_database_action.rb

@@ -0,0 +1,31 @@
+require 'trooper/action'
+
+module Trooper
+  module Actions
+
+    class SetupDatabaseAction < Action
+
+      def initialize(config = {})
+        @name = :setup_database
+        @description = "Setting up database"
+        @config = config
+        @commands = []
+      end
+
+      def call(configuration)
+        @config = configuration
+        build_commands
+        commands
+      end
+
+      private
+
+      def build_commands
+        cd application_path
+        rake "db:setup RAILS_ENV=#{environment}"
+      end
+      
+    end
+
+  end
+end

data/lib/trooper/actions/update_repository_action.rb

@@ -0,0 +1,33 @@
+require 'trooper/action'
+
+module Trooper
+  module Actions
+
+    class UpdateRepositoryAction < Action
+
+      def initialize(config = {})
+        @name = :update_repository
+        @description = "Updating repository"
+        @config = config
+        @commands = []
+      end
+
+      def call(configuration)
+        @config = configuration
+        build_commands
+        commands
+      end
+
+      private
+
+      def build_commands
+        cd application_path
+        run "git checkout #{branch} -q"
+        run "git pull origin #{branch} -q"
+        run "git gc --aggressive"
+      end
+      
+    end
+
+  end
+end

data/lib/trooper/arsenal.rb

@@ -0,0 +1,51 @@
+module Trooper
+  
+  class Arsenal < Array
+
+    # find an arsenal by its name
+    def find_by_name(name)
+      detect { |weapon| weapon.name == name }
+    end
+    alias :[] :find_by_name
+
+    # add a weapon to the arsenal
+    def add(weapon)
+      if weapon.ok?
+        remove weapon.name
+        self << weapon 
+      end
+      weapon
+    end
+
+    # remove a weapon from the arsenal
+    def remove(name)
+      self.delete_if {|w| w.name == name}
+    end
+
+    # clears arsenal
+    def clear!
+      self.clear
+    end
+
+    class << self
+
+      # returns the strategies arsenal
+      def strategies
+        @strategies ||= new
+      end
+
+      # returns the strategies arsenal
+      def actions
+        @actions ||= new
+      end
+
+      # clears all default arsenal
+      def reset!
+        @strategies, @actions = nil
+      end
+
+    end
+    
+  end
+
+end

data/lib/trooper/cli.rb

@@ -0,0 +1,67 @@
+require 'optparse'
+require 'trooper/configuration'
+
+module Trooper
+  class CLI
+
+    def self.start(argv = ARGV)
+      cli = self.new(argv)
+      cli.execute
+      cli
+    end
+
+    attr_reader :command, :options, :argv
+    attr_accessor :config
+
+    def initialize(argv)
+      @argv = argv
+      @options = { :environment => :production }
+
+      @command = option_parser.parse!(@argv)[0]
+      raise CliArgumentError, "You didnt pass an action" if @command == nil
+    end
+
+    def execute
+      case command.to_sym
+      when :init
+        Configuration.init
+      else
+        config = Configuration.new(options)
+        config.execute action
+      end
+    end
+
+    private
+
+    def option_parser
+      @option_parser ||= ::OptionParser.new do |op|
+        op.banner = 'Usage: trooper <command> [options]'      
+        op.separator ''
+
+        op.on "-d", "--debug", "Debuy" do 
+          @options[:debug] = true
+        end
+
+        op.on "-e", "--env ENV", "Environment" do |e|
+          @options[:environment] = e.to_sym
+        end
+
+        op.on "-f", "--file TROOPFILE", "Load a different Troopfile" do |f|
+          @options[:file_name] = f || 'Troopfile' 
+        end
+
+        op.on_tail "-h", "--help", "Help" do 
+          puts @option_parser
+          exit
+        end
+
+        op.on_tail "-v", "--version", "Show version" do
+          puts "Trooper v#{Trooper::Version::STRING}"
+          exit
+        end
+
+      end
+    end
+
+  end
+end

data/lib/trooper/config/action.rb

@@ -0,0 +1,34 @@
+require 'trooper/action'
+
+require 'trooper/actions/clone_repository_action'
+require 'trooper/actions/install_gems_action'
+require 'trooper/actions/migrate_database_action'
+require 'trooper/actions/restart_server_action'
+require 'trooper/actions/rollback_migrate_action'
+require 'trooper/actions/setup_database_action'
+require 'trooper/actions/update_repository_action'
+
+module Trooper
+  module Config
+    module Action
+
+      DEFAULT_ACTIONS = [Actions::CloneRepositoryAction, Actions::InstallGemsAction, 
+                          Actions::MigrateDatabaseAction, Actions::RestartServerAction, 
+                          Actions::RollbackMigrateAction, Actions::SetupDatabaseAction, 
+                          Actions::UpdateRepositoryAction]
+      
+      def action(name, description = "No Description", &block)
+        action = Trooper::Action.new name, description, &block
+        Trooper::Arsenal.actions.add action
+      end
+
+
+      def load_default_actions!
+        DEFAULT_ACTIONS.each do |klass|
+          Trooper::Arsenal.actions.add klass.new
+        end
+      end
+
+    end
+  end
+end

data/lib/trooper/config/environment.rb

@@ -0,0 +1,36 @@
+module Trooper
+  module Config
+    module Environment
+
+      def load_environment!
+        instance_variable = instance_variable_get("@#{self[:environment].to_s}_configuration")
+        unless instance_variable.nil?
+          instance_eval(&instance_variable)
+        end
+      end
+      
+      def env(environment_name, &block)
+        instance_variable_set "@#{environment_name.to_s}_configuration", block
+      end
+
+      def user(arg)
+        set :user => arg 
+      end
+
+      def hosts(*arg)
+        set :hosts => [*arg] 
+      end
+
+      def repository(arg)
+        set :repository => arg 
+      end
+
+      def path(arg)
+        set :application_path => "#{arg}/application" 
+        set :trooper_path => "#{arg}/trooper"
+        set :path => arg 
+      end
+
+    end
+  end
+end

data/lib/trooper/config/strategy.rb

@@ -0,0 +1,14 @@
+require 'trooper/strategy'
+
+module Trooper
+  module Config
+    module Strategy
+      
+      def strategy(name, description = "No Description", &block)
+        strategy = Trooper::Strategy.new name, description, self, &block
+        Trooper::Arsenal.strategies.add strategy
+      end
+
+    end
+  end
+end

data/lib/trooper/configuration.rb

@@ -0,0 +1,88 @@
+# encoding: utf-8
+
+require 'trooper/arsenal'
+
+require 'trooper/config/environment'
+require 'trooper/config/strategy'
+require 'trooper/config/action'
+
+module Trooper
+  class Configuration < Hash
+    FILE_NAME = "Troopfile"
+
+    include Trooper::Config::Environment
+    include Trooper::Config::Strategy
+    include Trooper::Config::Action
+
+    def self.init
+      gem_dir = File.dirname(__FILE__)
+
+      if RUBY_VERSION == /1.8/
+        require 'ftools'
+        File.copy("#{gem_dir}/template/troopfile.rb", "./Troopfile")
+      else
+        require 'fileutils'
+        ::FileUtils.copy("#{gem_dir}/template/troopfile.rb", "./Troopfile")
+      end
+    end
+    
+    # initialize a new configuration object, will parse the given troopfile.
+    #   Configuration.new({:my_override => 'settings'})
+    def initialize(options = {})
+      @loaded = false
+      @file_name = options[:file_name] || FILE_NAME
+      self[:environment] = options[:environment] || :production
+
+      load_default_actions!
+      load_troopfile! options
+    end
+
+    # returns a terminal friendly version of the configuration 
+    def to_s
+      self.map {|k,v| "#{k}: #{v}" }.join("\n")
+    end
+
+    # will find and execute the strategy name passed
+    #   @config.execute(:my_strategy_name)
+    def execute(strategy_name)
+      Arsenal.strategies[strategy_name].execute self
+    end
+
+    # a way to set variables that will be available to all actions
+    #   set(:my_variable => 'sdsd') # => available as method in an action
+    def set(hash)
+      self.merge! hash
+    end
+
+    # returns true if the troopfile was loaded
+    def loaded?
+      @loaded
+    end
+
+    private
+
+    # loads the troopfile and sets the environment up
+    def load_troopfile!(options)
+      if troopfile?
+        eval troopfile.read
+        @loaded = true
+        
+        load_environment!
+        set options
+      else
+        raise Trooper::NoConfigurationFileError, "No Configuration file (#{@file_name}) can be found!"
+      end
+    end
+
+    # returns the troopfile file object
+    def troopfile
+      File.open(@file_name)
+    end
+    
+    # returns true if the troopfile exists
+    def troopfile?
+      File.exists?(@file_name)
+    end
+
+  end
+end

data/lib/trooper/dsl/bundler.rb

@@ -0,0 +1,26 @@
+module Trooper
+  module DSL
+    module Bundler
+      
+      def bundle_exec(command)
+        use_bundle = using_bundler? ? "bundle exec " : ""
+        run use_bundle + command
+      end
+
+      def bundle_install
+        run "bundle install --path #{trooper_path}/bundle --deployment --without development test" if using_bundler?
+      end
+
+      def rake(command)
+        bundle_exec "rake #{command}"
+      end
+      
+      private
+      
+      def using_bundler?
+        File.exists? "Gemfile"
+      end
+      
+    end
+  end
+end

data/lib/trooper/dsl/folders.rb

@@ -0,0 +1,24 @@
+module Trooper
+  module DSL
+    module Folders
+      
+      def cd(path)
+        run "cd #{path}"
+      end
+
+      def create_folder(path)
+        run "mkdir -p #{path}"
+      end
+      alias :mkdir :create_folder
+
+      def delete_folder(path)
+        run "rm -rf #{path}"
+      end
+
+      def create_folders(*folders)
+        folders.each { |folder| create_folder folder }
+      end
+      
+    end
+  end
+end

data/lib/trooper/dsl/rake.rb

@@ -0,0 +1,11 @@
+module Trooper
+  module DSL
+    module Rake
+      
+      def rake(command)
+        run "rake #{command}"
+      end
+      
+    end
+  end
+end

data/lib/trooper/logger.rb

@@ -0,0 +1,86 @@
+# encoding: utf-8
+
+require 'logger'
+
+module Trooper
+
+  class Logger < ::Logger
+    ACTION = 6
+    SUCCESS = 7
+
+    # DEBUG < INFO < WARN < ERROR < FATAL < UNKNOWN < ACTION < SUCCESS
+    LABELS = %w(DEBUG INFO WARN ERROR FATAL ANY ACTION SUCCESS)
+
+    def action(progname = nil, &block)
+      add(ACTION, nil, progname, &block)
+    end
+
+    def success(progname = nil, &block)
+      add(SUCCESS, nil, progname, &block)
+    end
+
+    private
+
+    def format_severity(severity)
+      LABELS[severity] || 'ANY'
+    end
+
+  end
+  
+
+  class LogFormat
+
+    COLOURS = { 
+      :black    => 30,
+      :red      => 31, 
+      :green    => 32, 
+      :yellow   => 33,
+      :blue     => 34,
+      :magenta  => 35,
+      :cyan     => 36,
+      :white    => 37
+    }
+
+    def call(severity, datetime, progname, message)
+      # DEBUG < INFO < WARN < ERROR < FATAL < UNKNOWN < ACTION < SUCCESS
+      case severity
+      when "DEBUG"
+        colour("#{progname} => [#{severity}] #{message}\n", :yellow)
+      when "WARN"
+        colour("#{progname} => [#{severity}] #{message}\n", :yellow)
+      when "ACTION"
+        colour("#{progname} => [#{severity}] #{message}\n", :magenta)
+      when "SUCCESS"
+        colour("#{progname} => [#{severity}] #{message}\n", :green)
+      when "ERROR", "FATAL"
+        colour("#{progname} => [#{severity}] #{message}\n", :red)
+      else
+        "#{progname} => [#{severity}] #{message}\n"
+      end
+    end
+
+    private
+
+    def colour(msg, clr = :black)
+      "\e[#{COLOURS[clr]}m#{msg}\e[0m"
+    end
+
+    def underline
+      "\e[4m"
+    end
+    
+  end
+
+
+  def self.logger
+    @logger ||= begin
+      logger = Logger.new($stdout)
+      logger.level = ::Logger::DEBUG
+      logger.progname = 'Trooper'
+      logger.formatter = LogFormat.new
+      logger
+    end
+  end
+
+
+end

data/lib/trooper/runner.rb

@@ -0,0 +1,57 @@
+# encoding: utf-8
+
+require "net/ssh"
+
+module Trooper
+  class Runner
+    
+    attr_reader :host, :user, :connection
+    
+    # pass the host, user and any net/ssh config options
+    #   Runner.new('my.example.com', 'admin', :forward_agent => false)
+    def initialize(host, user, options = { :forward_agent => true })
+      @host = host
+      @user = user
+      @connection = Net::SSH.start(host, user, options)
+    end
+
+    # returns user@host as a string
+    def to_s
+      "#{user}@#{host}"
+    end
+    
+    # execute a set of commands via net/ssh, returns and array or raises an exception
+    #   runner.execute(['cd to/path', 'touch file']) # => ['cd to/path && touch file', :stdout, '']
+    #   runner.execute('cat file') # => ['cat file', :stdout, 'file content']
+    def execute(command, options = {})
+      commands = parse command
+      Trooper.logger.debug commands
+      connection.exec! commands do |ch, stream, data|
+        raise Trooper::StdError, "#{data}\n[ERROR INFO] #{commands}" if stream == :stderr
+        ch.wait
+        return [commands, stream, data]
+      end
+    end
+    
+    # close net/ssh connection
+    def close
+      connection.close
+    end
+    
+    private 
+    
+    # parse command, expects a string or array
+    #   parse(['cd to/path', 'touch file']) # => 'cd to/path && touch file'
+    def parse(command)
+      case command.class.name.downcase.to_sym #Array => :array
+      when :array
+        command.compact.join(' && ')
+      when :string
+        command.chomp
+      else
+        raise Trooper::MalformedCommandError, "Command Not a String or Array: #{command.inspect}"
+      end
+    end
+    
+  end
+end

data/lib/trooper/strategy.rb

@@ -0,0 +1,104 @@
+require 'trooper/runner'
+
+module Trooper
+  class Strategy
+
+    attr_reader :name, :description, :config, :run_list
+    
+    def initialize(name, description, config = {}, &block)
+      @name, @description, @config = name, description, config
+      @run_list = []
+      eval_block(&block)
+    end
+
+    def execute(config = {})
+      @config = config
+      Trooper.logger.debug "Configuration\n#{config}"
+      successful = nil
+
+      runners.each do |runner|
+        begin
+          Trooper.logger.info "\e[4mRunning on #{runner}\n"
+
+          run_list.each do |item, name|
+            self.send("#{item}_execute", runner, name)
+          end
+
+          successful = true
+          Trooper.logger.success "\e[4mAll Actions Completed\n"
+        rescue Exception => e
+          Trooper.logger.error "#{e.class.to_s} : #{e.message}\n\n#{e.backtrace.join("\n")}"
+          
+          successful = false
+          break #stop commands running on other servers
+        ensure
+          runner.close
+        end
+      end
+      
+      successful
+    end
+
+    def ok?
+      true
+    end
+
+    def call(strategy_name)
+      if Arsenal.strategies[strategy_name]
+        Arsenal.strategies[strategy_name].run_list.each do |action|
+          @run_list << action
+        end
+      end  
+    end
+
+    def actions(*action_names)
+      [*action_names].each do |name|
+        @run_list << [:action, name]
+      end
+    end
+
+    def method_missing(method_sym, *arguments, &block)
+      config[method_sym] || super
+    end
+
+    private
+
+    def eval_block(&block)
+      if block_given?
+        if block.arity == 1
+          block.call self
+        else
+          instance_eval &block
+        end
+      end
+    end
+
+    def action_execute(runner, name)
+      action = Arsenal.actions[name]
+
+      if action
+        commands = action.execute config
+        Trooper.logger.action action.description
+        runner_execute!(runner, commands)
+      end
+    end
+
+    def runners
+      @runners ||= begin
+        r, h, u = [], (hosts rescue nil), (user rescue nil)
+        h.each {|host| r << Runner.new(host, user) } if h && u; r
+      end
+    end
+
+    def runner_execute!(runner, commands, options = {})
+      result = runner.execute commands, options
+      if result && result[1] == :stdout
+        Trooper.logger.info "#{result[2]}\n"
+        true
+      else 
+        false
+      end
+    end
+
+  end
+end

data/lib/trooper/template/troopfile.rb

@@ -0,0 +1,34 @@
+user 'my_user'
+hosts 'stage.example.com'
+repository 'git@git.bar.co.uk:whatever.git'
+path "/path/to/data/folder"
+
+set :my_value => 'something'
+
+env :production do
+  hosts 'production1.example.com', 'production2.example.com'
+  set :my_value => 'something_else'
+
+  action :restart do
+    run 'touch tmp/restert.txt'
+  end
+end
+
+action :restart do
+  run 'touch tmp/restert.txt'
+end
+
+strategy :update, 'Update the code base on the server' do
+  actions :update_repository, :install_gems
+  call :restart
+end
+
+strategy :deploy, 'Full deployment to the server' do
+  call :update
+  actions :migrate_database
+  call :restart
+end
+
+strategy :restart, 'Restart application' do
+  actions :restart
+end

data/lib/trooper/version.rb

@@ -0,0 +1,9 @@
+module Trooper
+  module Version
+    MAJOR = 0
+    MINOR = 6
+    TINY  = 0
+    PRE   = 'alpha1'
+    STRING = [MAJOR, MINOR, TINY, PRE].compact.join('.')
+  end
+end

data/lib/trooper.rb

@@ -0,0 +1,29 @@
+require 'trooper/version'
+require 'trooper/logger'
+
+module Trooper
+  
+  # Base class for all Trooper exceptions
+  class TrooperError < StandardError
+  end
+
+  # When a strategy is not defined
+  class MissingStrategyError < TrooperError
+  end
+
+  # When a CLI argument is missing or badly formed
+  class CliArgumentError < TrooperError
+  end
+
+  # When a command(s) return a stderr stream
+  class StdError < TrooperError
+  end
+
+  # When a command is not formed corrently arrays or strings are exceptal commands
+  class MalformedCommandError < TrooperError
+  end
+
+  class NoConfigurationFileError < TrooperError
+  end
+
+end

metadata

@@ -0,0 +1,220 @@
+--- !ruby/object:Gem::Specification
+name: trooper
+version: !ruby/object:Gem::Version
+  version: 0.6.0.alpha1
+  prerelease: 6
+platform: ruby
+authors:
+- Richard Adams
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-04-16 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: 2.3.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.3.0
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.8'
+- !ruby/object:Gem::Dependency
+  name: guard-rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.6'
+- !ruby/object:Gem::Dependency
+  name: rb-fsevent
+  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: yard
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.7'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: sdoc
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.3.16
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.3.16
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.5.4
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.5.4
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.2
+description: Simple but powerful deployment
+email:
+- richard@madwire.co.uk
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- bin/trooper
+- lib/trooper/action.rb
+- lib/trooper/actions/clone_repository_action.rb
+- lib/trooper/actions/install_gems_action.rb
+- lib/trooper/actions/migrate_database_action.rb
+- lib/trooper/actions/restart_server_action.rb
+- lib/trooper/actions/rollback_migrate_action.rb
+- lib/trooper/actions/setup_database_action.rb
+- lib/trooper/actions/update_repository_action.rb
+- lib/trooper/arsenal.rb
+- lib/trooper/cli.rb
+- lib/trooper/config/action.rb
+- lib/trooper/config/environment.rb
+- lib/trooper/config/strategy.rb
+- lib/trooper/configuration.rb
+- lib/trooper/dsl/bundler.rb
+- lib/trooper/dsl/folders.rb
+- lib/trooper/dsl/rake.rb
+- lib/trooper/logger.rb
+- lib/trooper/runner.rb
+- lib/trooper/strategy.rb
+- lib/trooper/template/troopfile.rb
+- lib/trooper/version.rb
+- lib/trooper.rb
+- LICENSE
+- Rakefile
+- README.md
+homepage: http://www.madwire.co.uk
+licenses: []
+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: 3543094362386461389
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>'
+    - !ruby/object:Gem::Version
+      version: 1.3.1
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.22
+signing_key: 
+specification_version: 3
+summary: Deploy like a 'Trooper'
+test_files: []
+has_rdoc: