cs-bdd 0.0.5

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 8fea4af1f1c087b62438cbecf42def2f539e2fe1
+  data.tar.gz: affd1d59330b9ed5811fd65a099ec723de85ad24
+SHA512:
+  metadata.gz: bef6f96f0d15ce28ccf31738bf1641f1da1d7449f7e317c5b700f473d3bf42ec7beff9872360eb879a33cc2dc357b34348fe8867e315325a0bbdeb0f101a39ae
+  data.tar.gz: 90370746239e9a6f3f0e3f5b9c5565aec684e0fffdcc9936c45d2e8d0fbff009c1b5f78c54db06b1b348e3ff923e73246a613472e198e85964aba57e46b57bc9

data/.gitignore

@@ -0,0 +1,14 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log

data/Gemfile

@@ -0,0 +1,13 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in cs-bdd.gemspec
+gemspec
+
+# calabash gems
+gem 'calabash-common'
+# Only for Linux
+if RUBY_PLATFORM.include? 'linux'
+  gem 'calabash-android'
+else # Only for Mac. This gem will not be used in Windows
+  gem 'calabash-cucumber'
+end

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 CSOscarTanner
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,21 @@
+# CS::BDD
+
+A simple gem to generate all the files needed to create a project that will support calabash for Android and iOS.
+
+## Installation
+
+Install it as:
+
+    $ gem install cs-bdd
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Contributing
+
+1. Fork it ( https://github.com/CSOscarTanner/cs-bdd/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+

data/bin/cs-bdd

@@ -0,0 +1,93 @@
+#!/usr/bin/env ruby
+
+# File based on https://github.com/calabash/calabash-android/blob/e2da2817809edf38256a55093dc1d3835c9c6410/ruby-gem/bin/calabash-android
+
+require 'fileutils'
+require 'rbconfig'
+require_relative '../lib/cs/bdd/version'
+
+# for ruby 1.9.1 and earlier
+unless defined? RbConfig.ruby
+  def RbConfig.ruby
+    File.join(RbConfig::CONFIG["bindir"], RbConfig::CONFIG["ruby_install_name"] + RbConfig::CONFIG["EXEEXT"])
+  end
+end
+
+require File.join(File.dirname(__FILE__), "cs-bdd-generate")
+require File.join(File.dirname(__FILE__), "cs-bdd-helpers")
+
+@skeleton_dir = File.join( File.dirname(__FILE__), '..', 'lib', 'skeleton' )
+@examples_dir = File.join( File.dirname(__FILE__), "..", "lib", "examples" )
+@features_dir = File.join( FileUtils.pwd, "features" )
+@steps_dir = File.join(@features_dir, "step_definitions" )
+@android_dir = File.join(@features_dir, "android" )
+@ios_dir = File.join(@features_dir, "ios" )
+
+if ARGV.length == 0
+  print_usage
+else
+  cmd = ARGV.shift
+
+  case cmd
+  when 'new', 'n'
+    if ARGV.empty?
+      puts "Please specify the project name"
+      exit 1
+    else
+      @project_dir = File.join(FileUtils.pwd, ARGV.first)
+      generate_skeleton
+    end
+  when 'generate', 'g'
+
+    # Looks if the user is in the root folder of the project
+    unless Dir.exists? File.join(FileUtils.pwd, "features", "android", "features")
+      puts "Please run this command on the root folder of the project"
+      exit 1
+    end
+
+    if ARGV.empty?
+      puts "Please inform the generator that will be used. Type cs-bdd to see the usage info."
+      exit 1
+    else
+      generator = ARGV.shift
+
+      if ARGV.empty?
+        puts "Please specify the name of the resource to be generated."
+        exit 1
+      end
+
+      name = ARGV.first
+
+      case generator
+      when 'feature'
+        create_feature_file name
+        create_steps_file name
+        create_screen_file name, 'IOS'
+        create_screen_file name, 'Android'
+      when 'aFeature'
+        create_feature_file name, 'Android'
+        create_steps_file name, 'Android'
+        create_screen_file name, 'Android'
+      when 'iFeature'
+        create_feature_file name, 'IOS'
+        create_steps_file name, 'IOS'
+        create_screen_file name, 'IOS'
+      when 'step'
+        create_steps_file name
+      when 'aStep'
+        create_steps_file name, 'Android'
+      when 'iStep'
+        create_steps_file name, 'IOS'
+      when 'aScreen'
+        create_screen_file name, 'Android'
+      when 'iScreen'
+        create_screen_file name, 'IOS'
+      end
+    end
+  when 'version', 'v'
+    puts CS::BDD::VERSION
+  else
+    puts "Invalid command '#{cmd}'"
+    print_usage
+  end
+end

data/bin/cs-bdd-generate.rb

@@ -0,0 +1,11 @@
+def generate_skeleton
+  if File.exists?(@project_dir)
+    puts "A project directory already exists. Nothing will be done."
+    exit 1
+  end
+
+  FileUtils.cp_r(@skeleton_dir, @project_dir)
+
+  puts "Project folder created. \n"
+
+end

data/bin/cs-bdd-helpers.rb

@@ -0,0 +1,73 @@
+def print_usage
+  puts <<EOF
+  Usage: cs-bdd <command-name> [parameters]
+  <command-name> can be one of
+    new or n <project_name>
+      generate a project folder structure
+      \033[0;32mEx.: cs-bdd n project_name\033[0m
+    generate or g <type> <name>
+      generate a Feature or Step Definition or Screen file
+      <type> can be one of
+        feature -> Generate all files that composes an OS independenty feature
+        aFeature -> Generate all files that composes an Android feature
+        iFeature -> Generate all files that composes an iOS feature
+        step -> Generate an OS independenty step
+        aStep -> Generate a step that will be loaded only in Android
+        iStep -> Generate a step that will be loaded only in iOS
+        aScreen -> Generate an Android screen
+        iScreen -> Generate an iOS screen
+        \033[0;32mEx.: cs-bdd g aFeature Feature_name\033[0m
+    version or v
+      prints the gem version
+      \033[0;32mEx.: cs-bdd v\033[0m
+EOF
+end
+
+def create_feature_file name, platform = nil
+  # Getting the contents of the example.feature file
+  content = File.read( File.join( @examples_dir, "example.feature" ) )
+  
+  # Updating the contents with the name passed as an option
+  content = content.gsub( "|Name|", name.capitalize )
+
+  # If platform is not nil than the feature is OS dependent
+  file = nil
+  if platform.nil?
+    content = content.gsub( "|Platform|", "") # Don't show any indication of platform inside the feature file
+    file = File.join( @features_dir, "#{name.downcase}.feature" )
+  else
+    content = content.gsub( "|Platform|", "(#{platform} Only)") # Indicates the platform in the title of the feature
+    file = File.join( @features_dir, platform.downcase, "features", "#{name.downcase}.feature" )
+  end
+
+  # Creating the feature file with the updated content
+  File.open( file, 'w' ) { |file| file.puts content }
+end
+
+def create_steps_file name, platform = nil
+  # Getting the contents of the example_steps.rb file
+  content = File.read( File.join( @examples_dir, "example_steps.rb" ) )
+  
+  # If platform is not nil than the feature is OS dependent
+  file = nil
+  if platform.nil?
+    file = File.join( @steps_dir, "#{name.downcase}_steps.rb" )
+  else
+    file = File.join( @features_dir, platform.downcase, "steps_definition", "#{name.downcase}.feature" )
+  end
+
+  # Creating the steps file with the default content
+  File.open( file, 'w' ) { |file| file.puts content }
+end
+
+def create_screen_file name, platform
+  # Getting the contents of the example_screen.rb file
+  content = File.read( File.join( @examples_dir, "example_screen.rb" ) )
+  
+  # Updating the contents with the name passed as an option
+  content = content.gsub( "|Name|", name.capitalize )
+  content = content.gsub( "|Platform|", platform )
+  
+  # Creating the feature file with the updated content
+  File.open( File.join( @features_dir, platform.downcase, "screens", "#{name.downcase}_screen.rb" ), 'w' ) { |file| file.puts content }
+end

data/cs-bdd.gemspec

@@ -0,0 +1,23 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'cs/bdd/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "cs-bdd"
+  spec.version       = CS::BDD::VERSION
+  spec.authors       = ["Oscar Tanner"]
+  spec.email         = ["oscar.tanner@concretesolutions.com.br"]
+  spec.summary       = %q{Generates an android and iOS calabash project.}
+  spec.description   = %q{A simple gem to generate all the folder and files needed to create an android and iOS calabash project.}
+  spec.homepage      = "https://github.com/CSOscarTanner/cs-bdd"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = ["cs-bdd"]
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.7"
+  spec.add_development_dependency "rake", "~> 10.0"
+end

data/lib/cs/bdd.rb

@@ -0,0 +1,7 @@
+require "cs/bdd/version"
+
+module CS
+  module BDD
+    # Your code goes here...
+  end
+end

data/lib/cs/bdd/version.rb

@@ -0,0 +1,5 @@
+module CS
+  module BDD
+    VERSION = "0.0.5"
+  end
+end

data/lib/examples/example.feature

@@ -0,0 +1,7 @@
+Feature: |Name| |Platform|
+
+  Background:
+    # Insert the steps
+    
+  Scenario: First Scenario
+    # Insert the steps

data/lib/examples/example_screen.rb

@@ -0,0 +1,15 @@
+class |Name|Screen < |Platform|ScreenBase
+
+  # The screen identificator
+  #trait(:trait)                 { "* marked:'#{layout_name}'" }
+
+  # Declare all the elements of this screen
+  #element(:layout_name)         {'insert_layout_identificator'}
+  #element(:button)              {'insert_button_identificator'}
+
+  # Declare all actions of this screen
+  # action(:touch_button) {
+  #   touch("* marked:'#{button}'")
+  # }
+
+end

data/lib/examples/example_steps.rb

@@ -0,0 +1,5 @@
+######### GIVEN #########
+
+######### WHEN #########
+
+######### THEN #########

data/lib/skeleton/.gitignore

@@ -0,0 +1,3 @@
+.irb-history
+reports/*
+test_servers/*

data/lib/skeleton/README.md

@@ -0,0 +1,167 @@
+#Getting Started 
+
+## Ruby
+  
+  There is a lot of ways of installing ruby, one is using RVM (http://rvm.io/rvm/install):
+  
+  Install RVM stable with ruby: 
+
+  ```
+  $ \curl -sSL https://get.rvm.io | bash -s stable --ruby
+  ```
+  
+  After this, include the following lines in you `~/.bashrc` file.
+  
+  ```
+  export PATH="$PATH:$HOME/.rvm/bin" # Add RVM to PATH for scripting
+  [[ -s $HOME/.rvm/scripts/rvm ]] && source $HOME/.rvm/scripts/rvm
+  ```
+
+# Android
+
+## Installing the Gems
+
+  Install the following gems
+
+  ```
+  gem install calabash-common
+  gem install calabash-android
+  ```
+
+  **Warning!**
+  
+  The command **`gem install calabash-android`** installs the beta version of the cucumber gem.
+  This gem brokes the execution of the calabash. After the installation of calabash-android, install the stable version of the cucumber gem (command: `gem install cucumber`) and remove the beta version (command: `gem uninstall cucumber`).
+
+## Running the tests
+  To run the android tests, you need to:
+  
+  1. Open the Android AVD
+  2. Open the terminal on the tests folder
+  3. Execute the command:
+  
+  ```
+    calabash-android run features/app-QA.apk -p android
+  ```
+  
+
+  > To run in a computer with more than one emulator or device, use the command:
+  >
+  >```
+  >  ADB_DEVICE_ARG=emulator-5554 calabash-android run features/app-QA.apk -p android
+  >```
+  >
+  >Given that 'emulator-5554' is one of the returns of the command `$ adb devices` on the terminal
+
+
+  > To run on all connected devices, run the script `run_tests_all_devices.sh`, located on the `config/scripts/android` folder of the project
+
+  > **!! IMPORTANT !!** 
+
+  > Remember to export the WORKSPACE variable with the path of the cloned test repository
+  
+  > Remember to pass the APK path as the parameter of the script
+  > 
+  > ```
+  > ./config/scripts/android/run_tests_all_devices.sh PATH_OF_APK_FILE
+  >```
+
+
+## Calabash Terminal
+
+The calabash terminal allows you to run the calabash commands without being on a test context
+To open the calabash terminal, you need to:
+
+  1. Open the Android AVD
+  2. Open the terminal on the tests folder
+  3. Execute the command:
+  
+  ```
+    calabash-android console features/app-QA.apk -p android
+  ```
+  
+  4. Run the commands
+  
+  ```
+    reinstall_apps
+    start_test_server_in_background
+  ```
+  
+  5. Run the commands you want to.
+
+# iOS
+
+## Installing the Gems
+
+  Install the following gems
+
+  ```
+  gem install calabash-common
+  gem install calabash-cucumber
+  ```
+  
+## Configuring the iOS project
+
+  1. Run the command `pod install`
+  2. Run the command `calabash-ios setup` and follow the instructions
+  3. Make sure that the signing is a wildcard
+
+
+## Running the tests
+  To run the iOS tests in a device, you need to:
+  
+  1. Open the terminal on the tests folder
+  2. Compile the project to create the .app file with the command 
+  
+  ```
+  ./config/scripts/ios/build_app.sh xcworkspace_path TargetName-cal iphoneos8.1 ConfigurationName
+  ```
+  
+        PS.1: TargetName-cal is the name of the target created with the command `calabash-ios setup`
+        PS.2: iphoneos8.1 is the sdk for devices, for emulatores use iphonesimulator8.1
+        PS.3: Configuration name can be Dev, Debug, Release, Prod or any other configuration build
+        PS.4: The path to the .app file is the last output line of the above command
+
+  3. To execute one feature, run the command
+  
+  ```
+    APP_BUNDLE_PATH=AppFilePath DEVICE_TARGET=DeviceUUID DEVICE_ENDPOINT=CalabashServerEndpointDevice cucumber -p ios
+  ```
+  
+  4. To execute all the features in the configured devices run the script
+  
+  ```
+    ./config/scripts/ios/run_tests_all_devices.sh AppFilePath
+  ```
+  
+      PS.: Remember to configure all the connected devices on the file `./config/scripts/ios/devices`.
+           In this file you need to inform the device UUID, the device IP with the calabash server port and a name to identify this device on the reports. Remember to leave an empty line at the end of the file and to split the informations using pipes.
+
+## Calabash Terminal (Device)
+
+The calabash terminal allows you to run the calabash commands without being on a test context
+To open the calabash terminal, you need to:
+
+  1. Connect the device
+  2. Open the terminal on the tests folder
+  3. Execute the command:
+  
+  ```
+    APP_BUNDLE_PATH=AppFilePath DEVICE_TARGET=DeviceUUID DEVICE_ENDPOINT=CalabashServerEndpointDevice calabash-ios console
+  ```
+  
+  4. Run the command
+  
+  ```
+    start_test_server_in_background
+  ```
+  
+  5. Run the commands you want to.
+
+## Pitfalls
+
+  1. Always build the project with the device connected
+  2. Ensure that the device is enabled to Development and the UI Automations is enabled on the Developer menu (Settings)
+  3. If the device in pin locked, ensure that it is unlocked. If there is no pin, the calabash will automatically unlock the device
+  4. Ensure that the device WIFI is enabled and it is accessible from the computer that is starting the tests. The calabash server works sending commands to the device by the network.
+  5. Always run the target -cal on the Xcode one first time to see if the target is ok and running. The calabash-ios gem cannot print errors of execution, but Xcode can.

data/lib/skeleton/config/cucumber.yml

@@ -0,0 +1,7 @@
+# config/cucumber.yml
+##YAML Template
+---
+android: PLATFORM=android -r features/support -r features/android -r features/step_definitions --exclude features/ios
+
+
+ios: PLATFORM=ios -r features/support -r features/ios -r features/step_definitions --exclude features/android

data/lib/skeleton/config/scripts/android/run_tests_all_devices.sh

@@ -0,0 +1,24 @@
+#!/bin/bash
+# ----------------------------------------------------------------------------
+# Uncomment the next line to enable debug
+# set -x
+#
+# $1 -> parameter with the name of the apk
+
+
+## CODE BEGIN  #############################################################
+echo Start: $(date)
+for device in $(adb devices | grep "device$" | cut -f 1)
+do
+  rm -r $WORKSPACE/reports/$device &> /dev/null
+  mkdir -p $WORKSPACE/reports/$device &> /dev/null
+  echo $device | grep -q emulator
+  # SET THE IGNORE TAGS TRUE IF THE TEST ARE RUNNING IN A DEVICE
+  [ $? -ne 0 ] && ignore='--tags ~@ignore_if_test_in_device'
+  cd $WORKSPACE
+  ADB_DEVICE_ARG=$device SCREENSHOT_PATH=$WORKSPACE/reports/$device/ calabash-android run $1 -p android --format 'Calabash::Formatters::Html' --out $WORKSPACE/reports/$device/reports.html $ignore &
+done
+wait
+echo End: $(date)
+echo 'Bye!'
+## CODE END  #############################################################

data/lib/skeleton/config/scripts/ios/build_app.sh

@@ -0,0 +1,38 @@
+#!/usr/bin/env bash
+# ----------------------------------------------------------------------------
+# Uncomment the next line to enable debug
+# set -x
+#
+# $1 -> xcworkspace path
+# $2 -> target (scheme) name created by the command calabash-ios setup
+# $3 -> sdk. This will differ from simulator and device build
+#       When this script was created the available sdks were: 'iphoneos8.1' for 
+#       devices and iphonesimulator8.1 for simulator
+# $4 -> Configuration type. Ex.: 'Dev'
+
+## CODE BEGIN  #############################################################
+
+# When running on CI
+# It is a good pratice to run pod install when executing this script on the CI to avoid
+# building problems
+# pod install
+
+[ $# -ne 4 ] && echo "Wrong number of parameters." && exit 1
+
+echo "Building project for calabash"
+
+xcodebuild -workspace "$1" -scheme "$2" -sdk "$3" -configuration "$4" clean build
+
+BUILT_PRODUCTS_DIR=`xcodebuild -workspace "$1" -scheme "$2" -sdk "$3" -showBuildSettings -configuration "$4" | 
+                    grep -i "\bbuilt_products_dir" | 
+                    cut -d "=" -f2 `
+
+export APP_BUNDLE_PATH=`echo "$BUILT_PRODUCTS_DIR/$2.app" | 
+                        sed 's/^\ *//g' |
+                        sed 's/\ *$//g'`
+
+echo $APP_BUNDLE_PATH
+
+echo End: $(date)
+echo 'Bye!'
+## CODE END  #############################################################

data/lib/skeleton/config/scripts/ios/devices

@@ -0,0 +1,4 @@
+# <DEVICE_TARGET (UUID)> | <DEVICE_ENDPOINT (IP)> | <DEVICE_NAME>
+000...000 | http://0.0.0.0:37265 | Device0
+111...111 | http://1.1.1.1:37265 | Device1
+# EOF - Never erase this comment or the script will have problems to read this file

data/lib/skeleton/config/scripts/ios/run_tests_all_devices.sh

@@ -0,0 +1,44 @@
+#!/usr/bin/env bash
+# ----------------------------------------------------------------------------
+# Uncomment the next line to enable debug
+# set -x
+#
+# $1 -> parameter with the path of the .app bundle
+
+## CODE BEGIN  #############################################################
+
+echo Start: $(date)
+
+# Exits if the app path was not informed
+if [ -z $1 ]; then
+  echo "The first parameter must be the app path"
+  exit 1
+fi
+
+# Reads the devices file line by line
+while read line
+do
+  # Ignoring all comments
+  echo $line | grep -q "^#" && continue
+
+  # Reading the informations of the device in the devices file
+  # The variables can't contain any kind of spaces, so we erase then off
+  target="$(echo $line | cut -d'|' -f1 | tr -d ' ')"
+  endpoint="$(echo $line | cut -d'|' -f2 | tr -d ' ')"
+  name="$(echo $line | cut -d'|' -f3 | tr -d ' ')"
+
+  # Cleaning the previous reports folder and ensuring its existence
+  rm -rf "$WORKSPACE/reports/$name" &> /dev/null
+  mkdir -p "$WORKSPACE/reports/$name" &> /dev/null
+
+  # Navigating to the tests root folder
+  cd "$WORKSPACE"
+
+  # Executing calabash for the device
+  APP_BUNDLE_PATH="$1" DEVICE_TARGET="$target" DEVICE_ENDPOINT="$endpoint" SCREENSHOT_PATH="$WORKSPACE/reports/$name/" cucumber -p ios --format 'Calabash::Formatters::Html' --out "$WORKSPACE/reports/$name/reports.html"
+
+done < config/scripts/ios/devices
+
+echo End: $(date)
+echo 'Bye!'
+## CODE END  #############################################################

data/lib/skeleton/features/android/android_screen_base.rb

@@ -0,0 +1,98 @@
+require 'calabash-android/abase'
+
+class AndroidScreenBase < Calabash::ABase
+
+  def self.element element_name
+    define_method element_name.to_s
+  end
+
+  class << self
+    alias :value :element
+    alias :action :element
+    alias :trait :element
+  end
+
+  element(:loading_screen)      {"insert_loading_view_id"}
+
+  # The progress bar of the application is a custom view
+  def wait_for_progress
+    wait_for_element_does_not_exist(loading_screen)
+  end
+
+  def drag_to direction
+
+    positions = [0,0,0,0] # [ 'from_x', 'to_x', 'from_y', 'to_y' ]
+
+    case(direction)
+    when :down
+      positions = [30,30,60,30]
+    when :up
+      positions = [80,80,60,90]
+    when :left
+      positions = [90,20,80,80]
+    when :right
+      positions = [20,90,80,80]
+    end
+
+    # perform_action( 'action', 'from_x', 'to_x', 'from_y', 'to_y', 'number of steps (in this case, velocity of drag' )
+    perform_action('drag', positions[0], positions[1], positions[2], positions[3], 15)
+    
+    sleep(1)
+  end
+
+  def drag_until_element_is_visible_with_special_query direction, element
+    drag_until_element_is_visible direction, element, "* {text CONTAINS[c] '#{self.get_translation(element)}'}"
+  end
+
+  def drag_until_element_is_visible direction, element, query = nil, limit = 15
+    i = 0
+
+    element_text = get_translation(element)
+
+    element_query = ""
+    if query.nil?
+      element_query = "* marked:'#{element_text}'"
+    else
+      element_query = query
+    end
+
+    sleep(2)
+    while( !element_exists(element_query) and i < limit) do
+      drag_to direction
+      i = i + 1
+    end
+
+    raise ("Executed #{limit} moviments #{direction.to_s} and the element '#{element_text}' was not found on this view!") unless i < limit
+  end
+
+  def drag_for_specified_number_of_times direction, times
+    times.times do
+      drag_to direction
+    end
+  end
+
+  def is_on_page? page_text
+
+    translated_page_text = get_translation(page_text)[0,50] # Using only the first 50 chars in the comparation
+
+    begin
+      wait_for(:timeout => 5) { has_text? translated_page_text }
+    rescue
+      raise "Unexpected Page. Expected was: '#{translated_page_text}'"
+    end
+  end
+
+  def enter text, element, query = nil
+    if query.nil?
+      query( "* marked:'#{element}'", {:setText => text} )
+    else
+      query( query, {:setText => text} )
+    end
+  end
+
+  def touch_element_by_index id, index
+    wait_for(:timeout => 5) { element_exists("* id:'#{id}' index:#{index}") }
+    touch("* id:'#{id}' index:#{index}")
+  end
+
+end

data/lib/skeleton/features/android/features/android.feature

@@ -0,0 +1,9 @@
+Feature: Example Android
+# This feature will only be executed when the android profile is loaded
+# You can rename this file and update its contents or delete it and create new features
+
+  Background:
+    # Insert the steps
+    
+  Scenario: First Scenario
+    # Insert the steps

data/lib/skeleton/features/android/screens/example_screen.rb

@@ -0,0 +1,15 @@
+class ExampleScreen < AndroidScreenBase
+
+  # The screen identificator
+  #trait(:trait)                 { "* marked:'#{layout_name}'" }
+
+  # Declare all the elements of this screen
+  #element(:layout_name)         {'insert_layout_identificator'}
+  #element(:button)              {'insert_button_identificator'}
+
+  # Declare all actions of this screen
+  # action(:touch_button) {
+  #   touch("* marked:'#{button}'")
+  # }
+
+end

data/lib/skeleton/features/android/support/app_installation_hooks.rb

@@ -0,0 +1,43 @@
+require 'calabash-android/management/app_installation'
+
+AfterConfiguration do |config|
+  FeatureNameMemory.feature_name = nil
+end
+
+Before('@reinstall') do |scenario|
+  uninstall_apps
+  install_app(ENV["TEST_APP_PATH"])
+  install_app(ENV["APP_PATH"])
+end
+
+Before do |scenario|
+  @scenario_is_outline = (scenario.class == Cucumber::Ast::OutlineTable::ExampleRow)
+  if @scenario_is_outline 
+    scenario = scenario.scenario_outline 
+  end 
+
+  feature_name = scenario.feature.title
+  if FeatureNameMemory.feature_name != feature_name \
+      or ENV["RESET_BETWEEN_SCENARIOS"] == "1"
+    if ENV["RESET_BETWEEN_SCENARIOS"] == "1"
+      log "New scenario - reinstalling apps"
+    else
+      log "First scenario in feature - reinstalling apps"
+    end
+    
+    uninstall_apps
+    install_app(ENV["TEST_APP_PATH"])
+    install_app(ENV["APP_PATH"])
+
+    FeatureNameMemory.feature_name = feature_name
+    FeatureNameMemory.invocation = 1
+  else
+    FeatureNameMemory.invocation += 1
+  end
+end
+
+FeatureNameMemory = Class.new
+class << FeatureNameMemory
+  @feature_name = nil
+  attr_accessor :feature_name, :invocation
+end

data/lib/skeleton/features/android/support/app_life_cycle_hooks.rb

@@ -0,0 +1,13 @@
+require 'calabash-android/management/adb'
+require 'calabash-android/operations'
+
+Before do |scenario|
+  start_test_server_in_background
+end
+
+After do |scenario|
+  if scenario.failed?
+    screenshot_embed
+  end
+  shutdown_test_server
+end

data/lib/skeleton/features/example.feature

@@ -0,0 +1,9 @@
+Feature: Example
+# This feature will be executed for both SOs
+# You can rename this file and update its contents or delete it and create new features
+
+  Background:
+    # Insert the steps
+    
+  Scenario: First Scenario
+    # Insert the steps

data/lib/skeleton/features/ios/features/ios.feature

@@ -0,0 +1,9 @@
+Feature: Example iOS
+# This feature will only be executed when the ios profile is loaded
+# You can rename this file and update its contents or delete it and create new features
+
+  Background:
+    # Insert the steps
+    
+  Scenario: First Scenario
+    # Insert the steps

data/lib/skeleton/features/ios/ios_screen_base.rb

@@ -0,0 +1,134 @@
+require 'calabash-cucumber/ibase'
+
+class IOSScreenBase < Calabash::IBase
+
+  def self.element(element_name, &block)
+    define_method(element_name.to_s, *block)
+  end
+
+  class << self
+    alias :value :element
+    alias :action :element
+    alias :trait :element
+  end
+
+  element(:loading_screen)            { 'LOADING' }
+
+  # The progress bar of the application is a custom view
+  def wait_for_progress
+    wait_for { element_does_not_exist "* marked:'#{loading_screen}'" }
+  end
+
+  def has_text?(text)
+    !query("* {text CONTAINS[c] '#{text}'}").empty? or !query("* {accessibilityLabel CONTAINS[c] '#{text}'}").empty?
+  end
+
+  def drag_to direction
+
+    # iOS swipe command doesn't work.
+    # For a workaround we need to use the scroll function, but it only work after a swipe command
+
+    # iOS swipe :up and :down are the opposite of the Android directions
+    # Setting swipe_opt that will define the swipe 'force'
+    swipe_opt = nil
+    case direction
+    when :left
+      swipe_opt = {:'swipe-delta' => {:horizontal=>{:dx => 280} }, :offset => { :x => 300, :y => 300 } }
+    when :right
+      swipe_opt = {:'swipe-delta' => {:horizontal=>{:dx => 250} }, :offset => { :x => 50, :y => 300 } }
+    when :up
+      direction = :down
+      swipe_opt = {:'swipe-delta' => {:vertical=>{:dy => 200} }, :offset => { :x => 160, :y => 100 } }
+    when :down
+      direction = :up
+      swipe_opt = {:'swipe-delta' => {:vertical=>{:dy => 200} }, :offset => { :x => 160, :y => 400 } }
+    end
+
+    swipe(direction, swipe_opt)
+
+    sleep(1)
+  end
+
+  # In the iOS, an element could be found from its text or its accessibilityLabel
+  # so this function looks for these two properties on the screen. When the query
+  # looks for just a part of the text (CONTAINS[c]) then we need to specify if
+  # we will look in accessibilityLabel or in any other propertie (marked)
+  def ios_element_exists? query
+    second_query = nil
+
+    if query.include? "marked"
+      second_query = query.gsub( 'marked', 'accessibilityLabel' )
+    end
+
+    if query.include? "accessibilityLabel"
+      second_query = query.gsub( 'accessibilityLabel', 'marked' )
+    end
+
+    if second_query.nil?
+      return element_exists(query)
+    else
+      element_exists(query) or element_exists(second_query)
+    end
+
+  end
+
+  def drag_until_element_is_visible_with_special_query direction, element
+    drag_until_element_is_visible direction, element, "* {accessibilityLabel CONTAINS[c] '#{element}'}"
+  end
+
+  def drag_until_element_is_visible direction, element, query = nil, limit = 15
+    i = 0
+
+    element_query = ""
+    if query.nil?
+      element_query = "* marked:'#{element}'"
+    else
+      element_query = query
+    end
+
+    sleep(1)
+    while( !ios_element_exists?(element_query) and i < limit) do
+      drag_to direction
+      i = i + 1
+    end
+
+    raise ("Executed #{limit} moviments #{direction.to_s} and the element '#{element}' was not found on this view!") unless i < limit
+  end
+
+  def drag_for_specified_number_of_times direction, times
+    times.times do
+      drag_to direction
+    end
+  end
+
+  def is_on_page? page_text
+    begin
+      wait_for(:timeout => 5) { has_text? page_text }
+    rescue
+      raise "Unexpected Page. Expected was: '#{page_text}'"
+    end
+  end
+
+  def enter text, element, query = nil
+    if query.nil?
+      query( "* marked:'#{element}'", {:setText => text} )
+    else
+      query( query, {:setText => text} )
+    end
+  end
+
+  def touch_screen_element element
+    begin
+      wait_for(:timeout => 5) { element_exists("* marked:'#{element}'") }
+      touch "* marked:'#{element}'"
+    rescue
+      raise "Element #{element} not found on the view"
+    end
+  end
+
+  def touch_element_by_index id, index
+    wait_for(:timeout => 5) { element_exists("* marked:'#{id}' index:#{index}") }
+    touch("* marked:'#{id}' index:#{index}")
+  end
+
+end

data/lib/skeleton/features/ios/support/01_launch.rb

@@ -0,0 +1,84 @@
+########################################
+#                                      #
+#       Important Note                 #
+#                                      #
+#   When running calabash-ios tests at #
+#   www.xamarin.com/test-cloud         #
+#   the  methods invoked by            #
+#   CalabashLauncher are overriden.    #
+#   It will automatically ensure       #
+#   running on device, installing apps #
+#   etc.                               #
+#                                      #
+########################################
+
+require 'calabash-cucumber/launcher'
+
+# APP_BUNDLE_PATH = "~/Library/Developer/Xcode/DerivedData/??/Build/Products/Calabash-iphonesimulator/??.app"
+# You may uncomment the above to overwrite the APP_BUNDLE_PATH
+# However the recommended approach is to let Calabash find the app itself
+# or set the environment variable APP_BUNDLE_PATH
+
+Before('@reinstall') do |scenario|
+  reinstall_app
+end
+
+Before do |scenario|
+  
+  # If the scenario is outline, to get the feature title we have to access a different attribute of the variable scenario,
+  # so this function changes the value of the scenario variable so we don't have to do this on the verification step below 
+  @scenario_is_outline = (scenario.class == Cucumber::Ast::OutlineTable::ExampleRow)
+  if @scenario_is_outline 
+    scenario = scenario.scenario_outline 
+  end
+  # Looks if is a new feature that will be executed
+  if ENV['FEATURE_NAME'] != scenario.feature.title # ENV['FEATURE_NAME'] is just an aux created to store the feature name
+    reinstall_app # always reinstall the app before a the execution of a new feature
+    ENV['FEATURE_NAME'] = scenario.feature.title
+  end 
+
+  @calabash_launcher = Calabash::Cucumber::Launcher.new
+  unless @calabash_launcher.calabash_no_launch?
+    @calabash_launcher.relaunch
+    @calabash_launcher.calabash_notify(self)
+  end
+
+end
+
+After do |scenario|
+  unless @calabash_launcher.calabash_no_stop?
+    calabash_exit
+    if @calabash_launcher.active?
+      @calabash_launcher.stop
+    end
+  end
+end
+
+at_exit do
+  launcher = Calabash::Cucumber::Launcher.new
+  if launcher.simulator_target?
+    launcher.simulator_launcher.stop unless launcher.calabash_no_stop?
+  end
+end
+
+# Install or reinstall the app on the device
+def reinstall_app
+
+  system( "echo 'Installing the app...'" )  
+
+  # Trying to reinstall the app
+  success = system "ios-deploy -r -b #{ENV['APP_BUNDLE_PATH']} -i #{ENV['DEVICE_TARGET']} -t 5 > /dev/null"
+
+  # If the app is not installed the above command will throw an error
+  # So we just install the app
+  if !success
+    success = system "ios-deploy -b #{ENV['APP_BUNDLE_PATH']} -i #{ENV['DEVICE_TARGET']} -t 5 > /dev/null"
+    if !success # If there is any error raises an exception
+      raise 'Error. Could not install the app.'
+    end
+  end
+
+  system( "echo 'Installed.'" )
+
+  sleep(3) # Gives to the iphone a time to finish the installation of the app
+end

data/lib/skeleton/features/step_definitions/base_steps.rb

@@ -0,0 +1,39 @@
+######### GIVEN #########
+
+Given(/^I (?:drag|dragged) the screen (down|up|left|right) until I see the element "(.*?)"$/) do |direction, element|
+  @page.drag_until_element_is_visible_with_special_query direction.to_sym, element
+end
+
+Given(/^I am on a page that contains '(.*?)'$/) do |page_text|
+  @page.is_on_page? page_text
+end
+
+######### WHEN #########
+
+When(/^I drag the screen (left|right|down|up) (\d+) times$/) do |direction, times|
+  @page.drag_for_specified_number_of_times(direction.to_sym, times.to_i)
+end
+
+When(/^I (?:touch|touched) the "(.*?)" element$/) do |element|
+  @page.touch_screen_element element
+end
+
+When(/^I drag the screen (down|up|left|right)$/) do |direction|
+  @page.drag_to direction.to_sym
+end
+
+######### THEN #########
+
+Then(/^I (?:wait|waited) for the progress bar to vanish$/) do
+  # wait_for_progress is a method of the base class, so doesn't matter what is the value
+  # of the @page variable, because all screens will have this method
+  @page.wait_for_progress
+end
+
+Then(/^I should see the page '(.*?)'$/) do |page_text|
+  @page.is_on_page? page_text
+end
+
+Then(/^I should see a page that contains '(.*?)'$/) do |page_text|
+  @page.is_on_page? page_text
+end

data/lib/skeleton/features/support/env.rb

@@ -0,0 +1,5 @@
+if ENV['PLATFORM'] == 'ios'
+ require 'calabash-cucumber/cucumber'
+elsif ENV['PLATFORM'] == 'android'
+  require 'calabash-android/cucumber'
+end

metadata

@@ -0,0 +1,113 @@
+--- !ruby/object:Gem::Specification
+name: cs-bdd
+version: !ruby/object:Gem::Version
+  version: 0.0.5
+platform: ruby
+authors:
+- Oscar Tanner
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-11-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+description: A simple gem to generate all the folder and files needed to create an
+  android and iOS calabash project.
+email:
+- oscar.tanner@concretesolutions.com.br
+executables:
+- cs-bdd
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/cs-bdd
+- bin/cs-bdd-generate.rb
+- bin/cs-bdd-helpers.rb
+- cs-bdd.gemspec
+- lib/cs/bdd.rb
+- lib/cs/bdd/version.rb
+- lib/examples/example.feature
+- lib/examples/example_screen.rb
+- lib/examples/example_steps.rb
+- lib/skeleton/.gitignore
+- lib/skeleton/README.md
+- lib/skeleton/config/cucumber.yml
+- lib/skeleton/config/scripts/android/run_tests_all_devices.sh
+- lib/skeleton/config/scripts/ios/build_app.sh
+- lib/skeleton/config/scripts/ios/devices
+- lib/skeleton/config/scripts/ios/run_tests_all_devices.sh
+- lib/skeleton/features/android/android_screen_base.rb
+- lib/skeleton/features/android/features/.gitkeep
+- lib/skeleton/features/android/features/android.feature
+- lib/skeleton/features/android/screens/example_screen.rb
+- lib/skeleton/features/android/steps_definition/.gitkeep
+- lib/skeleton/features/android/support/app_installation_hooks.rb
+- lib/skeleton/features/android/support/app_life_cycle_hooks.rb
+- lib/skeleton/features/android/support/hooks.rb
+- lib/skeleton/features/example.feature
+- lib/skeleton/features/ios/features/.gitkeep
+- lib/skeleton/features/ios/features/ios.feature
+- lib/skeleton/features/ios/ios_screen_base.rb
+- lib/skeleton/features/ios/screens/example_screen.rb
+- lib/skeleton/features/ios/steps_definition/.gitkeep
+- lib/skeleton/features/ios/support/01_launch.rb
+- lib/skeleton/features/ios/support/02_pre_stop_hooks.rb
+- lib/skeleton/features/step_definitions/base_steps.rb
+- lib/skeleton/features/support/env.rb
+homepage: https://github.com/CSOscarTanner/cs-bdd
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.2
+signing_key: 
+specification_version: 4
+summary: Generates an android and iOS calabash project.
+test_files: []