furter 0.0.3

data/lib/furter/accessors/alert_button.rb

@@ -0,0 +1,18 @@
+module Furter
+  module Accessors
+    class AlertButton < View
+      include Frank::Cucumber::FrankHelper
+
+      def click
+        wait_for_nothing_to_be_animating
+        super
+      end
+
+      private
+      def selector
+        "view:'UIAlertView' view:'UIAlertButton' marked:'#{@locator[:text]}'"
+      end
+    end
+  end
+end
+

data/lib/furter/accessors/button.rb

@@ -0,0 +1,17 @@
+module Furter
+  module Accessors
+    class Button < View
+      private
+      def view_class
+        case
+          when @locator[:type]
+            "view:'#{@locator[:type]}'"
+          when @locator[:text]
+            "button label"
+          else
+            "button"
+        end
+      end
+    end
+  end
+end

data/lib/furter/accessors/label.rb

@@ -0,0 +1,13 @@
+module Furter
+  module Accessors
+    class Label < View
+      def view_class
+        'label'
+      end
+
+      def text
+        frankly_map(selector, 'text')[0]
+      end
+    end
+  end
+end

data/lib/furter/accessors/map_pin.rb

@@ -0,0 +1,18 @@
+module Furter
+  module Accessors
+    class MapPin < View
+      include Frank::Cucumber::FrankHelper
+
+      def click
+        wait_for_nothing_to_be_animating
+        super
+      end
+
+      private
+      def selector
+        "view:'MKPinAnnotationView' marked:'#{@locator[:text]}'"
+      end
+    end
+  end
+end
+

data/lib/furter/accessors/switch.rb

@@ -0,0 +1,20 @@
+module Furter
+  module Accessors
+    class Switch < View
+      include Furter
+
+      def on?
+        frankly_map(selector, 'isOn')[0]
+      end
+
+      def set(on_or_off)
+        click if on_or_off != on?
+      end
+
+      private
+      def view_class
+        "view:'UISwitch'"
+      end
+    end
+  end
+end

data/lib/furter/accessors/table.rb

@@ -0,0 +1,15 @@
+module Furter
+  module Accessors
+    class Table < View
+      def options
+        frankly_map("#{selector} label", "text").compact.map(&:strip).reject(&:empty?)
+      end
+
+      private
+      def selector
+        "view:'UITableView' marked:'#{@locator[:label]}'"
+      end
+    end
+  end
+end
+

data/lib/furter/accessors/table_item.rb

@@ -0,0 +1,10 @@
+module Furter
+  module Accessors
+    class TableItem < Button
+      private
+      def selector
+        "label marked:'#{@locator[:text]}' parent tableViewCell"
+      end
+    end
+  end
+end

data/lib/furter/accessors/text.rb

@@ -0,0 +1,27 @@
+module Furter
+  module Accessors
+    class Text < View
+      alias_method :editable?, :enabled?
+
+      def get_text
+        frankly_map(selector, "text")[0]
+      end
+
+      def set_text(text)
+        frankly_map(selector, "becomeFirstResponder")
+        frankly_map(selector, "setText:", text)
+        frankly_map(selector, "endEditing:", true)
+      end
+
+      def has_text?(text)
+        element_exists "view marked:'#{text}'"
+      end
+
+      private
+      def selector
+        return "textField placeholder:'#{@locator[:placeholder]}'" if @locator[:placeholder]
+        return "textField marked:'#{@locator[:label]}'" if @locator[:label]
+      end
+    end
+  end
+end

data/lib/furter/accessors/view.rb

@@ -0,0 +1,46 @@
+module Furter
+  module Accessors
+    class View
+      include Furter, Frank::Cucumber::FrankHelper, Frank::Cucumber::WaitHelper
+
+      def initialize(locator={})
+        @locator = locator
+      end
+
+      def click
+        wait_for_and_touch selector
+      end
+
+      def visible?
+        element_is_not_hidden selector
+      end
+
+      def enabled?
+        frankly_map(selector, 'isEnabled')[0]
+      end
+
+      private
+      def selector
+        "#{view_class} #{selector_how}#{selector_extra}"
+      end
+
+      def selector_how
+        case
+          when @locator[:label]
+            "marked:'#{@locator[:label]}'"
+          when @locator[:text]
+            "text:'#{@locator[:text]}'"
+        end
+      end
+
+      def selector_extra
+        " #{@locator[:extra]}" if @locator[:extra]
+      end
+
+      def view_class
+        return "view:'#{@locator[:type]}'" if @locator[:type]
+        "view"
+      end
+    end
+  end
+end

data/lib/furter/navigation.rb

@@ -0,0 +1,25 @@
+require 'page_navigation'
+
+module Furter
+  module Navigation
+    include PageNavigation, Frank::Cucumber::FrankHelper
+
+    def wait_a_bit_for_animations
+      begin
+        wait_for_nothing_to_be_animating 3
+      rescue
+      end
+    end
+
+    def on(cls, &block)
+      screen = cls.new
+      wait_a_bit_for_animations
+      wait_until(:message => "Expected #{cls} to be active", :timeout => 30) do
+        screen.active?
+      end
+      wait_a_bit_for_animations
+      block.call screen if block
+      screen
+    end
+  end
+end

data/lib/furter/version.rb

@@ -0,0 +1,3 @@
+module Furter
+  VERSION = "0.0.3"
+end

data/spec/lib/furter/accessors/button_spec.rb

@@ -0,0 +1,23 @@
+require 'spec_helper'
+
+describe Furter::Accessors::Button do
+  let(:button) { Furter::Accessors::Button.new(:text => 'Some Text') }
+  let(:selector) { button.send(:selector) }
+
+  context 'locating buttons' do
+    it 'can be found by text' do
+      text_button = Furter::Accessors::Button.new(:text => 'Some Text')
+      text_button.send(:selector).should eq("button label text:'Some Text'")
+    end
+
+    it ':text is the same as :label' do
+      label_button = Furter::Accessors::Button.new(:label => 'Some Text')
+      label_button.send(:selector).should eq("button marked:'Some Text'")
+    end
+
+    it 'can be a custom button type as well' do
+      custom_button = Furter::Accessors::Button.new(:label => 'Some Label', :type => 'MyButtonType')
+      custom_button.send(:selector).should eq("view:'MyButtonType' marked:'Some Label'")
+    end
+  end
+end

data/spec/lib/furter/accessors/label_spec.rb

@@ -0,0 +1,24 @@
+require 'spec_helper'
+
+describe Furter::Accessors::Label do
+  let(:label) { Furter::Accessors::Label.new(:label => 'someLabel')}
+  let(:selector) { label.send(:selector) }
+
+  context 'locating labels' do
+    it 'can be found by accessibility label' do
+      label_control = Furter::Accessors::Label.new(:label => 'someAccessibilityLabel')
+      label_control.send(:selector).should eq("label marked:'someAccessibilityLabel'")
+    end
+
+    it 'can be found by text' do
+      label_control = Furter::Accessors::Label.new(:text => 'Text Value')
+      label_control.send(:selector).should eq("label text:'Text Value'")
+    end
+  end
+
+  it 'knows the text value' do
+    label.should_receive(:frankly_map).with(selector, 'text').and_return(['expected text'])
+    label.text.should eq('expected text')
+  end
+end
+

data/spec/lib/furter/accessors/switch_spec.rb

@@ -0,0 +1,28 @@
+require 'spec_helper'
+
+describe Furter::Accessors::Switch do
+  let(:switch) { Furter::Accessors::Switch.new(:label => 'accessibilityLabel') }
+
+  context 'locating switches' do
+    it 'can be found by label' do
+      switch.send(:selector).should eq("view:'UISwitch' marked:'accessibilityLabel'")
+    end
+  end
+
+  it 'knows if it is on' do
+    switch.should_receive(:frankly_map).with(anything, 'isOn').and_return([false])
+    switch.should_not be_on
+  end
+
+  it 'can turn it off or on' do
+    switch.should_receive(:on?).and_return(true, false)
+    switch.should_receive(:click).twice
+    [false, true].each { |on_or_off| switch.set on_or_off }
+  end
+
+  it 'will only toggle if in the expected state' do
+    switch.should_receive(:frankly_map).with(anything, 'isOn').and_return([false])
+    switch.should_not_receive(:click)
+    switch.set false
+  end
+end

data/spec/lib/furter/accessors/text_spec.rb

@@ -0,0 +1,39 @@
+require 'spec_helper'
+
+describe Furter::Accessors::Text do
+  let(:placeholder) { Furter::Accessors::Text.new(:placeholder => 'Placeholder Text') }
+  let(:label) { Furter::Accessors::Text.new(:label => 'accessibilityLabel') }
+
+  context 'locating text fields' do
+    it 'should work by placeholder' do
+      placeholder.send(:selector).should eq("textField placeholder:'Placeholder Text'")
+    end
+
+    it 'should work by accessibility label' do
+      label.send(:selector).should eq("textField marked:'accessibilityLabel'")
+    end
+  end
+
+  it 'can get text' do
+    placeholder.should_receive(:frankly_map).with(anything, 'text').and_return(['expected text'])
+    placeholder.get_text.should eq('expected text')
+  end
+
+  it 'can set text' do
+    placeholder.should_receive(:frankly_map).with(anything, 'becomeFirstResponder').ordered
+    placeholder.should_receive(:frankly_map).with(anything, 'setText:', 'the new text').ordered
+    placeholder.should_receive(:frankly_map).with(anything, 'endEditing:', true).ordered
+
+    placeholder.set_text 'the new text'
+  end
+
+  it 'knows if text exists anywhere' do
+    placeholder.should_receive(:element_exists).with("view marked:'to find anywhere'")
+    placeholder.has_text? 'to find anywhere'
+  end
+
+  it 'knows whether we are editable or not' do
+    placeholder.should_receive(:frankly_map).with(anything, 'isEnabled').and_return([true])
+    placeholder.should be_enabled
+  end
+end

data/spec/lib/furter/accessors/view_spec.rb

@@ -0,0 +1,43 @@
+require 'spec_helper'
+
+describe Furter::Accessors::View do
+  let(:view) { Furter::Accessors::View.new(:label => 'id') }
+  let(:selector) { view.send(:selector) }
+
+  context 'locating views' do
+    it 'can be found by accessibility label' do
+      by_label = Furter::Accessors::View.new(:label => 'id')
+      by_label.send(:selector).should eq("view marked:'id'")
+    end
+
+    it 'can use a custom type' do
+      by_type = Furter::Accessors::View.new(:type => 'UICustomType', :label => 'id')
+      by_type.send(:selector).should eq("view:'UICustomType' marked:'id'")
+    end
+
+    it 'can pass extra information as well' do
+      with_extras = Furter::Accessors::View.new(:label => 'id', :extra => 'label')
+      with_extras.send(:selector).should eq("view marked:'id' label")
+    end
+
+    it 'can be found by text' do
+      by_text = Furter::Accessors::View.new(:text => "Some Text")
+      by_text.send(:selector).should eq("view text:'Some Text'")
+    end
+  end
+
+  it 'can be clicked' do
+    view.should_receive(:wait_for_and_touch).with(selector)
+    view.click
+  end
+
+  it 'knows if it is visible' do
+    view.should_receive(:element_is_not_hidden).with(selector).and_return(true)
+    view.should be_visible
+  end
+
+  it 'knows if it is enabled' do
+    view.should_receive(:frankly_map).with(selector, 'isEnabled').and_return([true])
+    view.should be_enabled
+  end
+end

data/spec/lib/furter/accessors_spec.rb

@@ -0,0 +1,116 @@
+require 'spec_helper'
+
+class SomePage
+  include Furter
+
+  text(:text_field, :placeholder => 'text')
+  label(:label_field, :label => 'id')
+  view(:generic_view, :label => 'id')
+  button(:button_field, :label => 'id')
+  switch(:switch_field, :label => 'id')
+end
+
+describe Furter::Accessors do
+  let(:screen) { SomePage.new }
+
+  context 'text' do
+    let(:text) { double('Text accessor') }
+
+    before(:each) do
+      Furter::Accessors::Text.should_receive(:new).with(:placeholder => 'text').and_return(text)
+    end
+
+    it 'can be returned' do
+      text.should_receive(:get_text)
+      screen.text_field
+    end
+
+    it 'can be set' do
+      text.should_receive(:set_text).with('new text')
+      screen.text_field = 'new text'
+    end
+
+    it 'has editability' do
+      text.should_receive(:editable?).and_return(false)
+      screen.should_not be_text_field_editable
+    end
+
+    it 'can dish out a view' do
+      screen.text_field_view.should be(text)
+    end
+  end
+
+  context 'label' do
+    let(:label) { double('Label control') }
+
+    before(:each) do
+      Furter::Accessors::Label.should_receive(:new).with(:label => 'id').and_return(label)
+    end
+
+    it 'knows its value' do
+      label.should_receive(:text).and_return('expected text')
+      screen.label_field.should eq('expected text')
+    end
+
+    it 'can dish out a view' do
+      screen.label_field_view.should be(label)
+    end
+
+  end
+
+  context 'view' do
+    let(:view) { double('View accessor') }
+
+    before(:each) do
+      Furter::Accessors::View.should_receive(:new).with(:label => 'id').and_return(view)
+    end
+
+    it 'can be clicked' do
+      view.should_receive(:click)
+      screen.generic_view
+    end
+
+    it 'can return the raw view' do
+      screen.generic_view_view.should be(view)
+    end
+  end
+
+  context 'button' do
+    let(:button) { double('Button accessor') }
+
+    before(:each) do
+      Furter::Accessors::Button.should_receive(:new).with(:label => 'id').and_return(button)
+    end
+
+    it 'can be clicked' do
+      button.should_receive(:click)
+      screen.button_field
+    end
+
+    it 'can return the raw view' do
+      screen.button_field_view.should be(button)
+    end
+  end
+
+  context 'switch' do
+    let(:switch) { double('Switch accessor') }
+
+    before(:each) do
+      Furter::Accessors::Switch.should_receive(:new).with(:label => 'id').and_return(switch)
+    end
+
+    it 'is aware of its state' do
+      switch.should_receive(:on?).and_return(true)
+      screen.switch_field.should be_true
+    end
+
+    it 'can be turned on or off' do
+      switch.should_receive(:set).with(false)
+      screen.switch_field = false
+    end
+
+    it 'can return the raw view' do
+      screen.switch_field_view.should be(switch)
+    end
+  end
+end