rufus 0.1 → 0.3

data/features/alert.feature

@@ -0,0 +1,16 @@
+Feature: Interacting with alerts
+
+  Background:
+    Given I am on the "HomePage"
+    When I click the view defined "show_alert"
+
+  Scenario: Getting the title of an alert view
+    Then I see the title of the alert defined "alert" is "Rufus Alert"
+
+  Scenario: Selecting action button in alert view
+    And I select the "Ok" button on the alert defined "alert"
+    Then I am on the "RufusPage"
+
+  Scenario: Selecting cancel button in alert view
+    And I select the "Cancel" button on the alert defined "alert"
+    Then I am on the "HomePage"

data/features/step_definitions/alert_steps.rb.rb

@@ -0,0 +1,4 @@
+
+When(/^I select the "([^"]*)" button on the alert defined "([^"]*)"$/) do |button, alert|
+  on(HomePage).send("#{alert}_view").click button
+end

data/features/step_definitions/view_steps.rb

@@ -9,4 +9,10 @@ Then(/^I can find the "([^"]*)" view defined by "([^"]*)"$/) do |which, how|
 end
 Given(/^I start the driver$/) do
  puts selenium
+end
+Then(/^I am presented with an alert with the title "([^"]*)"$/) do |title|
+
+end
+Then(/^I see the title of the alert defined "([^"]*)" is "([^"]*)"$/) do |alert, title|
+  on(HomePage).send("#{alert}_view").title.should == title
 end

data/features/support/hooks.rb

@@ -0,0 +1,3 @@
+Before do
+  puts selenium
+end

data/features/support/screens/home_page.rb

@@ -4,6 +4,9 @@ class HomePage
   include Rufus
 
   view(:view_rufus, :name =>'rufusButton')
+  button(:view_show_alert, :name => 'showAlertButton')
+  alert(:alert, :name => 'Rufus Alert')
+
 
   def active?
      view_rufus_view.exists?

data/features/view.feature

@@ -1,10 +1,6 @@
 Feature: Interacting with views
-  There are some things here that we can use
 
-  Background: Launch
-    Given I start the driver
-
-    Scenario:  Clicking a view
+   Scenario:  Clicking a view
     Given I am on the "HomePage"
     When I click the view defined "rufus"
-    Then I am on the "RufusPage"
+    Then I am on the "RufusPage"

data/lib/rufus/accessors/accessors.rb

@@ -21,5 +21,9 @@ module Rufus
     def button(name, locator)
       view(name, locator)
     end
+
+    def alert(name, locator)
+      view(name, locator)
+    end
   end
 end

data/lib/rufus/accessors/view.rb

@@ -33,6 +33,10 @@ module Rufus
         selenium.find(what).send_keys keys
       end
 
+      def class
+        selenium.find(what).tag_name
+      end
+
       def what
         key = @locator.keys[0].to_sym
         value = @locator[key]

data/lib/rufus/driver.rb

@@ -1,18 +1,15 @@
 require 'yaml'
+require 'rufus/drivers/iOS_device'
+require 'rufus/drivers/iOS_simulator'
 require 'selenium-webdriver'
 
 module Rufus
   class Driver
 
     def initialize
-      @config = YAML.load_file('config.yml') unless !File.exists?('config.yml')
-
-      if @config["appium_url"].nil? || @config["appium_url"].eql?("")
-        @url = 'http://127.0.0.1:4723/wd/hub'
-      else
-        @url = @config["appium_url"]
-      end
-
+      raise 'No config.yml found' if !File.exists?('config.yml')
+      @config = YAML.load_file('config.yml')
+      @url = url(@config)
     end
 
     def start
@@ -98,23 +95,82 @@ module Rufus
       end
     end
 
+    def find_alert(locator)
+      alert = nil
+      all_elements.each do |element|
+        if is_alert?(element)
+          alert = element if match?(element, locator[:name])
+        end
+      end
+      alert
+    end
+
+    def click_alert(button)
+      if alert_shown?
+        click_alert_button(button)
+      end
+    end
+
+    def alert_shown?
+      all_elements.each do |element|
+        if is_alert?(element)
+          return true
+        end
+      end
+      false
+    end
+
+    def class_for(element)
+      element.tag_name
+    end
+
+    def match?(element, name)
+      element.attribute(:name).eql? name
+    end
+
     private
+
+    def url(config)
+      if config["appium_url"].nil? || config["appium_url"].eql?("")
+        'http://127.0.0.1:4723/wd/hub'
+      else
+        config["appium_url"]
+      end
+    end
+
+    def click_alert_button(button)
+      all_elements.each do |element|
+        element.click if is_table_view_cell?(element) && match?(element, button)
+      end
+    end
+
+    def is_alert?(element)
+      class_for(element).eql?('UIAAlert')
+    end
+
+    def is_table_view_cell?(element)
+      class_for(element).eql?('UIATableCell')
+    end
+
+    def all_elements
+     elements_by_tag('UIAElement')
+    end
+
     def elements_by_tag(name)
       driver.find_elements(:tag_name, name)
     end
 
-    private
-    def capabilities
-      {
-          'browserName' => @config["browser"],
-          'platform' => @config["platform"],
-          'version' => @config["version"].to_s,
-          'app' => @config["app"]
-      }
+    def driver
+      if use_device
+        @selenium ||= Rufus::Drivers::IOS_Device.for(@config,@url)
+      else
+        @selenium ||= Rufus::Drivers::IOS_Simulator.for(@config,@url)
+      end
     end
 
-    def driver
-      @selenium ||= Selenium::WebDriver.for(:remote, :desired_capabilities => capabilities, :url => @url)
+    def use_device
+      @config["use_physical"] == true
     end
+
   end
 end

data/lib/rufus/drivers/iOS_device.rb

@@ -0,0 +1,23 @@
+require 'selenium-webdriver'
+
+module Rufus
+  module Drivers
+    class IOS_Device
+
+      def self.for(config,url)
+        @config = config
+         Selenium::WebDriver.for(:remote, :desired_capabilities => capabilities, :url => url)
+
+      end
+
+      def self.capabilities
+        {
+            'browserName' => @config["browser"],
+            'platform' => @config["platform"],
+            'version' => @config["version"].to_s,
+            'app' => @config["app"]
+        }
+      end
+    end
+  end
+end

data/lib/rufus/drivers/iOS_simulator.rb

@@ -0,0 +1,25 @@
+require 'selenium-webdriver'
+
+module Rufus
+  module Drivers
+    class IOS_Simulator
+
+      def self.for(config,url)
+        @config = config
+         Selenium::WebDriver.for(:remote, :desired_capabilities => capabilities, :url => url)
+      end
+
+
+      private
+      def self.capabilities
+        {
+            'browserName' => @config["browser"],
+            'platform' => @config["platform"],
+            'version' => @config["version"].to_s,
+            'app' => @config["sim_app_path"],
+            'device' => "iPhoneSimulator"
+        }
+      end
+    end
+  end
+end

data/rufus.gemspec

@@ -1,13 +1,14 @@
 Gem::Specification.new do |gem|
   gem.name          = "rufus"
-  gem.version       = "0.1"
+  gem.version       = "0.3"
   gem.authors       = ["Jeremy Stewart"]
   gem.email         = ["jlstewart379@gmail.com"]
   gem.description   = "Page object wrapper for Appium"
   gem.summary       = "Page object wrapper for Appium"
   gem.homepage      = "https://github.com/jlstewart379/rufus"
   gem.require_paths = ["lib"]
+  gem.license = 'MIT'
   gem.files         = `git ls-files`.split($/)
   gem.add_dependency 'page_navigation', '>= 0.7'
   gem.add_development_dependency 'rspec'
-end
+end

data/spec/{driver_spec.rb → drivers_specs/driver_spec.rb}

@@ -1,5 +1,7 @@
 require 'spec_helper'
 require 'rufus/driver'
+require 'rufus/drivers/iOS_device'
+require 'rufus/drivers/iOS_simulator'
 require 'yaml'
 
 describe Rufus::Driver do
@@ -10,22 +12,33 @@ describe Rufus::Driver do
 
     let(:yaml){double('YAML loader')}
 
-
-    before(:each) do
-      File.stub(:exists?).and_return(true)
-      YAML.should_receive(:load_file).with("config.yml").and_return("browser_name" =>"iOS", "platform"=>"Mac", "version"=>"6.1", "app"=>"/Users/app/path/rufus.app")
-      @driver = Rufus::Driver.new
+    context 'config file exists' do
+      before(:each) do
+        File.stub(:exists?).and_return(true)
+        YAML.should_receive(:load_file).with("config.yml").and_return("browser_name" =>"iOS", "platform"=>"Mac", "version"=>"6.1", "app"=>"/Users/app/path/rufus.app")
+        @driver = Rufus::Driver.new
+      end
+      it 'loads the config file' do
+        config = @driver.config
+        config["browser_name"].should eq("iOS")
+        config["platform"].should eq("Mac")
+        config["version"].should eq("6.1")
+        config["app"].should eq("/Users/app/path/rufus.app")
+      end
     end
+    context 'config file does not exists' do
 
-    it 'loads the config file' do
+      before(:each) do
+        File.stub(:exists?).and_return(false)
+      end
 
-      config = @driver.config
-      config["browser_name"].should eq("iOS")
-      config["platform"].should eq("Mac")
-      config["version"].should eq("6.1")
-      config["app"].should eq("/Users/app/path/rufus.app")
+      it 'raises an exception if no config found' do
+
+        expect{Rufus::Driver.new}.to raise_error(RuntimeError, 'No config.yml found')
+      end
     end
 
+
  end
 
   context 'dealing with elements' do
@@ -149,4 +162,118 @@ describe Rufus::Driver do
 
     end
   end
+
+  context 'finding alerts' do
+
+    let(:mock_driver){double('mock selenium driver')}
+    let(:mock_alert){double('mock alert view')}
+    let(:mock_elements){double('mock elements')}
+    let(:mock_element){double('mock element')}
+
+    before(:each) do
+      File.stub(:exists?).and_return(true)
+      YAML.should_receive(:load_file).with("config.yml").and_return("browser_name" =>"iOS", "platform"=>"Mac", "version"=>"6.1", "app"=>"/Users/app/path/rufus.app")
+      @driver = Rufus::Driver.new
+      Selenium::WebDriver.should_receive(:for).and_return(mock_driver)
+    end
+  end
+
+  context 'searching elements' do
+    let(:mock_element){double('mock element')}
+    let(:mock_driver){double('mock selenium driver')}
+
+    before(:each) do
+      File.stub(:exists?).and_return(true)
+      YAML.should_receive(:load_file).with("config.yml").and_return("browser_name" =>"iOS", "platform"=>"Mac", "version"=>"6.1", "app"=>"/Users/app/path/rufus.app")
+      @driver = Rufus::Driver.new
+    end
+
+    it 'can find the class for an element' do
+      mock_element.should_receive(:tag_name).and_return('UIAAlert')
+      @driver.class_for(mock_element).should eq('UIAAlert')
+    end
+
+    context 'matching elements by name' do
+      it 'returns true if element matches' do
+        mock_element.should_receive(:attribute).with(:name).and_return('Rufus Alert')
+        @driver.match?(mock_element, 'Rufus Alert').should be_true
+      end
+      it 'returns false if element does not match' do
+        mock_element.should_receive(:attribute).with(:name).and_return('Some other alert title')
+        @driver.match?(mock_element, 'Rufus Alert').should be_false
+      end
+    end
+
+    context 'clicking alert view buttons' do
+
+      let(:mock_element){double{'mock element'}}
+      let(:mock_driver){double('mock selenium driver')}
+
+      before(:each) do
+        File.stub(:exists?).and_return(true)
+        YAML.should_receive(:load_file).with("config.yml").and_return("browser_name" =>"iOS", "platform"=>"Mac", "version"=>"6.1", "app"=>"/Users/app/path/rufus.app")
+        @driver = Rufus::Driver.new
+
+      end
+
+      it 'can tell if an alert is in the view hierarchy' do
+        mock_element.should_receive(:tag_name).and_return('UIAAlert')
+        @driver.send(:is_alert?, mock_element).should be_true
+      end
+      it 'can tell if an alert is not in the view hierarchy' do
+        mock_element.should_receive(:tag_name).and_return('SomeOtherClass')
+        @driver.send(:is_alert?, mock_element).should be_false
+      end
+
+      it 'can tell if a table cell is in the view hierarchy' do
+        mock_element.should_receive(:tag_name).and_return('UIATableCell')
+        @driver.send(:is_table_view_cell?, mock_element).should be_true
+      end
+
+      it 'can click an alert button' do
+        mock_driver.should_receive(:find_elements).at_least(2).times.with(:tag_name, 'UIAElement').and_return([mock_element])
+        Selenium::WebDriver.should_receive(:for).and_return(mock_driver)
+        mock_element.should_receive(:tag_name).at_least(2).times.and_return('UIAAlert')
+        @driver.click_alert('Ok')
+      end
+    end
+
+
+    context 'starting drivers' do
+
+      let(:yaml){double('YAML loader')}
+      let(:mock_driver){'a mock app driver'}
+      let(:url){'http://127.0.0.1:4723/wd/hub'}
+
+      context 'starting iOS device driver' do
+        before(:each) do
+          File.stub(:exists?).and_return(true)
+          @config = {"browser_name" =>"iOS", "platform"=>"Mac", "version"=>"6.1", "app"=>"/Users/app/path/rufus.app", "use_physical" => true}
+          YAML.should_receive(:load_file).with("config.yml").and_return(@config)
+          @driver = Rufus::Driver.new
+        end
+
+        it 'can start the driver for an iOS device' do
+            Rufus::Drivers::IOS_Device.should_receive(:for).with(@config, url).and_return(mock_driver)
+            mock_driver.should_receive(:get)
+            @driver.start
+        end
+      end
+
+      context 'starting iOS simulator driver' do
+        before(:each) do
+          File.stub(:exists?).and_return(true)
+          @config = {"browser_name" =>"iOS", "platform"=>"Mac", "version"=>"6.1", "app"=>"/Users/app/path/rufus.app", "use_physical" => false}
+          YAML.should_receive(:load_file).with("config.yml").and_return(@config)
+          @driver = Rufus::Driver.new
+        end
+
+        it 'can start the driver for an iOS simulator' do
+          Rufus::Drivers::IOS_Simulator.should_receive(:for).with(@config, url).and_return(mock_driver)
+          mock_driver.should_receive(:get)
+          @driver.start
+        end
+      end
+    end
+  end
 end