crafterm-sprinkle 0.1.0

data/spec/spec_helper.rb

@@ -0,0 +1,17 @@
+begin
+  require 'spec'
+rescue LoadError
+  require 'rubygems'
+  gem 'rspec'
+  require 'spec'
+end
+
+$:.unshift(File.dirname(__FILE__) + '/../lib')
+require 'sprinkle'
+
+module Kernel
+  def logger
+    @@__log_file__ ||= StringIO.new
+    @@__log__ = ActiveSupport::BufferedLogger.new @@__log_file__
+  end
+end

data/spec/sprinkle/actors/capistrano_spec.rb

@@ -0,0 +1,150 @@
+require File.dirname(__FILE__) + '/../../spec_helper'
+
+describe Sprinkle::Actors::Capistrano do
+
+  before do
+    @recipes = 'deploy'
+    @cap = ::Capistrano::Configuration.new
+    ::Capistrano::Configuration.stub!(:new).and_return(@cap)
+    @cap.stub!(:load).and_return
+  end
+
+  def create_cap(&block)
+    Sprinkle::Actors::Capistrano.new &block
+  end
+
+  describe 'when created' do
+
+    it 'should create a new capistrano object' do
+      ::Capistrano::Configuration.should_receive(:new).and_return(@cap)
+      create_cap
+    end
+
+    describe 'when verbose' do
+
+      before do
+        Sprinkle::OPTIONS[:verbose] = true
+      end
+
+      it 'should set verbose logging on the capistrano object' do
+        @cap = create_cap
+        @cap.config.logger.level.should == ::Capistrano::Logger::INFO
+      end
+
+    end
+
+    describe 'when not verbose' do
+
+      before do
+        Sprinkle::OPTIONS[:verbose] = false
+      end
+
+      it 'should set quiet logging on the capistrano object' do
+        @cap = create_cap
+        @cap.config.logger.level.should == ::Capistrano::Logger::IMPORTANT
+      end
+
+    end
+
+    describe 'with a block' do
+
+      before do
+        @actor = create_cap do
+          recipes 'cool gear' # default is deploy
+        end
+      end
+
+      it 'should evaluate the block against the actor instance' do
+        @actor.loaded_recipes.should include('cool gear')
+      end
+
+    end
+
+    describe 'without a block' do
+
+      it 'should automatically load the default capistrano configuration' do
+        @cap.should_receive(:load).with('deploy').and_return
+      end
+
+      after do
+        @actor = create_cap
+      end
+
+    end
+
+  end
+
+  describe 'recipes' do
+
+    it 'should add the recipe location to an internal store' do
+      @cap = create_cap do
+        recipes 'deploy'
+      end
+      @cap.loaded_recipes.should == [ @recipes ]
+    end
+
+    it 'should load the given recipe' do
+      @cap.should_receive(:load).with(@recipes).and_return
+      create_cap
+    end
+
+  end
+
+  describe 'processing commands' do
+
+    before do
+      @commands = %w( op1 op2 )
+      @roles    = %w( app )
+      @name     = 'name'
+
+      @cap = create_cap do; recipes 'deploy'; end
+      @cap.stub!(:run).and_return
+    end
+
+    it 'should dynamically create a capistrano task containing the commands' do
+      @cap.config.should_receive(:task).and_return
+    end
+
+    it 'should invoke capistrano task after creation' do
+      @cap.should_receive(:run).with(@name).and_return
+    end
+
+    after do
+      @cap.process @name, @commands, @roles
+    end
+
+  end
+
+  describe 'generated task' do
+
+    before do
+      @commands = %w( op1 op2 )
+      @roles    = %w( app )
+      @name     = 'name'
+
+      @cap = create_cap do; recipes 'deploy'; end
+      @cap.config.stub!(:fetch).and_return(:sudo)
+      @cap.config.stub!(:invoke_command).and_return
+    end
+
+    it 'should use sudo to invoke commands when so configured' do
+      @cap.config.should_receive(:fetch).with(:run_method, :sudo).and_return(:sudo)
+    end
+
+    it 'should run the supplied commands' do
+      @cap.config.should_receive(:invoke_command).with('op1', :via => :sudo).ordered.and_return
+      @cap.config.should_receive(:invoke_command).with('op2', :via => :sudo).ordered.and_return
+    end
+
+    it 'should be applicable for the supplied roles' do
+      @cap.stub!(:run).and_return
+      @cap.config.should_receive(:task).with(:install_name, :roles => @roles).and_return
+    end
+
+    after do
+      @cap.process @name, @commands, @roles
+    end
+
+  end
+
+end

data/spec/sprinkle/deployment_spec.rb

@@ -0,0 +1,80 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe Sprinkle::Deployment do
+  include Sprinkle::Deployment
+  
+  def create_deployment(&block)
+    deployment do
+      delivery :capistrano, &block
+      
+      source do
+        prefix '/usr/local'
+      end
+    end
+  end
+
+  describe 'when created' do
+
+    it 'should be invalid without a block descriptor' do
+      lambda { deployment }.should raise_error
+    end
+
+    it 'should be invalid without a delivery method' do
+      lambda { @deployment = deployment do; end }.should raise_error
+    end
+
+    it 'should optionally accept installer defaults' do 
+      @deployment = create_deployment
+      @deployment.should respond_to(:source)
+    end
+    
+    it 'should provide installer defaults as a proc when requested' do 
+      @deployment = create_deployment
+      @deployment.defaults[:source].class.should == Proc
+    end
+    
+  end 
+  
+  describe 'delivery specification' do
+    
+    before do
+      @actor = mock(Sprinkle::Actors::Capistrano)
+      Sprinkle::Actors::Capistrano.stub!(:new).and_return(@actor)
+    end
+
+    it 'should automatically instantiate the delivery type' do 
+      @deployment = create_deployment
+      @deployment.style.should == @actor
+    end
+
+    it 'should optionally accept a block to pass to the actor' do
+      lambda { @deployment = create_deployment }.should_not raise_error
+    end
+
+    describe 'with a block' do
+
+      it 'should pass the block to the actor for configuration' do
+        @deployment = create_deployment do; recipes 'deploy'; end
+      end
+
+    end
+  end
+  
+  describe 'when processing policies' do 
+    
+    before do 
+      @policy = mock(Policy, :process => true)
+      POLICIES = [ @policy ]
+      @deployment = create_deployment
+    end
+    
+    it 'should apply all policies, passing itself as the deployment context' do
+      @policy.should_receive(:process).with(@deployment).and_return
+    end
+    
+    after do
+      @deployment.process
+    end
+  end
+
+end

data/spec/sprinkle/extensions/array_spec.rb

@@ -0,0 +1,19 @@
+require File.dirname(__FILE__) + '/../../spec_helper'
+
+describe Array, 'task name conversions' do
+  
+  it 'should be able to deliver a task name' do
+    ['build_essential'].to_task_name.should == 'build_essential'
+  end
+  
+  it 'should join multiple elements together with a _ char' do
+    ['gdb', 'gcc', 'g++'].to_task_name.should == 'gdb_gcc_g++'
+  end
+  
+  it 'should use the task name of the underlying array element' do
+    string = 'build-essential'
+    string.should_receive(:to_task_name).and_return('build_essential')
+    [string].to_task_name.should == 'build_essential'
+  end
+    
+end

data/spec/sprinkle/extensions/string_spec.rb

@@ -0,0 +1,21 @@
+require File.dirname(__FILE__) + '/../../spec_helper'
+
+describe String, 'task name conversions' do
+  
+  it 'should be able to deliver a task name' do
+    'build_essential'.to_task_name.should == 'build_essential'
+  end
+  
+  it 'should convert all - chars to _ in the task name' do
+    'build-essential'.to_task_name.should == 'build_essential'
+  end
+  
+  it 'should convert multiple - chars to _ chars in the task name' do
+    'build--essential'.to_task_name.should == 'build__essential'
+  end
+  
+  it 'should lowercase the task name' do
+    'BUILD-ESSENTIAL'.to_task_name.should == 'build_essential'
+  end
+  
+end

data/spec/sprinkle/installers/apt_spec.rb

@@ -0,0 +1,46 @@
+require File.dirname(__FILE__) + '/../../spec_helper'
+
+describe Sprinkle::Installers::Apt do
+
+  before do
+    @package = mock(Sprinkle::Package, :name => 'package')
+  end
+
+  def create_apt(debs, &block)
+    Sprinkle::Installers::Apt.new(@package, debs, &block)
+  end
+
+  describe 'when created' do
+
+    it 'should accept a single package to install' do
+      @installer = create_apt 'ruby'
+      @installer.packages.should == [ 'ruby' ]
+    end
+
+    it 'should accept an array of packages to install' do
+      @installer = create_apt %w( gcc gdb g++ )
+      @installer.packages.should == ['gcc', 'gdb', 'g++']
+    end
+
+  end
+
+  describe 'during installation' do
+
+    before do
+      @installer = create_apt 'ruby'
+      @install_sequence = @installer.send :install_sequence
+    end
+
+    it 'should invoke the apt installer for all specified packages' do
+      @install_sequence.should =~ /apt-get -qyu install ruby/
+    end
+
+    it 'should specify a non interactive mode to the apt installer' do
+      @install_sequence.should =~ /DEBIAN_FRONTEND=noninteractive/
+    end
+
+    it 'should install a specific version if defined'
+
+  end
+
+end

data/spec/sprinkle/installers/gem_spec.rb

@@ -0,0 +1,64 @@
+require File.dirname(__FILE__) + '/../../spec_helper'
+
+describe Sprinkle::Installers::Gem do
+
+  before do
+    @gem = 'rails'
+    @version = '2.0.2'
+    @options = { :source => 'http://gems.github.com/' }
+  end
+
+  def create_gem(gem, version = nil, options = {}, &block)
+    @package = mock(Sprinkle::Package, :name => gem, :version => version, :source => nil)
+    Sprinkle::Installers::Gem.new(@package, gem, options, &block)
+  end
+
+  describe 'when created' do
+
+    before do
+      @installer = create_gem @gem, @version, @options
+    end
+
+    it 'should accept a single package to install' do
+      @installer.gem.should == @gem
+    end
+
+    it 'should optionally store a version of the gem to install' do
+      @installer.version.should == '2.0.2'
+    end
+
+    it 'should optionally store a source location of the gem to install' do
+      @installer.source.should == 'http://gems.github.com/'
+    end
+
+  end
+
+  describe 'during installation' do
+
+    describe 'without a version' do
+
+      before do
+        @installer = create_gem @gem
+      end
+
+      it 'should invoke the gem installer for all specified package' do
+        @installer.send(:install_sequence).should == "gem install #{@gem}"
+      end
+
+    end
+
+    describe 'with a specific version' do
+
+      before do
+        @installer = create_gem @gem, @version
+      end
+
+      it 'should install a specific version if defined' do
+        @installer.send(:install_sequence).should == "gem install #{@gem} --version '#{@version}'"
+      end
+
+    end
+
+  end
+
+end

data/spec/sprinkle/installers/installer_spec.rb

@@ -0,0 +1,125 @@
+require File.dirname(__FILE__) + '/../../spec_helper'
+
+describe Sprinkle::Installers::Installer do
+  include Sprinkle::Deployment
+
+  before do
+    @package = mock(Sprinkle::Package, :name => 'package')
+    @empty = Proc.new { }
+    @sequence = ['op1', 'op2']
+    @delivery = mock(Sprinkle::Deployment, :process => true)
+    @installer = create_installer
+    @installer.delivery = @delivery
+    @roles = []
+    @deployment = deployment do
+      delivery :capistrano
+      installer do; prefix '/usr/bin'; end
+    end
+  end
+
+  def create_installer(&block)
+    installer = Sprinkle::Installers::Installer.new @package, &block
+    installer.stub!(:puts).and_return
+
+    # this is actually an abstract class so we'll insert a few fake install sequences
+    class << installer
+      def install_sequence
+        ['op1', 'op2']
+      end
+    end
+
+    installer
+  end
+
+  describe 'when created' do
+
+    it 'should belong to a package' do
+      @installer.package.should == @package
+    end
+
+    describe 'with a block to customize installer defaults' do
+
+      it 'should accept an optional block to customize installers defaults' do
+        @installer = create_installer do; prefix '/usr/local'; end
+        @installer.prefix.should == '/usr/local'
+      end
+
+      it 'should override any deployment level defaults' do
+        @installer = create_installer do; prefix '/usr/local'; end
+        @installer.defaults(@deployment)
+        @installer.prefix.should == '/usr/local'
+      end
+    end
+  end
+
+  describe 'during configuration' do
+
+    before do
+      @default = Proc.new { }
+      @defaults = { :installer => @default }
+      @deployment.stub!(:defaults).and_return(@defaults)
+    end
+
+    it 'should be configurable via external defaults' do
+      @installer.should respond_to(:defaults)
+    end
+
+    it 'should select the defaults for the particular concrete installer class' do
+      @deployment.should_receive(:defaults).and_return(@defaults)
+      @defaults.should_receive(:[]).with(:installer).and_return(@default)
+    end
+
+    it 'should configure the installer delivery mechansim' do
+      @installer.should_receive(:instance_eval)
+    end
+
+    it 'should maintain an options hash set arbitrarily via method missing' do
+      @installer.instance_eval do
+        hsv 'gts'
+      end
+      @installer.hsv.should == 'gts'
+    end
+
+    after do
+      @installer.defaults(@deployment)
+    end
+
+  end
+
+  describe Sprinkle::Installers::Installer, 'during installation' do
+
+    it 'should request the install sequence from the concrete class' do
+      @installer.should_receive(:install_sequence).and_return(@sequence)
+    end
+
+    describe 'when testing' do
+
+      before do
+        Sprinkle::OPTIONS[:testing] = true
+        @logger = mock(ActiveSupport::BufferedLogger, :debug => true, :debug? => true)
+      end
+
+      it 'should not invoke the delivery mechanism with the install sequence' do
+        @delivery.should_not_receive(:process)
+      end
+
+      it 'should print the install sequence to the console' do
+        @installer.should_receive(:logger).twice.and_return(@logger)
+      end
+
+    end
+
+    describe 'when in production' do
+      it 'should invoke the delivery mechanism to process the install sequence' do
+        @delivery.should_receive(:process).with(@package.name, @sequence, @roles)
+      end
+    end
+
+    after do
+      @installer.process(@roles)
+      Sprinkle::OPTIONS[:testing] = false
+    end
+
+  end
+
+end