calabash-cucumber 0.9.0

data/.gitignore

@@ -0,0 +1,3 @@
+pkg
+Markdown.pl
+.idea

data/CHANGES.txt

@@ -0,0 +1 @@
+1.0.0: Initial calabash release

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in calabash-cucumber.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,8 @@
+calabash-cucumber
+Copyright (c) Karl Krukow. All rights reserved.
+The use and distribution terms for this software are covered by the
+Eclipse Public License 1.0 (http://opensource.org/licenses/eclipse-1.0.php)
+which can be found in the file epl-v10.html at the root of this distribution.
+By using this software in any fashion, you are agreeing to be bound by
+the terms of this license.
+You must not remove this notice, or any other, from this software.

data/README.md

@@ -0,0 +1,182 @@
+This guide explains how to setup and use Calabash for iOS.
+=============================================================
+
+*Note*: To use Calabash with your iOS app, you must first link your
+app with the `calabash.framework` as described in the README in the
+`../frameworks/` directory.
+
+After completing this guide you will be able to run tests locally
+against the iOS Simulator. You can also interactively explore the
+sample application using the Ruby irb console.
+
+Finally, you can run your Calabash tests on real physical,
+non-jailbroken iOS devices (iPad, iPhone, iPod Touch) using the
+LessPainful service at
+
+(http://www.lesspainful.com)
+
+The LessPainful service offers test reports that compares
+test results and screenshots on multiple iDevices.
+
+This guide takes approximately 5-10 minutes to complete.
+
+Installing the client.
+----------------------
+
+### Prerequisites
+
+You need to have Ruby 1.9.2+ installed, and a recent RubyGems
+installation. I use RVM or rbenv to manage my Ruby installations.
+
+For RVM, see:
+
+ [http://beginrescueend.com/](http://beginrescueend.com/)
+
+For rbenv, see:
+ [https://github.com/sstephenson/rbenv](https://github.com/sstephenson/rbenv)
+
+The rbenv project is probably the simpler of the two.
+
+You also need XCode 4.x. This guide aims at XCode 4.2, but should
+also work for XCode versions >= 4.0.
+
+### Installation
+
+*   Make sure ruby and ruby gems is on your path.
+
+        krukow:~/examples$ ruby -v
+        ruby 1.9.2p290 (2011-07-09 revision 32553) [x86_64-darwin11.1.0]
+        krukow:~/examples$ gem -v
+        1.8.10
+
+*   Install `ilesspainfulclient-cucumber` gem version 0.1.3:
+
+        krukow:~/examples$ gem install ilesspainfulclient-cucumber
+        Fetching: ilesspainfulclient-cucumber-0.1.3.gem (100%)
+        Successfully installed ilesspainfulclient-cucumber-0.1.3
+        1 gem installed
+
+Exploring the sample application.
+---------------------------------
+
+Download the sample app from github:
+
+[LessPainful-ios-sample-app](https://github.com/LessPainful/LessPainful_ios_sample_app)
+
+Let's say you've put the sample app in a into a working
+directory, `examples`.
+
+Open the XCode project: LPSimpleExample.xcodeproj using XCode.
+
+Select the LPSimpleExample-LP and iPhone Simulator 4.3 or 5.0 scheme
+under schemes.
+
+![Selecting the right scheme](https://github.com/LessPainful/LessPainful_ios_client/raw/master/documentation/example-1.png "Selecting Scheme")
+
+### Run it
+CMD-R to run. Look at the log output and verify that you see:
+
+    LPSimpleExample[11298:13703] HTTPServer: Started HTTP server on port 37265
+
+If that message is there, you're good to go.
+
+### Play with it
+
+The easy way is to just run one of the irb scripts: `irb_ios4.sh` or
+`irb_ios5.sh`.
+
+From this console you can explore your application interactively.
+
+You can query, touch, scroll, etc from the irb session.
+For example, notice that the sample app has a button: "Login".
+
+### Query
+If you're running the iOS5 iPhone simulator run `irb_ios5.sh` otherwise: `irb_ios4.sh`.
+
+Now try this from the irb:
+
+    ruby-1.9.2-p290 :003 > query("button")
+
+You should see something like this:
+
+    => ["<UIRoundedRectButton: 0x6567e00; frame = (109 215; 73 37); opaque = NO; autoresize = RM+BM; layer = <CALayer: 0x6567ef0>>"]
+
+The `query` function takes a string query as an argument. They query argument is similar to a css selector, for example we can do:
+
+    ruby-1.9.2-p290 :009 > query("button label")
+     => ["<UIButtonLabel: 0x6624f40; frame = (16 9; 40 19); text = 'Login'; clipsToBounds = YES; opaque = NO; userInteractionEnabled = NO; layer = <CALayer: 0x6645ec0>>"]
+
+It may also take parameters that are mapped to Objective-C selectors on the found object.
+
+    ruby-1.9.2-p290 :010 > query("button label", :text)
+    => ["Login"]
+
+### Touch
+
+Anything that can be found using query can also be touched.
+Try this while you watch the iOS Simulator:
+
+    ruby-1.9.2-p290 :011 > touch("button")
+
+Notice that the button is touched (turns blue), although this button doesn't do anything.
+
+You can also touch the tab bars:
+
+    ruby-1.9.2-p290 :016 > touch("tabBarButton index:1")
+
+The filter: `index:1` means that it is the second tab-bar button that should be touched.
+
+### Accessibility
+
+In general UI views are found using accessibility labels. To use those in the simulator they must be enabled.
+
+* Press the "home-screen" button in the iOS Simulator
+* Scroll left and open the Settings app insied iOS Simulator
+* Select `General` > `Accessibility` > `Accessibility Inspector` : On.
+* Re-run the sample app from XCode.
+
+In your irb session try this:
+
+    ruby-1.9.2-p290 :025 > query("view marked:'switch'")
+
+This command finds a view with accessibility label 'switch' (not that we use single quotes to delimit the accessibility label.
+
+In general, many views have accessibility labels that "make sense". For example the tab bar buttons have accessibility labels:
+
+    ruby-1.9.2-p290 :029 > touch("tabBarButton marked:'second'")
+
+To control accessibility labels on your views use:
+`isAccessibilityElement = YES, and accessibilityLabel = @"somelbl";` This can be done in interface builder or programmatically:
+
+        (void) viewDidLoad {
+            [super viewDidLoad];
+            self.uiswitch.isAccessibilityElement = YES;
+            self.uiswitch.accessibilityLabel = @"switch";
+        }
+
+### Advanced commands
+
+Surprisingly, these commands are enough to navigate fairly many iOS apps. However, there are many more commands available. Consult the file `documentation/GherkinAPI.txt` for examples of how to use these.
+
+
+### Working with your app
+
+Now you're ready to work with your app.
+
+You should download the LessPainful-ios-server project from Github:
+
+[LessPainful-ios-server](https://github.com/LessPainful/LessPainful_ios_server)
+
+Read the `README` from that project, and follow the instructions on
+how to run LessPainful on your project.
+
+License
+=======
+LessPainful-ios-client
+Copyright (c) Karl Krukow. All rights reserved.
+The use and distribution terms for this software are covered by the
+Eclipse Public License 1.0 (http://opensource.org/licenses/eclipse-1.0.php)
+which can be found in the file epl-v10.html at the root of this distribution.
+By using this software in any fashion, you are agreeing to be bound by
+the terms of this license.
+You must not remove this notice, or any other, from this software.

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/bin/calabash

@@ -0,0 +1,21 @@
+#!/usr/bin/env ruby
+
+require 'fileutils'
+
+features_dir = File.join( FileUtils.pwd, "features" )
+
+if File.exists?( features_dir ) 
+  puts "A features directory already exists. I won't overwrite it. Giving up."
+  exit 1
+else
+  puts "I'm about to create a subdirectory called features which will contain all your calabash tests. Please hit return to confirm that's what you want."
+  exit 2 unless STDIN.gets.chomp == ''
+end
+
+source_dir = File.join( File.dirname(__FILE__), '..', 'features-skeleton' )
+
+FileUtils.cp_r( source_dir, features_dir )
+
+puts "features subdirectory created. Try starting you app in the iOS simulator using the Calabash target (see calabash-ios-server for how to create the target)."
+puts "Then try executing \n\nSTEP_PAUSE=2 OS=ios5 DEVICE=iphone cucumber"
+puts "\n (replace ios5 with ios4 if running iOS 4.x simulator. Replace iphone with ipad if running iPad simulator.)."

data/calabash-cucumber.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "calabash-cucumber/version"
+
+Gem::Specification.new do |s|
+  s.name        = "calabash-cucumber"
+  s.version     = Calabash::Cucumber::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Karl Krukow"]
+  s.email       = ["karl@lesspainful.com"]
+  s.homepage    = "http://www.lesspainful.com/calabash"
+  s.summary     = %q{Client for calabash-ios-server for automated functional testing on iOS}
+  s.description = %q{calabash-cucumber drives tests for native iOS apps. You must link your app with calabash-ios-server framework to execute tests.}
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_dependency( "cucumber" )
+  s.add_dependency( "rspec", ["2.7.0"] )
+  s.add_dependency( "json" )
+  s.add_dependency( "net-http-persistent" )
+end

data/copy_resources.sh

@@ -0,0 +1,2 @@
+#!/bin/bash
+cp ../resources/* lib/calabash-cucumber/resources/

data/epl-v10.html

@@ -0,0 +1,261 @@
+<?xml version="1.0" encoding="ISO-8859-1" ?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+<title>Eclipse Public License - Version 1.0</title>
+<style type="text/css">
+  body {
+    size: 8.5in 11.0in;
+    margin: 0.25in 0.5in 0.25in 0.5in;
+    tab-interval: 0.5in;
+    }
+  p {  	
+    margin-left: auto;
+    margin-top:  0.5em;
+    margin-bottom: 0.5em;
+    }
+  p.list {
+  	margin-left: 0.5in;
+    margin-top:  0.05em;
+    margin-bottom: 0.05em;
+    }
+  </style>
+
+</head>
+
+<body lang="EN-US">
+
+<p align=center><b>Eclipse Public License - v 1.0</b></p>
+
+<p>THE ACCOMPANYING PROGRAM IS PROVIDED UNDER THE TERMS OF THIS ECLIPSE
+PUBLIC LICENSE (&quot;AGREEMENT&quot;). ANY USE, REPRODUCTION OR
+DISTRIBUTION OF THE PROGRAM CONSTITUTES RECIPIENT'S ACCEPTANCE OF THIS
+AGREEMENT.</p>
+
+<p><b>1. DEFINITIONS</b></p>
+
+<p>&quot;Contribution&quot; means:</p>
+
+<p class="list">a) in the case of the initial Contributor, the initial
+code and documentation distributed under this Agreement, and</p>
+<p class="list">b) in the case of each subsequent Contributor:</p>
+<p class="list">i) changes to the Program, and</p>
+<p class="list">ii) additions to the Program;</p>
+<p class="list">where such changes and/or additions to the Program
+originate from and are distributed by that particular Contributor. A
+Contribution 'originates' from a Contributor if it was added to the
+Program by such Contributor itself or anyone acting on such
+Contributor's behalf. Contributions do not include additions to the
+Program which: (i) are separate modules of software distributed in
+conjunction with the Program under their own license agreement, and (ii)
+are not derivative works of the Program.</p>
+
+<p>&quot;Contributor&quot; means any person or entity that distributes
+the Program.</p>
+
+<p>&quot;Licensed Patents&quot; mean patent claims licensable by a
+Contributor which are necessarily infringed by the use or sale of its
+Contribution alone or when combined with the Program.</p>
+
+<p>&quot;Program&quot; means the Contributions distributed in accordance
+with this Agreement.</p>
+
+<p>&quot;Recipient&quot; means anyone who receives the Program under
+this Agreement, including all Contributors.</p>
+
+<p><b>2. GRANT OF RIGHTS</b></p>
+
+<p class="list">a) Subject to the terms of this Agreement, each
+Contributor hereby grants Recipient a non-exclusive, worldwide,
+royalty-free copyright license to reproduce, prepare derivative works
+of, publicly display, publicly perform, distribute and sublicense the
+Contribution of such Contributor, if any, and such derivative works, in
+source code and object code form.</p>
+
+<p class="list">b) Subject to the terms of this Agreement, each
+Contributor hereby grants Recipient a non-exclusive, worldwide,
+royalty-free patent license under Licensed Patents to make, use, sell,
+offer to sell, import and otherwise transfer the Contribution of such
+Contributor, if any, in source code and object code form. This patent
+license shall apply to the combination of the Contribution and the
+Program if, at the time the Contribution is added by the Contributor,
+such addition of the Contribution causes such combination to be covered
+by the Licensed Patents. The patent license shall not apply to any other
+combinations which include the Contribution. No hardware per se is
+licensed hereunder.</p>
+
+<p class="list">c) Recipient understands that although each Contributor
+grants the licenses to its Contributions set forth herein, no assurances
+are provided by any Contributor that the Program does not infringe the
+patent or other intellectual property rights of any other entity. Each
+Contributor disclaims any liability to Recipient for claims brought by
+any other entity based on infringement of intellectual property rights
+or otherwise. As a condition to exercising the rights and licenses
+granted hereunder, each Recipient hereby assumes sole responsibility to
+secure any other intellectual property rights needed, if any. For
+example, if a third party patent license is required to allow Recipient
+to distribute the Program, it is Recipient's responsibility to acquire
+that license before distributing the Program.</p>
+
+<p class="list">d) Each Contributor represents that to its knowledge it
+has sufficient copyright rights in its Contribution, if any, to grant
+the copyright license set forth in this Agreement.</p>
+
+<p><b>3. REQUIREMENTS</b></p>
+
+<p>A Contributor may choose to distribute the Program in object code
+form under its own license agreement, provided that:</p>
+
+<p class="list">a) it complies with the terms and conditions of this
+Agreement; and</p>
+
+<p class="list">b) its license agreement:</p>
+
+<p class="list">i) effectively disclaims on behalf of all Contributors
+all warranties and conditions, express and implied, including warranties
+or conditions of title and non-infringement, and implied warranties or
+conditions of merchantability and fitness for a particular purpose;</p>
+
+<p class="list">ii) effectively excludes on behalf of all Contributors
+all liability for damages, including direct, indirect, special,
+incidental and consequential damages, such as lost profits;</p>
+
+<p class="list">iii) states that any provisions which differ from this
+Agreement are offered by that Contributor alone and not by any other
+party; and</p>
+
+<p class="list">iv) states that source code for the Program is available
+from such Contributor, and informs licensees how to obtain it in a
+reasonable manner on or through a medium customarily used for software
+exchange.</p>
+
+<p>When the Program is made available in source code form:</p>
+
+<p class="list">a) it must be made available under this Agreement; and</p>
+
+<p class="list">b) a copy of this Agreement must be included with each
+copy of the Program.</p>
+
+<p>Contributors may not remove or alter any copyright notices contained
+within the Program.</p>
+
+<p>Each Contributor must identify itself as the originator of its
+Contribution, if any, in a manner that reasonably allows subsequent
+Recipients to identify the originator of the Contribution.</p>
+
+<p><b>4. COMMERCIAL DISTRIBUTION</b></p>
+
+<p>Commercial distributors of software may accept certain
+responsibilities with respect to end users, business partners and the
+like. While this license is intended to facilitate the commercial use of
+the Program, the Contributor who includes the Program in a commercial
+product offering should do so in a manner which does not create
+potential liability for other Contributors. Therefore, if a Contributor
+includes the Program in a commercial product offering, such Contributor
+(&quot;Commercial Contributor&quot;) hereby agrees to defend and
+indemnify every other Contributor (&quot;Indemnified Contributor&quot;)
+against any losses, damages and costs (collectively &quot;Losses&quot;)
+arising from claims, lawsuits and other legal actions brought by a third
+party against the Indemnified Contributor to the extent caused by the
+acts or omissions of such Commercial Contributor in connection with its
+distribution of the Program in a commercial product offering. The
+obligations in this section do not apply to any claims or Losses
+relating to any actual or alleged intellectual property infringement. In
+order to qualify, an Indemnified Contributor must: a) promptly notify
+the Commercial Contributor in writing of such claim, and b) allow the
+Commercial Contributor to control, and cooperate with the Commercial
+Contributor in, the defense and any related settlement negotiations. The
+Indemnified Contributor may participate in any such claim at its own
+expense.</p>
+
+<p>For example, a Contributor might include the Program in a commercial
+product offering, Product X. That Contributor is then a Commercial
+Contributor. If that Commercial Contributor then makes performance
+claims, or offers warranties related to Product X, those performance
+claims and warranties are such Commercial Contributor's responsibility
+alone. Under this section, the Commercial Contributor would have to
+defend claims against the other Contributors related to those
+performance claims and warranties, and if a court requires any other
+Contributor to pay any damages as a result, the Commercial Contributor
+must pay those damages.</p>
+
+<p><b>5. NO WARRANTY</b></p>
+
+<p>EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, THE PROGRAM IS
+PROVIDED ON AN &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS
+OF ANY KIND, EITHER EXPRESS OR IMPLIED INCLUDING, WITHOUT LIMITATION,
+ANY WARRANTIES OR CONDITIONS OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY
+OR FITNESS FOR A PARTICULAR PURPOSE. Each Recipient is solely
+responsible for determining the appropriateness of using and
+distributing the Program and assumes all risks associated with its
+exercise of rights under this Agreement , including but not limited to
+the risks and costs of program errors, compliance with applicable laws,
+damage to or loss of data, programs or equipment, and unavailability or
+interruption of operations.</p>
+
+<p><b>6. DISCLAIMER OF LIABILITY</b></p>
+
+<p>EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, NEITHER RECIPIENT
+NOR ANY CONTRIBUTORS SHALL HAVE ANY LIABILITY FOR ANY DIRECT, INDIRECT,
+INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING
+WITHOUT LIMITATION LOST PROFITS), HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OR
+DISTRIBUTION OF THE PROGRAM OR THE EXERCISE OF ANY RIGHTS GRANTED
+HEREUNDER, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.</p>
+
+<p><b>7. GENERAL</b></p>
+
+<p>If any provision of this Agreement is invalid or unenforceable under
+applicable law, it shall not affect the validity or enforceability of
+the remainder of the terms of this Agreement, and without further action
+by the parties hereto, such provision shall be reformed to the minimum
+extent necessary to make such provision valid and enforceable.</p>
+
+<p>If Recipient institutes patent litigation against any entity
+(including a cross-claim or counterclaim in a lawsuit) alleging that the
+Program itself (excluding combinations of the Program with other
+software or hardware) infringes such Recipient's patent(s), then such
+Recipient's rights granted under Section 2(b) shall terminate as of the
+date such litigation is filed.</p>
+
+<p>All Recipient's rights under this Agreement shall terminate if it
+fails to comply with any of the material terms or conditions of this
+Agreement and does not cure such failure in a reasonable period of time
+after becoming aware of such noncompliance. If all Recipient's rights
+under this Agreement terminate, Recipient agrees to cease use and
+distribution of the Program as soon as reasonably practicable. However,
+Recipient's obligations under this Agreement and any licenses granted by
+Recipient relating to the Program shall continue and survive.</p>
+
+<p>Everyone is permitted to copy and distribute copies of this
+Agreement, but in order to avoid inconsistency the Agreement is
+copyrighted and may only be modified in the following manner. The
+Agreement Steward reserves the right to publish new versions (including
+revisions) of this Agreement from time to time. No one other than the
+Agreement Steward has the right to modify this Agreement. The Eclipse
+Foundation is the initial Agreement Steward. The Eclipse Foundation may
+assign the responsibility to serve as the Agreement Steward to a
+suitable separate entity. Each new version of the Agreement will be
+given a distinguishing version number. The Program (including
+Contributions) may always be distributed subject to the version of the
+Agreement under which it was received. In addition, after a new version
+of the Agreement is published, Contributor may elect to distribute the
+Program (including its Contributions) under the new version. Except as
+expressly stated in Sections 2(a) and 2(b) above, Recipient receives no
+rights or licenses to the intellectual property of any Contributor under
+this Agreement, whether expressly, by implication, estoppel or
+otherwise. All rights in the Program not expressly granted under this
+Agreement are reserved.</p>
+
+<p>This Agreement is governed by the laws of the State of New York and
+the intellectual property laws of the United States of America. No party
+to this Agreement will bring a legal action under this Agreement more
+than one year after the cause of action arose. Each party waives its
+rights to a jury trial in any resulting litigation.</p>
+
+</body>
+
+</html>