furter 0.0.3

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

@@ -0,0 +1,129 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<document type="com.apple.InterfaceBuilder3.CocoaTouch.Storyboard.XIB" version="2.0" toolsVersion="3084" systemVersion="12D78" targetRuntime="iOS.CocoaTouch" propertyAccessControl="none" useAutolayout="YES" initialViewController="3">
+    <dependencies>
+        <plugIn identifier="com.apple.InterfaceBuilder.IBCocoaTouchPlugin" version="2083"/>
+    </dependencies>
+    <scenes>
+        <!--Navigation Controller-->
+        <scene sceneID="11">
+            <objects>
+                <navigationController id="3" sceneMemberID="viewController">
+                    <navigationBar key="navigationBar" opaque="NO" clipsSubviews="YES" multipleTouchEnabled="YES" contentMode="scaleToFill" id="4">
+                        <autoresizingMask key="autoresizingMask"/>
+                    </navigationBar>
+                    <connections>
+                        <segue destination="12" kind="relationship" relationship="rootViewController" id="19"/>
+                    </connections>
+                </navigationController>
+                <placeholder placeholderIdentifier="IBFirstResponder" id="10" sceneMemberID="firstResponder"/>
+            </objects>
+            <point key="canvasLocation" x="-1" y="64"/>
+        </scene>
+        <!--Master View Controller - Master-->
+        <scene sceneID="18">
+            <objects>
+                <tableViewController storyboardIdentifier="" title="Master" id="12" customClass="MasterViewController" sceneMemberID="viewController">
+                    <tableView key="view" opaque="NO" clipsSubviews="YES" clearsContextBeforeDrawing="NO" contentMode="scaleToFill" alwaysBounceVertical="YES" dataMode="prototypes" style="plain" rowHeight="44" sectionHeaderHeight="22" sectionFooterHeight="22" id="13">
+                        <rect key="frame" x="0.0" y="64" width="320" height="504"/>
+                        <autoresizingMask key="autoresizingMask" widthSizable="YES" heightSizable="YES"/>
+                        <color key="backgroundColor" white="1" alpha="1" colorSpace="calibratedWhite"/>
+                        <prototypes>
+                            <tableViewCell contentMode="scaleToFill" selectionStyle="blue" accessoryType="disclosureIndicator" hidesAccessoryWhenEditing="NO" indentationLevel="1" indentationWidth="0.0" reuseIdentifier="Cell" textLabel="phq-AM-6qj" style="IBUITableViewCellStyleDefault" id="lJ0-d7-vTF">
+                                <rect key="frame" x="0.0" y="22" width="320" height="44"/>
+                                <autoresizingMask key="autoresizingMask"/>
+                                <view key="contentView" opaque="NO" clipsSubviews="YES" multipleTouchEnabled="YES" contentMode="center">
+                                    <rect key="frame" x="0.0" y="0.0" width="300" height="43"/>
+                                    <autoresizingMask key="autoresizingMask"/>
+                                    <subviews>
+                                        <label opaque="NO" clipsSubviews="YES" multipleTouchEnabled="YES" contentMode="center" text="Title" lineBreakMode="tailTruncation" baselineAdjustment="alignBaselines" adjustsFontSizeToFit="NO" id="phq-AM-6qj">
+                                            <rect key="frame" x="10" y="0.0" width="280" height="43"/>
+                                            <autoresizingMask key="autoresizingMask"/>
+                                            <fontDescription key="fontDescription" type="boldSystem" pointSize="20"/>
+                                            <color key="textColor" cocoaTouchSystemColor="darkTextColor"/>
+                                            <color key="highlightedColor" red="1" green="1" blue="1" alpha="1" colorSpace="calibratedRGB"/>
+                                        </label>
+                                    </subviews>
+                                    <color key="backgroundColor" white="0.0" alpha="0.0" colorSpace="calibratedWhite"/>
+                                </view>
+                                <color key="backgroundColor" white="1" alpha="1" colorSpace="calibratedWhite"/>
+                                <connections>
+                                    <segue destination="21" kind="push" identifier="showDetail" id="jZb-fq-zAk"/>
+                                </connections>
+                            </tableViewCell>
+                        </prototypes>
+                        <sections/>
+                        <connections>
+                            <outlet property="dataSource" destination="12" id="16"/>
+                            <outlet property="delegate" destination="12" id="15"/>
+                        </connections>
+                    </tableView>
+                    <navigationItem key="navigationItem" title="Master" id="36"/>
+                </tableViewController>
+                <placeholder placeholderIdentifier="IBFirstResponder" id="17" sceneMemberID="firstResponder"/>
+            </objects>
+            <point key="canvasLocation" x="459" y="64"/>
+        </scene>
+        <!--Detail View Controller - Detail-->
+        <scene sceneID="24">
+            <objects>
+                <viewController storyboardIdentifier="" title="Detail" id="21" customClass="DetailViewController" sceneMemberID="viewController">
+                    <view key="view" contentMode="scaleToFill" id="22">
+                        <rect key="frame" x="0.0" y="64" width="320" height="504"/>
+                        <autoresizingMask key="autoresizingMask" flexibleMaxX="YES" flexibleMaxY="YES"/>
+                        <subviews>
+                            <label clipsSubviews="YES" userInteractionEnabled="NO" contentMode="scaleToFill" text="Detail view content goes here" textAlignment="center" lineBreakMode="tailTruncation" minimumFontSize="10" translatesAutoresizingMaskIntoConstraints="NO" id="27">
+                                <color key="backgroundColor" white="1" alpha="1" colorSpace="calibratedWhite"/>
+                                <fontDescription key="fontDescription" type="system" size="system"/>
+                                <color key="textColor" cocoaTouchSystemColor="darkTextColor"/>
+                                <nil key="highlightedColor"/>
+                            </label>
+                            <button opaque="NO" contentMode="scaleToFill" contentHorizontalAlignment="center" contentVerticalAlignment="center" buttonType="roundedRect" lineBreakMode="middleTruncation" translatesAutoresizingMaskIntoConstraints="NO" id="BGA-y0-odx">
+                                <fontDescription key="fontDescription" type="boldSystem" pointSize="15"/>
+                                <state key="normal" title="Button">
+                                    <color key="titleColor" red="0.19607843459999999" green="0.30980393290000002" blue="0.52156865600000002" alpha="1" colorSpace="calibratedRGB"/>
+                                    <color key="titleShadowColor" white="0.5" alpha="1" colorSpace="calibratedWhite"/>
+                                </state>
+                                <state key="highlighted">
+                                    <color key="titleColor" white="1" alpha="1" colorSpace="calibratedWhite"/>
+                                </state>
+                            </button>
+                        </subviews>
+                        <color key="backgroundColor" white="1" alpha="1" colorSpace="custom" customColorSpace="calibratedWhite"/>
+                        <constraints>
+                            <constraint firstAttribute="bottom" secondItem="BGA-y0-odx" secondAttribute="bottom" constant="107" id="Oz5-UI-e4N"/>
+                            <constraint firstItem="27" firstAttribute="leading" secondItem="22" secondAttribute="leading" constant="20" symbolic="YES" type="default" id="R0m-z7-TWk"/>
+                            <constraint firstItem="BGA-y0-odx" firstAttribute="leading" secondItem="22" secondAttribute="leading" constant="20" symbolic="YES" type="default" id="a4V-WS-rvQ"/>
+                            <constraint firstItem="27" firstAttribute="top" secondItem="22" secondAttribute="top" constant="9" id="fqs-Iu-ZEi"/>
+                            <constraint firstAttribute="trailing" secondItem="27" secondAttribute="trailing" constant="20" symbolic="YES" type="default" id="pRe-qY-58T"/>
+                        </constraints>
+                    </view>
+                    <navigationItem key="navigationItem" title="Detail" id="26"/>
+                    <connections>
+                        <outlet property="detailDescriptionLabel" destination="27" id="28"/>
+                    </connections>
+                </viewController>
+                <placeholder placeholderIdentifier="IBFirstResponder" id="23" sceneMemberID="firstResponder"/>
+            </objects>
+            <point key="canvasLocation" x="902" y="64"/>
+        </scene>
+    </scenes>
+    <classes>
+        <class className="DetailViewController" superclassName="UIViewController">
+            <source key="sourceIdentifier" type="project" relativePath="./Classes/DetailViewController.h"/>
+            <relationships>
+                <relationship kind="outlet" name="detailDescriptionLabel" candidateClass="UILabel"/>
+            </relationships>
+        </class>
+        <class className="MasterViewController" superclassName="UITableViewController">
+            <source key="sourceIdentifier" type="project" relativePath="./Classes/MasterViewController.h"/>
+        </class>
+        <class className="NSLayoutConstraint" superclassName="NSObject">
+            <source key="sourceIdentifier" type="project" relativePath="./Classes/NSLayoutConstraint.h"/>
+        </class>
+    </classes>
+    <simulatedMetricsContainer key="defaultSimulatedMetrics">
+        <simulatedStatusBarMetrics key="statusBar"/>
+        <simulatedOrientationMetrics key="orientation"/>
+        <simulatedScreenMetrics key="destination" type="retina4"/>
+    </simulatedMetricsContainer>
+</document>

data/app/FurterApp/FurterApp/main.m

@@ -0,0 +1,18 @@
+//
+//  main.m
+//  FurterApp
+//
+//  Created by Levi Wilson on 3/20/13.
+//  Copyright (c) 2013 Levi Wilson. All rights reserved.
+//
+
+#import <UIKit/UIKit.h>
+
+#import "AppDelegate.h"
+
+int main(int argc, char *argv[])
+{
+    @autoreleasepool {
+        return UIApplicationMain(argc, argv, nil, NSStringFromClass([AppDelegate class]));
+    }
+}

data/cucumber.yml

@@ -0,0 +1,2 @@
+default: --no-source --color --format pretty
+wip: --no-source --color --format pretty --tag @wip

data/features/button.feature

@@ -0,0 +1,12 @@
+Feature:  Working with buttons
+
+  Scenario: Clicking buttons by text
+    When I click the button identified by "text"
+    Then the text identified by "label" should be "The button was clicked!"
+
+  Scenario: Clicking buttons by label
+    When I click the button identified by "label"
+    Then the text identified by "label" should be "The labeled button was clicked!"
+
+  Scenario: Working with the raw button view
+    Then we can interact with the raw view of the button identified by "label"

data/features/label.feature

@@ -0,0 +1,10 @@
+Feature: Working with label controls
+
+  Scenario: Getting the value of a label by accessibility label
+    Then I know that the label identified by "id" is "Detail view content goes here"
+
+  Scenario: Accessing the raw view properties of a label
+    Then the label identified by "id" should be "visible"
+
+  Scenario: Finding labels by their text
+    Then the label identified by "text" should be "visible"

data/features/navigation.feature

@@ -0,0 +1,5 @@
+Feature:  Navigating through the application
+
+  Scenario: Using routes for navigation
+    When I navigate to the "ElsewherePage" using the "crazy route" route
+    Then I should end up on the "ElsewherePage"

data/features/step_definitions/button_steps.rb

@@ -0,0 +1,7 @@
+When /^I click the button identified by "([^"]*)"$/ do |how|
+  on(DetailPage).send("button_#{how}")
+end
+
+Then /^we can interact with the raw view of the button identified by "([^"]*)"$/ do |how|
+  on(DetailPage).send("button_#{how}_view").should be_kind_of(Furter::Accessors::View)
+end

data/features/step_definitions/label_steps.rb

@@ -0,0 +1,8 @@
+Then /^I know that the label identified by "([^"]*)" is "([^"]*)"$/ do |how, what|
+  on(DetailPage).send("label_#{how}").should eq(what)
+end
+
+Then /^the label identified by "([^"]*)" should be "([^"]*)"$/ do |how, property|
+  which_method = "#{property}?".to_sym
+  on(DetailPage).send("label_#{how}_view").send(which_method).should be_true
+end

data/features/step_definitions/navigation_steps.rb

@@ -0,0 +1,7 @@
+When /^I navigate to the "([^"]*)" using the "([^"]*)" route$/ do |where, which_route|
+  navigate_to(where.to_class, :using => which_route.to_method)
+end
+
+Then /^I should end up on the "([^"]*)"$/ do |where|
+  on(where.to_class).should be_active
+end

data/features/step_definitions/switches_steps.rb

@@ -0,0 +1,12 @@
+Then(/^switches can be toggled both on or off$/) do
+  on(DetailPage) do |screen|
+    [true, false].each do |what_now|
+      screen.switch_toggle = what_now
+      screen.switch_toggle.should eq(what_now)
+    end
+  end
+end
+
+Then /^we have access to the switch view$/ do
+  on(DetailPage).switch_toggle_view.should be_kind_of(Furter::Accessors::View)
+end

data/features/step_definitions/text_steps.rb

@@ -0,0 +1,25 @@
+When(/^I set the text identified by "(.*?)" to "(.*?)"$/) do |how, text|
+  on(DetailPage).send("text_#{how}=", text)
+end
+
+Then(/^the text identified by "(.*?)" should be "(.*?)"$/) do |how, text|
+  on(DetailPage).send("text_#{how}").should eq(text)
+end
+
+Then(/^we know if a text field is both editable and not editable$/) do
+  first_field = "textField placeholder:'First Field'"
+
+  on(DetailPage) do |screen|
+    frankly_map(first_field, 'setEnabled:', false)
+    screen.should_not be_text_placeholder_editable
+
+    frankly_map(first_field, 'setEnabled:', true)
+    screen.should be_text_placeholder_editable
+  end
+end
+
+Then(/^we can interact with the raw text view identified by "(.*?)"$/) do |how|
+  text_view = on(DetailPage).send("text_#{how}_view")
+  text_view.should be_kind_of(Furter::Accessors::View)
+end
+

data/features/support/core_ext/string.rb

@@ -0,0 +1,9 @@
+class String
+  def to_class
+    Object.const_get self
+  end
+
+  def to_method
+    self.gsub(/\W+/,'_').downcase.to_sym
+  end
+end

data/features/support/env.rb

@@ -0,0 +1,25 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '../../', 'lib'))
+
+require 'furter'
+require 'require_all'
+
+require 'rspec-expectations'
+
+World(Furter::Navigation)
+
+require_rel '/screens'
+
+APP_BUNDLE_PATH = File.expand_path( '../../../app/FurterApp/Frank/frankified_build/FurterApp.app', __FILE__ )
+
+Frank::Cucumber::FrankHelper.use_shelley_from_now_on
+
+Furter::Navigation.routes = {
+    :default => [],
+    :crazy_route => [
+        [DetailPage, :button_text],
+        [DetailPage, :button_label],
+        [DetailPage, :switch_toggle],
+        [DetailPage, :go_elsewhere],
+        [ElsewherePage, :active?]
+    ]
+}

data/features/support/hooks.rb

@@ -0,0 +1,3 @@
+Before do
+  launch_app APP_BUNDLE_PATH, '6.1', 'ipad'
+end

data/features/support/screens/detail.rb

@@ -0,0 +1,15 @@
+class DetailPage
+  include Furter
+
+  text(:text_placeholder, :placeholder => 'First Field')
+  text(:text_label, :label => 'textByLabel')
+
+  label(:label_id, :label => 'labelByAccessibilityLabel')
+  label(:label_text, :text => 'Placeholder')
+
+  button(:button_text, :text => 'Some Button')
+  button(:button_label, :label => 'labeledButtonId')
+  button(:go_elsewhere, :text => 'Go Elsewhere')
+
+  switch(:switch_toggle, :label => 'switchToggle')
+end

data/features/support/screens/elsewhere_page.rb

@@ -0,0 +1,7 @@
+class ElsewherePage
+  include Furter
+
+  def active?
+    has_text? 'You are now elsewhere.'
+  end
+end

data/features/switches.feature

@@ -0,0 +1,7 @@
+Feature:  Working with switch controls
+
+  Scenario: Getting and setting a switch value
+    Then switches can be toggled both on or off
+
+  Scenario: Working with the raw switch view
+    Then we have access to the switch view

data/features/text.feature

@@ -0,0 +1,15 @@
+Feature:  Working with text controls
+
+  Scenario: Getting and setting text by placeholder
+    When I set the text identified by "placeholder" to "The first field's text"
+    Then the text identified by "placeholder" should be "The first field's text"
+
+  Scenario: Getting and setting text by label
+    When I set the text identified by "label" to "the label text"
+    Then the text identified by "label" should be "the label text"
+
+  Scenario: Determining if a text field is editable
+    Then we know if a text field is both editable and not editable
+
+  Scenario: Working with the raw view
+    Then we can interact with the raw text view identified by "placeholder"

data/furter.gemspec

@@ -0,0 +1,26 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'furter/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "furter"
+  gem.version       = Furter::VERSION
+  gem.authors       = ["Levi Wilson"]
+  gem.email         = ["levi@leviwilson.com"]
+  gem.description   = %q{Higher-level abstraction around iOS drivers}
+  gem.summary       = %q{Higher-level abstraction around iOS 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.require_paths = ["lib"]
+
+  gem.add_dependency 'frank-cucumber', '~> 1.1.8'
+  gem.add_dependency 'page_navigation', '>= 0.7'
+
+  gem.add_development_dependency 'rspec'
+  gem.add_development_dependency 'rake'
+  gem.add_development_dependency 'require_all'
+end

data/lib/furter.rb

@@ -0,0 +1,53 @@
+require 'frank-cucumber'
+require 'furter/navigation'
+require 'furter/accessors'
+require 'furter/accessors/view'
+require 'furter/accessors/alert_button'
+require 'furter/accessors/button'
+require 'furter/accessors/map_pin'
+require 'furter/accessors/switch'
+require 'furter/accessors/table'
+require 'furter/accessors/table_item'
+require 'furter/accessors/text'
+require 'furter/accessors/label'
+
+module Furter
+  include Frank::Cucumber::FrankHelper
+
+  TIMEOUT = 30
+
+  def self.included(cls)
+    cls.extend Furter::Accessors
+  end
+
+  def has_text?(text)
+    Furter::Accessors::Text.new.has_text? text
+  end
+
+  def wait_for_text(text)
+    wait_until(:message => "Timed out waiting for text \"#{text}\"", :timeout => Furter::TIMEOUT) do
+      has_text? text
+    end
+  end
+
+  def exists?(locator)
+    element_exists locator
+  end
+
+  def wait_for(locator, &block)
+    wait_until(:message => "Timed out waiting for \"#{locator}\"", :timeout => Furter::TIMEOUT) do
+      exists? locator
+    end
+    block.call locator if block
+  end
+
+  def wait_for_and_touch(locator)
+    wait_for(locator) do |locator|
+      touch locator
+    end
+  end
+
+  def active?
+    true
+  end
+end

data/lib/furter/accessors.rb

@@ -0,0 +1,87 @@
+module Furter
+  module Accessors
+    def text(name, locator)
+      define_method("#{name}") do
+        Furter::Accessors::Text.new(locator).get_text
+      end
+      define_method("#{name}_editable?") do
+        Furter::Accessors::Text.new(locator).editable?
+      end
+      define_method("#{name}=") do |text|
+        Furter::Accessors::Text.new(locator).set_text text
+      end
+      define_method("#{name}_view") do
+        Furter::Accessors::Text.new(locator)
+      end
+    end
+
+    def label(name, locator)
+      define_method("#{name}") do
+        Furter::Accessors::Label.new(locator).text
+      end
+      define_method("#{name}_view") do
+        Furter::Accessors::Label.new(locator)
+      end
+    end
+
+    def view(name, locator)
+      define_method("#{name}") do
+        Furter::Accessors::View.new(locator).click
+      end
+      define_method("#{name}_view") do
+        Furter::Accessors::View.new(locator)
+      end
+    end
+
+    def button(name, locator)
+      define_method("#{name}") do
+        Furter::Accessors::Button.new(locator).click
+      end
+      define_method("#{name}_view") do
+        Furter::Accessors::Button.new(locator)
+      end
+    end
+
+    def alert_button(name, locator)
+      define_method("#{name}") do
+        Furter::Accessors::AlertButton.new(locator).click
+      end
+    end
+
+    def table(name, locator)
+      define_method("#{name}=") do |which|
+        Furter::Accessors::TableItem.new(:text => which).click
+      end
+      define_method("#{name}_options") do
+        Furter::Accessors::Table.new(locator).options
+      end
+      define_method("#{name}_view") do
+        Furter::Accessors::Table.new(locator)
+      end
+    end
+
+    def table_item(name, locator)
+      define_method("#{name}") do
+        Furter::Accessors::TableItem.new(locator).click
+      end
+    end
+
+    def map_pin(name, locator)
+      define_method("#{name}") do
+        Furter::Accessors::MapPin.new(locator).click
+      end
+    end
+
+    def switch(name, locator)
+      define_method("#{name}") do
+        Furter::Accessors::Switch.new(locator).on?
+      end
+      define_method("#{name}=") do |on_or_off|
+        Furter::Accessors::Switch.new(locator).set on_or_off
+      end
+      define_method("#{name}_view") do
+        Furter::Accessors::Switch.new(locator)
+      end
+    end
+  end
+end