powcloud-sprinkle 0.3.0

data/spec/sprinkle/policy_spec.rb

@@ -0,0 +1,126 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe Sprinkle::Policy do
+  include Sprinkle::Policy
+
+  before do
+    @name = 'a policy'
+  end
+
+  describe 'when created' do
+
+    it 'should be invalid without a name' do
+      lambda { policy nil }.should raise_error
+    end
+
+    it 'should be invalid without role definitions' do
+      lambda { policy @name do; end }.should raise_error
+      lambda { policy @name, :roles => :app do; end }.should_not raise_error
+    end
+
+    it 'should optionally accept package dependencies' do
+      p = policy @name, :roles => :app do; end
+      p.should respond_to(:requires)
+      p.requires :appserver
+      p.packages.should == [ :appserver ]
+    end
+
+    it 'should optionally accept package dependencies with versions' do
+      p = policy @name, :roles => :app do; end
+      p.requires :appserver, :version => 2
+      p.packages.should == [ :appserver ]
+      pending 'requires version checking implementation'
+    end
+
+    it 'should add itself to the global policy list' do
+      sz = Sprinkle::Policy::POLICIES.size
+      p = policy @name, :roles => :app do; end
+      Sprinkle::Policy::POLICIES.size.should == sz + 1
+      Sprinkle::Policy::POLICIES.last.should == p
+    end
+
+  end
+
+  describe 'with packages' do
+    include Sprinkle::Package
+
+    before do
+      @deployment = mock(Sprinkle::Deployment)
+      Sprinkle::Package::PACKAGES.clear # reset full package list before each spec is run
+
+      @a = package :a do; requires :b; requires :c; end
+      @b = package :b, :provides => :xyz do; end
+      @c = package :c, :provides => :abc do; end
+      @d = package :d, :provides => :abc do; end
+
+      @policy = policy :test, :roles => :app do; requires :a; end
+      $terminal.stub!(:choose).and_return(:c) # stub out highline asking questions
+    end
+
+    describe 'when applying' do
+      include Sprinkle::Package
+
+      it 'should determine the packages to install via the hierarchy dependency tree of each package in the policy' do
+        @a.should_receive(:process).and_return
+        @b.should_receive(:process).and_return
+        @c.should_receive(:process).and_return
+        @d.should_not_receive(:process)
+      end
+
+      it 'should normalize (ie remove duplicates from) the installation order of all packages including dependencies' do
+        @e = package :e do; requires :b; end
+        @policy.requires :e
+
+        @a.should_receive(:process).once.and_return
+        @b.should_receive(:process).once.and_return
+        @c.should_receive(:process).once.and_return
+        @d.should_not_receive(:process)
+        @e.should_receive(:process).once.and_return
+      end
+    end
+
+    describe 'containing package dependencies with versions' do
+
+      it 'should be invalid if the specified package does not exist'
+      it 'should ignore any packages of the same name that have other versions'
+      it 'should select the correct package version when applying'
+
+    end
+
+    describe 'containing virtual packages' do
+
+      it 'should automatically select a concrete package implementation for a virtual one when there exists only one possible selection' do
+        @policy = policy :virtual, :roles => :app do; requires :xyz; end
+        Sprinkle::Package::PACKAGES[:xyz].should == [ @b ]
+      end
+
+      it 'should ask the user for the concrete package implementation to use for a virtual one when more than one possible choice exists' do
+        @policy = policy :virtual, :roles => :app do; requires :abc; end
+        Sprinkle::Package::PACKAGES[:abc].should include(@c)
+        Sprinkle::Package::PACKAGES[:abc].should include(@d)
+        $terminal.should_receive(:choose).and_return(:c)
+      end
+
+    end
+
+    after do
+      @policy.process(@deployment)
+    end
+  end
+end
+
+describe Sprinkle::Policy, 'with missing packages' do
+
+  before do
+    @deployment = mock(Sprinkle::Deployment)
+    Sprinkle::Package::PACKAGES.clear # reset full package list before each spec is run
+
+    @policy = policy :test, :roles => :app do; requires :z; end
+    $terminal.stub!(:choose).and_return(:c) # stub out highline asking questions
+  end
+
+  it 'should raise an error if a package is missing' do
+    lambda { @policy.process(@deployment) }.should raise_error
+  end
+
+end

data/spec/sprinkle/script_spec.rb

@@ -0,0 +1,51 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe Sprinkle::Script, 'class' do
+  
+  it 'should define a entry point into the system' do
+    Sprinkle::Script.should respond_to(:sprinkle)
+  end
+  
+end
+
+describe Sprinkle::Script, 'when given a script' do
+  
+  before do
+    @script = 'script'
+    @filename = 'filename'
+    
+    @sprinkle = Sprinkle::Script.new
+    Sprinkle::Script.stub!(:new).and_return(@sprinkle)
+  end
+
+  it 'should create a new sprinkle instance' do
+    Sprinkle::Script.should_receive(:new).and_return(@sprinkle)
+    Sprinkle::Script.sprinkle @script
+  end
+  
+  it 'should evaulate the sprinkle script against the instance' do
+    @sprinkle.should_receive(:instance_eval).and_return
+    Sprinkle::Script.sprinkle @script
+  end
+  
+  it 'should specify the filename if given for line number errors' do 
+    @sprinkle.should_receive(:instance_eval).with(@script, @filename).and_return
+    Sprinkle::Script.sprinkle @script, @filename
+  end
+  
+  it 'should specify a filename of __SCRIPT__ by default if none is provided' do 
+    @sprinkle.should_receive(:instance_eval).with(@script, '__SCRIPT__').and_return
+    Sprinkle::Script.sprinkle @script
+  end
+  
+  it 'should automatically run in production mode by default' do
+    @sprinkle.should_receive(:instance_eval).with(@script, '__SCRIPT__').and_return
+    Sprinkle::Script.sprinkle @script
+  end
+  
+  it 'should ask the Sprinkle instance to process the data from the script' do
+    @sprinkle.should_receive(:sprinkle)
+    Sprinkle::Script.sprinkle @script
+  end
+  
+end

data/spec/sprinkle/sprinkle_spec.rb

@@ -0,0 +1,25 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe Sprinkle do
+
+  it 'should automatically extend Object to support package, policy and deployment DSL keywords' do
+    %w( package policy deployment ).each do |keyword|
+      Object.should respond_to(keyword.to_sym)
+    end
+  end
+
+  it 'should default to production mode' do
+    Sprinkle::OPTIONS[:testing].should be_false
+  end
+
+  it 'should automatically create a logger object on Kernel' do
+    Object.should respond_to(:logger)
+    logger.should_not be_nil
+    logger.class.should == ActiveSupport::BufferedLogger
+  end
+
+  it 'should create a logger of level INFO' do
+    logger.level.should == ActiveSupport::BufferedLogger::Severity::INFO
+  end
+
+end

data/spec/sprinkle/verify_spec.rb

@@ -0,0 +1,174 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe Sprinkle::Verify do
+  before do
+    @name = :package
+    @package = package @name do
+      gem 'nonexistent'
+      verify 'moo' do
+        # Check a file exists
+        has_file 'my_file.txt'
+        
+        # Check that a file contains a substring
+        file_contains 'my_file.txt', 'A sunny day on the lower east-side'
+        
+        # Check a directory exists
+        has_directory 'mydir'
+        
+        # Check a symlink exists
+        has_symlink 'mypointer'
+        
+        # Check a symlink points to a certain file
+        has_symlink 'mypointer', 'myfile'
+        
+        # Check if an executable exists
+        has_executable '/usr/bin/ruby'
+        
+        # Check if a global executable exists (in PATH)
+        has_executable 'rails'
+        
+        # Check for a process
+        has_process 'httpd'
+        
+        # Check that ruby can include files
+        ruby_can_load 'a', 'b', 'c'
+        
+        # Check that a gem exists
+        has_gem 'rails'
+        has_gem 'rails', '2.1.0'
+        
+        # Check for a certain RPM package
+        has_rpm 'ntp'
+      end
+    end
+    @verification = @package.verifications[0]
+    @delivery = mock(Sprinkle::Deployment, :process => true)
+    @verification.delivery = @delivery
+  end
+  
+  describe 'when created' do
+    it 'should raise error without a block' do
+      lambda { Verify.new(nil, '') }.should raise_error
+    end
+  end
+  
+  describe 'with checks' do
+    it 'should do a "test -f" on the has_file check' do
+      @verification.commands.should include('test -f my_file.txt')
+    end
+    
+    it 'should do a grep to see if a file contains a text string' do
+      @verification.commands.should include("grep 'A sunny day on the lower east-side' my_file.txt")
+    end
+    
+    it 'should do a "test -d" on the has_directory check' do
+      @verification.commands.should include('test -d mydir')
+    end
+    
+    it 'should do a "test -L" to check something is a symbolic link' do
+      @verification.commands.should include('test -L mypointer')
+    end
+    
+    it 'should do a test equality to check a symlink points to a specific file' do
+      @verification.commands.should include("test 'myfile' = `readlink mypointer`")
+    end
+    
+    it 'should do a "test -x" to check for an executable' do
+      @verification.commands.should include("test -x /usr/bin/ruby")
+    end
+    
+    it 'should test the "which" command to look for a global executable' do
+      @verification.commands.should include('[ -n "`echo \`which rails\``" ]')
+    end
+    
+    it 'should test the process list to find a process' do
+      @verification.commands.should include("ps aux | grep 'httpd' | grep -v grep")
+    end
+    
+    it 'should check if ruby can include a, b, c' do
+      @verification.commands.should include("ruby -e \"require 'rubygems';require 'a';require 'b';require 'c'\"")
+    end
+    
+    it 'should check that a ruby gem is installed' do
+      @verification.commands.should include("sudo gem list | grep -e '^rails (.*.*)$'")
+      @verification.commands.should include("sudo gem list | grep -e '^rails (.*2\\.1\\.0.*)$'")
+    end
+    
+    it 'should check that an RPM is installed' do
+      @verification.commands.should include("rpm -qa | grep ntp")
+    end
+  end
+  
+  describe 'with configurations' do
+    # Make sure it includes Sprinkle::Configurable
+    it 'should respond to configurable methods' do
+      @verification.should respond_to(:defaults)
+    end
+    
+    it 'should default padding option to 4' do
+      @verification.padding.should eql(4)
+    end
+  end
+  
+  describe 'with process' do
+    it 'should raise an error when no delivery mechanism is set' do
+      @verification.instance_variable_set(:@delivery, nil)
+      lambda { @verification.process([]) }.should raise_error
+    end
+    
+    describe 'when not testing' do
+      before do
+        # To be explicit
+        Sprinkle::OPTIONS[:testing] = false
+      end
+      
+      it 'should call process on the delivery with the correct parameters' do
+        @delivery.should_receive(:process).with(@name, @verification.commands, [:app], true).once.and_return(true)
+        @verification.process([:app])
+      end
+      
+      it 'should raise Sprinkle::VerificationFailed exception when commands fail' do
+        @delivery.should_receive(:process).once.and_return(false)
+        lambda { @verification.process([:app]) }.should raise_error(Sprinkle::VerificationFailed) do |error|
+          error.package.should eql(@package)
+          error.description.should eql('moo')
+        end
+      end
+    end
+    
+    describe 'when testing' do
+      before do
+        Sprinkle::OPTIONS[:testing] = true
+        @logger = mock(ActiveSupport::BufferedLogger, :debug => true, :debug? => true)
+      end
+      
+      it 'should not call process on the delivery' do
+        @delivery.should_not_receive(:process)
+      end
+
+      it 'should print the install sequence to the console' do
+        @verification.should_receive(:logger).twice.and_return(@logger)
+      end
+      
+      after do
+        @verification.process([:app])
+        Sprinkle::OPTIONS[:testing] = false
+      end
+    end
+  end
+  
+  describe 'with registering new verification modules' do
+    module MyModule
+      def rawr; end
+    end
+    
+    it 'should not respond to rawr initially' do
+      @verification.should_not respond_to(:rawr)
+    end
+    
+    it 'should respond to rawr after registering the module' do
+      Sprinkle::Verify.register(MyModule)
+      @verification.should respond_to(:rawr)
+    end
+  end
+end

metadata

@@ -0,0 +1,244 @@
+--- !ruby/object:Gem::Specification 
+name: powcloud-sprinkle
+version: !ruby/object:Gem::Version 
+  version: 0.3.0
+platform: ruby
+authors: 
+- Marcus Crafter
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-02-08 00:00:00 +03:00
+default_executable: sprinkle
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.2.9
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: activesupport
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 2.0.2
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: highline
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.4.0
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: capistrano
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 2.5.5
+    version: 
+description: Ruby DSL based software provisioning tool
+email: drush@powcloud.com
+executables: 
+- sprinkle
+extensions: []
+
+extra_rdoc_files: 
+- README.markdown
+files: 
+- .gitignore
+- CREDITS
+- MIT-LICENSE
+- README.markdown
+- Rakefile
+- VERSION
+- bin/sprinkle
+- examples/packages/build_essential.rb
+- examples/packages/databases/mysql.rb
+- examples/packages/databases/sqlite3.rb
+- examples/packages/phusion.rb
+- examples/packages/ruby/rails.rb
+- examples/packages/ruby/ruby.rb
+- examples/packages/ruby/rubygems.rb
+- examples/packages/scm/git.rb
+- examples/packages/scm/subversion.rb
+- examples/packages/servers/apache.rb
+- examples/rails/README
+- examples/rails/deploy.rb
+- examples/rails/packages/database.rb
+- examples/rails/packages/essential.rb
+- examples/rails/packages/rails.rb
+- examples/rails/packages/scm.rb
+- examples/rails/packages/search.rb
+- examples/rails/packages/server.rb
+- examples/rails/rails.rb
+- examples/sprinkle/sprinkle.rb
+- lib/sprinkle.rb
+- lib/sprinkle/actors/actors.rb
+- lib/sprinkle/actors/capistrano.rb
+- lib/sprinkle/actors/local.rb
+- lib/sprinkle/actors/ssh.rb
+- lib/sprinkle/actors/vlad.rb
+- lib/sprinkle/configurable.rb
+- lib/sprinkle/deployment.rb
+- lib/sprinkle/extensions/arbitrary_options.rb
+- lib/sprinkle/extensions/array.rb
+- lib/sprinkle/extensions/blank_slate.rb
+- lib/sprinkle/extensions/dsl_accessor.rb
+- lib/sprinkle/extensions/string.rb
+- lib/sprinkle/extensions/symbol.rb
+- lib/sprinkle/installers/apt.rb
+- lib/sprinkle/installers/binary.rb
+- lib/sprinkle/installers/bsd_port.rb
+- lib/sprinkle/installers/deb.rb
+- lib/sprinkle/installers/freebsd_pkg.rb
+- lib/sprinkle/installers/freebsd_portinstall.rb
+- lib/sprinkle/installers/gem.rb
+- lib/sprinkle/installers/install_package.rb
+- lib/sprinkle/installers/installer.rb
+- lib/sprinkle/installers/mac_port.rb
+- lib/sprinkle/installers/noop.rb
+- lib/sprinkle/installers/openbsd_pkg.rb
+- lib/sprinkle/installers/opensolaris_pkg.rb
+- lib/sprinkle/installers/push_text.rb
+- lib/sprinkle/installers/rake.rb
+- lib/sprinkle/installers/rpm.rb
+- lib/sprinkle/installers/smart.rb
+- lib/sprinkle/installers/source.rb
+- lib/sprinkle/installers/transfer.rb
+- lib/sprinkle/installers/yum.rb
+- lib/sprinkle/package.rb
+- lib/sprinkle/policy.rb
+- lib/sprinkle/script.rb
+- lib/sprinkle/verifiers/directory.rb
+- lib/sprinkle/verifiers/executable.rb
+- lib/sprinkle/verifiers/file.rb
+- lib/sprinkle/verifiers/package.rb
+- lib/sprinkle/verifiers/process.rb
+- lib/sprinkle/verifiers/rpm.rb
+- lib/sprinkle/verifiers/ruby.rb
+- lib/sprinkle/verifiers/symlink.rb
+- lib/sprinkle/verify.rb
+- script/console
+- script/destroy
+- script/generate
+- spec/spec.opts
+- spec/spec_helper.rb
+- spec/sprinkle/actors/capistrano_spec.rb
+- spec/sprinkle/actors/local_spec.rb
+- spec/sprinkle/configurable_spec.rb
+- spec/sprinkle/deployment_spec.rb
+- spec/sprinkle/extensions/array_spec.rb
+- spec/sprinkle/extensions/string_spec.rb
+- spec/sprinkle/installers/apt_spec.rb
+- spec/sprinkle/installers/bsd_port_spec.rb
+- spec/sprinkle/installers/freebsd_pkg_spec.rb
+- spec/sprinkle/installers/freebsd_portinstall_spec.rb
+- spec/sprinkle/installers/gem_spec.rb
+- spec/sprinkle/installers/installer_spec.rb
+- spec/sprinkle/installers/mac_port_spec.rb
+- spec/sprinkle/installers/noop_spec.rb
+- spec/sprinkle/installers/openbsd_pkg_spec.rb
+- spec/sprinkle/installers/opensolaris_pkg_spec.rb
+- spec/sprinkle/installers/push_text_spec.rb
+- spec/sprinkle/installers/rake_spec.rb
+- spec/sprinkle/installers/rpm_spec.rb
+- spec/sprinkle/installers/source_spec.rb
+- spec/sprinkle/installers/transfer_spec.rb
+- spec/sprinkle/installers/yum_spec.rb
+- spec/sprinkle/package_spec.rb
+- spec/sprinkle/policy_spec.rb
+- spec/sprinkle/script_spec.rb
+- spec/sprinkle/sprinkle_spec.rb
+- spec/sprinkle/verify_spec.rb
+has_rdoc: true
+homepage: http://github.com/powcloud/sprinkle
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: sprinkle
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Ruby DSL based software provisioning tool
+test_files: 
+- spec/spec_helper.rb
+- spec/sprinkle/actors/capistrano_spec.rb
+- spec/sprinkle/actors/local_spec.rb
+- spec/sprinkle/configurable_spec.rb
+- spec/sprinkle/deployment_spec.rb
+- spec/sprinkle/extensions/array_spec.rb
+- spec/sprinkle/extensions/string_spec.rb
+- spec/sprinkle/installers/apt_spec.rb
+- spec/sprinkle/installers/bsd_port_spec.rb
+- spec/sprinkle/installers/freebsd_pkg_spec.rb
+- spec/sprinkle/installers/freebsd_portinstall_spec.rb
+- spec/sprinkle/installers/gem_spec.rb
+- spec/sprinkle/installers/installer_spec.rb
+- spec/sprinkle/installers/mac_port_spec.rb
+- spec/sprinkle/installers/noop_spec.rb
+- spec/sprinkle/installers/openbsd_pkg_spec.rb
+- spec/sprinkle/installers/opensolaris_pkg_spec.rb
+- spec/sprinkle/installers/push_text_spec.rb
+- spec/sprinkle/installers/rake_spec.rb
+- spec/sprinkle/installers/rpm_spec.rb
+- spec/sprinkle/installers/source_spec.rb
+- spec/sprinkle/installers/transfer_spec.rb
+- spec/sprinkle/installers/yum_spec.rb
+- spec/sprinkle/package_spec.rb
+- spec/sprinkle/policy_spec.rb
+- spec/sprinkle/script_spec.rb
+- spec/sprinkle/sprinkle_spec.rb
+- spec/sprinkle/verify_spec.rb
+- examples/packages/build_essential.rb
+- examples/packages/databases/mysql.rb
+- examples/packages/databases/sqlite3.rb
+- examples/packages/phusion.rb
+- examples/packages/ruby/rails.rb
+- examples/packages/ruby/ruby.rb
+- examples/packages/ruby/rubygems.rb
+- examples/packages/scm/git.rb
+- examples/packages/scm/subversion.rb
+- examples/packages/servers/apache.rb
+- examples/rails/deploy.rb
+- examples/rails/packages/database.rb
+- examples/rails/packages/essential.rb
+- examples/rails/packages/rails.rb
+- examples/rails/packages/scm.rb
+- examples/rails/packages/search.rb
+- examples/rails/packages/server.rb
+- examples/rails/rails.rb
+- examples/sprinkle/sprinkle.rb