rufus 0.1

data/.gitignore

@@ -0,0 +1,61 @@
+_Store
+*/build/*
+*.pbxuser
+!default.pbxuser
+*.mode1v3
+!default.mode1v3
+*.mode2v3
+!default.mode2v3
+*.perspectivev3
+!default.perspectivev3
+xcuserdata
+profile
+*.moved-aside
+DerivedData
+.idea/
+*.hmap
+*.xcuserstate
+*.orig
+
+*.gem
+*.rbc
+.bundle
+.config
+coverage
+InstalledFiles
+lib/bundler/man
+screenshots/
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+
+# YARD artifacts
+.yardoc
+_yardoc
+doc/
+
+.DS_Store
+
+.DS_Store
+
+.DS_Store
+
+
+
+*.xcuserstate
+
+
+
+
+build
+
+.idea/workspace.xml
+
+element_methods.rtf
+
+RufusApp/RufusApp.xcodeproj/project.xcworkspace/xcshareddata/
+
+

data/.gitmodules

@@ -0,0 +1,6 @@
+[submodule "libimobiledevice-macosx"]
+	path = libimobiledevice-macosx
+	url = https://github.com/benvium/libimobiledevice-macosx.git
+[submodule "ActualAppium"]
+	path = appium
+	url = https://github.com/appium/appium.git

data/Gemfile

@@ -0,0 +1,7 @@
+source 'http://rubygems.org'
+
+gem 'cucumber'
+gem 'selenium-webdriver'
+gem 'require_all'
+gem 'page_navigation'
+gem 'rspec'

data/Gemfile.lock

@@ -0,0 +1,51 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    builder (3.2.0)
+    childprocess (0.3.9)
+      ffi (~> 1.0, >= 1.0.11)
+    cucumber (1.2.5)
+      builder (>= 2.1.2)
+      diff-lcs (>= 1.1.3)
+      gherkin (~> 2.11.7)
+      multi_json (~> 1.3)
+    data_magic (0.15.2)
+      faker (>= 1.1.2)
+      yml_reader (>= 0.2)
+    diff-lcs (1.2.4)
+    faker (1.1.2)
+      i18n (~> 0.5)
+    ffi (1.9.0)
+    gherkin (2.11.8)
+      multi_json (~> 1.3)
+    i18n (0.6.4)
+    multi_json (1.7.9)
+    page_navigation (0.9)
+      data_magic (>= 0.14)
+    require_all (1.2.1)
+    rspec (2.14.1)
+      rspec-core (~> 2.14.0)
+      rspec-expectations (~> 2.14.0)
+      rspec-mocks (~> 2.14.0)
+    rspec-core (2.14.4)
+    rspec-expectations (2.14.0)
+      diff-lcs (>= 1.1.3, < 2.0)
+    rspec-mocks (2.14.1)
+    rubyzip (0.9.9)
+    selenium-webdriver (2.35.0)
+      childprocess (>= 0.2.5)
+      multi_json (~> 1.0)
+      rubyzip
+      websocket (~> 1.0.4)
+    websocket (1.0.7)
+    yml_reader (0.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  cucumber
+  page_navigation
+  require_all
+  rspec
+  selenium-webdriver

data/README.md

@@ -0,0 +1,120 @@
+Last Updated: 9-24-2013
+
+This project is intended to facilitate automated testing on iOS devices using cucumber and the Page Object pattern. 
+
+
+QUICK START GUIDE
+-----------------
+1. gem install rufus
+2. require 'rufus' in your Gemfile
+3. Clone appium into project directory (where .xcodeproj resides). Repo located at: https://github.com/appium/appium.git
+4. Create a config.yml in project directory with the following information:
+
+browser: iOS
+platform: Mac
+version: 6.1
+app:$HOME/Library/Developer/Xcode/DerivedData/<UNIQUE>/Build/Products/Debug-iphoneos/YourApp.app 
+
+5. Start appium server using node
+>appium -U <UDID> --app <PATH_TO_APP>
+
+6. Deploy to iOS device using libimobiledevice. Repo located at: https://github.com/benvium/libimobiledevice-macosx
+
+7. Run tests
+>bundle exec cucumber
+
+
+LONG START GUIDE
+----------------
+
+PREREQUISITES 
+--------------------------
+1. Ruby
+2. Homebrew
+3. Bundler
+
+INSTALLING NODE WITH HOMEBREW
+-----------------------------
+
+- brew doctor
+- brew install node
+- curl https://npmjs.org/install.sh | sh
+- export NODE_PATH="/usr/local/lib/node"
+- export PATH="/usr/local/share/npm/bin:$PATH"
+- node -v <= check to see that node installed correctly
+
+APPIUM
+------
+
+Appium must be installed to run it from the command line. The repository at https://github.com/appium/appium.git is included as a submodule to this project. To download the necessary files, issue the following in your project directory:
+
+>git submodule init
+>git submodule update
+
+If you did not download the rufus source code, clone appium into your project directory. Either way, look into the appium directory to make sure there is a file server.js. 
+
+CONFIGURING ENVIRONMENT 
+--------------------------------------------
+Rufus relies on a config.yml file to exists in the project's root directory. This is used to tell appium about the physical device and the software under test. Below is a typical configuration to run automated tests on the iPad.
+
+browser: iOS
+platform: Mac
+version: 6.1
+app:$HOME/Library/Developer/Xcode/DerivedData/<UNIQUE_ID>/Build/Products/Debug-iphoneos/YourApp.app 
+
+STARTING APPIUM SERVER
+-----------------------------------------
+Open a separate terminal window and navigate to you appium installation. This will be the window that shows the appium server output. In this window issue the following command to start the appium server
+
+>node server.js -U <UDID> --app <PATH_TO_APP>
+
+The UDID is the unique identifier of your physical device. This can be found in Xcode. Navigate to Window > Organizer, select the target device and notice it's identifier. The PATH_TO_APP is the path to the compiled app that Xcode produces. It should be the same as the path configured in the config.yml
+
+After issuing the command there should be a message stating that the appium server is listening. 
+
+DEPLOYING TO DEVICE
+----------------------------------
+
+Rufus doesn't necessarily care how your app made it onto the device as long as selenium can see it, but I found the most consistent method to be through libimobiledevice. That project also is included as a submodule to this one. The original repository is https://github.com/benvium/libimobiledevice-macosx. Look at the libimobiledevice Readme in order to configure the environment variables your system needs to use this deployment mechanism. 
+
+The only gotcha I ran into was generating the .ipa archive that libimobiledevice uses. Take the following steps to generate the .ipa archive.
+
+1. Build the app for deployment to device
+2. Navigate to the .app file that should be found in the ../Debug-iphoneos/ directory
+3. Create a folder in that directory named 'Payload'. It must be named Payload.
+4. Put a copy of the .app file in the Payload directory
+5. Compress the directory into a .zip archive
+6. Change the .zip extension to .ipa
+7. Issue the command ideviceinstaller -i YourApp.ipa (This installs the app)
+
+
+USING THE RUFUS IRB DRIVER
+--------------------------
+After installing the gem, open an irb session from the same directory as your config.yml. 
+
+>require 'rufus/driver'
+>driver = Rufus.new
+>driver.start (starts the app)
+
+
+DEFINING A BUTTON SEQUENCE
+--------------------------
+
+Rufus doesn't mind the mindless work of pushing buttons in sequence. The following command will push the goodButton, badButton and sortaOkayButton in sequence 10 times in a row if such a sequence is possible. In this example, the goodButton must be available to be pressed after pushing the sortaOkayButton in order for the loop to continue. 
+
+driver.sequence 'goodButton', 'badButton', 'sortaOkayButton', 10
+
+OTHER DRIVER USE CASES
+----------------------
+
+Push a button by name
+
+>driver.push_button 'buttonName'
+
+>Get a list of all the button names
+
+>driver.buttons (example return: ['go', 'yesButton','noButton'])
+
+Enter 'Hello' into text field
+
+>driver.type 'hello' 'textFieldName'

data/RufusApp/Frank/features/my_first.feature

@@ -0,0 +1,12 @@
+Feature: 
+  As an iOS developer
+  I want to have a sample feature file
+  So I can see what my next step is in the wonderful world of Frank/Cucumber testing
+
+Scenario: 
+    Rotating the simulator for demonstration purposes
+Given I launch the app
+Given the device is in landscape orientation
+Given the device is in portrait orientation
+Given the device is in landscape orientation
+Given the device is in portrait orientation

data/RufusApp/Frank/features/step_definitions/launch_steps.rb

@@ -0,0 +1,20 @@
+def app_path
+  ENV['APP_BUNDLE_PATH'] || (defined?(APP_BUNDLE_PATH) && APP_BUNDLE_PATH)
+end
+
+Given /^I launch the app$/ do
+  # latest sdk and iphone by default
+  launch_app app_path
+end
+
+Given /^I launch the app using iOS (\d\.\d)$/ do |sdk|
+  # You can grab a list of the installed SDK with sim_launcher
+  # > run sim_launcher from the command line
+  # > open a browser to http://localhost:8881/showsdks
+  # > use one of the sdk you see in parenthesis (e.g. 4.2)
+  launch_app app_path, sdk
+end
+
+Given /^I launch the app using iOS (\d\.\d) and the (iphone|ipad) simulator$/ do |sdk, version|
+  launch_app app_path, sdk, version
+end

data/RufusApp/Frank/features/support/env.rb

@@ -0,0 +1,8 @@
+require 'frank-cucumber'
+
+# UIQuery is deprecated. Please use the shelley selector engine. 
+Frank::Cucumber::FrankHelper.use_shelley_from_now_on
+
+# This constant must be set to the full, absolute path for your Frankified target's app bundle.
+# See the "Given I launch the app" step definition in launch_steps.rb for more details
+APP_BUNDLE_PATH = File.expand_path( '../../../frankified_build/Frankified.app', __FILE__ )

data/RufusApp/Frank/frank_static_resources.bundle/ViewAttributeMapping.plist

@@ -0,0 +1,63 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>UIView</key>
+	<array>
+		<string>accessibilityLabel</string>
+		<string>accessibilityFrame</string>
+		<string>tag</string>
+		<string>alpha</string>
+		<string>autoresizingMask</string>
+		<string>backgroundColor</string>
+		<string>frame</string>
+		<string>isHidden</string>
+	</array>
+    <key>UIWindow</key>
+	<array>
+		<string>windowLevel</string>
+		<string>isKeyWindow</string>
+	</array>
+	<key>UIScrollView</key>
+	<array>
+		<string>contentOffset</string>
+		<string>contentSize</string>
+		<string>isScrollEnabled</string>
+		<string>contentInset</string>
+		<string>isPagingEnabled</string>
+		<string>bounces</string>
+		<string>alwaysBounceVertical</string>
+		<string>alwaysBounceHorizontal</string>
+		<string>showsHorizontalScrollIndicator</string>
+		<string>showsVerticalScrollIndicator</string>
+		<string>zoomScale</string>
+		<string>maximumZoomScale</string>
+		<string>minimumZoomScale</string>
+		<string>delegate</string>
+	</array>
+	<key>UITableView</key>
+	<array>
+		<string>dataSource</string>
+	</array>
+	<key>UILabel</key>
+	<array>
+		<string>text</string>
+		<string>font</string>
+		<string>textAlignment</string>
+	</array>
+	<key>UISegmentedControl</key>
+	<array>
+		<string>segmentedControlStyle</string>
+		<string>numberOfSegments</string>
+		<string>selectedSegmentIndex</string>
+	</array>
+	<key>MKMapView</key>
+	<array>
+		<string>mapType</string>
+		<string>isZoomEnabled</string>
+		<string>isScrollEnabled</string>
+		<string>userTrackingMode</string>
+		<string>delegate</string>
+	</array>
+</dict>
+</plist>

data/RufusApp/Frank/frank_static_resources.bundle/ViewAttributeMappingMac.plist

@@ -0,0 +1,99 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>NSObject</key>
+	<array>
+		<string>FEX_accessibilityLabel</string>
+		<string>FEX_accessibilityFrame</string>
+	</array>
+	<key>NSView</key>
+	<array>
+		<string>tag</string>
+		<string>autoresizesSubviews</string>
+		<string>autoresizingMask</string>
+		<string>frame</string>
+		<string>bounds</string>
+		<string>isHidden</string>
+		<string>isFlipped</string>
+		<string>isRotatedFromBase</string>
+		<string>isRotatedOrScaledFromBase</string>
+		<string>isInFullScreenMode</string>
+		<string>isOpaque</string>
+		<string>canBecomeKeyView</string>
+		<string>acceptsTouchEvents</string>
+		<string>wantsRestingTouches</string>
+	</array>
+	<key>NSWindow</key>
+	<array>
+		<string>alphaValue</string>
+		<string>backgroundColor</string>
+		<string>isOpaque</string>
+		<string>level</string>
+		<string>isKeyWindow</string>
+		<string>frame</string>
+		<string>isVisible</string>
+		<string>windowNumber</string>
+		<string>isSheet</string>
+	</array>
+	<key>NSControl</key>
+	<array>
+		<string>stringValue</string>
+		<string>attributedStringValue</string>
+	</array>
+	<key>NSScrollView</key>
+	<array>
+		<string>backgroundColor</string>
+		<string>borderType</string>
+		<string>contentSize</string>
+		<string>documentVisibleRect</string>
+		<string>drawsBackground</string>
+		<string>hasHorizontalScroller</string>
+		<string>hasVerticalScroller</string>
+		<string>autohidesScrollers</string>
+		<string>hasHorizontalRuler</string>
+		<string>hasVerticalRuler</string>
+		<string>rulersVisible</string>
+		<string>scrollerKnobStyle</string>
+		<string>scrollerStyle</string>
+		<string>lineScroll</string>
+		<string>horizontalLineScroll</string>
+		<string>verticalLineScroll</string>
+		<string>pageScroll</string>
+		<string>horizontalPageScroll</string>
+		<string>verticalPageScroll</string>
+		<string>scrollsDynamically</string>
+		<string>findBarPosition</string>
+		<string>usesPredominantAxisScrolling</string>
+		<string>horizontalScrollElasticity</string>
+		<string>verticalScrollElasticity</string>
+	</array>
+	<key>NSTableView</key>
+	<array>
+		<string>dataSource</string>
+	</array>
+	<key>NSTextField</key>
+	<array>
+		<string>isEditable</string>
+		<string>isSelectable</string>
+		<string>drawsBackground</string>
+		<string>backgroundColor</string>
+		<string>isBezeled</string>
+		<string>bezelStyle</string>
+		<string>isBordered</string>
+	</array>
+	<key>NSTextView</key>
+	<array>
+		<string>isEditable</string>
+		<string>isSelectable</string>
+		<string>drawsBackground</string>
+		<string>backgroundColor</string>
+	</array>
+	<key>NSSegmentedControl</key>
+	<array>
+		<string>segmentStyle</string>
+		<string>segmentCount</string>
+		<string>selectedSegment</string>
+	</array>
+</dict>
+</plist>

data/RufusApp/Frank/frank_static_resources.bundle/index.html

@@ -0,0 +1,86 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta charset='utf-8' />
+    <title>Symbiote</title>
+    <script src='js/lib/jquery.min.js'></script>
+    <script src='js/lib/jquery-ui.min.js'></script>
+    <script src='js/lib/jquery.treeview.js'></script>
+    <script src='js/lib/coffee-script.js'></script>
+    <script src='js/lib/raphael.js'></script>
+    <script src='js/lib/underscore.js'></script>
+    <script src='js/lib/backbone.js'></script>
+    <script src='js/lib/json2.js'></script>
+    <script data-main='/js/main' src='js/lib/require.js'></script>
+    <link href='/stylesheets/css/symbiote.css' rel='stylesheet' />
+    <link href='pictos/pictos.css' rel='stylesheet' />
+  </head>
+  <body>
+    <header id='header'>
+      <h1>symbiote</h1>
+      <div class='toast'></div>
+      <div id='refresh'>
+        <button id='dump_button'>
+          <span></span>
+        </button>
+      </div>
+    </header>
+    <section class='symbiote_shell'>
+      <article id='selector-test'><div class='wrap outter'><label class='selector-engine-label'>use</label>
+        <div class='selector-engine dropdown'></div></div><div class='wrap middle'><label class='query'>to select views matching</label><input id='query' placeholder="Selector label marked:'Search'" /></div><div class='wrap outter'>
+          <label>and then</label>
+          <div class='action-buttons dropdown'></div>
+        </div></article>
+    </section>
+    <section class='the-columns'>
+      <div id='list-tabs'>
+        <ul>
+          <li>
+            <a href='#dom-dump'>View Hierarchy</a>
+          </li>
+          <li>
+            <a href='#accessible-views-tab'>Accessible Elements</a>
+          </li>
+        </ul>
+        <div id='dom-dump'>
+          <ul></ul>
+        </div>
+        <div id='accessible-views-tab'>
+          <div class='hints'>
+            <p>Here is a list of all elements with accessibility labels.</p>
+            <p>Clicking on a row will flash that view element in the simulator. Hover over a row to see the selector used to flash that view element.</p>
+          </div>
+          <div id='accessible-views'></div>
+        </div>
+      </div>
+      <div id='inspect-tabs'>
+        <ul>
+          <li>
+            <a href='#dom-detail'>View Properties</a>
+          </li>
+          <li>
+            <a href='#ui-locator'>View Locator</a>
+          </li>
+        </ul>
+        <div id='ui-locator'>
+          <div id='live-view'>
+            <button>
+              Live
+              <span>Y</span>
+            </button>
+          </div>
+          <div id='asploder'>
+            <button>
+              Asplode
+            </button>
+          </div>
+          <button id='ui-locator-rotator'>1</button>
+          <div id='ui-locator-view'></div>
+        </div>
+        <div id='dom-detail'>
+          <p>Click an element in the view hierarchy on the right to see details of that element here.</p>
+        </div>
+      </div>
+    </section>
+  </body>
+</html>

data/RufusApp/Frank/frank_static_resources.bundle/index.html.haml

@@ -0,0 +1,76 @@
+!!! 5
+%html
+  %head
+    %meta(charset="utf-8")
+    %title Symbiote
+
+    %script(src="js/lib/jquery.min.js")
+    %script(src="js/lib/jquery-ui.min.js")
+    %script(src="js/lib/jquery.treeview.js")
+    %script(src="js/lib/coffee-script.js")
+    %script(src="js/lib/raphael.js")
+    %script(src="js/lib/underscore.js")
+    %script(src="js/lib/backbone.js")
+    %script(src="js/lib/json2.js")
+
+    %script(data-main="/js/main" src="js/lib/require.js")
+
+    %link(href="/stylesheets/css/symbiote.css" rel="stylesheet")
+    %link(href="pictos/pictos.css" rel="stylesheet")
+
+  %body
+    %header#header
+      %h1 symbiote
+      .toast
+      #refresh
+        %button#dump_button
+          %span
+
+    %section.symbiote_shell
+      %article#selector-test
+        .wrap.outter<>
+          %label.selector-engine-label use
+          .selector-engine.dropdown
+
+        .wrap.middle<>
+          %label.query<> to select views matching
+          %input#query(placeholder="Selector label marked:'Search'")<>
+
+        .wrap.outter>
+          %label and then
+          .action-buttons.dropdown
+
+    %section.the-columns
+      #list-tabs
+        %ul
+          %li
+            %a(href="#dom-dump") View Hierarchy
+          %li
+            %a(href="#accessible-views-tab") Accessible Elements
+        #dom-dump
+          %ul
+        #accessible-views-tab
+          %div.hints
+            %p Here is a list of all elements with accessibility labels.
+            %p Clicking on a row will flash that view element in the simulator. Hover over a row to see the selector used to flash that view element.
+          #accessible-views
+
+      #inspect-tabs
+        %ul
+          %li
+            %a(href="#dom-detail") View Properties
+          %li
+            %a(href="#ui-locator") View Locator
+        #ui-locator
+          #live-view
+            %button
+              Live
+              %span Y
+          #asploder
+            %button
+              Asplode
+          %button#ui-locator-rotator 1
+          #ui-locator-view
+
+        #dom-detail
+          %p Click an element in the view hierarchy on the right to see details of that element here.