frank-cucumber 0.8.12 → 0.8.13

data/frank-skeleton/features/support/env.rb

@@ -1,5 +1,8 @@
 require 'frank-cucumber'
 
+# UIQuery is deprecated. Please use the shelley selector engine. 
+Frank::Cucumber::FrankHelper.use_shelley_from_now_on
+
 # TODO: set this constant to the full path for your Frankified target's app bundle.
 # See the "Given I launch the app" step definition in launch_steps.rb for more details
 APP_BUNDLE_PATH = nil

data/frank-skeleton/frank_static_resources.bundle/ViewAttributeMapping.plist

@@ -6,6 +6,7 @@
 	<array>
 		<string>accessibilityLabel</string>
 		<string>accessibilityFrame</string>
+		<string>tag</string>
 		<string>alpha</string>
 		<string>autoresizingMask</string>
 		<string>backgroundColor</string>

data/lib/frank-cucumber/core_frank_steps.rb

@@ -4,40 +4,33 @@ require 'rspec/expectations'
 
 # -- See -- #
 Then /^I wait to see "([^\"]*)"$/ do |expected_mark|
-  Timeout::timeout(WAIT_TIMEOUT) do
-    until view_with_mark_exists( expected_mark )
-      sleep 0.1
-    end
-  end
+  wait_until(:message => "waited to see view marked '#{expected_mark}'"){ 
+    view_with_mark_exists( expected_mark ) 
+  }
 end
 
 Then /^I wait to not see "([^\"]*)"$/ do |expected_mark|
-  sleep 3
-  Timeout::timeout(WAIT_TIMEOUT) do
-    while element_exists( "view marked:'#{expected_mark}'" )
-      sleep 0.1
-    end
-  end
+  sleep 3 # ugh, this should be removed but I'm worried it'll break existing tests
+
+  wait_until(:message => "waited to not see view marked '#{expected_mark}'"){ 
+    !view_with_mark_exists( expected_mark )
+  }
+end
+
+Then /^I should see a navigation bar titled "([^\"]*)"$/ do |expected_mark|
+  check_element_exists( "navigationItemView marked:'#{expected_mark}'" )
 end
 
 Then /^I wait to see a navigation bar titled "([^\"]*)"$/ do |expected_mark|
-    Timeout::timeout(30) do
-      values = frankly_map( 'navigationItemView', 'accessibilityLabel' )
-      until values.include?(expected_mark)
-        values = frankly_map( 'navigationItemView', 'accessibilityLabel' )
-        sleep 0.1
-      end
-    end
+  wait_until( :timeout => 30, :message => "waited to see a navigation bar titled '#{expected_mark}'" ) {
+    element_exists( "navigationItemView marked:'#{expected_mark}'" )
+  }
 end
 
 Then /^I wait to not see a navigation bar titled "([^\"]*)"$/ do |expected_mark|
-    Timeout::timeout(30) do
-      values = frankly_map( 'navigationItemView', 'accessibilityLabel' )
-      while values.include?(expected_mark)
-        values = frankly_map( 'navigationItemView', 'accessibilityLabel' )
-        sleep 0.1
-      end
-    end
+  wait_until( :timeout => 30, :message => "waited to not see a navigation bar titled '#{expected_mark}'" ) {
+    !element_exists( "navigationItemView marked:'#{expected_mark}'" )
+  }
 end
 
 Then /^I should see a "([^\"]*)" button$/ do |expected_mark|
@@ -45,7 +38,7 @@ Then /^I should see a "([^\"]*)" button$/ do |expected_mark|
 end
 
 Then /^I should see "([^\"]*)"$/ do |expected_mark|
-  check_element_exists("view marked:'#{expected_mark}'")
+  check_view_with_mark_exists(expected_mark)
 end
 
 Then /^I should not see "([^\"]*)"$/ do |expected_mark|
@@ -66,14 +59,8 @@ Then /I should not see the following:/ do |table|
   end
 end
 
-Then /^I should see a navigation bar titled "([^\"]*)"$/ do |expected_mark|
-  values = frankly_map( 'navigationItemView', 'accessibilityLabel' )
-  values.should include(expected_mark)
-end
-
 Then /^I should see an alert view titled "([^\"]*)"$/ do |expected_mark|
   values = frankly_map( 'alertView', 'message')
-  puts values
   values.should include(expected_mark)
 end
 

data/lib/frank-cucumber/frank_helper.rb

@@ -1,12 +1,13 @@
-require 'net/http'
 require 'json'
-require 'frank-cucumber/frank_localize'
+require 'frank-cucumber/gateway'
+require 'frank-cucumber/host_scripting'
+require 'frank-cucumber/wait_helper'
 
 module Frank module Cucumber
 
 module FrankHelper 
-  HOST = "localhost"
-  FRANK_PORT = 37265
+  include WaitHelper
+  include HostScripting
 
   class << self
     # TODO: adding an ivar to the module itself is a big ugyl hack. We need a FrankDriver class, or similar
@@ -16,12 +17,16 @@ module FrankHelper
     end
   end
 
-  def touch( uiquery )
-    views_touched = frankly_map( uiquery, 'touch' )
-    raise "could not find anything matching [#{uiquery}] to touch" if views_touched.empty?
-    #TODO raise warning if views_touched.count > 1
+  def selector_engine
+    Frank::Cucumber::FrankHelper.selector_engine || 'uiquery' # default to UIQuery for backwards compatibility
   end
   
+  def touch( uiquery )
+    touch_successes = frankly_map( uiquery, 'touch' )
+    raise "could not find anything matching [#{uiquery}] to touch" if touch_successes.empty?
+    raise "some views could not be touched (probably because they are not within the current viewport)" if touch_successes.include?(false)
+  end
+
   def element_exists( query )
     matches = frankly_map( query, 'accessibilityLabel' )
     # TODO: raise warning if matches.count > 1
@@ -46,6 +51,46 @@ module FrankHelper
     check_element_exists( "view marked:'#{expected_mark}'" )
   end
 
+  def check_view_with_mark_does_not_exist(expected_mark)
+    check_element_does_not_exist( "view marked:'#{expected_mark}'" )
+  end
+
+
+  # Waits for any of the selectors provided to match a view. Returns true
+  # as soon as we find a matching view, otherwise keeps testing until timeout.
+  # The first selector which matches is passed to a block if it was provided. 
+  def wait_for_element_to_exist(*selectors,&block)
+    wait_until(:message => "Waited for element matching any of #{selectors.join(', ')} to exist") do
+      at_least_one_exists = false
+      selectors.each do |selector|
+        if element_exists( selector )
+          at_least_one_exists = true
+          block.call(selector) if block
+        end
+      end
+      at_least_one_exists
+    end
+  end
+
+  def wait_for_element_to_not_exist(selector)
+    wait_until(:message => "Waited for element #{selector} to not exist") do
+      !element_exists(selector)
+    end
+  end
+
+  def wait_for_element_to_exist_and_then_touch_it(*selectors)
+    wait_for_element_to_exist(*selectors) do |sel| 
+      touch(sel)
+    end
+  end
+
+  def wait_for_nothing_to_be_animating( timeout = false )
+    wait_until :timeout => timeout do
+      !element_exists('view isAnimating')
+    end
+  end
+
+
   # a better name would be element_exists_and_is_not_hidden
   def element_is_not_hidden(query)
      matches = frankly_map( query, 'isHidden' )
@@ -54,45 +99,31 @@ module FrankHelper
   end
 
   def app_exec(method_name, *method_args)
-    operation_map = {
-      :method_name => method_name,
-      :arguments => method_args
-    }
+    operation_map = Gateway.build_operation_map(method_name,method_args)
     
-    before = Time.now
-    res = post_to_uispec_server( 'app_exec', :operation => operation_map )
+    res = frank_server.send_post( 
+      'app_exec', 
+      :operation => operation_map 
+    )
 
-    #logger.debug( "MAP applying #{method_name} with args:( #{method_args.inspect} ) to 'Application Delegate' took #{Time.now - before} seconds" )
-
-    res = JSON.parse( res )
-    if res['outcome'] != 'SUCCESS'
-      raise "app_exec #{method_name} failed because: #{res['reason']}\n#{res['details']}"
-    end
-
-    res['results']
+    return Gateway.evaluate_frankly_response( res, "app_exec #{method_name}" )
   end
 
-  def frankly_engine_map( selector_engine, query, method_name, *method_args )
-    operation_map = {
-      :method_name => method_name,
-      :arguments => method_args,
-    }
-    res = post_to_uispec_server( 'map', :query => query, :operation => operation_map, :selector_engine => selector_engine )
-    res = JSON.parse( res )
-    if res['outcome'] != 'SUCCESS'
-      raise "frankly_map #{query} #{method_name} failed because: #{res['reason']}\n#{res['details']}"
-    end
-
-    res['results']
-  end
-  
   def frankly_map( query, method_name, *method_args )
-    selector_engine = Frank::Cucumber::FrankHelper.selector_engine || 'uiquery' # default to UIQuery for backwards compatibility
-    frankly_engine_map( selector_engine, query, method_name, *method_args )
+    operation_map = Gateway.build_operation_map(method_name,method_args)
+
+    res = frank_server.send_post( 
+      'map',
+      :query => query, 
+      :operation => operation_map, 
+      :selector_engine => selector_engine
+    )
+
+    return Gateway.evaluate_frankly_response( res, "frankly_map #{query} #{method_name}" )
   end
 
   def frankly_dump
-    res = get_to_uispec_server( 'dump' )
+    res = frank_server.send_get( 'dump' )
     puts JSON.pretty_generate(JSON.parse(res)) rescue puts res #dumping a super-deep DOM causes errors
   end
 
@@ -101,7 +132,7 @@ module FrankHelper
     path += '/allwindows' if allwindows
     path += "/frame/" + URI.escape(subframe) if (subframe != nil)
 
-    data = get_to_uispec_server( path )
+    data = frank_server.send_get( path )
 
     open(filename, "wb") do |file|
       file.write(data)
@@ -117,15 +148,14 @@ module FrankHelper
   end
 
   def frankly_current_orientation
-    res = get_to_uispec_server( 'orientation' )
+    res = frank_server.send_get( 'orientation' )
     orientation = JSON.parse( res )['orientation']
     puts "orientation reported as '#{orientation}'" if $DEBUG
     orientation
   end
 
-
   def frankly_is_accessibility_enabled
-    res = get_to_uispec_server( 'accessibility_check' )
+    res = frank_server.send_get( 'accessibility_check' )
     JSON.parse( res )['accessibility_enabled'] == 'true'
   end
 
@@ -167,121 +197,13 @@ module FrankHelper
   end
   
   def frankly_ping
-    get_to_uispec_server('')
-    return true
-  rescue Errno::ECONNREFUSED
-    return false
-  rescue EOFError
-    return false
-  end
-
-  #taken from Ian Dee's Encumber
-  def post_to_uispec_server( verb, command_hash )
-    url = frank_url_for( verb )
-    req = Net::HTTP::Post.new url.path
-    req.body = command_hash.to_json
-
-    make_http_request( url, req )
-  end
-
-  def get_to_uispec_server( verb )
-    url = frank_url_for( verb )
-    req = Net::HTTP::Get.new url.path
-    make_http_request( url, req )
-  end
-
-  def frank_url_for( verb , port=nil )
-    port ||= FRANK_PORT
-    
-    url = URI.parse "http://#{HOST}:#{port}/"
-    url.path = '/'+verb
-    url
-  end
-
-  def make_http_request( url, req )
-    http = Net::HTTP.new(url.host, url.port)
-
-    res = http.start do |sess|
-      sess.request req
-    end
-
-    res.body
-  end
-  
-  def start_recording
-    %x{osascript<<APPLESCRIPT
-	tell application "QuickTime Player"
-	set sr to new screen recording
-	  tell sr to start
-	end tell
-  APPLESCRIPT}
-  
-  end
-
-  def stop_recording
-    %x{osascript<<APPLESCRIPT
-	tell application "QuickTime Player"
-	  set sr to (document 1)
-	  tell sr to stop
-	end tell
-  APPLESCRIPT}  
-  end
-  
-  def quit_simulator
-    %x{osascript<<APPLESCRIPT-
-      application "iPhone Simulator" quit
-    APPLESCRIPT}
-  end
-
-def simulator_reset_data
-  %x{osascript<<APPLESCRIPT
-activate application "iPhone Simulator"
-tell application "System Events"
-  click menu item 5 of menu 1 of menu bar item 2 of menu bar 1 of process "#{Localize.t(:iphone_simulator)}"
-  delay 0.5
-  click button 2 of window 1 of process "#{Localize.t(:iphone_simulator)}"
-end tell
-  APPLESCRIPT} 
-end
-
-  #Note this needs to have "Enable access for assistive devices"
-  #chcked in the Universal Access system preferences
-  def simulator_hardware_menu_press( menu_label )
-    %x{osascript<<APPLESCRIPT
-activate application "iPhone Simulator"
-tell application "System Events"
-	click menu item "#{menu_label}" of menu "#{Localize.t(:hardware)}" of menu bar of process "#{Localize.t(:iphone_simulator)}"
-end tell
-  APPLESCRIPT}  
-  end
-  
-  def press_home_on_simulator
-    simulator_hardware_menu_press Localize.t(:home)
-  end
-  
-  def rotate_simulator_left
-    simulator_hardware_menu_press Localize.t(:rotate_left)
+    frank_server.ping
   end
 
-  def rotate_simulator_right
-    simulator_hardware_menu_press Localize.t(:rotate_right)
-  end
-
-  def shake_simulator
-    simulator_hardware_menu_press Localize.t(:shake_gesture)
-  end
-  
-  def simulate_memory_warning
-    simulator_hardware_menu_press Localize.t(:simulate_memory_warning)
-  end
-  
-  def toggle_call_status_bar
-    simulator_hardware_menu_press Localize.t(:toggle_call_status_bar)
-  end
-  
-  def simulate_hardware_keyboard
-    simulator_hardware_menu_press Localize.t(:simulate_hardware_keyboard)
+  def frank_server
+    @_frank_server ||= Frank::Cucumber::Gateway.new
   end
+ 
 end
 
 

data/lib/frank-cucumber/gateway.rb

@@ -0,0 +1,134 @@
+require 'net/http'
+require 'uri'
+
+module Frank module Cucumber
+
+class Gateway
+  DEFAULT_HOST = "localhost"
+  DEFAULT_PORT = 37265
+
+  def initialize( host=DEFAULT_HOST, port=DEFAULT_PORT )
+    @base_uri = URI.parse "http://#{host}:#{port}/"
+  end
+
+  def ping
+    send_get('')
+    return true
+  rescue FrankNetworkError
+    return false
+  end
+
+  class << self
+    def build_operation_map( method_sig, method_args )
+      num_args_according_to_method_sig = method_sig.count(':')
+
+      if num_args_according_to_method_sig != method_args.count
+        raise <<-EOS
+          
+          The method you've specified - #{method_sig} - wants #{num_args_according_to_method_sig} arguments, but you've supplied #{method_args.count} arguments.
+
+        EOS
+      end
+
+      if num_args_according_to_method_sig > 0 && !method_sig.end_with?(':')
+        raise <<-EOS
+
+          The method signature you've specified - #{method_sig} - is invalid. Objective C method signatures which take parameters must end with a :
+
+        EOS
+      end
+
+      {
+        :method_name => method_sig,
+        :arguments => method_args,
+      }
+    end
+
+    def evaluate_frankly_response( json, req_desc )
+      res = JSON.parse( json )
+      if res['outcome'] != 'SUCCESS'
+        raise "#{req_desc} failed because: #{res['reason']}\n#{res['details']}"
+      end
+
+      res['results']
+    end
+  end
+
+  #taken from Ian Dee's Encumber
+  def send_post( verb, command_hash )
+    url = frank_url_for( verb )
+    req = Net::HTTP::Post.new url.path
+    req.body = command_hash.to_json
+
+    make_http_request( url, req )
+  end
+
+  def send_get( verb )
+    url = frank_url_for( verb )
+    req = Net::HTTP::Get.new url.path
+    make_http_request( url, req )
+  end
+  
+  private
+
+  def frank_url_for( verb )
+    url = @base_uri.clone
+    url.path = '/'+verb
+    url
+  end
+
+  def make_http_request( url, req )
+    http = Net::HTTP.new(url.host, url.port)
+
+    begin
+      res = http.start do |sess|
+        sess.request req
+      end
+
+      res.body
+    rescue Errno::ECONNREFUSED
+      raise FrankNetworkError 
+    rescue EOFError
+      raise FrankNetworkError
+    end
+  end
+
+end
+
+
+class FrankNetworkError < RuntimeError
+  OVERLY_VERBOSE_YET_HELPFUL_ERROR_MESSAGE = <<EOS
+  
+
+*********************************************
+Oh dear. Your app fell over and can't get up.
+*********************************************
+
+
+We just encountered an error while trying to talk to the Frank server embedded 
+within the app under test. This usually means that the app has just crashed, 
+either while carrying out the current step or while finishing up the previous 
+step.
+
+Here are some things you could do next:
+
+- Take a look at the app's logs to see why it crashed. You can view the logs 
+  in Console.app (a search for 'Frankified' will usually find your frankified 
+  app's output).
+
+- Launch your frankified app in the XCode debugger and then run this scenario 
+  again. You'll get lots of helpful output from XCode. Don't forget to do 
+  something to prevent cucumber from automatically re-launching your app when 
+  you run the scenario by hand. If you don't prevent the relaunch then you 
+  won't still be in the XCode debugger when the crash happens.
+
+  
+
+EOS
+
+  def initialize
+    super OVERLY_VERBOSE_YET_HELPFUL_ERROR_MESSAGE
+  end
+end
+
+end end

data/lib/frank-cucumber/host_scripting.rb

@@ -0,0 +1,83 @@
+require 'frank-cucumber/frank_localize'
+
+module Frank module Cucumber
+
+module HostScripting
+  
+  def start_recording
+    %x{osascript<<APPLESCRIPT
+	tell application "QuickTime Player"
+	set sr to new screen recording
+	  tell sr to start
+	end tell
+  APPLESCRIPT}
+  
+  end
+
+  def stop_recording
+    %x{osascript<<APPLESCRIPT
+	tell application "QuickTime Player"
+	  set sr to (document 1)
+	  tell sr to stop
+	end tell
+  APPLESCRIPT}  
+  end
+  
+  def quit_simulator
+    %x{osascript<<APPLESCRIPT-
+      application "iPhone Simulator" quit
+    APPLESCRIPT}
+  end
+
+def simulator_reset_data
+  %x{osascript<<APPLESCRIPT
+activate application "iPhone Simulator"
+tell application "System Events"
+  click menu item 5 of menu 1 of menu bar item 2 of menu bar 1 of process "#{Localize.t(:iphone_simulator)}"
+  delay 0.5
+  click button 2 of window 1 of process "#{Localize.t(:iphone_simulator)}"
+end tell
+  APPLESCRIPT} 
+end
+
+  #Note this needs to have "Enable access for assistive devices"
+  #chcked in the Universal Access system preferences
+  def simulator_hardware_menu_press( menu_label )
+    %x{osascript<<APPLESCRIPT
+activate application "iPhone Simulator"
+tell application "System Events"
+	click menu item "#{menu_label}" of menu "#{Localize.t(:hardware)}" of menu bar of process "#{Localize.t(:iphone_simulator)}"
+end tell
+  APPLESCRIPT}  
+  end
+  
+  def press_home_on_simulator
+    simulator_hardware_menu_press Localize.t(:home)
+  end
+  
+  def rotate_simulator_left
+    simulator_hardware_menu_press Localize.t(:rotate_left)
+  end
+
+  def rotate_simulator_right
+    simulator_hardware_menu_press Localize.t(:rotate_right)
+  end
+
+  def shake_simulator
+    simulator_hardware_menu_press Localize.t(:shake_gesture)
+  end
+  
+  def simulate_memory_warning
+    simulator_hardware_menu_press Localize.t(:simulate_memory_warning)
+  end
+  
+  def toggle_call_status_bar
+    simulator_hardware_menu_press Localize.t(:toggle_call_status_bar)
+  end
+  
+  def simulate_hardware_keyboard
+    simulator_hardware_menu_press Localize.t(:simulate_hardware_keyboard)
+  end
+end 
+
+end end

data/lib/frank-cucumber/version.rb

@@ -1,5 +1,5 @@
 module Frank
   module Cucumber
-    VERSION = "0.8.12"
+    VERSION = "0.8.13"
   end
 end

data/lib/frank-cucumber/wait_helper.rb

@@ -0,0 +1,30 @@
+require 'timeout'
+
+module Frank
+module Cucumber
+
+module WaitHelper
+  TIMEOUT = ENV['WAIT_TIMEOUT'].to_i || 240
+  POLL_SLEEP = 0.1 #seconds
+
+  def wait_until(opts = {})
+    timeout = opts[:timeout] || TIMEOUT
+    message = opts[:message]
+
+    begin
+      Timeout::timeout(timeout) do
+        until yield
+          sleep POLL_SLEEP
+        end
+      end
+    rescue Timeout::Error => e
+      raise message if message
+      raise
+    end
+  end
+
+  module_function :wait_until
+end
+
+end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: frank-cucumber
 version: !ruby/object:Gem::Version
-  version: 0.8.12
+  version: 0.8.13
   prerelease: 
 platform: ruby
 authors:
@@ -10,11 +10,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-03-21 00:00:00.000000000Z
+date: 2012-05-17 00:00:00.000000000Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cucumber
-  requirement: &70106655707880 !ruby/object:Gem::Requirement
+  requirement: &70094361339780 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -22,10 +22,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70106655707880
+  version_requirements: *70094361339780
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &70106655707040 !ruby/object:Gem::Requirement
+  requirement: &70094361337940 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -33,10 +33,10 @@ dependencies:
         version: '2.0'
   type: :runtime
   prerelease: false
-  version_requirements: *70106655707040
+  version_requirements: *70094361337940
 - !ruby/object:Gem::Dependency
   name: sim_launcher
-  requirement: &70106655705860 !ruby/object:Gem::Requirement
+  requirement: &70094361335880 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -44,10 +44,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70106655705860
+  version_requirements: *70094361335880
 - !ruby/object:Gem::Dependency
   name: i18n
-  requirement: &70106655704200 !ruby/object:Gem::Requirement
+  requirement: &70094361333760 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -55,10 +55,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70106655704200
+  version_requirements: *70094361333760
 - !ruby/object:Gem::Dependency
   name: plist
-  requirement: &70106655703560 !ruby/object:Gem::Requirement
+  requirement: &70094361332940 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -66,10 +66,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70106655703560
+  version_requirements: *70094361332940
 - !ruby/object:Gem::Dependency
   name: json
-  requirement: &70106655702840 !ruby/object:Gem::Requirement
+  requirement: &70094361331940 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -77,7 +77,7 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70106655702840
+  version_requirements: *70094361331940
 description: Use cucumber to test native iOS apps via Frank
 email:
 - gems@thepete.net
@@ -131,9 +131,12 @@ files:
 - lib/frank-cucumber/core_frank_steps.rb
 - lib/frank-cucumber/frank_helper.rb
 - lib/frank-cucumber/frank_localize.rb
+- lib/frank-cucumber/gateway.rb
+- lib/frank-cucumber/host_scripting.rb
 - lib/frank-cucumber/launcher.rb
 - lib/frank-cucumber/localize.yml
 - lib/frank-cucumber/version.rb
+- lib/frank-cucumber/wait_helper.rb
 - test/launcher_test.rb
 - test/test_helper.rb
 homepage: http://rubygems.org/gems/frank-cucumber