capistrano-spec 0.1.0

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,21 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+## PROJECT::SPECIFIC

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Joshua Nichols
+
+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.rdoc

@@ -0,0 +1,137 @@
+= capistrano-spec
+
+Capistrano... the final frontier of testing... well, maybe not final, but it is a frontier. I had set out to do some bug fixing and some BDDing on some of my capistrano code, but found it wasn't really obvious how to do so. As a result, I set out to write capistrano-spec and document how to test capistrano libraries.
+
+== Install
+
+You know the drill:
+
+  gem install capistrano-spec
+
+And require it in your +spec/spec_helper.rb+:
+
+  require 'capistrano-spec'
+
+== Designing your capistrano extension
+
+In the wild, you'll mostly commonly come across two patterns:
+
+* files living under recipes/* that are autoloaded
+* files living under lib that are required from config/deploy.rb
+
+In these files, you can start using the capistrano top-level methods, like +namespace+ or +task+, like:
+
+  # in recipes/speak.rb or lib/speak.rb
+  task :speak do
+    set :message, 'oh hai'
+    puts message
+  end
+
+Capistrano does some trickery to +require+ and +load+ so that if you +require+ or +load+, the file is ran in the context of a Capistrano::Configuration, where all the +task+ and +namespace+ methods you know and love will be available.
+
+Some consider this a little gross, because it'd be easy to accidentally require/load this without being in the context of a Capistrano::Configuration. The answer to this is to pull use +Capistrano::Configuration.instance+ to make sure it's evaluted in that context:
+
+  # in recipes/speak.rb or lib/speak.rb
+  Capistrano::Configuration.instance(true).load do
+    task :speak do
+      set :message, 'oh hai'
+      puts message
+    end
+  end
+
+There's a problem though: it's not particular testable. You can't take some +Capistrano::Configuration+ and easily bring your task into it.
+
+So, here's what I recommend instead: create a method for taking a configuration, and adding your goodies to it.
+
+  require 'capistrano'
+  module Capistrano
+    module Speak
+      def self.load_into(configuration)
+        configuration.load do
+          task :speak do
+            set :message, 'oh hai'
+            puts message
+          end
+        end
+      end
+    end
+  end
+
+  # may as well load it if we have it
+  if Capistrano::Configuration.instance
+    Capistrano::Speak.load_into(Capistrano::Configuration.instance)
+  end
+
+Now, we're going to be able to test this. Behold!
+
+== Testing
+
+Alright, we can start testing by making Capistrano::Configuration and load Capistrano::Speak into it.
+
+  describe Capistrano::Speak, "loaded into a configuration" do
+    before do
+      @configuration = Capistrano::Configuration.new
+      Capistrano::Speak.load_into(@configuration)
+    end
+  
+  end
+
+
+Now you have access to a configuration, so you can start poking around the +@configuration+ object as you see fit.
+
+Now, remember, if you +set+ values, you can access them using +fetch+:
+
+  before do
+    @configuration.set :foo, 'bar'
+  end
+  
+  it "should define foo" do
+    @configuration.fetch(:foo).should == 'bar'
+  end
+
+You can also find and execute tasks, so you can verify if you successfully set a value:
+
+
+  describe 'speak task' do
+    before do
+      @configuration.find_and_execute_task('speak')
+    end
+    
+    it "should define message" do
+      @configuration.fetch(:message).should == 'oh hai'
+    end
+  end
+
+One thing you might be wondering now is... that's cool, but what about working with remote servers? I have just the trick for you: extensions to Capistrano::Configuration to track what files were up or downloaded and what commands were run. Now, this is no substitution for manually testing your capistrano recipe by running it on the server, but it is good for sanity checking.
+
+  before do
+    @configuration = Capistrano::Configuration.new
+    @configuration.extend(Capistrano::Spec::ConfigurationExtension)
+  end
+
+  it "should run yes" do
+    @configuration.run "yes"
+    @configuration.should have_run("yes")
+  end
+
+  it "should upload foo" do
+    @configuration.upload 'foo', '/tmp/foo'
+    @configuration.should have_uploaded('foo').to('/tmp/foo')
+  end
+
+  it "should have gotten" do
+    @configuration.get '/tmp/bar', 'bar'
+    @configuration.should have_gotten('/tmp/bar').to('bar')
+  end
+
+== Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+== Copyright
+
+Copyright (c) 2010 Joshua Nichols. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,47 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "capistrano-spec"
+    gem.version = '0.1.0'
+
+    gem.summary = %Q{Test your capistrano recipes}
+    gem.description = %Q{Helpers and matchers for testing capistrano}
+    gem.email = "josh@technicalpickles.com"
+    gem.homepage = "http://github.com/technicalpickles/capistrano-spec"
+    gem.authors = ["Joshua Nichols"]
+    gem.add_development_dependency "rspec", ">= 1.2.9"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+Spec::Rake::SpecTask.new(:rcov) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :spec => :check_dependencies
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "capistrano-spec #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/capistrano-spec.gemspec

@@ -0,0 +1,55 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{capistrano-spec}
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Joshua Nichols"]
+  s.date = %q{2010-07-21}
+  s.description = %q{Helpers and matchers for testing capistrano}
+  s.email = %q{josh@technicalpickles.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "capistrano-spec.gemspec",
+     "lib/capistrano-spec.rb",
+     "lib/capistrano/spec.rb",
+     "spec/capistrano-spec_spec.rb",
+     "spec/spec.opts",
+     "spec/spec_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/technicalpickles/capistrano-spec}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.6}
+  s.summary = %q{Test your capistrano recipes}
+  s.test_files = [
+    "spec/capistrano-spec_spec.rb",
+     "spec/spec_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rspec>, [">= 1.2.9"])
+    else
+      s.add_dependency(%q<rspec>, [">= 1.2.9"])
+    end
+  else
+    s.add_dependency(%q<rspec>, [">= 1.2.9"])
+  end
+end
+

data/lib/capistrano/spec.rb

@@ -0,0 +1,167 @@
+module Capistrano
+  module Spec
+    module ConfigurationExtension
+      def get(remote_path, path, options={}, &block)
+        gets[remote_path] = {:path => path, :options => options, :block => block}
+      end
+
+      def gets
+        @gets ||= {}
+      end
+
+      def run(cmd, options={}, &block)
+        runs[cmd] = {:options => options, :block => block}
+      end
+
+      def runs
+        @runs ||= {}
+      end
+
+      def upload(from, to, options={}, &block)
+        uploads[from] = {:to => to, :options => options, :block => block}
+      end
+
+      def uploads
+        @uploads ||= {}
+      end
+      
+    end
+
+    module Helpers
+      def find_callback(configuration, on, task)
+        if task.kind_of?(String)
+          task = configuration.find_task(task)
+        end
+
+        callbacks = configuration.callbacks[on]
+
+        callbacks && callbacks.select do |task_callback|
+          task_callback.applies_to?(task) || task_callback.source == task.fully_qualified_name
+        end
+      end
+
+    end
+
+    module Matchers
+      extend ::Spec::Matchers::DSL
+
+      define :callback do |task_name|
+        extend Helpers
+
+        match do |configuration|
+          @task = configuration.find_task(task_name)
+          callbacks = find_callback(configuration, @on, @task)
+
+          if callbacks
+            @callback = callbacks.first
+
+            if @callback && @after_task_name
+              @after_task = configuration.find_task(@after_task_name)
+              @callback.applies_to?(@after_task)
+            elsif @callback && @before_task_name
+              @before_task = configuration.find_task(@before_task_name)
+              @callback.applies_to?(@before_task)
+            else
+              ! @callback.nil?
+            end
+          else
+            false
+          end
+        end
+
+        def on(on)
+          @on = on
+          self
+        end
+
+        def before(before_task_name)
+          @on = :before
+          @before_task_name = before_task_name
+          self
+        end
+
+        def after(after_task_name)
+          @on = :after
+          @after_task_name = after_task_name
+          self
+        end
+
+        failure_message_for_should do |actual|
+          if @after_task_name
+            "expected configuration to callback #{task_name.inspect} #{@on} #{@after_task_name.inspect}, but did not"
+          elsif @before_task_name
+            "expected configuration to callback #{task_name.inspect} #{@on} #{@before_task_name.inspect}, but did not"
+          else
+            "expected configuration to callback #{task_name.inspect} on #{@on}, but did not"
+          end
+        end
+
+      end
+
+      define :have_gotten do |path|
+        match do |configuration|
+
+          get = configuration.gets[path]
+          if @to
+            get && get[:path] == @to
+          else
+            get
+          end
+        end
+
+        def to(to)
+          @to = to
+          self
+        end
+
+        failure_message_for_should do |actual|
+          if @to
+            "expected configuration to get #{path} to #{@to}, but did not"
+          else
+            "expected configuration to get #{path}, but did not"
+          end
+        end
+      end
+
+      define :have_uploaded do |path|
+        match do |configuration|
+          upload = configuration.uploads[path]
+          if @to
+            upload && upload[:to] == @to
+          else
+            upload
+          end
+        end
+
+        def to(to)
+          @to = to
+          self
+        end
+
+        failure_message_for_should do |actual|
+          if @to
+            "expected configuration to upload #{path} to #{@to}, but did not"
+          else
+            "expected configuration to upload #{path}, but did not"
+          end
+        end
+      end
+
+      define :have_run do |cmd|
+
+        match do |configuration|
+          run = configuration.runs[cmd]
+
+          run
+        end
+
+        failure_message_for_should do |actual|
+          "expected configuration to run #{cmd}, but did not"
+        end
+        
+      end
+
+    end
+  end
+end
+

data/lib/capistrano-spec.rb

@@ -0,0 +1 @@
+require 'capistrano/spec'

data/spec/capistrano-spec_spec.rb

@@ -0,0 +1,7 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe "CapistranoSpec" do
+  it "fails" do
+    fail "hey buddy, you should probably rename this file and start specing for real"
+  end
+end

data/spec/spec.opts

@@ -0,0 +1 @@
+--color

data/spec/spec_helper.rb

@@ -0,0 +1,9 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'capistrano-spec'
+require 'spec'
+require 'spec/autorun'
+
+Spec::Runner.configure do |config|
+  
+end

metadata

@@ -0,0 +1,87 @@
+--- !ruby/object:Gem::Specification 
+name: capistrano-spec
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Joshua Nichols
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-07-21 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 2
+        - 9
+        version: 1.2.9
+  type: :development
+  version_requirements: *id001
+description: Helpers and matchers for testing capistrano
+email: josh@technicalpickles.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- .document
+- .gitignore
+- LICENSE
+- README.rdoc
+- Rakefile
+- capistrano-spec.gemspec
+- lib/capistrano-spec.rb
+- lib/capistrano/spec.rb
+- spec/capistrano-spec_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://github.com/technicalpickles/capistrano-spec
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: Test your capistrano recipes
+test_files: 
+- spec/capistrano-spec_spec.rb
+- spec/spec_helper.rb