tango 0.0.1

data/.gitignore

@@ -0,0 +1,3 @@
+pkg/*
+*.gem
+.bundle

data/.rspec

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

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in tango.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,24 @@
+PATH
+  remote: .
+  specs:
+    tango (0.0.1)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    diff-lcs (1.1.2)
+    rspec (2.4.0)
+      rspec-core (~> 2.4.0)
+      rspec-expectations (~> 2.4.0)
+      rspec-mocks (~> 2.4.0)
+    rspec-core (2.4.0)
+    rspec-expectations (2.4.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.4.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  rspec
+  tango!

data/Rakefile

@@ -0,0 +1,10 @@
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec
+
+
+require 'bundler'
+
+Bundler::GemHelper.install_tasks

data/lib/tango.rb

@@ -0,0 +1,6 @@
+require 'tango/dance'
+require 'tango/dance_builder'
+require 'tango/step'
+require 'tango/step_builder'
+require 'tango/step_runner'
+require 'tango/step_runner_context'

data/lib/tango/dance.rb

@@ -0,0 +1,24 @@
+module Tango
+  class Dance
+
+    class StepAlreadyDefinedError < RuntimeError; end
+    class UndefinedStepError < RuntimeError; end
+
+    def initialize(&block)
+      @steps = {}
+      DanceBuilder.new(self).instance_eval(&block)
+    end
+
+    def define_step(name, step)
+      raise StepAlreadyDefinedError, "Step #{name} already defined" if @steps.has_key?(name)
+      step.dance   = self
+      @steps[name] = step
+    end
+
+    def run(step_name, options = {})
+      raise UndefinedStepError, "Step #{step_name} not defined" unless @steps.has_key?(step_name)
+      @steps[step_name].run(options)
+    end
+
+  end
+end

data/lib/tango/dance_builder.rb

@@ -0,0 +1,13 @@
+module Tango
+  class DanceBuilder
+
+    def initialize(dance)
+      @dance = dance
+    end
+
+    def step(name, &block)
+      @dance.define_step(name, Step.new(&block))
+    end
+
+  end
+end

data/lib/tango/step.rb

@@ -0,0 +1,13 @@
+module Tango
+  class Step
+    def initialize(&block)
+      StepBuilder.new(self).instance_eval(&block)
+    end
+
+    attr_accessor :dance, :met_block, :meet_block
+
+    def run(options = {})
+      StepRunner.new(self, options).run
+    end
+  end
+end

data/lib/tango/step_builder.rb

@@ -0,0 +1,17 @@
+module Tango
+  class StepBuilder
+
+    def initialize(step)
+      @step = step
+    end
+
+    def met?(&block)
+      @step.met_block = block
+    end
+
+    def meet(&block)
+      @step.meet_block = block
+    end
+
+  end
+end

data/lib/tango/step_runner.rb

@@ -0,0 +1,40 @@
+module Tango
+  class StepRunner
+
+    def initialize(step, options)
+      @step    = step
+      @options = options
+      @context = StepRunnerContext.new(@step)
+    end
+
+    def run
+      if @step.met_block
+        run_with_met_block
+      else
+        run_without_met_block
+      end
+    end
+
+  private
+
+    def run_with_met_block
+      unless met?
+        meet
+        raise "Couldn't meet" unless met?
+      end
+    end
+
+    def run_without_met_block
+      meet
+    end
+
+    def met?
+      @context.instance_exec(@options, &@step.met_block)
+    end
+
+    def meet
+      @context.instance_exec(@options, &@step.meet_block)
+    end
+
+  end
+end

data/lib/tango/step_runner_context.rb

@@ -0,0 +1,13 @@
+module Tango
+  class StepRunnerContext
+
+    def initialize(step)
+      @step = step
+    end
+
+    def run(step_name, options = {})
+      @step.dance.run(step_name, options)
+    end
+
+  end
+end

data/lib/tango/version.rb

@@ -0,0 +1,3 @@
+module Tango
+  VERSION = "0.0.1"
+end

data/spec/dance_spec.rb

@@ -0,0 +1,86 @@
+require 'tango'
+
+module Tango
+  describe Dance do
+
+    it "should run a step" do
+      step_run = false
+
+      dance = Dance.new do
+        step "example step" do
+          meet { step_run = true }
+        end
+      end
+
+      dance.run "example step"
+      step_run.should be_true
+    end
+
+    it "should run one step from within another" do
+      inner_step_run = false
+
+      dance = Dance.new do
+        step "outer step" do
+          meet { run "inner step" }
+        end
+
+        step "inner step" do
+          meet { inner_step_run = true }
+        end
+      end
+
+      dance.run "outer step"
+      inner_step_run.should be_true
+    end
+
+    context "option passing" do
+      it "should pass options to a step when running" do
+        step_options = { :example => "example" }
+
+        dance = Dance.new do
+          step "example step" do
+            meet {|options| options.should == step_options }
+          end
+        end
+
+        dance.run "example step", step_options
+      end
+
+      it "should pass options when running other steps" do
+        step_options = { :example => "example" }
+
+        dance = Dance.new do
+          step "outer step" do
+            meet { run "inner step", step_options }
+          end
+
+          step "inner step" do 
+            meet {|options| options.should == step_options }
+          end
+        end
+
+        dance.run "outer step"
+      end
+    end
+
+    context "error handling" do
+      it "should raise an error on an attempt to redefine a step" do
+        expect do
+          Dance.new do
+            step "example step" do; end
+            step "example step" do; end
+          end
+        end.should raise_error(Dance::StepAlreadyDefinedError)
+      end
+
+      it "should raise an error on an attempt to run an undefined step" do
+        dance = Dance.new do; end
+
+        expect do
+          dance.run "undefined step"
+        end.should raise_error(Dance::UndefinedStepError)
+      end
+    end
+
+  end
+end

data/spec/step_spec.rb

@@ -0,0 +1,94 @@
+require 'tango'
+
+module Tango
+  describe Step do
+
+    context "with just a meet block" do
+      it "should run the meet block" do
+        meet_block_calls = 0
+        step = Step.new do
+          meet { meet_block_calls += 1 }
+        end
+
+        step.run
+        meet_block_calls.should == 1
+      end
+    end
+
+    context "with a meet block and a met block" do
+      it "should check the met?, run the meet, then check the met? again" do
+        met_block_calls  = 0
+        meet_block_calls = 0
+        step = Step.new do
+          met? do
+            met_block_calls += 1
+            meet_block_calls > 0
+          end
+          meet { meet_block_calls += 1 }
+        end
+
+        step.run
+        met_block_calls.should  == 2
+        meet_block_calls.should == 1
+      end
+
+      it "should not run the meet if the met? succeeds the first time" do
+        met_block_calls  = 0
+        meet_block_calls = 0
+        step = Step.new do
+          met? do
+            met_block_calls += 1
+            true
+          end
+          meet { meet_block_calls += 1 }
+        end
+
+        step.run
+        met_block_calls.should  == 1
+        meet_block_calls.should == 0
+      end
+
+      it "should raise if the met? block fails twice" do
+        met_block_calls  = 0
+        meet_block_calls = 0
+        step = Step.new do
+          met? do
+            met_block_calls += 1
+            false
+          end
+          meet { meet_block_calls += 1 }
+        end
+
+        expect { step.run }.should raise_error
+        met_block_calls.should  == 2
+        meet_block_calls.should == 1
+      end
+    end
+
+    context "run with options" do
+      it "should pass the options to the met block" do
+        step_options = { :example => "example" }
+
+        step = Step.new do
+          met? do |options|
+            options.should == step_options
+            true
+          end
+        end
+
+        step.run(step_options)
+      end
+
+      it "should pass the options to the meet block" do
+        step_options = { :example => "example" }
+
+        step = Step.new do
+          meet {|options| options.should == step_options }
+        end
+
+        step.run(step_options)
+      end
+    end
+
+  end
+end

data/tango.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "tango/version"
+
+Gem::Specification.new do |s|
+  s.name        = "tango"
+  s.version     = Tango::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Pete Yandell"]
+  s.email       = ["pete@notahat.com"]
+  s.homepage    = ""
+  s.summary     = %q{Experiment in deployment tools.}
+  s.description = %q{Experiment in deployment tools, taking ideas from babushka and elsewhere.}
+
+  s.add_development_dependency "rspec"
+
+  s.rubyforge_project = "tango"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

metadata

@@ -0,0 +1,93 @@
+--- !ruby/object:Gem::Specification 
+name: tango
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Pete Yandell
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-01-17 00:00:00 +11:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id001
+description: Experiment in deployment tools, taking ideas from babushka and elsewhere.
+email: 
+- pete@notahat.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- .rspec
+- Gemfile
+- Gemfile.lock
+- Rakefile
+- lib/tango.rb
+- lib/tango/dance.rb
+- lib/tango/dance_builder.rb
+- lib/tango/step.rb
+- lib/tango/step_builder.rb
+- lib/tango/step_runner.rb
+- lib/tango/step_runner_context.rb
+- lib/tango/version.rb
+- spec/dance_spec.rb
+- spec/step_spec.rb
+- tango.gemspec
+has_rdoc: true
+homepage: ""
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: tango
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Experiment in deployment tools.
+test_files: 
+- spec/dance_spec.rb
+- spec/step_spec.rb