gametel 0.1

data/features/support/screens/views_menu_screen.rb

@@ -0,0 +1,40 @@
+class ViewsMenuScreen
+  include Gametel
+
+  list_item(:animation, :text => 'Animation')
+  list_item(:auto_complete, :text => 'Auto Complete')
+  list_item(:buttons, :text => 'Buttons')
+  list_item(:chronometer, :text => 'Chronometer')
+  list_item(:controls, :text => 'Controls')
+  list_item(:custom, :text => 'Custom')
+  list_item(:date_widgets, :text => 'Date Widgets')
+  list_item(:expandable_lists, :text => 'Expandable Lists')
+  list_item(:focus, :text => 'Focus')
+  list_item(:full_screen_modes, :text => 'Full Screen Modes')
+  list_item(:gallery, :text => 'Gallery')
+  list_item(:game_controller_input, :text => 'Game Controller Input')
+  list_item(:grid, :text => 'Grid')
+  list_item(:hover_events, :text => 'Hover Events')
+  list_item(:image_button, :text => 'ImageButton')
+  list_item(:image_switcher, :text => 'ImageSwitcher')
+  list_item(:image_view, :text => 'ImageView')
+  list_item(:layout_animations, :text => 'Layout Animations')
+  list_item(:layouts, :text => 'Layouts')
+  list_item(:lists, :text => 'Lists')
+  list_item(:popup_menu, :text => 'Popup Menu')
+  list_item(:progress_bar, :text => 'Progress Bar')
+  list_item(:radio_group, :text => 'Radio Group')
+  list_item(:rating_bar, :text => 'Rating Bar')
+  list_item(:rotating_button, :text => 'Rotating Button')
+  list_item(:scrollbars, :text => 'ScrollBars')
+  list_item(:search_view, :text => 'Search View')
+  list_item(:secure_view, :text => 'Secure View')
+  list_item(:seek_bar, :text => 'Seek Bar')
+  list_item(:spinner, :text => 'Spinner')
+  list_item(:splitting_touches_across_views, :text => 'Splitting Touches across Views')
+  list_item(:switches, :text => 'Switches')
+  list_item(:tabs, :text => 'Tabs')
+  list_item(:text_switcher, :text => 'TextSwitcher')
+  list_item(:visibility, :text => 'Visibility')
+  list_item(:webview, :text => 'WebView')
+end

data/features/text.feature

@@ -0,0 +1,7 @@
+Feature: Interacting with the standard text field
+
+  Scenario: Entering text into a text field
+    Given I'm on the controls screen
+    When I enter "example text" into the text field
+    Then I should have the value "example text" on the screen
+

data/gametel.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/gametel/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Jeffrey S. Morgan", "Levi Wilson"]
+  gem.email         = ["jeff.morgan@leandog.com", "levi@leandog.com"]
+  gem.description   = %q{High level wrapper around android drivers}
+  gem.summary       = %q{High level wrapper around android drivers}
+  gem.homepage      = ""
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "gametel"
+  gem.require_paths = ["lib"]
+  gem.version       = Gametel::VERSION
+
+  gem.add_dependency 'calabash-android', '>= 0.1.0'
+
+  gem.add_development_dependency 'rspec', '>= 2.6.0'
+  gem.add_development_dependency 'cucumber'
+
+end

data/irb_android.sh

@@ -0,0 +1,2 @@
+#!/bin/bash
+IRBRC=.irbrc irb

data/lib/gametel.rb

@@ -0,0 +1,55 @@
+require 'gametel/accessors'
+require 'gametel/navigation'
+require 'gametel/version'
+require 'gametel/platforms/calabash'
+
+module Gametel
+  include Calabash::Android::Operations
+
+  attr_reader :platform
+
+  def self.included(cls)
+    cls.extend Gametel::Accessors
+  end
+
+  def initialize(pform = :calabash)
+    @platform = Gametel::Platforms::Calabash.new if pform == :calabash
+  end
+
+  #
+  # Returns true if the provided text is found on the screen
+  #
+  def has_text?(text)
+    platform.has_text?(text)
+  end
+
+  #
+  # Press the back button
+  #
+  def back
+    platform.back
+  end
+
+  #
+  # scroll down
+  #
+  def scroll_down
+    platform.scroll_down
+  end
+
+  #
+  # scroll up
+  #
+  def scroll_up
+    platform.scroll_up
+  end
+
+  #
+  # Wait for the provided text to appear
+  #
+  def wait_for_text(text_to_find)
+    platform.wait_for_text(text_to_find)
+  end
+
+end
+

data/lib/gametel/accessors.rb

@@ -0,0 +1,98 @@
+module Gametel
+  module Accessors
+    #
+    # Generates one method to enter text into a text field.
+    #
+    # @example
+    #   text(:first_name, :index => 0)
+    #   # will generate 'first_name=" method
+    #
+    # @param  [String]  the name used for the generated methods
+    # @param  [Hash]  locator for how the text is found  The valid
+    # keys are:
+    #  * :name
+    #  * :index
+    #
+    def text(name, locator)
+      define_method("#{name}=") do |value|
+        platform.enter_text(value, locator)
+      end
+    end
+
+    #
+    # Generates one method to click a button.
+    #
+    # @example
+    #   button(:save, :text => 'Save')
+    #   # will generate 'save' method
+    #
+    # @param  [String]  the name used for the generated methods
+    # @param  [Hash]  locator for how the button is found  The valid
+    # keys are:
+    #  * :text
+    #  * :index
+    #
+    def button(name, locator)
+      define_method(name) do
+        platform.press_button(locator)
+      end
+    end
+
+    #
+    # Generates one method to click a list item.
+    #
+    # @example
+    #   list_item(:details, :text => 'Details')
+    #   # will generate 'details' method
+    #
+    # @param  [String]  the name used for the generated methods
+    # @param  [Hash]  locator for how the list item is found  The valid
+    # keys are:
+    #  * :text
+    #  * :index
+    #
+    def list_item(name, locator)
+      define_method(name) do
+        platform.press_list_item(locator)
+      end
+    end
+
+    #
+    # Generates one method to click a checkbox.
+    #
+    # @example
+    #   checkbox(:enable, :text => 'Enable')
+    #   # will generate 'enable' method
+    #
+    # @param  [String]  the name used for the generated methods
+    # @param  [Hash]  locator for how the checkbox is found  The valid
+    # keys are:
+    #  * :text
+    #  * :index
+    #
+    def checkbox(name, locator)
+      define_method(name) do
+        platform.click_checkbox(locator)
+      end
+    end
+
+    #
+    # Generates one method to click a radio button.
+    #
+    # @example
+    #   radio_button(:circle, :text => 'Circle')
+    #   # will generate 'circle' method
+    #
+    # @param  [String]  the name used for the generated methods
+    # @param  [Hash]  locator for how the checkbox is found  The valid
+    # keys are:
+    #  * :text
+    #
+    def radio_button(name, locator)
+      define_method(name) do
+        platform.click_radio_button(locator)
+      end
+    end
+  end
+end
+  

data/lib/gametel/navigation.rb

@@ -0,0 +1,9 @@
+module Gametel
+  module Navigation
+    def on(cls, &block)
+      @current_screen = cls.new
+      block.call @current_screen if block
+      @current_screen
+    end
+  end
+end

data/lib/gametel/platforms/calabash.rb

@@ -0,0 +1,89 @@
+require 'calabash-android/operations'
+
+include Calabash::Android::Operations
+
+module Gametel
+  module Platforms
+    class Calabash
+
+      #
+      # enter text in a text box
+      #
+      def enter_text(text, locator)
+        performAction('enter_text_into_named_field', text, locator[:name]) if locator[:name]
+        performAction('enter_text_into_numbered_field', text, locator[:index] + 1) if locator[:index]
+      end
+
+      #
+      # press a button
+      #
+      def press_button(locator)
+        performAction 'press_button_with_text', locator[:text] if locator[:text]
+        performAction 'press_button_number', locator[:index] + 1 if locator[:index]
+      end
+
+      #
+      # press a list item
+      #
+      def press_list_item(locator)
+        performAction 'press_list_item', locator[:index] + 1, 0 if locator[:index]
+        performAction 'click_on_text', locator[:text] if locator[:text]
+      end
+      
+      #
+      # click a checkbox
+      #
+      def click_checkbox(locator)
+        performAction 'toggle_numbered_checkbox', locator[:index] + 1 if locator[:index]
+        performAction 'click_on_text', locator[:text] if locator[:text]
+      end
+
+      #
+      # click a radio button
+      #
+      def click_radio_button(locator)
+        performAction 'click_on_text', locator[:text] if locator[:text]
+      end
+
+      #
+      # determine if text exists on the screen
+      #
+      def has_text?(text)
+        begin
+          performAction 'assert_text', text, true
+        rescue
+          return false
+        end
+        true
+      end
+
+      #
+      # press the back button
+      #
+      def back
+        performAction 'go_back'
+      end
+
+      #
+      # scroll down
+      #
+      def scroll_down
+        performAction 'scroll_down'
+      end
+
+      #
+      # scroll up
+      #
+      def scroll_up
+        performAction 'scroll_up'
+      end
+
+      #
+      # wait for text to appear on the screen
+      #
+      def wait_for_text(text_to_find)
+        performAction 'wait_for_text', text_to_find
+      end
+    end
+  end
+end

data/lib/gametel/version.rb

@@ -0,0 +1,3 @@
+module Gametel
+  VERSION = "0.1"
+end

data/spec/lib/gametel/accessors_spec.rb

@@ -0,0 +1,67 @@
+require 'spec_helper'
+
+class AccessorsSampleScreen
+  include Gametel
+
+  list_item(:first_list_item_text, :text => 'first item')
+  list_item(:first_list_item_index, :index => 0)
+  text(:first_name_index, :index => 2)
+  text(:first_name_name, :name => 'Some name')
+  button(:save_text, :text => 'Save')
+  button(:save_index, :index => 1)
+  checkbox(:checkbox_index, :index => 0)
+  checkbox(:checkbox_text, :text => 'Checkbox 2')
+  radio_button(:radio_text, :text => 'Radio Button 1')
+end
+
+describe Gametel::Accessors do
+  context "when using Calabash" do
+    let(:screen) { AccessorsSampleScreen.new }
+    let(:platform) { calabash_platform(screen) }
+    
+    it "should know how to press a list item by text" do
+      platform.should_receive(:performAction).with('click_on_text', 'first item')
+      screen.first_list_item_text
+    end
+
+    it "should know how to press a list item by index" do
+      platform.should_receive(:performAction).with('press_list_item', 1, 0)
+      screen.first_list_item_index
+    end
+
+    it "should know how to enter text into a text field using index" do
+      platform.should_receive(:performAction).with('enter_text_into_numbered_field', 'blah', 3)
+      screen.first_name_index = 'blah'
+    end
+
+    it "should know how to enter text into a text field using the name" do
+      platform.should_receive(:performAction).with('enter_text_into_named_field', 'blah', 'Some name')
+      screen.first_name_name = 'blah'
+    end
+
+    it "should know how to press a button by text" do
+      platform.should_receive(:performAction).with('press_button_with_text', 'Save')
+      screen.save_text
+    end
+
+    it "should know how to press a button by index" do
+      platform.should_receive(:performAction).with('press_button_number', 2)
+      screen.save_index
+    end
+
+    it "should know how to check a checkbox by index" do
+      platform.should_receive(:performAction).with('toggle_numbered_checkbox', 1)
+      screen.checkbox_index
+    end
+
+    it "should know how to check a checkbox by text" do
+      platform.should_receive(:performAction).with('click_on_text', 'Checkbox 2')
+      screen.checkbox_text
+    end
+
+    it "should know how to click a radio button by text" do
+      platform.should_receive(:performAction).with('click_on_text', 'Radio Button 1')
+      screen.radio_text
+    end
+  end
+end

data/spec/lib/gametel_spec.rb

@@ -0,0 +1,44 @@
+require 'spec_helper'
+
+class GametelSampleScreen
+  include Gametel
+end
+
+describe Gametel do
+
+  it "should initialize the platform to Calabash when no other platform is specified" do
+    screen = GametelSampleScreen.new
+    platform = screen.instance_variable_get(:@platform)
+    platform.should be_instance_of ::Gametel::Platforms::Calabash
+  end
+
+  it "should add the accessors to the class when included" do
+    GametelSampleScreen.should respond_to :text
+    GametelSampleScreen.should respond_to :button
+  end
+  
+  context "when using Calabash" do
+    let(:screen) { GametelSampleScreen.new }
+    let(:platform) { calabash_platform(screen) }
+          
+    it "should know when a sceen has text" do
+      platform.should_receive(:performAction).with('assert_text', 'blah', true).and_return(true)
+      screen.has_text? "blah"
+    end
+
+    it "should know how to press the back button" do
+      platform.should_receive(:performAction).with('go_back')
+      screen.back
+    end
+
+    it "should know how to scroll down" do
+      platform.should_receive(:performAction).with('scroll_down')
+      screen.scroll_down
+    end
+
+    it "should know how to scroll up" do
+      platform.should_receive(:performAction).with('scroll_up')
+      screen.scroll_up
+    end
+  end
+end