engineyard-serverside-adapter 1.3.1.pre

data/.gitignore

@@ -0,0 +1,4 @@
+pkg/*
+*.gem
+.bundle
+Gemfile.lock

data/Gemfile

@@ -0,0 +1,4 @@
+source :gemcutter
+
+# Specify your gem's dependencies in engineyard-serverside-adapter.gemspec
+gemspec

data/Rakefile

@@ -0,0 +1,9 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.spec_files = FileList['spec/**/*_spec.rb']
+end
+task :default => :spec

data/engineyard-serverside-adapter.gemspec

@@ -0,0 +1,25 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path("../lib/engineyard-serverside-adapter/version", __FILE__)
+
+Gem::Specification.new do |s|
+  s.name        = "engineyard-serverside-adapter"
+  s.version     = EY::Serverside::Adapter::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = []
+  s.email       = []
+  s.homepage    = "http://github.com/engineyard/engineyard-serverside-adapter"
+  s.summary     = "Adapter for speaking to engineyard-serverside"
+  s.description = "A separate adapter for speaking the CLI language of the engineyard-serverside gem."
+
+  s.required_rubygems_version = ">= 1.3.6"
+  s.rubyforge_project         = "engineyard-serverside-adapter"
+
+  s.add_dependency             "escape",     "~> 0.0.4"
+  s.add_dependency             "json_pure",  "~> 1.4.6"
+  s.add_development_dependency "bundler",    ">= 1.0.0"
+  s.add_development_dependency "rspec",      "~> 1.3.0"
+
+  s.files        = `git ls-files`.split("\n")
+  s.executables  = `git ls-files`.split("\n").map{|f| f =~ /^bin\/(.*)/ ? $1 : nil}.compact
+  s.require_path = 'lib'
+end

data/lib/engineyard-serverside-adapter.rb

@@ -0,0 +1,53 @@
+require 'pathname'
+
+module EY
+  module Serverside
+    class Adapter
+      autoload :Action,                 'engineyard-serverside-adapter/action'
+      autoload :Arguments,              'engineyard-serverside-adapter/arguments'
+      autoload :Command,                'engineyard-serverside-adapter/command'
+      autoload :Deploy,                 'engineyard-serverside-adapter/deploy'
+      autoload :DisableMaintenancePage, 'engineyard-serverside-adapter/disable_maintenance_page'
+      autoload :EnableMaintenancePage,  'engineyard-serverside-adapter/enable_maintenance_page'
+      autoload :Integrate,              'engineyard-serverside-adapter/integrate'
+      autoload :Rollback,               'engineyard-serverside-adapter/rollback'
+      autoload :VERSION,                'engineyard-serverside-adapter/version'
+
+      ENGINEYARD_SERVERSIDE_VERSION = ENV['ENGINEYARD_SERVERSIDE_VERSION'] || VERSION
+
+      def initialize(gem_bin_path = "")
+        @gem_bin_path = Pathname.new(gem_bin_path)
+        @arguments    = Arguments.new
+
+        yield @arguments if block_given?
+      end
+
+      def deploy(&b)
+        Deploy.new(new_action_args, &b)
+      end
+
+      def disable_maintenance_page(&b)
+        DisableMaintenancePage.new(new_action_args, &b)
+      end
+
+      def enable_maintenance_page(&b)
+        EnableMaintenancePage.new(new_action_args, &b)
+      end
+
+      def integrate(&b)
+        Integrate.new(new_action_args, &b)
+      end
+
+      def rollback(&b)
+        Rollback.new(new_action_args, &b)
+      end
+
+      private
+
+      def new_action_args
+        {:arguments => @arguments.dup, :gem_bin_path => @gem_bin_path}
+      end
+
+    end
+  end
+end

data/lib/engineyard-serverside-adapter/action.rb

@@ -0,0 +1,94 @@
+require 'escape'
+require 'pathname'
+
+module EY
+  module Serverside
+    class Adapter
+      class Action
+
+        def initialize(options = {}, &block)
+          @gem_bin_path = Pathname.new(options[:gem_bin_path] || "")
+          arguments = options[:arguments] || Arguments.new
+          block.call arguments if block
+
+          extract_state_from_arguments(arguments)
+          validate!
+        end
+
+        def call(&block)
+          block.call check_and_install_command.to_s
+          block.call action_command.to_s
+        end
+
+        def verbose
+          @state[:verbose]
+        end
+
+        class << self
+          attr_accessor :options
+
+          def option(name, type, extra={:required => false})
+            self.options ||= {}
+            options[name] = extra.merge({:type => type})
+          end
+        end
+
+      private
+
+        def extract_state_from_arguments(arguments)
+          @state = self.class.options.inject({}) do |acc, (option_name, option_attrs)|
+            acc.merge(option_name => arguments.send(option_name))
+          end
+        end
+
+        def check_and_install_command
+          "(#{check_command}) || (#{install_command})"
+        end
+
+        def check_command
+          escaped_engineyard_serverside_version = ENGINEYARD_SERVERSIDE_VERSION.gsub(/\./, '\.')
+
+          [
+            Escape.shell_command([gem_path, "list", "engineyard-serverside"]),
+            Escape.shell_command(["grep", "engineyard-serverside "]),
+            Escape.shell_command(["egrep", "-q", "#{escaped_engineyard_serverside_version}[,)]"]),
+          ].join(" | ")
+        end
+
+        def install_command
+          # rubygems looks at *.gem in its current directory for
+          # installation candidates, so we have to make sure it
+          # runs from a directory with no gem files in it.
+          #
+          # rubygems help suggests that --remote will disable this
+          # behavior, but it doesn't.
+          install_command = "cd `mktemp -d` && #{gem_path} install engineyard-serverside --no-rdoc --no-ri -v #{ENGINEYARD_SERVERSIDE_VERSION}"
+          Escape.shell_command(['sudo', 'sh', '-c', install_command])
+        end
+
+        def gem_path
+          @gem_bin_path.join('gem').to_s
+        end
+
+        def action_command
+          cmd = Command.new(@gem_bin_path, *task)
+          @state.each do |option_name, value|
+            option_type = self.class.options[option_name][:type]
+            switch = "--" + option_name.to_s.gsub(/_/, '-')
+            cmd.send("#{option_type}_argument", switch, value)
+          end
+          cmd
+        end
+
+        def validate!
+          self.class.options.each do |option_name, option_attrs|
+            if option_attrs[:required] && !@state[option_name]
+              raise ArgumentError, "Required field '#{option_name}' not provided."
+            end
+          end
+        end
+
+      end
+    end
+  end
+end

data/lib/engineyard-serverside-adapter/arguments.rb

@@ -0,0 +1,61 @@
+module EY
+  module Serverside
+    class Adapter
+      class Arguments < Struct.new(:app, :config, :framework_env, :instances, :migrate, :ref, :repo, :stack, :verbose)
+
+        def app=(app)
+          enforce_nonempty!('app', app)
+          super
+        end
+
+        def framework_env=(framework_env)
+          enforce_nonempty!('framework_env', framework_env)
+          super
+        end
+
+        def instances=(instances)
+          unless instances.respond_to?(:each)
+            raise ArgumentError, "Value for 'instances' must look like an enumerable."
+          end
+
+          if instances.empty?
+            raise ArgumentError, "Value for 'instances' must not be empty."
+          end
+
+          instances.each do |instance|
+            unless instance.respond_to?(:[]) && instance[:hostname] && instance[:roles]
+              raise ArgumentError, "Malformed instance #{instance}; it must have both [:hostname] and [:roles]"
+            end
+          end
+
+          super
+        end
+
+        def ref=(ref)
+          enforce_nonempty!('ref', ref)
+          super
+        end
+
+        def repo=(repo)
+          enforce_nonempty!('repo', repo)
+          super
+        end
+
+        def stack=(stack)
+          enforce_nonempty!('stack', stack)
+          super
+        end
+
+        private
+
+        def enforce_nonempty!(name, value)
+          if value.to_s.empty?
+            raise ArgumentError, "Value for '#{name}' must be non-empty."
+          end
+        end
+
+      end
+    end
+  end
+end
+

data/lib/engineyard-serverside-adapter/command.rb

@@ -0,0 +1,66 @@
+require 'escape'
+require 'json'
+
+module EY
+  module Serverside
+    class Adapter
+      class Command
+        def initialize(bin_path, *task)
+          @task = task
+          @arguments = []
+          @binary = bin_path.join('engineyard-serverside').to_s
+        end
+        
+        def to_s
+          Escape.shell_command [@binary, "_#{ENGINEYARD_SERVERSIDE_VERSION}_"] + @task + @arguments.sort_by { |x| x.first }.flatten
+        end
+
+        def array_argument(switch, values)
+          compacted = values.compact.sort
+          if compacted.any?
+            @arguments << [switch, compacted]
+          end
+        end
+
+        def boolean_argument(switch, value)
+          if value
+            @arguments << [switch]
+          end
+        end
+
+        def hash_argument(switch, pairs)
+          if pairs.any? {|k,v| !v.nil?}
+            @arguments << [switch, pairs.reject { |k,v| v.nil? }.map { |pair| pair.join(':') }.sort]
+          end
+        end
+
+        def instances_argument(_, instances)
+          role_pairs = instances.inject({}) do |roles, instance|
+            roles.merge(instance[:hostname] => instance[:roles].join(','))
+          end
+          hash_argument('--instance-roles', role_pairs)
+
+          role_pairs = instances.inject({}) do |roles, instance|
+            roles.merge(instance[:hostname] => instance[:name])
+          end
+          hash_argument('--instance-names', role_pairs)
+
+          array_argument('--instances', instances.map{|i| i[:hostname]})
+        end
+
+        def json_argument(switch, value)
+          if value
+            string_argument(switch, value.to_json)
+          end
+        end
+
+        def string_argument(switch, value)
+          unless value.to_s.empty?
+            @arguments << [switch, value]
+          end
+        end
+
+      end
+    end
+  end
+end

data/lib/engineyard-serverside-adapter/deploy.rb

@@ -0,0 +1,25 @@
+module EY
+  module Serverside
+    class Adapter
+      class Deploy < Action
+
+        option :app,           :string,    :required => true
+        option :stack,         :string,    :required => true
+        option :instances,     :instances, :required => true
+        option :config,        :json
+        option :verbose,       :boolean
+        option :framework_env, :string,    :required => true
+        option :ref,           :string,    :required => true
+        option :repo,          :string,    :required => true
+        option :migrate,       :string
+
+      private
+
+        def task
+          ['deploy']
+        end
+
+      end
+    end
+  end
+end

data/lib/engineyard-serverside-adapter/disable_maintenance_page.rb

@@ -0,0 +1,19 @@
+module EY
+  module Serverside
+    class Adapter
+      class DisableMaintenancePage < Action
+
+        option :app,       :string,    :required => true
+        option :instances, :instances, :required => true
+        option :verbose,   :boolean
+
+      private
+
+        def task
+          ['deploy', 'disable_maintenance_page']
+        end
+
+      end
+    end
+  end
+end

data/lib/engineyard-serverside-adapter/enable_maintenance_page.rb

@@ -0,0 +1,19 @@
+module EY
+  module Serverside
+    class Adapter
+      class EnableMaintenancePage < Action
+
+        option :app,       :string,    :required => true
+        option :instances, :instances, :required => true
+        option :verbose,   :boolean
+
+      private
+
+        def task
+          ['deploy', 'enable_maintenance_page']
+        end
+
+      end
+    end
+  end
+end

data/lib/engineyard-serverside-adapter/integrate.rb

@@ -0,0 +1,21 @@
+module EY
+  module Serverside
+    class Adapter
+      class Integrate < Action
+
+        option :app,           :string,    :required => true
+        option :stack,         :string,    :required => true
+        option :instances,     :instances, :required => true
+        option :framework_env, :string,    :required => true
+        option :verbose,       :boolean
+
+      private
+
+        def task
+          ['integrate']
+        end
+
+      end
+    end
+  end
+end

data/lib/engineyard-serverside-adapter/rollback.rb

@@ -0,0 +1,21 @@
+module EY
+  module Serverside
+    class Adapter
+      class Rollback < Action
+
+        option :app,       :string,    :required => true
+        option :stack,     :string,    :required => true
+        option :instances, :instances, :required => true
+        option :config,    :json
+        option :verbose,   :boolean
+
+      private
+
+        def task
+          ['deploy', 'rollback']
+        end
+
+      end
+    end
+  end
+end

data/lib/engineyard-serverside-adapter/version.rb

@@ -0,0 +1,7 @@
+module EY
+  module Serverside
+    class Adapter
+      VERSION = "1.3.1.pre"
+    end
+  end
+end

data/spec/adapter_spec.rb

@@ -0,0 +1,125 @@
+require 'spec_helper'
+
+shared_examples_for "a serverside action" do
+  before(:each) do
+    @adapter = described_class.new do |args|
+      args.app           = 'app-from-adapter-new'
+      args.instances     = [{:hostname => 'localhost', :roles => %w[a b c]}]
+      args.framework_env = 'production'
+      args.ref           = 'master'
+      args.repo          = 'git@github.com:engineyard/engineyard-serverside.git'
+      args.stack         = 'nginx_unicorn'
+      args
+    end
+  end
+
+  it "gives you an Arguments already set up from when you instantiated the adapter" do
+    command = @adapter.send(@method) do |args|
+      args.app.should == 'app-from-adapter-new'
+    end
+  end
+
+  it "applies both sets of changes" do
+    action = @adapter.send(@method) do |args|
+      args.verbose = true
+    end
+
+    command = last_command(action)
+    command.should include('--app app-from-adapter-new')
+    command.should include('--verbose')
+  end
+
+  it "does not let arguments changes propagate back up to the adapter" do
+    command1 = @adapter.send(@method) do |args|
+      args.app = 'sporkr'
+    end
+
+    @adapter.send(@method) do |args|
+      args.app.should == 'app-from-adapter-new'
+    end
+  end
+
+  context "with no pathname specified" do
+    it "begins both commands with no path" do
+      action = @adapter.send(@method) do |args|
+        args.verbose = true
+      end
+
+      commands = all_commands(action)
+      commands.first.should =~ /^\(gem/
+      commands.last.should =~ /^engineyard-serverside/
+    end
+  end
+
+  context "with a pathname specified" do
+    it "begins both commands with the given path" do
+      adapter = described_class.new("/usr/local/grin") do |args|
+        args.app           = 'app-from-adapter-new'
+        args.instances     = [{:hostname => 'localhost', :roles => %w[a b c]}]
+        args.framework_env = 'production'
+        args.ref           = 'master'
+        args.repo          = 'git@github.com:engineyard/engineyard-serverside.git'
+        args.stack         = 'nginx_unicorn'
+        args
+      end
+
+      action = adapter.send(@method) do |args|
+        args.verbose = true
+      end
+
+      commands = all_commands(action)
+      commands.first.should =~ %r{^\(/usr/local/grin/gem}
+      commands.last.should =~ %r{^/usr/local/grin/engineyard-serverside}
+    end
+  end
+end
+
+describe EY::Serverside::Adapter do
+  context ".new" do
+    it "lets you access the arguments" do
+      adapter = described_class.new do |args|
+        args.app = 'myapp'
+      end
+    end
+
+    it "does not require a block" do
+      lambda { described_class.new }.should_not raise_error
+    end
+  end
+
+  [
+    :deploy,
+    :disable_maintenance_page,
+    :enable_maintenance_page,
+    :integrate,
+    :rollback,
+  ].each do |method|
+    context "##{method}" do
+      before { @method = method }
+      it_should_behave_like "a serverside action"
+    end
+  end
+
+  context "mapping of methods to action classes" do
+    before(:each) do
+      @adapter = described_class.new do |args|
+        args.app           = 'app-from-adapter-new'
+        args.instances     = [{:hostname => 'localhost', :roles => %w[a b c]}]
+        args.framework_env = 'production'
+        args.ref           = 'master'
+        args.repo          = 'git@github.com:engineyard/engineyard-serverside.git'
+        args.stack         = 'nginx_unicorn'
+        args
+      end
+    end
+
+    it "gives you the right command" do
+      @adapter.enable_maintenance_page.should  be_kind_of(EY::Serverside::Adapter::EnableMaintenancePage)
+      @adapter.disable_maintenance_page.should be_kind_of(EY::Serverside::Adapter::DisableMaintenancePage)
+      @adapter.deploy.should                   be_kind_of(EY::Serverside::Adapter::Deploy)
+      @adapter.integrate.should                be_kind_of(EY::Serverside::Adapter::Integrate)
+      @adapter.rollback.should                 be_kind_of(EY::Serverside::Adapter::Rollback)
+    end
+  end
+
+end

data/spec/arguments_spec.rb

@@ -0,0 +1,28 @@
+require 'spec_helper'
+
+describe EY::Serverside::Adapter::Arguments do
+  def raises_argument_error(&block)
+    lambda {
+      block.call(described_class.new)
+    }.should raise_error(ArgumentError)
+  end
+
+  it "raises an ArgumentError immediately when instances is empty" do
+    raises_argument_error do |arguments|
+      arguments.instances = []
+    end
+  end
+
+  it "raises an ArgumentError immediately when instances is something totally silly" do
+    raises_argument_error do |arguments|
+      arguments.instances = 42
+    end
+  end
+
+  it "raises an ArgumentError immediately when instances contains something totally silly" do
+    raises_argument_error do |arguments|
+      arguments.instances = [nil]
+    end
+  end
+
+end

data/spec/deploy_spec.rb

@@ -0,0 +1,48 @@
+require 'spec_helper'
+
+describe EY::Serverside::Adapter::Deploy do
+  it_should_behave_like "it installs engineyard-serverside"
+
+  it_should_behave_like "it accepts app"
+  it_should_behave_like "it accepts framework_env"
+  it_should_behave_like "it accepts instances"
+  it_should_behave_like "it accepts migrate"
+  it_should_behave_like "it accepts ref"
+  it_should_behave_like "it accepts repo"
+  it_should_behave_like "it accepts stack"
+  it_should_behave_like "it accepts verbose"
+
+  it_should_require :app
+  it_should_require :instances
+  it_should_require :framework_env
+  it_should_require :ref
+  it_should_require :repo
+  it_should_require :stack
+
+  it_should_behave_like "it treats config as optional"
+  it_should_behave_like "it treats migrate as optional"
+
+  context "with valid arguments" do
+    let(:command) do
+      adapter = described_class.new do |arguments|
+        arguments.app = "rackapp"
+        arguments.framework_env = 'production'
+        arguments.config = {'a' => 1}
+        arguments.instances = [{:hostname => 'localhost', :roles => %w[han solo], :name => 'chewie'}]
+        arguments.migrate = 'rake db:migrate'
+        arguments.ref = 'master'
+        arguments.repo = 'git@github.com:engineyard/engineyard-serverside.git'
+        arguments.stack = "nginx_unicorn"
+      end
+      last_command(adapter)
+    end
+
+    it "puts the config in the command line as json" do
+      command.should =~ /--config '#{Regexp.quote '{"a":1}'}'/
+    end
+
+    it "invokes exactly the right command" do
+      command.should == "engineyard-serverside _#{EY::Serverside::Adapter::VERSION}_ deploy --app rackapp --config '{\"a\":1}' --framework-env production --instance-names localhost:chewie --instance-roles localhost:han,solo --instances localhost --migrate 'rake db:migrate' --ref master --repo git@github.com:engineyard/engineyard-serverside.git --stack nginx_unicorn"
+    end
+  end
+end

data/spec/disable_maintenance_page_spec.rb

@@ -0,0 +1,26 @@
+require 'spec_helper'
+
+describe EY::Serverside::Adapter::DisableMaintenancePage do
+  it_should_behave_like "it installs engineyard-serverside"
+
+  it_should_behave_like "it accepts app"
+  it_should_behave_like "it accepts instances"
+  it_should_behave_like "it accepts verbose"
+
+  it_should_require :app
+  it_should_require :instances
+
+  context "with valid arguments" do
+    let(:command) do
+      adapter = described_class.new do |arguments|
+        arguments.app = "rackapp"
+        arguments.instances = [{:hostname => 'localhost', :roles => %w[han solo], :name => 'chewie'}]
+      end
+      last_command(adapter)
+    end
+
+    it "invokes exactly the right command" do
+      command.should == "engineyard-serverside _#{EY::Serverside::Adapter::VERSION}_ deploy disable_maintenance_page --app rackapp --instance-names localhost:chewie --instance-roles localhost:han,solo --instances localhost"
+    end
+  end
+end

data/spec/enable_maintenance_page_spec.rb

@@ -0,0 +1,28 @@
+require 'spec_helper'
+
+describe EY::Serverside::Adapter::EnableMaintenancePage do
+  it_should_behave_like "it installs engineyard-serverside"
+
+  it_should_behave_like "it accepts app"
+  it_should_behave_like "it accepts instances"
+  it_should_behave_like "it accepts verbose"
+
+  it_should_require :app
+  it_should_require :instances
+
+  context "with valid arguments" do
+
+    let(:command) do
+      adapter = described_class.new do |arguments|
+        arguments.app = "rackapp"
+        arguments.instances = [{:hostname => 'localhost', :roles => %w[han solo], :name => 'chewie'}]
+      end
+      last_command(adapter)
+    end
+
+    it "invokes exactly the right command" do
+      command.should == "engineyard-serverside _#{EY::Serverside::Adapter::VERSION}_ deploy enable_maintenance_page --app rackapp --instance-names localhost:chewie --instance-roles localhost:han,solo --instances localhost"
+    end
+  end
+
+end

data/spec/integrate_spec.rb

@@ -0,0 +1,32 @@
+require 'spec_helper'
+
+describe EY::Serverside::Adapter::Integrate do
+  it_should_behave_like "it installs engineyard-serverside"
+
+  it_should_behave_like "it accepts app"
+  it_should_behave_like "it accepts framework_env"
+  it_should_behave_like "it accepts instances"
+  it_should_behave_like "it accepts stack"
+  it_should_behave_like "it accepts verbose"
+
+  it_should_require :app
+  it_should_require :stack
+  it_should_require :instances
+  it_should_require :framework_env
+
+  context "with valid arguments" do
+    let(:command) do
+      adapter = described_class.new do |arguments|
+        arguments.app = "rackapp"
+        arguments.instances = [{:hostname => 'localhost', :roles => %w[han solo], :name => 'chewie'}]
+        arguments.stack = "nginx_unicorn"
+        arguments.framework_env = "production"
+      end
+      last_command(adapter)
+    end
+
+    it "invokes exactly the right command" do
+      command.should == "engineyard-serverside _#{EY::Serverside::Adapter::VERSION}_ integrate --app rackapp --framework-env production --instance-names localhost:chewie --instance-roles localhost:han,solo --instances localhost --stack nginx_unicorn"
+    end
+  end
+end

data/spec/rollback_spec.rb

@@ -0,0 +1,34 @@
+require 'spec_helper'
+
+describe EY::Serverside::Adapter::Rollback do
+  it_should_behave_like "it installs engineyard-serverside"
+
+  it_should_behave_like "it accepts app"
+  it_should_behave_like "it accepts instances"
+  it_should_behave_like "it accepts stack"
+  it_should_behave_like "it accepts verbose"
+
+  it_should_require :app
+  it_should_require :stack
+  it_should_require :instances
+
+  context "with valid arguments" do
+    let(:command) do
+      adapter = described_class.new do |arguments|
+        arguments.app = "rackapp"
+        arguments.instances = [{:hostname => 'localhost', :roles => %w[han solo], :name => 'chewie'}]
+        arguments.stack = "nginx_unicorn"
+        arguments.config = {'a' => 1}
+      end
+      last_command(adapter)
+    end
+
+    it "puts the config in the command line as json" do
+      command.should =~ /--config '#{Regexp.quote '{"a":1}'}'/
+    end
+
+    it "invokes exactly the right command" do
+      command.should == "engineyard-serverside _#{EY::Serverside::Adapter::VERSION}_ deploy rollback --app rackapp --config '{\"a\":1}' --instance-names localhost:chewie --instance-roles localhost:han,solo --instances localhost --stack nginx_unicorn"
+    end
+  end
+end

data/spec/spec.opts

@@ -0,0 +1,3 @@
+--color
+--format specdoc
+--backtrace

data/spec/spec_helper.rb

@@ -0,0 +1,182 @@
+require 'rubygems'
+require 'bundler/setup'
+
+require 'engineyard-serverside-adapter'
+require 'pp'
+
+module ArgumentsHelpers
+  def valid_options
+    {
+      :app           => 'rackapp',
+      :framework_env => 'production',
+      :instances     => [{:hostname => 'localhost', :roles => %w[han solo], :name => 'chewie'}],
+      :ref           => 'master',
+      :repo          => 'git@github.com:engineyard/engineyard-serverside.git',
+      :stack         => 'nginx_unicorn',
+    }
+  end
+
+  def valid_arguments() arguments_without() end   # without nothing --> valid :)
+
+  def arguments_with(fields)
+    arguments = valid_arguments
+    fields.each do |field, value|
+      arguments.send("#{field}=", value)
+    end
+    arguments
+  end
+
+  def arguments_without(*fields)
+    arguments = EY::Serverside::Adapter::Arguments.new
+    valid_options.each do |field, value|
+      arguments.send("#{field}=", value) unless fields.include?(field)
+    end
+    arguments
+  end
+
+  def all_commands(adapter)
+    commands = []
+    adapter.call { |command| commands << command }
+    commands
+  end
+
+  def last_command(adapter)
+    all_commands(adapter).last
+  end
+end
+
+module RequiredFieldHelpers
+  def it_should_require(field)
+    context "field #{field}" do
+      it "is just fine when #{field} is there" do
+        lambda { described_class.new(:arguments => valid_arguments) }.should_not raise_error
+      end
+
+      it "raises an error if #{field} is missing" do
+        lambda { described_class.new(:arguments => arguments_without(field)) }.should raise_error(ArgumentError)
+      end
+    end
+  end
+end
+
+Spec::Runner.configure do |config|
+  config.include ArgumentsHelpers
+  config.extend RequiredFieldHelpers
+
+  shared_examples_for "it installs engineyard-serverside" do
+    it "checks for and installs engineyard-serverside before invoking it" do
+      adapter = described_class.new(:arguments => valid_arguments)
+
+      all_commands(adapter).size.should == 2
+      installation_command = all_commands(adapter).first
+
+      # of course, the only way to be sure is to actually run it, but
+      # this gives us regression-proofing
+      version = EY::Serverside::Adapter::ENGINEYARD_SERVERSIDE_VERSION
+      escaped_version = version.gsub(/\./, '\\.')
+      installation_command.should == "(gem list engineyard-serverside | grep 'engineyard-serverside ' | egrep -q '#{escaped_version}[,)]') || (sudo sh -c 'cd `mktemp -d` && gem install engineyard-serverside --no-rdoc --no-ri -v #{version}')"
+
+
+      installation_command.should =~ /gem list engineyard-serverside/
+      installation_command.should =~ /egrep -q /
+      installation_command.should =~ /gem install engineyard-serverside.*-v #{Regexp.quote EY::Serverside::Adapter::VERSION}/
+    end
+  end
+
+  shared_examples_for "it accepts verbose" do
+    context "the --verbose arg" do
+      it "is present when you set verbose to true" do
+        adapter = described_class.new(:arguments => arguments_with(:verbose => true))
+        last_command(adapter).should =~ /--verbose/
+      end
+
+      it "is absent when you set verbose to false" do
+        adapter = described_class.new(:arguments => arguments_with(:verbose => false))
+        last_command(adapter).should_not =~ /--verbose/
+      end
+
+      it "is absent when you omit verbose" do
+        adapter = described_class.new(:arguments => valid_arguments)
+        last_command(adapter).should_not =~ /--verbose/
+      end
+    end
+  end
+
+  {
+    :app           => '--app',
+    :stack         => '--stack',
+    :framework_env => '--framework-env',
+    :ref           => '--ref',
+    :repo          => '--repo',
+    :migrate       => '--migrate',
+  }.each do |arg, switch|
+    shared_examples_for "it accepts #{arg}" do
+      it "puts the #{switch} arg in the command line" do
+        adapter = described_class.new(:arguments => arguments_with(arg => 'word'))
+        last_command(adapter).should =~ /#{switch} word/
+      end
+
+      it "handles arguments that need to be escaped" do
+        adapter = described_class.new(:arguments => arguments_with(arg => 'two words'))
+        last_command(adapter).should =~ /#{switch} 'two words'/
+      end
+    end
+
+    shared_examples_for "it treats #{arg} as optional" do
+      it "omits #{switch} when you don't give it #{arg}" do
+        adapter = described_class.new(:arguments => arguments_without(arg))
+        last_command(adapter).should_not include(switch)
+      end
+    end
+
+  end
+
+  shared_examples_for "it treats config as optional" do
+    it "omits --config when you don't give it config" do
+      adapter = described_class.new(:arguments => arguments_without(:config))
+      last_command(adapter).should_not include('--config')
+    end
+  end
+
+  shared_examples_for "it accepts instances" do
+    context "given an unnamed instance" do
+      it "puts the instance in the command line" do
+        adapter = described_class.new(:arguments => arguments_with(
+          :instances => [{:hostname => 'localhost', :roles => %w[han solo], :name => nil}]
+        ))
+        command = last_command(adapter)
+        command.should =~ /--instances localhost/
+        command.should =~ /--instance-roles localhost:han,solo/
+        command.should_not =~ /--instance-names/
+      end
+    end
+
+    context "given a named instance" do
+      it "puts the instance in the command line" do
+        adapter = described_class.new(:arguments => arguments_with(
+          :instances => [{:hostname => 'localhost', :roles => %w[han solo], :name => 'chewie'}]
+        ))
+        command = last_command(adapter)
+        command.should =~ /--instances localhost/
+        command.should =~ /--instance-roles localhost:han,solo/
+        command.should =~ /--instance-names localhost:chewie/
+      end
+    end
+
+    context "given multiple instances" do
+      it "puts the instance in the command line" do
+        adapter = described_class.new(:arguments => arguments_with({
+          :instances => [
+            {:hostname => 'localhost', :roles => %w[wookie], :name => 'chewie'},
+            {:hostname => 'crazy-ass-amazon-1243324321.domain', :roles => %w[bounty-hunter], :name => nil},
+            {:hostname => 'simpler.domain', :roles => %w[pilot scruffy-lookin-nerf-herder], :name => 'han'},
+          ]
+        }))
+        command = last_command(adapter)
+        command.should =~ /--instances crazy-ass-amazon-1243324321.domain localhost simpler.domain/
+        command.should =~ /--instance-roles crazy-ass-amazon-1243324321.domain:bounty-hunter localhost:wookie simpler.domain:pilot,scruffy-lookin-nerf-herder/
+        command.should =~ /--instance-names localhost:chewie simpler.domain:han/
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,156 @@
+--- !ruby/object:Gem::Specification 
+name: engineyard-serverside-adapter
+version: !ruby/object:Gem::Version 
+  hash: 961915976
+  prerelease: true
+  segments: 
+  - 1
+  - 3
+  - 1
+  - pre
+  version: 1.3.1.pre
+platform: ruby
+authors: []
+
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-09-15 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: escape
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 23
+        segments: 
+        - 0
+        - 0
+        - 4
+        version: 0.0.4
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: json_pure
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 11
+        segments: 
+        - 1
+        - 4
+        - 6
+        version: 1.4.6
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: bundler
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 23
+        segments: 
+        - 1
+        - 0
+        - 0
+        version: 1.0.0
+  type: :development
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 27
+        segments: 
+        - 1
+        - 3
+        - 0
+        version: 1.3.0
+  type: :development
+  version_requirements: *id004
+description: A separate adapter for speaking the CLI language of the engineyard-serverside gem.
+email: []
+
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- Rakefile
+- engineyard-serverside-adapter.gemspec
+- lib/engineyard-serverside-adapter.rb
+- lib/engineyard-serverside-adapter/action.rb
+- lib/engineyard-serverside-adapter/arguments.rb
+- lib/engineyard-serverside-adapter/command.rb
+- lib/engineyard-serverside-adapter/deploy.rb
+- lib/engineyard-serverside-adapter/disable_maintenance_page.rb
+- lib/engineyard-serverside-adapter/enable_maintenance_page.rb
+- lib/engineyard-serverside-adapter/integrate.rb
+- lib/engineyard-serverside-adapter/rollback.rb
+- lib/engineyard-serverside-adapter/version.rb
+- spec/adapter_spec.rb
+- spec/arguments_spec.rb
+- spec/deploy_spec.rb
+- spec/disable_maintenance_page_spec.rb
+- spec/enable_maintenance_page_spec.rb
+- spec/integrate_spec.rb
+- spec/rollback_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://github.com/engineyard/engineyard-serverside-adapter
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 23
+      segments: 
+      - 1
+      - 3
+      - 6
+      version: 1.3.6
+requirements: []
+
+rubyforge_project: engineyard-serverside-adapter
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Adapter for speaking to engineyard-serverside
+test_files: []
+