sunomono 0.2.0.pre

data/lib/sunomono/locales/en.yml

@@ -0,0 +1,27 @@
+en:
+  android_only: "(Android Only)"
+  ios_only: "(iOS Only)"
+  first_scenario: "First Scenario"
+  comments:
+    trait: "The screen identificator"
+    insert_steps: "Insert steps"
+    elements: "Declare all the elements of this screen"
+    actions: "Declare all actions of this screen"
+  steps:
+    drag_until: 'I (?:drag|dragged) the screen (down|up|left|right) until I see the element "(.*?)"'
+    page_contains: "I am on a page that contains '(.*?)'"
+    drag_number_of_times: 'I drag the screen (left|right|down|up) (\d+) times'
+    touch_element: 'I (?:touch|touched) the "(.*?)" element'
+    drag_screen: "I drag the screen (down|up|left|right)"
+    wait_progress_bar: "I (?:wait|waited) for the progress bar to vanish"
+    should_see_page: "I should see the page '(.*?)'"
+    should_see_page_that_contains: "I should see a page that contains '(.*?)'"
+    take_print: "take picture"
+    been_in_page: "I am at (?:page|screen) '(.*?)'"
+    move_to_page: "I went to (?:page|screen) '(.*?)'"
+    restart_app: "I restart the app"
+  directions:
+    up: 'up'
+    down: 'down'
+    left: 'left'
+    right: 'right'

data/lib/sunomono/locales/pt.yml

@@ -0,0 +1,27 @@
+pt:
+  android_only: "(Somente Android)"
+  ios_only: "(Somente iOS)"
+  first_scenario: "Primeiro Cenario"
+  comments:
+    trait: "Identificador da tela"
+    insert_steps: "Insira os passos"
+    elements: "Declare todos os elementos da tela"
+    actions: "Declare todas as acoes da tela"
+  steps:
+    drag_until: 'que Eu (?:arrastei|arrasto) a tela para (baixo|cima|esquerda|direita) ate ver o elemento "(.*?)"'
+    page_contains: "que Eu estou em uma pagina que contem '(.*?)'"
+    drag_number_of_times: 'Eu arrasto a tela para (esquerda|direita|baixo|cima) (\d+) vezes'
+    touch_element: 'Eu (?:clico|cliquei) no elemento "(.*?)"'
+    drag_screen: "Eu arrasto a tela para (baixo|cima|esquerda|direita)"
+    wait_progress_bar: "Eu (?:espero|esperei) ate a barra de progresso sumir"
+    should_see_page: "Eu deveria ver a pagina '(.*?)'"
+    should_see_page_that_contains: "Eu deveria ver uma pagina que contem '(.*?)'"
+    take_print: "faco um print"
+    been_in_page: "que eu (?:estou|estava) na (?:pagina|tela)(?: de|) '(.*?)'"
+    move_to_page: "eu (?:devo|deveria) estar na (?:pagina|tela)(?: de|) '(.*?)'"
+    restart_app: "(?:Eu |)reiniciar o aplicativo"
+  directions:
+    up: 'cima'
+    down: 'baixo'
+    left: 'esquerda'
+    right: 'direita'

data/lib/sunomono/version.rb

@@ -0,0 +1,3 @@
+module Sunomono
+  VERSION = '0.2.0.pre'.freeze
+end

data/lib/templates/android_screen_base.tt

@@ -0,0 +1,186 @@
+require 'calabash-android/abase'
+
+class AndroidScreenBase < Calabash::ABase
+  def self.element(element_name, &block)
+    define_method(element_name.to_s, *block)
+  end
+
+  class << self
+    alias_method :value, :element
+    alias_method :action, :element
+    alias_method :trait, :element
+  end
+
+  def restart_app
+    shutdown_test_server
+    start_test_server_in_background
+  end
+
+  def method_missing(method, *args)
+    if method.to_s.start_with?('touch_')
+      # If method name starts with touch_, executes the touch
+      # screen element method using the element name which is the
+      # method name without the first 'touch_' chars
+      touch_screen_element public_send(method.to_s.sub('touch_', ''))
+    elsif method.to_s.start_with?('enter_')
+      # If method starts with enter_, execute the enter method using
+      # the field name, which is the method name without the initial
+      # 'enter_' chars and appended '_field' chars
+      enter args[0], public_send("#{method.to_s.sub('enter_', '')}_field")
+    elsif method.to_s.end_with?('_visible?')
+      # If method ends with _visible?, executes the visible? method
+      # The field name is the method name without de ending
+      # '_visible? chars
+      visible? public_send(method.to_s.sub('_visible?', ''))
+    elsif method.to_s.end_with?('_visible!')
+      # Do the same as the method above, but throws an exception
+      # if the field is not visible
+      field_name = method.to_s.sub('_visible!', '')
+                         .sub('_field', '')
+                         .sub('_', ' ')
+                         .capitalize
+      raise ElementNotFoundError, "ID: #{field_name}" unless
+        visible? public_send(method.to_s.sub('_visible!', ''))
+    else
+      super(method, args)
+    end
+  end
+
+  def visible?(id, query = nil)
+    query = "* id:'#{id}'" if query.nil?
+    begin
+      wait_for(timeout: 3) { element_exists query }
+    rescue
+      return false
+    end
+    true
+  end
+
+  element(:loading_screen)      { 'insert_loading_view_id' }
+
+  # The progress bar of the application is a custom view
+  def wait_for_progress
+    sleep(2)
+    wait_for_element_does_not_exist("* id:'#{loading_screen}'",
+                                    timeout: 10)
+  end
+
+  def drag_to(direction)
+    positions = [0, 0, 0, 0] # [ 'from_x', 'to_x', 'from_y', 'to_y' ]
+
+    case(direction)
+    when :<%= (I18n.translate "directions.down").to_sym %>
+      positions = [30,30,60,30]
+    when :<%= (I18n.translate "directions.up").to_sym %>
+      positions = [80,80,60,90]
+    when :<%= (I18n.translate "directions.left").to_sym %>
+      positions = [90,20,80,80]
+    when :<%= (I18n.translate "directions.right").to_sym %>
+      positions = [20,90,80,80]
+    else
+      raise 'Direction not known!'
+    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] '#{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(2)
+    while !element_exists(element_query) && i < limit
+      drag_to direction
+      i += 1
+    end
+
+    fail "Executed #{limit} moviments #{direction} 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
+
+  # Negation indicates that we want a page that doesn't
+  # has the message passed as parameter
+  def is_on_page?(page_text, negation = '')
+  fail 'Error! Invalid query string!' if
+       page_text.to_s == ''
+
+    should_not_have_exception = false
+    should_have_exception = false
+    begin
+      wait_for(timeout: 5) { has_text? page_text }
+      # If negation is not nil, we should raise an error
+      # if this message was found on the view
+      should_not_have_exception = true unless negation == ''
+    rescue
+      # only raise exception if negation is nil,
+      # otherwise this is the expected behaviour
+      should_have_exception = true if negation == ''
+    end
+
+    fail "Unexpected Page. The page should not have: '#{page_text}'" if
+      should_not_have_exception
+
+    fail "Unexpected Page. Expected was: '#{page_text}'" if
+      should_have_exception
+  end
+
+  def enter(text, element, query = nil)
+    if query.nil?
+      query("* marked:'#{element}'", setText: text.to_s)
+    else
+      query(query, setText: text.to_s)
+    end
+  end
+
+  def touch_screen_element(element, query = nil)
+    query = "* id:'#{element}'" if query.nil?
+    begin
+      wait_for(timeout: 5) { element_exists(query) }
+      touch(query)
+    rescue => e
+      raise "Problem in touch screen element: '#{element}'\nError Message: #{e.message}"
+    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
+
+  def clear_text_field(field)
+    clear_text_in("android.widget.EditText id:'#{field}'}")
+  end
+
+  def select_date_on_date_picker(date, date_picker_field_id)
+    # Touch the date picker field
+    touch "* id:'#{date_picker_field_id}'"
+
+    # Setting the date
+    set_date 'DatePicker', date.year, date.month, date.day
+
+    # Clicking in the Done button
+    touch "* id:'button1'"
+  end
+end

data/lib/templates/base_steps.tt

@@ -0,0 +1,48 @@
+######### <%= I18n.translate( :given ).upcase %> #########
+<%= I18n.translate( :given ).capitalize %>(/^<%= I18n.translate( "steps.drag_until" ) %>$/) do |direction, element|
+  @page.drag_until_element_is_visible_with_special_query direction.to_sym, element
+end
+
+<%= I18n.translate( :given ).capitalize %>(/^<%= I18n.translate( "steps.page_contains" ) %>$/) do |page_text|
+  @page.is_on_page? page_text
+end
+
+######### <%= I18n.translate( :when ).upcase %> #########
+
+<%= I18n.translate( :when ).capitalize %>(/^<%= I18n.translate( "steps.drag_number_of_times" ) %>$/) do |direction, times|
+  @page.drag_for_specified_number_of_times(direction.to_sym, times.to_i)
+end
+
+<%= I18n.translate( :when ).capitalize %>(/^<%= I18n.translate( "steps.touch_element" ) %>$/) do |element|
+  @page.touch_screen_element element
+end
+
+<%= I18n.translate( :when ).capitalize %>(/^<%= I18n.translate( "steps.drag_screen" ) %>$/) do |direction|
+  @page.drag_to direction.to_sym
+end
+
+<%= I18n.translate( :when ).capitalize %>(/^<%= I18n.translate( "steps.restart_app" ) %>$/) do
+  @page.restart_app
+end
+
+######### <%= I18n.translate( :then ).upcase %> #########
+
+<%= I18n.translate( :then ).capitalize %>(/^<%= I18n.translate "steps.wait_progress_bar" %>$/) 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
+
+<%= I18n.translate( :then ).capitalize %>(/^<%= I18n.translate "steps.should_see_page" %>$/) do |page_text|
+  @page.is_on_page? page_text
+end
+
+<%= I18n.translate( :then ).capitalize %>(/^<%= I18n.translate "steps.should_see_page_that_contains" %>$/) do |page_text|
+  @page.is_on_page? page_text
+end
+<% unless I18n.config.default_locale == :en %>
+
+<%= I18n.translate( :then ).capitalize %>(/^<%= I18n.translate "steps.take_print" %>$/) do
+  screenshot_embed
+end
+<% end %>

data/lib/templates/feature.tt

@@ -0,0 +1,8 @@
+<%= "# language: #{options[:lang]}" %>
+<%= I18n.translate( :feature ) %>: <%= config[:name] %> <%= !config[:platform].empty? ? I18n.translate( "#{config[:platform].downcase}_only") : "" %>
+
+  <%= I18n.translate( :background ) %>:
+    # <%= I18n.translate( "comments.insert_steps" ) %>
+    
+  <%= I18n.translate( :scenario ) %>: <%= I18n.translate( :first_scenario ) %>
+    # <%= I18n.translate( "comments.insert_steps" ) %>

data/lib/templates/ios_screen_base.tt

@@ -0,0 +1,249 @@
+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_method :value, :element
+    alias_method :action, :element
+    alias_method :trait, :element
+  end
+
+  def restart_app
+    # Relaunch options
+    options = { timeout: 3000 }
+
+    launcher.relaunch(options)
+    launcher.calabash_notify(self)
+  end
+
+  def method_missing(method, *args)
+    if method.to_s.start_with?('touch_')
+      # If method name starts with touch_, executes the touch
+      # screen element method using the element name which is the
+      # method name without the first 'touch_' chars
+      touch_screen_element public_send(method.to_s.sub('touch_', ''))
+    elsif method.to_s.start_with?('enter_')
+      # If method starts with enter_, execute the enter method using
+      # the field name, which is the method name without the initial
+      # 'enter_' chars and appended '_field' chars
+      enter args[0], public_send("#{method.to_s.sub('enter_', '')}_field")
+    elsif method.to_s.end_with?('_visible?')
+      # If method ends with _visible?, executes the visible? method
+      # The field name is the method name without de ending
+      # '_visible? chars
+      visible? public_send(method.to_s.sub('_visible?', ''))
+    elsif method.to_s.end_with?('_visible!')
+      # Do the same as the method above, but throws an exception
+      # if the field is not visible
+      field_name = method.to_s.sub('_visible!', '')
+                         .sub('_field', '')
+                         .sub('_', ' ')
+                         .capitalize
+      raise ElementNotFoundError, "ID: #{field_name}" unless
+        visible? public_send(method.to_s.sub('_visible!', ''))
+    else
+      super(method, args)
+    end
+  end
+
+  def visible?(id, query = nil)
+    query = "* id:'#{id}'" if query.nil?
+    begin
+      wait_for(timeout: 3) { element_exists query }
+    rescue
+      return false
+    end
+    true
+  end
+
+
+  element(:loading_screen)            { 'LOADING' }
+
+  # The progress bar of the application is a custom view
+  def wait_for_progress
+    sleep(2)
+    wait_for(timeout: 10) { element_does_not_exist "* marked:'#{loading_screen}'" }
+  end
+
+  def has_text?(text)
+    !query("* {text CONTAINS[c] '#{text}'}").empty? ||
+      !query("* {accessibilityLabel CONTAINS[c] '#{text}'}").empty?
+  end
+
+  def drag_to(direction, element = nil)
+    element = 'scrollView' if element.nil?
+
+    case direction
+    when :<%= (I18n.translate "directions.down").to_sym %>
+      direction = { x: 0, y: -100 }
+    when :<%= (I18n.translate "directions.up").to_sym %>
+      direction = { x: 0, y: 100 }
+    when :<%= (I18n.translate "directions.left").to_sym %>
+      direction = { x: 100, y: 0 }
+    when :<%= (I18n.translate "directions.right").to_sym %>
+      direction = { x: -100, y: 0 }
+    else
+      raise 'Direction not known!'
+    end
+
+    flick(element, direction)
+    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? 'CONTAINS[c]'
+      if query.include? 'marked'
+        second_query = query.gsub('marked', 'accessibilityLabel')
+      end
+      if query.include? 'accessibilityLabel'
+        second_query = query.gsub('accessibilityLabel', 'marked')
+      end
+    end
+
+    if second_query.nil?
+      return element_exists(query)
+    else
+      element_exists(query) || 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
+
+    query = "* marked:'#{element}'" if query.nil?
+
+    sleep(1)
+    while !ios_element_exists?(query) && i < limit
+      drag_to direction
+      i += 1
+    end
+
+    fail "Executed #{limit} moviments #{direction} 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
+
+  # Negation indicates that we want a page that doesn't has
+  # the message passed as parameter
+  def is_on_page?(page_text, negation = '')
+  fail 'Error! Invalid query string!' if
+       page_text.to_s == ''
+
+    should_not_have_exception = false
+    should_have_exception = false
+    begin
+      wait_for(timeout: 5) { has_text? page_text }
+      # If negation is not nil, we should raise an error
+      # if this message was found on the view
+      should_not_have_exception = true unless negation == ''
+    rescue
+      # only raise exception if negation is nil,
+      # otherwise this is the expected behaviour
+      should_have_exception = true if negation == ''
+    end
+
+    fail "Unexpected Page. The page should not have: '#{page_text}'" if
+      should_not_have_exception
+
+    fail "Unexpected Page. Expected was: '#{page_text}'" if
+      should_have_exception
+  end
+
+  def enter(text, element, query = nil)
+    query = "* marked:'#{element}'" if query.nil?
+
+    begin
+      wait_for(timeout: 5) { element_exists query }
+    rescue
+      # Just a better exception message
+      raise "Element '#{element}' not found on view!"
+    end
+
+    touch query
+    # Waits up to 20 seconds for the keyboard to show up
+    begin
+      wait_for(timeout: 10) { element_exists("view:'UIKeyboardAutomatic'") }
+    rescue
+      # If the keyboard didn't show up, tries another time
+      # before rainsing the error message
+      touch query
+      wait_for(timeout: 5) { element_exists("view:'UIKeyboardAutomatic'") }
+    end
+
+    keyboard_enter_text text
+  end
+
+  def touch_screen_element(element, query = nil)
+    query = "* marked:'#{element}'" if query.nil?
+    begin
+      wait_for(timeout: 5) { element_exists(query) }
+      touch query
+    rescue => e
+      raise "Problem in touch screen element: '#{element}'\nError Message: #{e.message}"
+    end
+  end
+
+  def touch_element_by_index(id, index)
+    query = "* marked:'#{id}' index:#{index}"
+    wait_for(timeout: 5) { element_exists(query) }
+    touch(query)
+  end
+
+  def clear_text_field(field)
+    clear_text("textField marked:'#{field}'")
+  end
+
+  def select_date_on_date_picker(date, date_picker_field_id)
+    # Touch the date picker element
+    touch_screen_element date_picker_field_id
+    # Waiting for the date picker to show up
+    wait_for(timeout: 5) { element_exists("view:'UIDatePicker'") }
+
+    # If date is today, then we have nothing to do
+    if date.year != DateTime.now.year ||
+       date.month != DateTime.now.month ||
+       date.day != DateTime.now.day
+      # Selecting 'date' on the date picker
+      picker_set_date_time date
+    end
+
+    # Touch the OK button
+    touch_screen_element 'Ok'
+  end
+
+  def touch_picker_item_by_index(index)
+    label = query('pickerView', :delegate,
+                  [{ pickerView: nil }, { titleForRow: index },
+                   { forComponent: 0 }])
+
+    # Exception if element no found
+    fail "Picker item index #{index} not found." if label.nil?
+    # Label is an array of 1 element. Just picking the first.
+    label = label.first
+
+    # Touching the first item using it's text and Javascript function
+    uia(%[uia.selectPickerValues('{0 "#{label}"}')])
+
+    # Touching the OK button to close the Picker
+    touch "* marked:'OK'"
+  end
+end