frank-pivotal 1.2.3.pre.1

data/lib/frank-pivotal/localize.yml

@@ -0,0 +1,104 @@
+en:
+  iphone_simulator: iOS Simulator
+  iphone_simulator_reset: Reset
+  hardware: Hardware
+  home: Home
+  rotate_left: Rotate Left
+  rotate_right: Rotate Right
+  shake_gesture: Shake Gesture
+  simulate_memory_warning: Simulate Memory Warning
+  toggle_in_call_status_bar: Toggle In-Call Status Bar
+  simulate_hardware_keyboard: Simulate Hardware Keyboard
+  only_one_simulator: Only one iOS Simulator can run at a time.
+
+fr:
+  iphone_simulator: Simulateur iOS
+  iphone_simulator_reset: Réinitialiser
+  hardware: Matériel
+  home: Écran d’accueil
+  rotate_left: Rotation à gauche
+  rotate_right: Rotation à droite
+  shake_gesture: Secousse
+  simulate_memory_warning: Simuler un avertissement de mémoire
+  toggle_in_call_status_bar: Afficher/Masquer la barre d'état d'appel en cour
+  simulate_hardware_keyboard: Simuler un clavier matériel
+  only_one_simulator: Un seul Simulateur iOS peut être exécuté à la fois.
+
+de:
+  iphone_simulator: iOS-Simulator
+  iphone_simulator_reset: Zurücksetzen
+  hardware: Hardware
+  home: Home
+  rotate_left: Links drehen
+  rotate_right: Rechts drehen
+  shake_gesture: Schüttelgeste
+  simulate_memory_warning: Speicherwarnhinweis simulieren
+  toggle_in_call_status_bar: Status für eingeh. Anrufe ein/aus
+  simulate_hardware_keyboard: Hardware-Tastatur simulieren
+  only_one_simulator: Es kann jeweils nur eine iOS-Simulator-Instanz aktiv sein.
+
+ru:
+  iphone_simulator: Симулятор iOS
+  iphone_simulator_reset: Сбросить
+  hardware: Аппаратура
+  home: Экран «Домой»
+  rotate_left: Повернуть влево
+  rotate_right: Повернуть вправо
+  shake_gesture: Выполнить жест встряхивания
+  simulate_memory_warning: Симулировать предупреждение о нехватке памяти
+  toggle_in_call_status_bar: Переключить на строку состояния поступающего вызова
+  simulate_hardware_keyboard: Симулировать физическую клавиатуру
+  only_one_simulator: Два и более Симуляторов iOS не могут быть запущены одновременно.
+
+zh:
+  iphone_simulator: iOS 模拟器
+  iphone_simulator_reset: 还原
+  hardware: 硬件
+  home: 首页
+  rotate_left: 向左旋转
+  rotate_right: 向右旋转
+  shake_gesture: 摇动手势
+  simulate_memory_warning: 模拟内存警告
+  toggle_in_call_status_bar: 切换呼叫状态栏
+  simulate_hardware_keyboard: 模拟硬件键盘
+  only_one_simulator: 一次只能运行一个“iOS 模拟器”。
+
+ja:
+  iphone_simulator: iOSシミュレータ
+  iphone_simulator_reset: リセット
+  hardware: ハードウェア
+  home: ホーム
+  rotate_left: 反時計回りに回転
+  rotate_right: 時計回りに回転
+  shake_gesture: シェイクジェスチャー
+  simulate_memory_warning: メモリ警告をシミュレート
+  toggle_in_call_status_bar: 着信ステータスバーを切り替える
+  simulate_hardware_keyboard: ハードウェアキーボードをシミュレート
+  only_one_simulator: 実行できるiOSシミュレータは1度に1つのみです。
+
+es:
+  iphone_simulator: Simulador iOS
+  iphone_simulator_reset: Restablecer
+  hardware: Hardware
+  home: Inicio
+  rotate_left: Girar a la izquierda
+  rotate_right: Girar a la derecha
+  shake_gesture: Agitar
+  simulate_memory_warning: Simular aviso de memoria
+  toggle_in_call_status_bar: Activar/Desactivar barra de estado durante llamada
+  simulate_hardware_keyboard: Simular teclado físico
+  only_one_simulator: Sólo se puede ejecutar un Simulador iOS a la vez.
+
+it:
+  iphone_simulator: Simulatore iOS
+  iphone_simulator_reset: Reimposta
+  hardware: Hardware
+  home: Home
+  rotate_left: Ruota a sinistra
+  rotate_right: Ruota a destra
+  shake_gesture: Gesto Agita
+  simulate_memory_warning: Simula avviso memoria
+  toggle_in_call_status_bar: Attiva/disattiva barra di state chiamata
+  simulate_hardware_keyboard: Simula la tastiera hardware
+  only_one_simulator: Solo un Simulatore iOS può essere eseguito in un momento.
+

data/lib/frank-pivotal/location_helper.rb

@@ -0,0 +1,20 @@
+module Frank
+  module Cucumber
+    module LocationHelper
+      # Ask Frank to set the location.
+      #
+      # @example
+      #   # Set the location to Stockholm
+      #   set_location(:latitude => 59.338887, :longitude => 18.058425)
+      #
+      def set_location(options = {})
+        res = frank_server.send_post( 
+          'location',
+          :latitude => options[:latitude],
+          :longitude => options[:longitude]
+        )
+        Frank::Cucumber::Gateway.evaluate_frankly_response( res, "setting the location to #{options[:latitude]}, #{options[:longitude]}" )
+      end
+    end
+  end
+end

data/lib/frank-pivotal/plugins/plugin.rb

@@ -0,0 +1,57 @@
+require 'erb'
+
+module Frank
+  module Plugins
+    class Plugin
+
+      attr_accessor :plugin_dir, :name, :exclude_dependencies
+
+      def initialize(plugin_dir, name)
+        self.plugin_dir= plugin_dir
+        self.name = name
+      end
+
+      def dependency(lib,linker_flag="-l#{lib}")
+        return linker_flag unless exclude_dependencies.include?(lib)
+        ''
+      end
+
+      def write_xcconfig(exclude_dependencies)
+          self.exclude_dependencies= exclude_dependencies
+
+          _xcconfig_erb = File.join(plugin_dir,"#{xcconfig}.erb")
+
+          unless File.exist?(_xcconfig_erb)
+            raise "Invalid plugin #{name} at #{File.join(plugin_dir)}.\nDoesn't have an erb file: #{_xcconfig_erb}"
+          end
+
+
+          _template = ERB.new(File.read(_xcconfig_erb))
+          result = _template.result(binding)
+          output_path = File.join(plugin_dir, xcconfig)
+          File.open(output_path,'w') {|f| f.write(result)}
+          output_path
+      end
+
+      def xcconfig
+        "#{name}.xcconfig"
+      end
+
+      def self.from_plugin_directory(path)
+        plugin_name = File.basename(path)
+        Plugin.new(path, plugin_name)
+      end
+
+      def self.generate_core_xcconfig(plugins)
+        _template = ERB.new(File.read(core_xcconfig_path))
+
+        _template.result(binding)
+      end
+
+      def self.core_xcconfig_path
+        File.expand_path(File.join(File.dirname(__FILE__), '..', 'frank.xcconfig.erb'))
+      end
+
+    end
+  end
+end

data/lib/frank-pivotal/rect.rb

@@ -0,0 +1,26 @@
+require "ostruct"
+
+module Frank module Cucumber
+
+  class Rect
+    attr_reader :x, :y, :width, :height
+
+    def self.from_api_repr( hash )
+      x,y = hash["origin"]["x"], hash["origin"]["y"]
+      width,height = hash["size"]["width"],hash["size"]["height"]
+      self.new( x, y, width, height )
+    end
+
+    def initialize(x,y,width,height)
+      @x,@y,@width,@height = x,y,width,height
+    end
+
+    def center
+      OpenStruct.new( 
+                     :x => @x.to_f + (@width.to_f/2),
+                     :y => @y.to_f + (@height.to_f/2)
+                    )
+    end
+  end
+
+end end

data/lib/frank-pivotal/scroll_helper.rb

@@ -0,0 +1,24 @@
+module Frank
+module Cucumber
+
+module ScrollHelper
+
+  def scroll_view_to_top( selector )
+    frankly_map( selector, "FEX_scrollToTop" )
+  end
+
+  def scroll_view_to_bottom( selector )
+    frankly_map( selector, "FEX_scrollToBottom" )
+  end
+
+  def scroll_view_to_position( selector, x, y )
+    frankly_map( selector, "FEX_setContentOffsetX:y:", x.to_i, y.to_i)
+  end
+
+  def scroll_table_view( selector, row, section = 0)
+    frankly_map(selector, "FEX_scrollToRow:inSection:", row.to_i, section.to_i)
+  end
+
+end
+
+end end

data/lib/frank-pivotal/version.rb

@@ -0,0 +1,5 @@
+module Frank
+  module Cucumber
+    VERSION = "1.2.3-1"
+  end
+end

data/lib/frank-pivotal/wait_helper.rb

@@ -0,0 +1,57 @@
+require 'timeout'
+
+module Frank
+module Cucumber
+
+# This module contains a single method called wait_until which implements the {http://sauceio.com/index.php/2011/04/how-to-lose-races-and-win-at-selenium/ Spin Assert} pattern.
+#
+# When we mix this module into another class or module (such as {FrankHelper}) then that wait_until method will be available inside 
+# that class or module. Because we call module_function at the end of the module this method is also available as a static method on the module. 
+# That means you can also call {Frank::Cucumber::WaitHelper.wait_until} from anywhere in your code.
+#
+module WaitHelper
+  # Default option for how long (in seconds) to keep checking before timing out the entire wait
+  TIMEOUT = (ENV['WAIT_TIMEOUT'] || 240).to_i
+  # How long to pause (in seconds) inbetween each spin through the assertion block
+  POLL_SLEEP = 0.1
+
+  # Repeatedly evaluate the passed in block until either it returns true or a timeout expires. Between 
+  # evaluations there is a pause of {POLL_SLEEP} seconds.
+  #
+  # wait_until takes the following options:
+  #  :timeout - How long in seconds to keep spinning before timing out of the entire operation. Defaults to TIMEOUT
+  #  :message - What to raise in the event of a timeout. Defaults to an empty StandardError
+  # 
+  # @yield the assertion to wait for
+  # @yieldreturn whether the assertion was met
+  #
+  #
+  # Here's an example where we will keep calling the reticulate_splines method until either it returns a result
+  # greater than 0 or 20 seconds elapses. In the timeout case an exception will be raised 
+  # saying "timed out waiting for splines to reticulate":
+  #
+  #   wait_until( :timeout => 20, :message => 'timed out waiting for splines to reticulate' ) do
+  #     num_splines_reticulated = reticulate_splines(1,2,3)
+  #     num_splines_reticulated > 0
+  #   end
+  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

data/lib/frank-pivotal.rb

@@ -0,0 +1,14 @@
+require 'frank-cucumber/rect'
+require 'frank-cucumber/color_helper'
+require 'frank-cucumber/frank_helper'
+require 'frank-cucumber/frank_mac_helper'
+require 'frank-cucumber/launcher'
+
+World(Frank::Cucumber::ColorHelper)
+World(Frank::Cucumber::FrankHelper)
+World(Frank::Cucumber::FrankMacHelper)
+World(Frank::Cucumber::Launcher)
+
+AfterConfiguration do
+  require 'frank-cucumber/core_frank_steps'
+end

data/test/keyboard_helper_test.rb

@@ -0,0 +1,84 @@
+require_relative 'test_helper.rb'
+
+class HelperForTesting
+  include Frank::Cucumber::KeyboardHelper
+
+
+  def mock_frank_server
+    RR.mock(@mock_frank_server = Object.new)
+  end
+
+  private
+  def frank_server
+    @mock_frank_server
+  end
+end
+
+describe "frank keyboard helper" do
+  
+  the_helper = nil
+  before do
+    the_helper = HelperForTesting.new
+  end
+
+  def successful_response
+    %Q{ { "outcome": "SUCCESS" } }
+  end
+
+  it 'posts to the right endpoint' do
+    the_helper.mock_frank_server.send_post('type_into_keyboard', anything ){ successful_response }
+
+    the_helper.type_into_keyboard('blah')
+  end
+
+  it 'sends the right payload, adding a trailing new-line if needed' do
+    the_helper.mock_frank_server.send_post.with_any_args do |endpoint,payload|
+      payload.must_equal( {:text_to_type => "the text I want to type\n"} )
+
+      successful_response
+    end
+
+    the_helper.type_into_keyboard('the text I want to type')
+  end
+
+  it "doesn't add a trailing newline if already there" do
+    the_helper.mock_frank_server.send_post.with_any_args do |endpoint,payload|
+      payload.must_equal( {:text_to_type => "existing newline\n"} )
+
+      successful_response
+    end
+
+    the_helper.type_into_keyboard("existing newline\n")
+  end
+
+  it "doesn't add a trailing newline if asked explicitly not to" do
+    the_helper.mock_frank_server.send_post.with_any_args do |endpoint,payload|
+      payload.must_equal( {:text_to_type => "text without newline"} )
+
+      successful_response
+    end
+
+    the_helper.type_into_keyboard("text without newline", :append_return => false)
+  end
+
+  it 'raises an exception if the server responds negatively' do
+    failure_message = <<-EOS
+    { 
+      "outcome": "NOT SUCCESS AT ALL",
+      "reason": "reason for failure",
+      "details": "details about failure"
+    }
+    EOS
+
+    the_helper.mock_frank_server.send_post.with_any_args{ failure_message }
+
+    exception = lambda{ 
+      the_helper.type_into_keyboard('text we attempted to type')
+    }.must_raise RuntimeError
+    
+    exception.message.must_match /text we attempted to type/ 
+    exception.message.must_match /reason for failure/ 
+    exception.message.must_match /details about failure/ 
+  end
+
+end

data/test/launcher_test.rb

@@ -0,0 +1,57 @@
+require_relative 'test_helper.rb'
+
+include Frank::Cucumber::Launcher
+include Frank::Cucumber::FrankHelper
+
+def wait_for_frank_to_come_up
+  # orig FrankHelper::wait_for_frank_to_come_up
+  # doing nothing
+end
+
+describe "frank cucumber launcher" do
+  DUMMY_APP_PATH = '/tmp/dummy_app_path'
+
+  before do
+    `mkdir -p #{DUMMY_APP_PATH}`
+  end
+
+  describe "when the path is wrong" do
+  
+    it 'throws exception when no app path is given' do
+      assert_raises(RuntimeError) do
+        enforce(nil)
+      end
+    end
+
+    it 'prints suggestions if available' do
+        mock_locator = Mock.new
+        mock_locator.expect :guess_possible_app_bundles_for_dir, ['suggestion_1'], ['']
+        begin
+          enforce(nil, mock_locator)
+        rescue RuntimeError => e
+          e.message.must_match "suggestion_1"
+        end
+    end
+
+    it "throws exception when app path doesn't exist" do
+      assert_raises(RuntimeError) do
+        enforce('/foo/bar/baz/not/a/real/path')
+      end
+    end
+  end
+
+  describe "when starting the simulator with the specified params" do
+
+    before do
+      @simulator_direct_client = Mock.new 
+      @simulator_direct_client.expect :relaunch, nil, [] 
+    end
+    
+    it 'selects iphone mode by default' do
+      launch_app(DUMMY_APP_PATH, 'X.Y')
+      @version.must_equal 'iphone'
+    end
+
+  end
+
+end

data/test/rect_test.rb

@@ -0,0 +1,25 @@
+require_relative 'test_helper.rb'
+
+require_relative '../lib/frank-cucumber/rect'
+
+module Frank module Cucumber
+
+describe Rect do
+  it 'parsing from the api hash representation correctly' do
+    api_repr = { "origin" => {"x" => 1.1, "y" => 2.2}, "size" => { "height" => 11.1, "width" => 22.2 } }
+    rect = Rect.from_api_repr( api_repr )
+
+    rect.x.must_equal 1.1
+    rect.y.must_equal 2.2
+    rect.width.must_equal 22.2
+    rect.height.must_equal 11.1
+  end
+
+  it 'calculates the center correctly' do
+    rect = Rect.new( 100, 200, 11, 21 )
+    rect.center.x.must_equal 105.5
+    rect.center.y.must_equal 210.5
+  end
+end
+
+end end

data/test/test_helper.rb

@@ -0,0 +1,16 @@
+require 'ostruct'
+require 'stringio'
+require 'minitest/autorun'
+require 'minitest/mock'
+require 'minitest/spec'
+include MiniTest
+
+require 'rr'
+class MiniTest::Unit::TestCase
+  include RR::Adapters::MiniTest
+end
+
+require_relative '../lib/frank-cucumber/color_helper'
+require_relative '../lib/frank-cucumber/frank_helper'
+require_relative '../lib/frank-cucumber/launcher'
+