calabash-cucumber 0.19.2 → 0.20.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 8663515ecc8e1606eb80316b167fa1ded4172620
-  data.tar.gz: 815edb4c91db68b8e41b257685c611f415cfb1d8
+  metadata.gz: 3beda8dc174cf33416893af2d2e58ed4a18d58cb
+  data.tar.gz: 60902d11897fa82bccba3e46aa869b52f152b9cc
 SHA512:
-  metadata.gz: fa781ea6d16d67eca424becf04ec27137efa80590207337de1708f5473bc111e6119b55ca73ed8c5f1b4c883a109fdee101c5f5459dd1d77169d9159a4211f4c
-  data.tar.gz: aac065435b8117da8e8db4b39c9dadf1961fad1a463482925d82dfa12486f3d07e315ac252627929bb1c465e832585c7bbc0c40f91cc870ee68bd0cb890ce4f1
+  metadata.gz: 734473873f98af082e74350e287571804aacb5855adff80bec317eb5cc73083ee6f7da6055f58aba53b3a9e15e9b5a775434febd7dfa18c5785ae89203958d87
+  data.tar.gz: 033948ff96011ee84c325adad1d72ceeef5fb4e22fdc607cb88e725ff19a20a17c6c6f7c6ba5c011054ae4f06a2c88e62993bf0eb6122127374615928610d176

data/lib/calabash-cucumber.rb

@@ -1,16 +1,23 @@
+require "calabash-cucumber/abstract"
 require "calabash-cucumber/environment"
 require "calabash-cucumber/logging"
+require "calabash-cucumber/log_tailer"
 require "calabash-cucumber/dot_dir"
 require "calabash-cucumber/store/preferences"
 require "calabash-cucumber/usage_tracker.rb"
 require "calabash-cucumber/dylibs"
 require "calabash-cucumber/http/http"
-require 'calabash-cucumber/core'
-require 'calabash-cucumber/tests_helpers'
+require "calabash-cucumber/automator/coordinates"
+require "calabash-cucumber/automator/automator"
+require "calabash-cucumber/automator/instruments"
+require "calabash-cucumber/automator/device_agent"
 require 'calabash-cucumber/keyboard_helpers'
 require 'calabash-cucumber/keychain_helpers'
 require 'calabash-cucumber/wait_helpers'
+require "calabash-cucumber/device_agent"
 require 'calabash-cucumber/operations'
+require 'calabash-cucumber/core'
+require 'calabash-cucumber/tests_helpers'
 require 'calabash-cucumber/version'
 require 'calabash-cucumber/date_picker'
 require 'calabash-cucumber/ipad_1x_2x'

data/lib/calabash-cucumber/abstract.rb

@@ -0,0 +1,23 @@
+
+module Calabash
+  module Cucumber
+    # @!visibility private
+    module Abstract
+
+      # @!visibility private
+      class AbstractMethodError < StandardError; end
+
+      # @!visibility private
+      def abstract_method!
+        if Kernel.method_defined?(:caller_locations)
+          method_name = caller_locations.first.label
+        else
+          method_name = caller.first[/\`(.*)\'/, 1]
+        end
+
+        raise AbstractMethodError.new("Abstract method '#{method_name}'")
+      end
+    end
+  end
+end
+

data/lib/calabash-cucumber/automator/automator.rb

@@ -0,0 +1,158 @@
+module Calabash
+  module Cucumber
+    # @!visibility private
+    module Automator
+      # @!visibility private
+      class Automator
+
+        require "calabash-cucumber/abstract"
+        include Calabash::Cucumber::Abstract
+
+
+        # @!visibility private
+        def initialize(*args)
+          abstract_method!
+        end
+
+        # @!visibility private
+        def name
+          abstract_method!
+        end
+
+        # @!visibility private
+        def stop
+          abstract_method!
+        end
+
+        # @!visibility private
+        def running?
+          abstract_method!
+        end
+
+        # @!visibility private
+        def client
+          abstract_method!
+        end
+
+        # @!visibility private
+        def touch(options)
+          abstract_method!
+        end
+
+        # @!visibility private
+        def double_tap(options)
+          abstract_method!
+        end
+
+        # @!visibility private
+        def two_finger_tap(options)
+          abstract_method!
+        end
+
+        # @!visibility private
+        def touch_hold(options)
+          abstract_method!
+        end
+
+        # @!visibility private
+        def flick(options)
+          abstract_method!
+        end
+
+        # @!visibility private
+        def swipe(direction, options={})
+          abstract_method!
+        end
+
+        # @!visibility private
+        #
+        # Callers must validate the options.
+        def pan(from_query, to_query, options={})
+          abstract_method!
+        end
+
+        # @!visibility private
+        #
+        # Callers must validate the options.
+        def pan_coordinates(from_point, to_point, options={})
+          abstract_method!
+        end
+
+        # @!visibility private
+        def pinch(in_or_out, options)
+          abstract_method!
+        end
+
+        # @!visibility private
+        def send_app_to_background(seconds)
+          abstract_method!
+        end
+
+        # @!visibility private
+        #
+        # It is the caller's responsibility to:
+        # 1. expect the keyboard is visible
+        # 2. escape the existing text
+        def enter_text_with_keyboard(string, options={})
+          abstract_method!
+        end
+
+        # @!visibility private
+        #
+        # Respond to keys like 'Delete' or 'Return'.
+        def char_for_keyboard_action(action_key)
+          abstract_method!
+        end
+
+        # @!visibility private
+        # It is the caller's responsibility to ensure the keyboard is visible.
+        def enter_char_with_keyboard(char)
+          abstract_method!
+        end
+
+        # @!visibility private
+        # It is the caller's responsibility to ensure the keyboard is visible.
+        def tap_keyboard_action_key
+          abstract_method!
+        end
+
+        # @!visibility private
+        # It is the caller's responsibility to ensure the keyboard is visible.
+        def tap_keyboard_delete_key
+          abstract_method!
+        end
+
+        # @!visibility private
+        #
+        # Legacy API - can we remove this method?
+        #
+        # It is the caller's responsibility to ensure the keyboard is visible.
+        def fast_enter_text(text)
+          abstract_method!
+        end
+
+        # @!visibility private
+        #
+        # Caller is responsible for limiting calls to iPads and waiting for the
+        # keyboard to disappear.
+        def dismiss_ipad_keyboard
+          abstract_method!
+        end
+
+        # @!visibility private
+        #
+        # Caller is responsible for providing a valid direction.
+        def rotate(direction)
+          abstract_method!
+        end
+
+        # @!visibility private
+        #
+        # Caller is responsible for normalizing and validating the position.
+        def rotate_home_button_to(position)
+          abstract_method!
+        end
+      end
+    end
+  end
+end

data/lib/calabash-cucumber/automator/coordinates.rb

@@ -0,0 +1,401 @@
+
+module Calabash
+  module Cucumber
+    module Automator
+      # @!visibility private
+      class Coordinates
+
+        require "calabash-cucumber/map"
+
+        require "calabash-cucumber/status_bar_helpers"
+        include Calabash::Cucumber::StatusBarHelpers
+
+        # @!visibility private
+        attr_reader :element
+
+        # @!visibility private
+        def initialize(element)
+          @element = element
+        end
+
+        # @!visibility private
+        def self.left_point_for_full_screen_pan
+          coordinates = Coordinates.instance_without_element
+          {
+            x: coordinates.send(:min_x),
+            y: coordinates.send(:window)[:center_y]
+          }
+        end
+
+        # @!visibility private
+        def self.right_point_for_full_screen_pan
+          coordinates = Coordinates.instance_without_element
+          {
+            x: coordinates.send(:max_x),
+            y: coordinates.send(:window)[:center_y]
+          }
+        end
+
+        # @!visibility private
+        def self.top_point_for_full_screen_pan
+          coordinates = Coordinates.instance_without_element
+          {
+            x: coordinates.send(:window)[:center_x],
+            y: coordinates.send(:min_y)
+          }
+        end
+
+        # @!visibility private
+        def self.bottom_point_for_full_screen_pan
+          coordinates = Coordinates.instance_without_element
+          {
+            x: coordinates.send(:window)[:center_x],
+            y: coordinates.send(:max_y)
+          }
+        end
+
+        # @!visibility private
+        def self.points_for_full_screen_pan(direction)
+          case direction
+            when :left
+              start_point = Coordinates.right_point_for_full_screen_pan
+              end_point = Coordinates.left_point_for_full_screen_pan
+            when :right
+              start_point = Coordinates.left_point_for_full_screen_pan
+              end_point = Coordinates.right_point_for_full_screen_pan
+            when :up
+              start_point = Coordinates.bottom_point_for_full_screen_pan
+              end_point = Coordinates.top_point_for_full_screen_pan
+            when :down
+              start_point = Coordinates.top_point_for_full_screen_pan
+              end_point = Coordinates.bottom_point_for_full_screen_pan
+            else
+              raise ArgumentError,
+                    "Direction #{direction} is not supported; use :left, :right, :top, :bottom"
+
+          end
+
+          {
+            start: start_point,
+            end: end_point
+          }
+        end
+
+        # @!visibility private
+        def left_point_for_full_view_pan
+          {
+            x: [min_x, element_origin[:x] + 10].max,
+            y: element_center[:y]
+          }
+        end
+
+        # @!visibility private
+        def right_point_for_full_view_pan
+          {
+            x: [max_x, element_origin[:x] + element_size[:width] - 10].min,
+            y: element_center[:y]
+          }
+        end
+
+        # @!visibility private
+        def top_point_for_full_view_pan
+          {
+            x: element_center[:x],
+            y: [min_y, (element_origin[:y] + 10)].max
+          }
+        end
+
+        # @!visibility private
+        def bottom_point_for_full_view_pan
+          {
+            x: element_center[:x],
+            y: [max_y, (element_origin[:y] + element_size[:height] - 10)].min
+          }
+        end
+
+        # @!visibility private
+        def points_for_full_view_pan(direction)
+          case direction
+            when :left
+              start_point = right_point_for_full_view_pan
+              end_point = left_point_for_full_view_pan
+            when :right
+              start_point = left_point_for_full_view_pan
+              end_point = right_point_for_full_view_pan
+            when :up
+              start_point = bottom_point_for_full_view_pan
+              end_point = top_point_for_full_view_pan
+            when :down
+              start_point = top_point_for_full_view_pan
+              end_point = bottom_point_for_full_view_pan
+            else
+              raise ArgumentError,
+                    "Direction #{direction} is not supported; use :left, :right, :top, :bottom"
+
+          end
+
+          {
+            start: start_point,
+            end: end_point
+          }
+        end
+
+        # @!visibility private
+        def left_point_for_half_view_pan
+          {
+            x: [min_x, element_center[:x] - (element_size[:width]/4.0)].max,
+            y: element_center[:y]
+          }
+        end
+
+        # @!visibility private
+        def right_point_for_half_view_pan
+          {
+            x: [max_x, element_center[:x] + (element_size[:width]/4.0)].min,
+            y: element_center[:y]
+          }
+        end
+
+        # @!visibility private
+        def top_point_for_half_view_pan
+          {
+            x: element_center[:x],
+            y: [min_y, element_center[:y] - (element_size[:height]/4.0)].max
+          }
+        end
+
+        # @!visibility private
+        def bottom_point_for_half_view_pan
+          {
+            x: element_center[:x],
+            y: [max_y, element_center[:y] + (element_size[:height]/4.0)].min
+          }
+        end
+
+        # @!visibility private
+        def points_for_half_view_pan(direction)
+          case direction
+            when :left
+              start_point = right_point_for_half_view_pan
+              end_point = left_point_for_half_view_pan
+            when :right
+              start_point = left_point_for_half_view_pan
+              end_point = right_point_for_half_view_pan
+            when :up
+              start_point = bottom_point_for_half_view_pan
+              end_point = top_point_for_half_view_pan
+            when :down
+              start_point = top_point_for_half_view_pan
+              end_point = bottom_point_for_half_view_pan
+            else
+              raise ArgumentError,
+                    "Direction #{direction} is not supported; use :left, :right, :top, :bottom"
+
+          end
+
+          {
+            start: start_point,
+            end: end_point
+          }
+        end
+
+        # @!visibility private
+        def left_point_for_small_view_pan
+          {
+            x: [min_x, element_center[:x] - (element_size[:width]/6.0)].max,
+            y: element_center[:y]
+          }
+        end
+
+        # @!visibility private
+        def right_point_for_small_view_pan
+          {
+            x: [max_x, element_center[:x] + (element_size[:width]/6.0)].min,
+            y: element_center[:y]
+          }
+        end
+
+        # @!visibility private
+        def top_point_for_small_view_pan
+          {
+            x: element_center[:x],
+            y: [min_y, element_center[:y] - (element_size[:height]/6.0)].max
+          }
+        end
+
+        # @!visibility private
+        def bottom_point_for_small_view_pan
+          {
+            x: element_center[:x],
+            y: [max_y, element_center[:y] + (element_size[:height]/6.0)].min
+          }
+        end
+
+        # @!visibility private
+        def points_for_small_view_pan(direction)
+          case direction
+            when :left
+              start_point = right_point_for_small_view_pan
+              end_point = left_point_for_small_view_pan
+            when :right
+              start_point = left_point_for_small_view_pan
+              end_point = right_point_for_small_view_pan
+            when :up
+              start_point = bottom_point_for_small_view_pan
+              end_point = top_point_for_small_view_pan
+            when :down
+              start_point = top_point_for_small_view_pan
+              end_point = bottom_point_for_small_view_pan
+            else
+              raise ArgumentError,
+                    "Direction #{direction} is not supported; use :left, :right, :top, :bottom"
+
+          end
+
+          {
+            start: start_point,
+            end: end_point
+          }
+        end
+
+        # @!visibility private
+        def self.end_point_for_swipe(dir, element, force)
+          case dir
+            when :left
+              degrees = 0
+            when :up
+              degrees = 90
+            when :right
+              degrees = 180
+            when :down
+              degrees = 270
+          end
+          radians = degrees * Math::PI / 180.0
+
+          case force
+          when :light
+            scale_radius_by = 0.25
+          when :normal
+            scale_radius_by = 0.333
+          when :strong
+            scale_radius_by = 0.5
+          end
+
+          element_width = element["rect"]["width"]
+          element_height = element["rect"]["height"]
+          x_center = element["rect"]["center_x"]
+          y_center = element["rect"]["center_y"]
+          radius = ([element_width, element_height].min) * scale_radius_by
+          to_x = x_center - (radius * Math.cos(radians))
+          to_y = y_center - (radius * Math.sin(radians))
+          { :x => to_x, :y => to_y }
+        end
+
+        private
+
+        # @!visibility private
+        def self.instance_without_element
+          Coordinates.new(nil)
+        end
+
+        # @!visibility private
+        def element_center
+          @element_center ||= begin
+            {
+              x: element["rect"]["center_x"],
+              y: element["rect"]["center_y"]
+            }
+          end
+        end
+
+        # @!visibility private
+        def element_origin
+          @element_origin ||= begin
+            {
+              x: element["rect"]["x"],
+              y: element["rect"]["y"]
+            }
+          end
+        end
+
+        # @!visibility private
+        def element_size
+          @element_size ||= begin
+            {
+              height: element["rect"]["height"],
+              width: element["rect"]["width"]
+            }
+          end
+        end
+
+        # @!visibility private
+        def query_wrapper(query, *args)
+          Calabash::Cucumber::Map.map(query, :query, *args)
+        end
+
+        # @!visibility private
+        def height_for_view(view_class)
+          element = query_wrapper(view_class).first
+          if element
+            element["rect"]["height"]
+          else
+            0
+          end
+        end
+
+        # @!visibility private
+        def status_bar_height
+          @status_bar_height ||= status_bar_details["frame"]["height"]
+        end
+
+        # @!visibility private
+        def nav_bar_height
+          @nav_bar_height ||= height_for_view("UINavigationBar")
+        end
+
+        # @!visibility private
+        def tab_bar_height
+          @tab_bar_height ||= height_for_view("UITabBar")
+        end
+
+        # @!visibility private
+        def toolbar_height
+          @toolbar_height ||= height_for_view("UIToolbar")
+        end
+
+        # @!visibility private
+        def window
+          @window ||= begin
+            element = query_wrapper("*").first
+            {
+              :height => element["rect"]["height"],
+              :width => element["rect"]["width"],
+              :center_x => element["rect"]["center_x"],
+              :center_y => element["rect"]["center_y"]
+            }
+          end
+        end
+
+        # @!visibility private
+        def min_y
+          @min_y ||= status_bar_height + nav_bar_height + 16
+        end
+
+        # @!visibility private
+        def max_y
+          @max_y ||= window[:height] - (tab_bar_height + toolbar_height + 16)
+        end
+
+        # @!visibility private
+        def min_x
+          10
+        end
+
+        # @!visibility private
+        def max_x
+          @max_x ||= window[:width] - 10
+        end
+      end
+    end
+  end
+end