furter 0.0.3 → 0.0.3.1

data/.travis.yml

@@ -1,2 +1,5 @@
 language: ruby
 rvm: 1.9.3
+before_install:
+  - sudo apt-get update -qq
+  - sudo apt-get install -qq libavahi-compat-libdnssd-dev

data/Changelog

@@ -1,3 +1,7 @@
+=== Version 0.3.1 / 2013-04-23
+* added a new slider accessor
+* added a views accessor to define which view controllers should be on a screen
+
 === Version 0.3 / 2013-04-03
 Initial release with support for text, label, button, view, alert_button,
 table, table_item, map_pin and switch controls

data/README.md

@@ -1,20 +1,76 @@
 # Furter
 
-TODO: Write a gem description
+A gem to assist in building page-object like structures for testing iOS applications.  `furter` uses [`frank-cucumber`](http://testingwithfrank.com/) to automate iOS applications using page-objects.
 
 ## Installation
 
 Add this line to your application's Gemfile:
 
-    gem 'furter', :git => 'https://github.com/leviwilson/furter.git'
+    source 'https://rubygems.org'
+    gem 'furter'
 
 And then execute:
 
     $ bundle
+    
+### Setting Up Cucumber
+After your `Gemfile` has been updated, add these lines to your `features/support/env.rb` file in `cucumber`:
 
-## Usage
+```ruby
+require 'furter'
+require 'rspec-expectations'
 
-TODO: Write usage instructions here
+World(Furter::Navigation)
+
+APP_BUNDLE_PATH = File.expand_path( '../../../Frank/frankified_build/YourApp.app', __FILE__ )
+
+Frank::Cucumber::FrankHelper.use_shelley_from_now_on
+
+Before do
+  version = '6.1'
+  idiom = 'iPhone'
+  
+  launch_app APP_BUNDLE_PATH, version, idiom
+end
+```
+
+## Defining Screens
+Simply create a new class that describes the screen that you are working with and include `Furter`.
+
+```ruby
+class LoginScreen
+  include Furter
+  
+  text(:username, :label => 'usernameField')
+  text(:password, :label => 'passwordField')
+  button(:login, :text => 'Login')
+end
+```
+
+In your step definition, use the `Furter::Navigation#on` method when using your page-object.  This method will create your screen and then wait until all animations have stopped before letting you interact with your page-object.
+
+```ruby
+When ^I login to my application$ do
+  on(LoginScreen) do |screen|
+    screen.username = 'user@example.com'
+    screen.password = '$3cr3t`
+    screen.login
+  end
+end
+```
+
+### Waiting for Screens
+If you would like for `furter` to wait until your screen becomes "active" (perhaps after some asynchronous call has come back), simply define an `active?` method and `furter` will wait until this returns `true` before interacting with it.
+
+```ruby
+class LandingScreen
+  include Furter
+  
+  def active?
+    has_text? 'You have successfully logged in!'
+  end
+end
+```
 
 ## Contributing
 

data/app/FurterApp/FurterApp/DetailViewController.h

@@ -15,6 +15,7 @@
 @property (weak, nonatomic) IBOutlet UIButton *textButton;
 @property (weak, nonatomic) IBOutlet UIButton *labeledButton;
 @property (weak, nonatomic) IBOutlet UILabel *labeledLabel;
+@property (weak, nonatomic) IBOutlet UISlider *slider;
 
 @property (strong, nonatomic) id detailItem;
 

data/app/FurterApp/FurterApp/DetailViewController.m

@@ -14,6 +14,7 @@
 @end
 
 @implementation DetailViewController
+@synthesize slider; 
 
 #pragma mark - Managing the detail item
 
@@ -47,6 +48,7 @@
     [self configureView];
     [self.labeledButton setAccessibilityLabel:@"labeledButtonId"];
     [self.labeledLabel setAccessibilityLabel:@"labelByAccessibilityLabel"];
+    [slider setAccessibilityLabel:@"sliderByLabel"]; 
 }
 
 - (void)didReceiveMemoryWarning

data/app/FurterApp/FurterApp/en.lproj/MainStoryboard_iPad.storyboard

@@ -107,6 +107,12 @@
                                     <segue destination="2m6-NE-oGx" kind="push" id="g3T-p0-Sec"/>
                                 </connections>
                             </button>
+                            <slider opaque="NO" contentMode="scaleToFill" contentHorizontalAlignment="center" contentVerticalAlignment="center" value="0.5" minValue="0.0" maxValue="1" translatesAutoresizingMaskIntoConstraints="NO" id="wB4-9F-vl7">
+                                <accessibility key="accessibilityConfiguration" label="sliderByLabel"/>
+                                <constraints>
+                                    <constraint firstAttribute="width" constant="288" id="dCS-tQ-uoe"/>
+                                </constraints>
+                            </slider>
                         </subviews>
                         <color key="backgroundColor" white="1" alpha="1" colorSpace="custom" customColorSpace="calibratedWhite"/>
                         <constraints>
@@ -125,6 +131,7 @@
                             <constraint firstItem="MgB-Y1-P3J" firstAttribute="leading" secondItem="HNa-e4-2od" secondAttribute="leading" type="default" id="TI6-aB-T6l"/>
                             <constraint firstItem="6Hu-uu-EUY" firstAttribute="trailing" secondItem="MgB-Y1-P3J" secondAttribute="trailing" type="default" id="Tkv-gE-Bb0"/>
                             <constraint firstItem="79f-eU-bDt" firstAttribute="top" secondItem="26" secondAttribute="top" constant="23" id="WAb-82-oiE"/>
+                            <constraint firstAttribute="bottom" secondItem="wB4-9F-vl7" secondAttribute="bottom" constant="250" id="bJ6-kP-IlL"/>
                             <constraint firstItem="HNa-e4-2od" firstAttribute="trailing" secondItem="mEd-bW-xG3" secondAttribute="trailing" type="default" id="e4T-wS-zIa"/>
                             <constraint firstItem="27" firstAttribute="centerY" secondItem="26" secondAttribute="centerY" type="default" id="fbb-bQ-YI1"/>
                             <constraint firstItem="MgB-Y1-P3J" firstAttribute="top" secondItem="26" secondAttribute="top" constant="120" id="fxO-Da-wfr"/>
@@ -133,6 +140,7 @@
                             <constraint firstItem="n4M-Kb-ePv" firstAttribute="trailing" secondItem="6Hu-uu-EUY" secondAttribute="trailing" type="default" id="kXJ-R6-5W3"/>
                             <constraint firstItem="79f-eU-bDt" firstAttribute="baseline" secondItem="mEd-bW-xG3" secondAttribute="baseline" type="default" id="piK-8v-q9x"/>
                             <constraint firstItem="Nyi-ck-8hR" firstAttribute="top" secondItem="nbu-fr-Znd" secondAttribute="top" type="default" id="wtS-Ul-nbp"/>
+                            <constraint firstItem="wB4-9F-vl7" firstAttribute="leading" secondItem="26" secondAttribute="leading" constant="206" id="zbX-ES-KTX"/>
                         </constraints>
                         <simulatedOrientationMetrics key="simulatedOrientationMetrics" orientation="landscapeRight"/>
                     </view>
@@ -144,6 +152,7 @@
                         <outlet property="labeledButton" destination="6Hu-uu-EUY" id="lP4-Wp-TLL"/>
                         <outlet property="labeledLabel" destination="27" id="GUQ-6K-Ygb"/>
                         <outlet property="placeholderTextField" destination="mEd-bW-xG3" id="WJN-WF-CeJ"/>
+                        <outlet property="slider" destination="wB4-9F-vl7" id="tyV-Zf-nQd"/>
                         <outlet property="textButton" destination="MgB-Y1-P3J" id="dgB-Uo-P2L"/>
                     </connections>
                 </viewController>

data/features/slider.feature

@@ -0,0 +1,9 @@
+Feature:  Working with sliders
+
+Scenario: Interacting with the slider
+    Then we can interact with the raw view of the slider identified by "label"
+
+Scenario: Getting and Setting value of the slider
+  Given we can interact with the raw view of the slider identified by "label"
+  When I set the progress of the slider identified by "label" to "0.2"
+  Then I can see the progress of the slider identified by "label" is "0.2"

data/features/step_definitions/navigation_steps.rb

@@ -4,4 +4,4 @@ end
 
 Then /^I should end up on the "([^"]*)"$/ do |where|
   on(where.to_class).should be_active
-end
+end

data/features/step_definitions/slider_steps.rb

@@ -0,0 +1,11 @@
+Then /^we can interact with the raw view of the slider identified by "([^"]*)"$/ do |how|
+  on(DetailPage).send("slider_#{how}_view").should be_kind_of(Furter::Accessors::View)
+end
+
+When /^I set the progress of the slider identified by "([^"]*)" to "([^"]*)"$/ do |how, value|
+  on(DetailPage).send("slider_#{how}_move", value.to_f)
+end
+
+Then /^I can see the progress of the slider identified by "([^"]*)" is "([^"]*)"$/ do |how, value|
+  on(DetailPage).send("slider_#{how}_progress").should eq(value.to_f)
+end

data/features/support/screens/detail.rb

@@ -12,4 +12,8 @@ class DetailPage
   button(:go_elsewhere, :text => 'Go Elsewhere')
 
   switch(:switch_toggle, :label => 'switchToggle')
+
+  slider(:slider_label, :label=> 'sliderByLabel')
+
+  views('DetailViewController')
 end

data/lib/furter.rb

@@ -10,6 +10,7 @@ require 'furter/accessors/table'
 require 'furter/accessors/table_item'
 require 'furter/accessors/text'
 require 'furter/accessors/label'
+require 'furter/accessors/slider'
 
 module Furter
   include Frank::Cucumber::FrankHelper
@@ -46,8 +47,7 @@ module Furter
       touch locator
     end
   end
-
-  def active?
-    true
-  end
 end
+
+
+

data/lib/furter/accessors.rb

@@ -83,5 +83,23 @@ module Furter
         Furter::Accessors::Switch.new(locator)
       end
     end
+
+    def slider(name, locator)
+      define_method("#{name}_view") do
+        Furter::Accessors::Slider.new(locator)
+      end
+      define_method("#{name}_move") do |value|
+        Furter::Accessors::Slider.new(locator).move value
+      end
+      define_method("#{name}_progress") do
+        Furter::Accessors::Slider.new(locator).progress
+      end
+    end
+
+    def views(*view_classes)
+      define_method(:active?) do
+        (view_classes & Furter::Accessors::View.new.next_responders) == view_classes
+      end
+    end
   end
 end

data/lib/furter/accessors/slider.rb

@@ -0,0 +1,20 @@
+module Furter
+  module Accessors
+    class Slider < View
+
+      def move(value)
+        frankly_map(selector, 'setValue:animated:', value, 'YES')
+      end
+
+      def progress
+        frankly_map(selector, 'value')[0]
+      end
+
+      def view_class
+        return "view:'#{@locator[:type]}'" if @locator[:type]
+        "view:'UISlider'"
+      end
+    end
+  end
+end
+

data/lib/furter/accessors/view.rb

@@ -19,6 +19,12 @@ module Furter
         frankly_map(selector, 'isEnabled')[0]
       end
 
+      def next_responders
+        frankly_map("view:'UIView'", 'nextResponder').map do |r|
+          r.gsub(/[<>]/,'')
+        end
+      end
+
       private
       def selector
         "#{view_class} #{selector_how}#{selector_extra}"

data/lib/furter/navigation.rb

@@ -16,7 +16,7 @@ module Furter
       wait_a_bit_for_animations
       wait_until(:message => "Expected #{cls} to be active", :timeout => 30) do
         screen.active?
-      end
+      end if screen.respond_to?(:active?)
       wait_a_bit_for_animations
       block.call screen if block
       screen

data/lib/furter/version.rb

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

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

@@ -0,0 +1,24 @@
+require 'spec_helper'
+
+describe Furter::Accessors::Slider do
+  let(:slider) { Furter::Accessors::Slider.new(:label => 'id') }
+  let(:selector) { slider.send(:selector) }
+
+  context 'locating slider' do
+    it 'can be found by id' do
+      id_slider = Furter::Accessors::Slider.new(:label => 'someSliderLabel')
+      id_slider.send(:selector).should eq("view:'UISlider' marked:'someSliderLabel'")
+    end
+  end
+
+  context 'moving slider' do
+    it "can move the slider value" do
+      slider.should_receive(:frankly_map).with(selector,"setValue:animated:", 0.20, "YES")
+      slider.move 0.20
+    end
+    it "can get progress value of slider" do
+      slider.should_receive(:frankly_map).with(selector, 'value').and_return([0.20])
+      slider.progress.should eq(0.20)
+    end
+  end
+end

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

@@ -40,4 +40,9 @@ describe Furter::Accessors::View do
     view.should_receive(:frankly_map).with(selector, 'isEnabled').and_return([true])
     view.should be_enabled
   end
-end
+
+  it 'should know about next responders' do
+    view.should_receive(:frankly_map).with("view:'UIView'", 'nextResponder').and_return(['<First>', '<Second>', '<Third>'])
+    view.next_responders.should eq ['First', 'Second', 'Third']
+  end
+end

data/spec/lib/furter/accessors_spec.rb

@@ -8,6 +8,7 @@ class SomePage
   view(:generic_view, :label => 'id')
   button(:button_field, :label => 'id')
   switch(:switch_field, :label => 'id')
+  views('First', 'Fifth', 'Seventh')
 end
 
 describe Furter::Accessors do
@@ -113,4 +114,27 @@ describe Furter::Accessors do
       screen.switch_field_view.should be(switch)
     end
   end
+
+  context 'views' do
+    let(:view) { double('View') }
+
+    before(:each) do
+      Furter::Accessors::View.should_receive(:new).and_return(view)
+    end
+
+    it 'is active if it has all of the views' do
+      view.should_receive(:next_responders).and_return(['First', 'Fifth', 'Seventh'])
+      screen.should be_active
+    end
+
+    it 'does not care about the order' do
+      view.should_receive(:next_responders).and_return(['Seventh', 'First', 'Fifth'])
+      screen.should be_active
+    end
+
+    it 'is inactive if not all views are represented' do
+      view.should_receive(:next_responders).and_return(['First', 'Fifth', 'Not The Seventh'])
+      screen.should_not be_active
+    end
+  end
 end

data/spec/lib/furter/navigation_spec.rb

@@ -0,0 +1,31 @@
+require 'spec_helper'
+
+class NavigationScreen; end
+
+RSpec.configure do |c|
+  c.include Furter::Navigation, :navigation => true
+end
+
+describe Furter::Navigation, :navigation => true do
+  let(:screen) { double('navigation screen') }
+
+  before(:each) do
+    NavigationScreen.should_receive(:new).and_return(screen)
+  end
+
+  it 'returns the screen that was asked for' do
+    on(NavigationScreen).should be(screen)
+  end
+
+  it 'cares about active? if you do' do
+    screen.should_receive(:active?).and_return(true)
+    on(NavigationScreen)
+  end
+
+  it 'gives you your object when it is ready' do
+    screen.should_receive(:call_me)
+    on(NavigationScreen) do |s|
+      s.call_me
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: furter
 version: !ruby/object:Gem::Version
-  version: 0.0.3
+  version: 0.0.3.1
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-04-03 00:00:00.000000000 Z
+date: 2013-04-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: frank-cucumber
@@ -146,9 +146,11 @@ files:
 - features/button.feature
 - features/label.feature
 - features/navigation.feature
+- features/slider.feature
 - features/step_definitions/button_steps.rb
 - features/step_definitions/label_steps.rb
 - features/step_definitions/navigation_steps.rb
+- features/step_definitions/slider_steps.rb
 - features/step_definitions/switches_steps.rb
 - features/step_definitions/text_steps.rb
 - features/support/core_ext/string.rb
@@ -165,6 +167,7 @@ files:
 - lib/furter/accessors/button.rb
 - lib/furter/accessors/label.rb
 - lib/furter/accessors/map_pin.rb
+- lib/furter/accessors/slider.rb
 - lib/furter/accessors/switch.rb
 - lib/furter/accessors/table.rb
 - lib/furter/accessors/table_item.rb
@@ -174,10 +177,12 @@ files:
 - lib/furter/version.rb
 - spec/lib/furter/accessors/button_spec.rb
 - spec/lib/furter/accessors/label_spec.rb
+- spec/lib/furter/accessors/slider_spec.rb
 - spec/lib/furter/accessors/switch_spec.rb
 - spec/lib/furter/accessors/text_spec.rb
 - spec/lib/furter/accessors/view_spec.rb
 - spec/lib/furter/accessors_spec.rb
+- spec/lib/furter/navigation_spec.rb
 - spec/spec_helper.rb
 homepage: ''
 licenses: []
@@ -193,7 +198,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -3139935095822533556
+      hash: -3754935544043957014
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -202,7 +207,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -3139935095822533556
+      hash: -3754935544043957014
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.25
@@ -213,9 +218,11 @@ test_files:
 - features/button.feature
 - features/label.feature
 - features/navigation.feature
+- features/slider.feature
 - features/step_definitions/button_steps.rb
 - features/step_definitions/label_steps.rb
 - features/step_definitions/navigation_steps.rb
+- features/step_definitions/slider_steps.rb
 - features/step_definitions/switches_steps.rb
 - features/step_definitions/text_steps.rb
 - features/support/core_ext/string.rb
@@ -227,8 +234,10 @@ test_files:
 - features/text.feature
 - spec/lib/furter/accessors/button_spec.rb
 - spec/lib/furter/accessors/label_spec.rb
+- spec/lib/furter/accessors/slider_spec.rb
 - spec/lib/furter/accessors/switch_spec.rb
 - spec/lib/furter/accessors/text_spec.rb
 - spec/lib/furter/accessors/view_spec.rb
 - spec/lib/furter/accessors_spec.rb
+- spec/lib/furter/navigation_spec.rb
 - spec/spec_helper.rb