cukesalad 0.2.0

data/.rspec

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

data/Examples/Calculator/Gemfile

@@ -0,0 +1,5 @@
+source :rubygems
+gem "cucumber", "0.10.0"
+gem "rspec", "2.5.0", :require => 'spec'
+gem "capybara", "0.4.1.2"
+gem "sinatra", "1.2.0"

data/Examples/Calculator/Gemfile.lock

@@ -0,0 +1,66 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    builder (3.0.0)
+    capybara (0.4.1.2)
+      celerity (>= 0.7.9)
+      culerity (>= 0.2.4)
+      mime-types (>= 1.16)
+      nokogiri (>= 1.3.3)
+      rack (>= 1.0.0)
+      rack-test (>= 0.5.4)
+      selenium-webdriver (>= 0.0.27)
+      xpath (~> 0.1.3)
+    celerity (0.8.9)
+    childprocess (0.1.8)
+      ffi (~> 1.0.6)
+    cucumber (0.10.0)
+      builder (>= 2.1.2)
+      diff-lcs (~> 1.1.2)
+      gherkin (~> 2.3.2)
+      json (~> 1.4.6)
+      term-ansicolor (~> 1.0.5)
+    culerity (0.2.15)
+    diff-lcs (1.1.2)
+    ffi (1.0.7)
+      rake (>= 0.8.7)
+    gherkin (2.3.5)
+      json (>= 1.4.6)
+    json (1.4.6)
+    json_pure (1.5.1)
+    mime-types (1.16)
+    nokogiri (1.4.4)
+    rack (1.2.2)
+    rack-test (0.5.7)
+      rack (>= 1.0)
+    rake (0.8.7)
+    rspec (2.5.0)
+      rspec-core (~> 2.5.0)
+      rspec-expectations (~> 2.5.0)
+      rspec-mocks (~> 2.5.0)
+    rspec-core (2.5.1)
+    rspec-expectations (2.5.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.5.0)
+    rubyzip (0.9.4)
+    selenium-webdriver (0.1.4)
+      childprocess (>= 0.1.7)
+      ffi (>= 1.0.7)
+      json_pure
+      rubyzip
+    sinatra (1.2.0)
+      rack (~> 1.1)
+      tilt (< 2.0, >= 1.2.2)
+    term-ansicolor (1.0.5)
+    tilt (1.2.2)
+    xpath (0.1.3)
+      nokogiri (~> 1.3)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  capybara (= 0.4.1.2)
+  cucumber (= 0.10.0)
+  rspec (= 2.5.0)
+  sinatra (= 1.2.0)

data/Examples/Calculator/cucumber.yml

@@ -0,0 +1,4 @@
+default: --exclude features/lib/alternative/
+alternative: -r features/lib/alternative/ -r features/support/env.rb -r features/lib/default/tasks/ 
+autotest: --color
+autotest-all: --color

data/Examples/Calculator/features/LOOK_MA_NO_STEP_DEFS.txt

@@ -0,0 +1,2 @@
+# 'Look Ma, No step defs!'
+# Surprised? See http://github.com/RiverGlide/CukeSalad for details.

data/Examples/Calculator/features/a_place_to_start.feature

@@ -0,0 +1,9 @@
+Feature: A Place To Start
+	As Callie, a calculating individual
+	I want to know when my calculator is on
+	So that I know when I can start calculating
+
+Scenario: Let's Begin
+	Given I am a Calculating Individual
+	When  I attempt to switch on the calculator
+	Then  I should see the answer '0'

data/Examples/Calculator/features/addition.feature

@@ -0,0 +1,19 @@
+Feature: Addition
+  As Callie, a calculating individual
+  I want to quickly find out the sum of some numbers
+	So that I am not tired out by doing mental arithmetic all day 
+	
+Scenario Outline: Find the sum of two numbers
+  Given I am a Calculating Individual
+  And I was able to switch on the calculator
+  When I attempt to add: the number '<first_number>' to the number '<second_number>'
+  Then I should see the answer '<result>'
+
+	
+Examples:
+|first_number|second_number|result|
+|          0 |           0 |    0 |
+|          0 |           1 |    1 |
+|          1 |           0 |    1 |
+|          1 |           1 |    2 |
+|         10 |           9 |   19 |

data/Examples/Calculator/features/complex_calculations.feature

@@ -0,0 +1,16 @@
+Feature: Complex Calculations
+  As Callie, a calculating individual
+  I want to do more complicated calculations
+  So that I am not tired out by doing mental arithmetic all day
+
+Scenario Outline: Get the result of a more complex calculation
+  Given I am a calculating individual
+  And I was able to switch on the calculator
+  When I attempt to calculate: with the following '<calculation>'
+  Then I should see the answer '<correct_result>'
+
+Examples:
+| calculation       | correct_result |
+| 1 + 1 + 1 =       |              3 |
+| 10 + 5 - 3 =      |             12 |
+| 10 + 5 - 3 - 12 = |              0 |

data/Examples/Calculator/features/lib/alternative/roles/calculating_web_user.rb

@@ -0,0 +1,55 @@
+# To run with this version of the Calculating Individual:
+# cucumber --profile alternative 
+
+require 'web_calculator'
+require 'capybara'
+require 'capybara/dsl'
+
+Capybara.app = WebCalculator
+Capybara.default_driver = :rack_test
+
+module CalculatingIndividual
+
+  # Uses a Browser to perform its tasks
+  include Capybara
+  # This is not a page object. It is a WebUser, specialised to our application
+  # See the comments in the 'enter' and 'press' method for an explanation of why
+
+  def switch_on_the_calculator
+    visit '/'
+  end
+
+  def enter value
+    fill_in 'number', :with => value
+    # Because the calculator is a simple web_app with only
+    # one page we can put the id for the field here. In a more complex web-app
+    # we would pass in the id of the thing to enter
+    # The task would express the action as: enter( :the_number, "10")
+    # Because we can change the id used in our application,
+    # we would just change the id in the application to be 'the_number'.
+    # If we were on a project where we could not change the id 
+    # in the application we would write an 'ApplicationExpert' 
+    # to map :the_number to the id for the field 'number'. Our CalculatingIndividual
+    # would ask the ApplicationExpert for the id of the symbol :the_number
+    # See 'press' below for am explanation of how an ApplicationExpert 
+    # would work 
+  end
+  
+  def press operator
+    click_button operator.to_s
+    # Here, our 'operator' happens to also match the id for the button.
+    # If we were on a project where we could not choose what the id
+    # was for buttons, we would write an ApplicationExpert to map 
+    # the symbol used in the task to the symbol for that button. 
+    # The ApplicationExpert would only need to know what page it 
+    # was on to find a mappings class (or yml file) for the fields on that page.
+  end
+
+  def look_at_the_display
+    find_field('display').value.to_i
+  end
+
+  def is_the_calculator_ready?
+    page.body.should =~ /Calculator is Ready!/
+  end
+end

data/Examples/Calculator/features/lib/default/roles/calculating_individual.rb

@@ -0,0 +1,32 @@
+require 'calculator'
+
+module CalculatingIndividual
+
+  def switch_on_the_calculator
+    @calculator = Calculator.new
+    @operate_with = {
+      plus: :+,
+     minus: :-
+    }
+  end
+
+  def enter value
+    @calculator.enter value.to_i
+  end
+
+  def press next_operator
+    if next_operator == :equals
+      equals
+    else
+      @calculator.get_ready_to @operate_with[next_operator]
+    end
+  end
+
+  def equals
+    @calculator.equals
+  end
+
+  def look_at_the_display
+    @calculator.display
+  end
+end

data/Examples/Calculator/features/lib/default/tasks/add.rb

@@ -0,0 +1,13 @@
+# This demonstrates how to use an attribute mapping 
+#  to make the interactions within the task read more naturally
+# In the scenario it might say "add: the number '5', to the number '10'
+# The form illustrated below simply maps the elements the_number and to_the_number
+#  to alternative symbols that make the interactions read more like real instructions
+# See subtract.rb for a way of writing tasks that reuses the common interactions 
+# required to perform calculations.
+in_order_to 'add', the_number: :first_number, to_the_number: :second_number do
+    enter the :first_number 
+    press :plus
+    enter the :second_number 
+    press :equals
+end

data/Examples/Calculator/features/lib/default/tasks/calculate.rb

@@ -0,0 +1,4 @@
+in_order_to "Calculate", with_the_following: :calculation do
+  see_how_to_do Calculations  
+  follow_the_steps_for the( :calculation ).split(" ")
+end

data/Examples/Calculator/features/lib/default/tasks/calculations.rb

@@ -0,0 +1,15 @@
+module Calculations
+  
+  def follow_the_steps_for sum
+    enter_numbers_and_operators_for sum
+  end
+  
+  def enter_numbers_and_operators_for sum
+    operator = {"+" => :plus, "-" => :minus, "=" => :equals}
+    sum.each do | token |
+      enter token.to_i if token =~ /\d+/
+      press operator[token] if operator.include? token
+    end
+  end
+end
+

data/Examples/Calculator/features/lib/default/tasks/see_the_answer.rb

@@ -0,0 +1,3 @@
+in_order_to "see the answer" do
+  look_at_the_display
+end

data/Examples/Calculator/features/lib/default/tasks/subtract.rb

@@ -0,0 +1,4 @@
+in_order_to "Subtract", the_number: :subtractor, from_the_number: :subtractee do
+  see_how_to_do Calculations
+  follow_the_steps_for [the(:subtractee), "-", the(:subtractor), "="] 
+end

data/Examples/Calculator/features/lib/default/tasks/switch_on_the_calculator.rb

@@ -0,0 +1,9 @@
+in_order_to "switch on the calculator" do
+  require 'rspec/expectations'
+  extend RSpec::Matchers
+  
+  @calc = switch_on_the_calculator
+  self.should respond_to :enter
+  self.should respond_to :press
+  self.should respond_to :look_at_the_display
+end

data/Examples/Calculator/features/subtraction.feature

@@ -0,0 +1,20 @@
+Feature: Subtraction
+  As Callie, a calculating individual
+  I want to quickly find the difference between two numbers
+	So that I am not tired out by doing mental arithmetic all day
+	
+Scenario Outline: Find the result of subtracting two numbers
+  Given I am a Calculating Individual
+  And I was able to switch on the calculator
+  When I attempt to subtract: the number '<subtractor>' from the number '<subtractee>'
+  Then I should see the answer '<result>'
+
+	
+Examples:
+| subtractor | subtractee  | result|
+|          0 |           0 |     0 |
+|          0 |           1 |     1 |
+|          1 |           1 |     0 |
+|          5 |          10 |     5 |
+
+

data/Examples/Calculator/features/support/env.rb

@@ -0,0 +1,6 @@
+$:.unshift(File.dirname(__FILE__) + '/../../lib') #where to find the calculator implementation
+$:.unshift(File.dirname(__FILE__) + '/../../../../lib') #where to find CukeSalad
+
+require 'cukesalad'
+
+begin require 'rspec/expectations'; rescue LoadError; require 'spec/expectations'; end

data/Examples/Calculator/features/typical_workflow.feature

@@ -0,0 +1,18 @@
+Feature: Typical Calculator Workflow
+  As Callie, a calculating individual
+  I want to interact with this calculator like any other calculator
+  So that I can start using it straight away
+
+Scenario Outline: See what I expect based on specific interactions
+  Given I am a calculating individual
+  And I was able to switch on the calculator
+  When I attempt to calculate: with the following '<interactions>'
+  Then I should see the answer '<expected>'
+
+Examples:
+| interactions    | expected |
+| 1 =             |        1 |
+| 1 + =           |        2 |
+| 1 - =           |        0 |
+| 1 + = =         |        3 |
+| 1 + 1 = 5 + =   |       10 |

data/Examples/Calculator/lib/calculator.rb

@@ -0,0 +1,53 @@
+
+class Calculator
+ 
+  attr_reader :display
+
+  def initialize
+    show 0
+    @operands = []
+  end
+  
+  def enter value
+    show value
+    @operands.push value
+  end
+
+  def get_ready_to op
+    calculate_if_necessary
+    start_next_calculation
+    @operator = op
+  end
+
+  def equals
+    we_need_two_operands
+    deal_with_repeated_equals
+    unless @operator.nil?
+      show @operands.inject (@operator)
+      @last_operator = @operator
+      @operator = nil
+      @operands[0] = @display
+    end
+  end
+
+  private
+  def show value
+    @display = value
+  end
+
+  def calculate_if_necessary
+    equals if @operands.size == 2
+  end
+  
+  def start_next_calculation
+    @operands = [@display] if @operator.nil?
+  end
+
+  def we_need_two_operands
+    @operands.concat @operands if @operands.size == 1
+  end
+  
+  def deal_with_repeated_equals
+    @operator = @last_operator if @operands.size == 2 && @operator.nil? && @last_operator
+  end
+end

data/Examples/Calculator/lib/config.ru

@@ -0,0 +1,4 @@
+$:.unshift(File.dirname(__FILE__), '.')
+require 'web_calculator'
+
+run WebCalculator

data/Examples/Calculator/lib/web_calculator.rb

@@ -0,0 +1,82 @@
+require 'sinatra/base'
+require 'erb'
+$:.unshift(File.dirname(__FILE__), '.')
+require 'calculator'
+
+Sinatra::Base.enable :inline_templates
+Sinatra::Base.enable :sessions
+
+class WebCalculator < Sinatra::Base
+
+  helpers do
+    def operate_with
+      { 'plus' => :+, 'minus' => :-}
+    end
+
+    def persist calc
+      session[:calc] = calc
+    end
+
+    def display_result_from calc
+      @display = calc.display
+      erb :index
+    end
+
+    def user_input
+      params[:number].to_i
+    end
+
+    def selected_operator
+      params[:operator]
+    end
+
+    def display_result_from_session
+      @display = session[:calc].display ||= 0
+      erb :index
+    end
+
+    def input_entered?
+      not params[:number].empty?
+    end
+
+    def equals_pressed?
+      selected_operator == "equals"
+    end
+
+    def load_calculator
+      session[:calc] ||= Calculator.new
+    end
+  
+  end
+
+  get '/' do
+    load_calculator
+    display_result_from_session
+  end
+
+  post '/' do
+    calculator = load_calculator 
+    calculator.enter user_input if input_entered?
+    if equals_pressed?
+      calculator.equals
+    else
+      calculator.get_ready_to operate_with[selected_operator]
+    end
+    persist calculator
+    display_result_from calculator
+  end
+end
+
+__END__
+@@ layout
+<h1>Calculator is Ready!</h1>
+<%= yield %>
+
+@@ index
+<form method="POST" action="/">
+  <input type="text" disabled name="display" id="display" value="<%=@display %>" />
+  <input type="text" name="number" id="number" />
+  <input type="submit" name="operator" id="minus" text="-" value="minus" />
+  <input type="submit" name="operator" id="plus" text="+" value="plus" />
+  <input type="submit" name="operator" id="equals" text="=" value="equals" />
+</form>

data/Examples/Calculator/spec/calculator_spec.rb

@@ -0,0 +1,73 @@
+$:.unshift File.join(File.dirname(__FILE__), "..", "lib")
+require 'rubygems'
+require 'bundler'
+Bundler.setup
+require 'calculator'
+
+describe Calculator do
+
+  it "starts with zero" do
+    calc = Calculator.new
+
+    calc.display.should == 0
+  end
+
+  it "shows the current number" do
+    calc = Calculator.new
+    calc.enter 1
+
+    calc.display.should == 1
+  end
+
+  it "displays the same when equals alone is pressed" do
+    calc = Calculator.new
+    calc.enter 1
+
+    calc.equals
+
+    calc.display.should == 1
+  end
+
+  it "treats 1 + = like 1 + 1 =" do
+    calc = Calculator.new
+
+    calc.enter 1
+    calc.get_ready_to :+
+    calc.equals
+
+    calc.display.should == 2
+  end
+
+  it "repeats the last operation" do
+    calc = Calculator.new
+    calc.enter 1
+    calc.get_ready_to :+
+    calc.equals
+    calc.equals
+    calc.display.should == 3
+  end
+
+  it "starts again when you enter a number after equals" do
+    calc = Calculator.new
+    calc.enter 1
+    calc.get_ready_to :+
+    calc.enter 1
+    calc.equals
+    calc.enter 5
+    calc.get_ready_to :+
+    calc.equals
+    
+    calc.display.should == 10
+  end
+
+  it "calculate what it has so far" do
+    calc = Calculator.new
+    calc.enter 1
+    calc.get_ready_to :+
+    calc.enter 1
+    calc.get_ready_to :+ 
+
+    calc.display.should == 2
+  end
+
+end

data/Examples/Calculator/spec/web_calculator_spec.rb

@@ -0,0 +1,99 @@
+$:.unshift(File.dirname(__FILE__) + '/../lib/')
+require 'web_calculator'
+require 'capybara'
+require 'capybara/dsl'
+
+Capybara.app = WebCalculator
+Capybara.default_driver = :rack_test
+
+describe "WebCalculator", :type => :request do
+
+  include Capybara
+
+  before(:each) do
+    Capybara.reset_sessions! 
+  end
+
+  context "homepage" do
+    it "is successful" do
+      visit '/'
+      page.should have_content 'Calculator is Ready!'
+    end
+  end
+
+  def calculator_display
+    find_field('display').value.to_i
+  end
+
+  context "storing calculator display state" do
+    it "starts with nothing" do
+      visit '/'
+      calculator_display.should == 0
+    end
+
+    it "udpates the display when an operator is pressed" do
+      visit '/'
+      fill_in 'number', :with => '10'
+      click_button 'minus'
+      calculator_display.should == 10
+    end
+
+    it "updates the display when a different different operator is pressed" do
+      visit '/'
+      fill_in 'number', :with => '15'
+      click_button 'plus'
+      calculator_display.should == 15
+    end
+
+    it "updates the display when a sequence of operators are entered" do
+      visit '/'
+      fill_in 'number', :with => '1'
+      click_button 'plus'
+      fill_in 'number', :with => '1'
+      click_button 'plus'
+      calculator_display.should == 2 
+    end
+
+    it "persists the display between requests" do
+      visit '/'
+      fill_in 'number', :with => '15'
+      click_button 'plus'
+      calculator_display.should == 15
+      visit '/'
+      calculator_display.should == 15
+    end
+  end
+
+  context "doing simple arithmetic" do
+    it "adds two numbers" do
+      visit '/'
+      fill_in 'number', :with => '1'
+      click_button 'plus'
+      fill_in 'number', :with => '0'
+      click_button 'equals'
+      calculator_display.should == 1
+    end
+    
+    it "adds two of the same number" do
+      visit '/'
+      fill_in 'number', :with => '1'
+      click_button 'plus'
+      fill_in 'number', :with => '1'
+      click_button 'equals'
+      calculator_display.should == 2
+    end
+  end
+
+  context "doing meta calculations" do
+    it "allows double equals calculator functionality" do
+      visit '/'
+      fill_in 'number', :with => '1'
+      click_button 'plus'
+      click_button 'equals'
+      calculator_display.should == 2
+      click_button 'equals'
+      calculator_display.should == 3
+    end
+  end
+
+end

data/Gemfile

@@ -0,0 +1,9 @@
+source :rubygems
+gem "cucumber", "0.10.0"
+gem "rspec", "2.5.0", :require => 'spec'
+gem "aruba", "0.3.5"
+
+group :development do
+  gem "bundler", "~> 1.0.0"
+  gem "jeweler", "~> 1.5.2"
+end