framework_gem 0.1.0 → 0.2.0

data/lib/User_Lib/screen/mobile/android/android_login.rb

@@ -1,111 +0,0 @@
-require './lib/screen/mobile/android/android_screen'
-require './lib/screen/mobile/login_mobile'
-
-# Defines Android-specific methods on the Login screen
-
-class AndroidLogin < AndroidScreen
-  include LoginMobile
-
-  # Internal: Closes the tour, enters username and password and hits sign-in button. Called by login method
-  # 
-  # Examples:
-  #   dut.screens.login.sign_in?
-  #   # => 'True'
-  #
-  # Returns a boolean value of true if the app signs in successfully, else returns false
-  def sign_in?(args={:username => nil, :password => nil})
-    loginfo2 'Signing in to Android Phone'
-    username = args[:username] || dut.username
-    password = args[:password] || dut.password
-    return false unless dut.tap?({:name => 'com.TWCableTV:id/closeTourButton', :timeout => 90.sec})
-    return false unless dut.tap?({:name => 'com.TWCableTV:id/username'})
-    return false unless dut.type?({:keys => username, :touch => false})
-    return false unless dut.tap?({:name => 'com.TWCableTV:id/password', :timeout => 0.sec})
-    return false unless dut.type?({:keys => password, :touch => false})
-    dut.tap?({:name => 'com.TWCableTV:id/signinButton'})
-  end
-
-  # Public: Logs in to the app with the twctvCAT username
-  #
-  # Examples:
-  #   dut.screens.login.login?
-  #   # => 'True'
-  #
-  # Returns a boolean value of 'True' if the app logs in successfully, else returns 'False'
-  def login?(args={:username => nil, :password => nil})
-    loginfo2 'Logging in Android Phone'
-    return false unless sign_in?(args)
-    if dut.tap?({:name => 'android:id/button1', :timeout => 10.sec})
-      loginfo('Dismissed content notification', false, true)
-    end
-    if dut.tap?({:name => 'com.TWCableTV:id/agreeButton', :timeout => 10.sec})
-      loginfo2('Agreed to Terms')
-    end
-    if dut.tap?({:name => 'android:id/button1', :timeout => 10.sec})
-      loginfo2('Dismissed Parental Controls notification')
-    end
-	if dut.tap?({:text => 'Allow', :timeout => 10.sec})
-	  loginfo2('Allowed Android permission')
-	end
-	if dut.tap?({:text => 'Allow', :timeout => 10.sec})
-	  loginfo2('Allowed Android permission')
-	end
-    true
-  end
-
-  # Public: Attempts to log in the app with an invalid username and password
-  #
-  # Example:
-  #   dut.screens.login.enter_bad_login?
-  #   # => 'True'
-  #
-  # Returns a boolean value of 'True' if the app successfully enters the invalid 
-  # username and password, else returns 'false'
-  def enter_bad_login?(args={:username => 'abc', :password => 'xyz'})
-    loginfo2 'Entering bad login on Android Phone'
-    sign_in?(args)
-  end
-
-  # Public: Checks for "Invalid Login" text
-  #
-  # Example:
-  #   dut.screens.login.is_login_invalid?
-  #   # => 'True'
-  def is_login_invalid?
-    dut.element?({:text=>"Invalid Login",:timeout=>90.sec})
-  end
-
-  # Public: Gets and returns the text in the username field
-  #
-  # Example:
-  # dut.screens.login.get_username
-  #   # => 'twctvCAT'
-  #
-  # Returns the text in the username field
-  def get_username(args={:timeout => 30.sec})
-    dut.element({:name => 'com.TWCableTV:id/username', :timeout => args[:timeout]})[:text]
-  end
-
-  # Public: Gets and returns the text in the password field
-  #
-  # Example:
-  # dut.screens.login.get_password
-  #   # => 'password1234'
-  #
-  # Returns the text in the password fieldld
-  def get_password
-    dut.element({:name => 'com.TWCableTV:id/password'})[:text]
-  end
-
-  # Public: Checks if the Sign In button is disabled
-  #
-  # Example:
-  # dut.screens.login.cannot_sign_in?
-  #   # => 'True'
-  #
-  # Returns true if the Sign In button is disabled
-  def cannot_sign_in?
-    dut.element?({:text => 'Sign In', :is_enabled => false})
-  end
-
-end

data/lib/User_Lib/screen/mobile/android/android_main_menu.rb

@@ -1,53 +0,0 @@
-require './lib/screen/mobile/android/android_screen'
-require './lib/screen/mobile/main_menu_mobile'
-
-# Defines Android-specific methods on the Main Menu screen
-
-class AndroidMainMenu < AndroidScreen
-  include MainMenuMobile
-
-  # Public: Navigates to the screen with the given name
-  def navigate_to?(name)
-	dut.tap?({:description => 'Open navigation drawer'})
-	sleep(2000)
-    dut.tap?({:text => name})
-  end
-
-  # Deprecated: Returns true if the Main Menu is displayed, otherwise false
-  #
-  # Examples
-  #
-  #   dut.scenes.main_menu.displayed?
-  #   # => 'True'
-  #
-  # Returns a boolen value of 'True' if the main menu is displayed, else returns 'False'
-  def displayed?
-  # Comment
-    dut.element?({:name => 'com.TWCableTV:id/homeLiveTv'}) && dut.element?({:name => 'com.TWCableTV:id/homeGuide'}) &&
-        dut.element?({:name => 'com.TWCableTV:id/homeDvr'}) && dut.element?({:name => 'com.TWCableTV:id/homeVOD'}) &&
-        dut.element?({:name => 'com.TWCableTV:id/homeSettings'})
-  end
-  
-  # Deprecated: Navigate back to main menu
-  #
-  # Examples
-  #
-  #   dut.scenes.main_menu.return_to_main_menu?
-  #   # => 'True'
-  #
-  # Returns a boolean value of 'True' if the app successfully navigates back to the main
-  # menu successfully, else returns 'False'
-  #
-  def return_to_main_menu?
-  	back_press = 5
-	home = dut.element?({:text => 'Live TV'}) and dut.element?({:text => 'Guide'}) and dut.element?({:text => 'On Demand'})
-	while !home and back_press > 0 do
-		tcfail 'No back button found' unless dut.tap?({:name => 'com.TWCableTV:id/phoneHeaderBackButton'})
-		home = dut.element?({:text => 'Live TV'}) and dut.element?({:text => 'Guide'}) and dut.element?({:text => 'On Demand'})
-		back_press = back_press - 1
-	end
-	
-	return true
-  end
-
-end

data/lib/User_Lib/screen/mobile/android/android_on_demand.rb

@@ -1,402 +0,0 @@
-require './lib/screen/mobile/android/android_screen'
-require './lib/screen/mobile/on_demand_mobile'
-
-# Defines Android-specific methods on the On Demand screen
-
-class AndroidOnDemand < AndroidScreen
-  include OnDemandMobile
-
-  # Returns true if the given category is found, otherwise false
-  def category?(category)
-    text = category.eql?('TV') ? 'regexp:^TV( Shows)?$' : category
-    dut.element?({:text => text})
-  end
-
-  # Returns true if successfully selected the given category, otherwise false
-  def select_category?(category)
-    logger.info("Selecting category #{category.inspect}")
-    text = category.eql?('TV') ? 'regexp:^TV( Shows)?$' : category
-    dut.tap?({:text => text})
-  end
-
-  #
-  # Look for something unique on the player screen. Video motion detection
-  # ROIs don't seem to work very well on mobile or I'd use one.
-  #
-  
-  def streaming?
-    dut.element?({:name => "com.TWCableTV:id/LayoutPlayer", :timeout => 25.sec})
-  end
-
-  def select_random_featured_asset(args = {})
-    retval = nil
-    elements = dut.elements({:type => "android.view.View"})
-    if nil != elements
-      size = elements.size() - 3
-      idx = rand(size) + 2
-      idx = idx.to_i
-      # Can't really know what the title is until we tap it with the
-      # current build
-      logger.info("Tapping android.vew.View index #{idx}")
-      sleep 5.sec
-      dut.tap?({:type => "android.view.View", :index => idx})
-      sleep 20.sec
-      title_element = dut.element({:name => 'com.TWCableTV:id/minorCatName'})
-      tcfail "Did not get a title element" unless ! title_element.nil?
-      retval = title_element.text
-    end
-    return retval
-  end
-  
-  # Returns a list of the visible titles in list view as an array of strings
-  def get_visible_titles
-    titles = []
-    count = nil
-    until count == titles.count
-      count = titles.count
-      titles = dut.elements({:name => 'com.TWCableTV:id/vodEventTitle', :min => 1, :info => [:text]}) || []
-    end
-    logger.info("Visible titles: #{titles.inspect}")
-    titles
-  end
-
-  def get_all_titles
-    logger.info("Getting all titles")
-    sleep 10.sec
-    retval = []
-    last_first_element = ""
-    this_first_element = "a"
-    while (last_first_element != this_first_element)
-      last_first_element = this_first_element
-      scroll_area = dut.screens.on_demand.list_scroll_area
-      if (last_first_element != "a")
-        # Don't scroll down the first time so we can get elements
-        # from the first page (This will fail if some jerkbag
-        # names a TV show "a")
-        tcfail 'Failed to scroll!' unless dut.screens.on_demand.scroll_down?(1, :area => scroll_area)        
-      end
-
-      titles = get_visible_titles
-      if (nil != titles && !titles.empty?)
-        this_first_element = titles[0]
-      end
-      titles.each do |title|
-        retval.push(title)
-      end
-    end
-    retval = retval.uniq # Elide duplicates
-    logger.info("Titles: #{retval.inspect}")
-    retval
-  end
-
-  # Returns a list of the visible assets in grid view as an array of coordinates
-  #TODO: we need these assets tagged so we know what they are
-  def get_visible_assets(args={})
-    category = args[:category]
-    elements = []
-    count = nil
-    until count == elements.count
-      count = elements.count
-      elements = dut.elements({:type => 'android.view.View', :is_tappable => true, :min => 1})
-      unless category.nil?
-        # This is a bit tricky. Since the assets are not labeled with their category, we have to find the ones that are
-        # within the scroll area for that category.
-        scroll_area = category_scroll_area(category)
-        elements = elements.reject do |asset|
-          scroll_area.nil? || asset[:y] < scroll_area[:y] && asset[:y] > (scroll_area[:y] + scroll_area[:height])
-        end
-      end
-      elements = [] if elements.nil?
-    end
-    tcfail "Failed to get visible assets#{category.nil? ? '' : %Q( for category "#{category}")}!" if elements.count == 0
-    # "
-    elements.map {|asset| [asset[:x], asset[:y], asset[:width], asset[:height]]}
-  end
-
-  def back_to?(category)
-    dut.tap?({:name => 'com.TWCableTV:id/phoneHeaderBackButton', :text => category})
-  end
-
-  def select_view_all?(n)
-    dut.tap?({:name => 'com.TWCableTV:id/vodPodViewAll', :y => 0.99, :index => n})
-  end
-
-  # Returns the visible minor categories
-  def get_visible_categories
-    elements = []
-    count = nil
-    until count == elements.count
-      count = elements.count
-      elements = dut.elements({:name => 'com.TWCableTV:id/vodPodCategoryText', :min => 1, :info => [:text]})
-      elements = [] if elements.nil?
-    end
-    elements
-  end
-
-  # Returns the number of visible View All buttons
-  def visible_view_all_count
-    (dut.elements({:name => 'com.TWCableTV:id/vodPodViewAll', :min => 1}) || []).count
-  end
-
-  # Returns the scroll area for the given category
-  def category_scroll_area(category, args={})
-    logger.info("Getting scroll area for category: #{category}")
-    if args[:categories].nil?
-      cats = get_visible_categories
-    else
-      cats = args[:categories]
-    end
-    areas = dut.elements({:name => 'com.TWCableTV:id/podContainerView'})
-    # Eliminate any area at the top that is not fully within the scroll area
-    if areas.first[:y] <= scroll_area[:y]
-      areas.shift
-    end
-    areas[cats.index(category)]
-  end
-
-  # Returns the time elapsed text as a string
-  def time_elapsed_text
-    timeout = 30.sec
-    start_time = Time.now
-    while ((Time.now - start_time) * 1000) <= timeout
-      txt = dut.element({:name => 'com.TWCableTV:id/txtCurrent', :info => [:text], :timeout => 1.sec})
-      if txt.nil?
-        tap_content
-      else
-        return txt
-      end
-    end
-    tcfail 'Failed to get time elapsed text!'
-  end
-
-  # Taps the content window
-  def tap_content
-    tcfail 'Failed to tap content!' unless dut.tap?({:name => 'com.TWCableTV:id/gl_containerVod'})
-  end
-
-  # Returns true if successfully stopped playing asset, otherwise false
-  def stop?
-    unless dut.tap?({:name => 'com.TWCableTV:id/btnStop'})
-      tap_content
-      return dut.tap?({:name => 'com.TWCableTV:id/btnStop'})
-    end
-    true
-  end
-
-  # Selects a random list asset and returns the title
-  def select_random_list_title
-    logger.info("Selecting random list title")
-    # Scroll a random number of times
-    tcfail 'Failed to scroll!' unless scroll_down?((0..3), :area => list_scroll_area)
-    visible_titles = get_visible_titles
-    title = visible_titles[rand(visible_titles.count)]
-    logger.info("---> Tapping #{title}")
-    tcfail 'Failed to select asset!' unless dut.tap?({:name => 'com.TWCableTV:id/vodEventTitle', :text => title})
-    if is_pin_prompt?
-      tcfail 'Failed to enter PIN!' unless enter_pin?
-    end
-
-    title
-  end
-
-  # Selects a random grid asset and returns the title
-  def select_random_grid_title
-    title = nil
-    retries = 0
-    max_retries = 6
-    while (title.nil? && retries < max_retries)
-      # Scroll a random number of times
-      tcfail 'Failed to scroll!' unless scroll_down?((0..3), :area => grid_scroll_area)
-      count = get_visible_assets.count
-      tcfail 'Failed to select asset!' unless dut.tap?(
-                                                {:type => 'android.view.View', :is_tappable => true, :index => rand(count) + 1})
-      if is_pin_prompt?
-        tcfail 'Failed to enter PIN!' unless enter_pin?
-      end
-      title = dut.element({:name => 'com.TWCableTV:id/minorCatName', :info => [:text]})
-      retries = retries + 1
-    end
-    return title
-  end
-
-  def current_category
-    dut.element({:name => 'com.TWCableTV:id/minorCatName', :info => [:text]})
-  end
-
-  # Returns the list scroll area
-  def list_scroll_area(args = nil)
-    # Note: the list scroll area for minor categories is minorContentListView, while the list scroll area for major
-    #       categories is minorListView
-    if (args.nil?) 
-         args = {}
-    end
-    args[:name] =  'regexp:^com.TWCableTV:id/minor(Content)?ListView$'
-    scroll_area = dut.element(args)
-    # TODO: this shouldn't be necessary. the timeout can be increased by setting the :timeout parameter like:
-    # TODO: dut.element({:name => 'foo', :timeout => 2.min})
-    if scroll_area.nil?
-      args[:name] = 'com.TWCableTV:id/minorListView'
-      scroll_area = dut.element(args)
-    end
-    # TODO: need to check whether this affects existing usages of this method which do not specify :fail_on_error,
-    # TODO: which would formerly have been true by default
-    if (nil != args[:fail_on_error] && args[:fail_on_error] != false)
-      tcfail 'Failed to find list scroll area!' if scroll_area.nil?
-    end                                                                     
-    scroll_area
-  end
-
-  # Returns the grid scroll area
-  def grid_scroll_area
-    # Note: the list scroll area for minor categories is minorContentGridView, while the list scroll area for major
-    #       categories is minorGridView
-    scroll_area = dut.element({:name => 'regexp:^com.TWCableTV:id/minor(Content)?GridView$'})
-    if (scroll_area.nil?)
-      # For some reason regexps never seem to work so well for me
-      scroll_area = dut.element({:name => "com.TWCableTV:id/minorGridView"})
-    end
-    if scroll_area.nil?
-      # Try networkTieryaddayadda
-      scroll_area = dut.element({:name => "com.TWCableTV:id/networkTierGridView"})
-    end
-    if scroll_area.nil?
-      # Er... viewPager maybe?
-      scroll_area = dut.element({:name => "com.TWCableTV:id/viewPager"})
-    end
-    
-    tcfail 'Failed to find grid scroll area!' if scroll_area.nil?
-    scroll_area
-  end
-
-  # Returns the main scroll area
-  def scroll_area
-    scroll_area = dut.element({:name => 'com.TWCableTV:id/vodMajorPodsScrollView'})
-    tcfail 'Failed to find scroll area!' if scroll_area.nil?
-    scroll_area
-  end
-
-  #
-  # Returns the first and last visible titles on the VOD featured
-  # page. The only way that I can see to actually get these titles is
-  # to select the VOD asset and scrape the title off its asset page.
-  # They're using views for the asset graphic, and there are always
-  # at most 2.5 rows of assets on a page, so I'm keying off the index
-  # number of the asset.
-  #
-  # Parameters:
-  #   first - Index of first visible asset in row
-  #   last - index of last visible asset in row
-  #
-  # Returns: Array with titles of each asset. Array
-  # may be empty if something goes wrong, so check its size.
-  
-  def vod_featured_first_last_title(first = 2, last = 8, retry_scroll_area = nil)
-    retries = 0
-    max_retries = 3
-    logger.info("Getting titles")
-    retval = []
-    [first, last].each do |index|
-      title_element = nil
-      while(title_element.nil? && retries <= max_retries)
-        begin
-          dut.tap?({:type => 'android.view.View', :index => index})
-          
-          sleep 5.sec
-          title_element = dut.element({:name => 'com.TWCableTV:id/minorCatName'})
-        rescue => e
-        end
-        if (title_element.nil?)
-          if (retry_scroll_area.nil? || retries > max_retries)
-            # This mostly seems to happen if the asset is mostly off the screen.
-            # If we still don't get a title, we're probably at the end of the
-            # VOD features list
-            logger.info("Could not find title of asset (probably at end of VOD features list)")
-            return retval
-          else
-            # Try scrolling down just a little
-            logger.info("Didn't get title element. Trying to skootch the screen down a bit (retries = #{retries}/#{max_retries}")
-            start_x = retry_scroll_area[:width] * 0.5
-            start_y = retry_scroll_area[:height] * 0.95
-            end_x = start_x
-            end_y = retry_scroll_area[:height] * 0.8
-            duration = 1000.ms
-            retries = retries + 1
-
-            dut.swipe?({:from => {:x => start_x, :y => start_y, :coordinates => true},
-                        :to => {:x => end_x, :y => end_y, :coordinates => true},
-                        :duration => duration}, :sleep_time => 1.sec)
-          end
-        else
-          retval.push(title_element.text)
-          dut.back?()
-          sleep 5.sec
-        end
-      end
-    end
-    logger.info("Returning titles: #{retval.inspect}")
-    return retval
-  end
-  
-  # Returns the name of the highlighted category
-  def highlighted_category
-    logger.info("Checking highlighted category")
-    rois = [dut.roi.image.onDemandFeaturedHighlit,
-            dut.roi.image.onDemandTvShowsHighlit,
-            dut.roi.image.onDemandMoviesHighlit,
-            dut.roi.image.onDemandKidsHighlit,
-            dut.roi.image.onDemandNetworksHighlit]
-    button_text = ["Featured", "TV Shows", "Movies", "Kids", "Networks"]
-    
-
-    rois.each_with_index do |roi,i|
-      logger.info("Checking #{button_text[i]}")
-      if (roi.displayed?(:timeout => 15.sec))
-        logger.info("#{button_text[i]} appears to be highlighted.")
-        return button_text[i]
-      end
-    end
-    
-    tcfail 'Failed to get highlighted category!'
-  end
-
-  def select_random_network
-    logger.info("Selecting a random network")
-    retries = 0
-    network_selected = false
-    while (!network_selected && retries < 5)
-      scroll_area = dut.element({:name => 'com.TWCableTV:id/networkGridview'})
-      tcfail "Failed to scroll!" unless scroll_down?((0..3), :area => scroll_area)
-      # Grab vodNetworkImageView elements and pick one randomly
-      visible_networks = dut.elements({:name => 'com.TWCableTV:id/vodNetworkImageView'})
-      tcfail "No visible networks" unless visible_networks.count() > 0
-      network = visible_networks[rand(visible_networks.count())]
-      tcfail "Failed to select network" unless dut.tap?({:name => network.name, :index => network.index})
-      sleep 10.sec
-      if (dut.element?({:name => 'com.TWCableTV:id/networkHeaderLogo', :timeout => 30.sec}))
-        network_selected = true
-      end
-      # Unfortunately the network looks like it contains an icon
-      # and not a text tag. I could argue for doing a
-      # sword_attach_screenshot here, but screenshots in appium
-      # significantly impact the run time of the test.
-      if (network_selected) 
-        logger.info("Successfully selected a random network.")
-      else
-        if (!dut.elements?({:name => "com.TWCableTV:id/vodNetworkImageView"}))
-          dut.back()
-        end
-        retries = retries + 1
-      end
-    end
-    return true
-  end
-
-  #
-  # Android phone at least doesn't seem to have subcategories.
-  # May need to specialize this for tablet tests.
-  #
-  def select_random_network_category
-    return true
-  end
-  
-end