framework_gem 0.1.0

data/lib/lib/screens/stb/stb_screens.rb

@@ -0,0 +1,13 @@
+require './lib/screens/screens'
+require './lib/screen/stb/stb_screen'
+
+# StbScreens adds to or modifies the base screens with STB-specific screens
+
+class StbScreens < Screens
+
+  # Public: Initializes StbScreens. NOT FOR USE IN TESTS.
+  def initialize(*args)
+    super(*args)
+  end
+end
+

data/lib/lib/screens/template.txt

@@ -0,0 +1,52 @@
+require './lib/screens/{PARENT_PATH}/{PARENT_LC}_screens'
+require './lib/screen/{PARENT_PATH}/{PLATFORM_LC}/{PLATFORM_LC}_home'
+require './lib/screen/{PARENT_PATH}/{PLATFORM_LC}/{PLATFORM_LC}_login'
+require './lib/screen/{PARENT_PATH}/{PLATFORM_LC}/{PLATFORM_LC}_dvr'
+require './lib/screen/{PARENT_PATH}/{PLATFORM_LC}/{PLATFORM_LC}_guide'
+require './lib/screen/{PARENT_PATH}/{PLATFORM_LC}/{PLATFORM_LC}_mini_guide'
+require './lib/screen/{PARENT_PATH}/{PLATFORM_LC}/{PLATFORM_LC}_main_menu'
+require './lib/screen/{PARENT_PATH}/{PLATFORM_LC}/{PLATFORM_LC}_on_demand'
+require './lib/screen/{PARENT_PATH}/{PLATFORM_LC}/{PLATFORM_LC}_live_tv'
+require './lib/screen/{PARENT_PATH}/{PLATFORM_LC}/{PLATFORM_LC}_settings'
+require './lib/screen/{PARENT_PATH}/{PLATFORM_LC}/{PLATFORM_LC}_parental_controls'
+require './lib/screen/{PARENT_PATH}/{PLATFORM_LC}/{PLATFORM_LC}_devices'
+require './lib/screen/{PARENT_PATH}/{PLATFORM_LC}/{PLATFORM_LC}_privacy_legal'
+require './lib/screen/{PARENT_PATH}/{PLATFORM_LC}/{PLATFORM_LC}_favorites'
+require './lib/screen/{PARENT_PATH}/{PLATFORM_LC}/{PLATFORM_LC}_search'
+require './lib/screen/{PARENT_PATH}/{PLATFORM_LC}/{PLATFORM_LC}_product_page'
+require './lib/screen/{PARENT_PATH}/{PLATFORM_LC}/{PLATFORM_LC}_watch_later'
+require './lib/screen/{PARENT_PATH}/{PLATFORM_LC}/{PLATFORM_LC}_library'
+require './lib/screen/{PARENT_PATH}/{PLATFORM_LC}/{PLATFORM_LC}_tv_shows'
+require './lib/screen/{PARENT_PATH}/{PLATFORM_LC}/{PLATFORM_LC}_movies'
+require './lib/screen/{PARENT_PATH}/{PLATFORM_LC}/{PLATFORM_LC}_video_store'
+
+# Adds to or modifies the {PARENT} screens with {PLATFORM}-specific screens.
+
+class {PLATFORM}Screens < {PARENT}Screens
+
+  # Public: Initializes {PLATFORM}Screens. NOT FOR USE IN TESTS.
+  def initialize(*args)
+    super(*args)
+    @home = {PLATFORM}Home.new(@dut)
+    @login = {PLATFORM}Login.new(@dut)
+    @dvr = {PLATFORM}Dvr.new(@dut)
+    @guide = {PLATFORM}Guide.new(@dut)
+    @mini_guide = {PLATFORM}MiniGuide.new(@dut)
+    @main_menu = {PLATFORM}MainMenu.new(@dut)
+    @on_demand = {PLATFORM}OnDemand.new(@dut)
+    @live_tv = {PLATFORM}LiveTv.new(@dut)
+    @settings = {PLATFORM}Settings.new(@dut)
+    @parental_controls = {PLATFORM}ParentalControls.new(@dut)
+    @devices = {PLATFORM}Devices.new(@dut)
+    @privacy_legal = {PLATFORM}PrivacyLegal.new(@dut)
+    @favorites = {PLATFORM}Favorites.new(@dut)
+    @search = {PLATFORM}Search.new(@dut)
+    @product_page = {PLATFORM}ProductPage.new(@dut)
+    @watch_later = {PLATFORM}WatchLater.new(@dut)
+    @library = {PLATFORM}Library.new(@dut)
+    @tv_shows = {PLATFORM}TvShows.new(@dut)
+    @movies = {PLATFORM}Movies.new(@dut)
+    @video_store = {PLATFORM}VideoStore.new(@dut)
+  end
+
+end

data/lib/lib/screens/tivo/tivo_screens.rb

@@ -0,0 +1,44 @@
+require './lib/screens/screens'
+require './lib/screen/tivo/tivo_dvr'
+require './lib/screen/tivo/tivo_guide'
+require './lib/screen/tivo/tivo_mini_guide'
+require './lib/screen/tivo/tivo_main_menu'
+require './lib/screen/tivo/tivo_on_demand'
+require './lib/screen/tivo/tivo_live_tv'
+require './lib/screen/tivo/tivo_settings'
+require './lib/screen/tivo/tivo_parental_controls'
+require './lib/screen/tivo/tivo_search'
+require './lib/screen/tivo/tivo_product_page'
+require './lib/screen/tivo/tivo_library'
+require './lib/screen/tivo/tivo_movies'
+require './lib/screen/tivo/tivo_tv_shows'
+require './lib/screen/tivo/tivo_video_store'
+require './lib/screen/tivo/tivo_login'
+
+# Adds to or modifies the screens with Tivo-specific screens.
+
+class TivoScreens < Screens
+
+  #attr_reader(:dvr, :library, :movies, :tv_shows, :video_store, :login)
+
+  # Public: Initializes TivoScreens. NOT FOR USE IN TESTS.
+  def initialize(*args)
+    super(*args)
+    @login = TivoLogin.new(@dut)
+    @dvr = TivoDvr.new(@dut)
+    @guide = TivoGuide.new(@dut)
+    @mini_guide = TivoMiniGuide.new(@dut)
+    @main_menu = TivoMainMenu.new(@dut)
+    @on_demand = TivoOnDemand.new(@dut)
+    @live_tv = TivoLiveTv.new(@dut)
+    @settings = TivoSettings.new(@dut)
+    @parental_controls = TivoParentalControls.new(@dut)
+    @search = TivoSearch.new(@dut)
+    @product_page = TivoProductPage.new(@dut)
+    @library = TivoLibrary.new(@dut)
+    @movies = TivoMovies.new(@dut)
+    @tv_shows = TivoTvShows.new(@dut)
+    @video_store = TivoVideoStore.new(@dut)
+  end
+
+end

data/lib/lib/selenium/appium/appium.rb

@@ -0,0 +1,388 @@
+require './lib/selenium/selenium'
+
+# Appium defines all the Appium methods in a module so that they can be included by other classes
+
+module Appium
+  include Selenium
+
+  @id = $stb_id
+  @is_appium = true
+  @rotation = nil
+
+  # Public: Starts a new session with the given parameters.
+  #
+  # new_session      - Boolean indicating whether to establish a new session (default: true).
+  # software_version - String version of app to install (default: nil).
+  #                    If default, value of :software_version: from configuration will be used.
+  # software_url     - String URL to software network location (default: nil).
+  #                    By default, it is assumed that software is stored locally.
+  # install_software - Boolean indicating whether to install provided software version (default: true).
+  # app_package      - String mobile app package to use (default: nil).
+  #                    By default, app package will be chosen based on mobile platform.
+  # app_activity     - String mobile app activity to use (default: nil).
+  #                    By default, app activity will be chosen based on mobile platform.
+  # bundle_id        - String mobile bundle id to use (default: nil).
+  #                    By default, bundle id will be chosen based on mobile platform.
+  # sleep_time       - Integer total milliseconds to sleep after establishing the session (default: 0).
+  #
+  # Returns a Boolean true if the session was started, otherwise false.
+  def start_session?(args={})
+    args[:new_session] = args.fetch(:new_session, true)
+    args[:app_version] = args.delete(:software_version) if args.include?(:software_version)
+    args[:install_app] = args.delete(:install_software) if args.include?(:install_software)
+    args[:app_url] = args.delete(:software_url) if args.include?(:software_url)
+    ret = selenium_post('session', args)
+    sleep(args.fetch(:sleep_time, 0.sec))
+    !ret.nil?
+  end
+
+  # Public: Taps an element or coordinates.
+  #         For any String criteria, a Regular Expression may be used by adding the 'regexp:' prefix.
+  #
+  # name              - String name of the element (default: nil). Corresponds to Android 'resource-id' and Ios 'name'.
+  # text              - String text of the element (default: nil). Corresponds to Android 'text' and Ios 'value'.
+  # type              - String type of the element (default: nil). Corresponds to element class/tag.
+  # description       - String description of the element (default: nil).
+  #                     Corresponds to Android 'content-desc' and Ios 'label'.
+  # selector          - String automation selector (default: nil).
+  # index             - Integer index of element to use among all matching elements (default: nil).
+  #                     By default, exactly one element must match.
+  # is_visible        - Boolean indicating whether the element is visible (default: nil).
+  #                     Corresponds to Ios 'visible'. Always true for Android.
+  # is_on_screen      - Boolean indicating whether any part of the element is within screen boundaries (default: nil).
+  # is_tappable       - Boolean indicating whether the element may be tapped (default: nil).
+  #                     Corresponds to Android 'clickable'. Android only.
+  # is_password       - Boolean indicating whether the element is a password field (default: nil).
+  #                     Corresponds to Android 'password'. Android only.
+  # is_enabled        - Boolean indicating whether the element is enabled (default: nil).
+  #                     Corresponds to Android and Ios 'enabled'.
+  # is_checked        - Boolean indicating whether the element is checked (default: nil).
+  #                     Corresponds to Android 'checked'. Android only.
+  # is_selected       - Boolean indicating whether the element is selected (default: nil).
+  #                     Corresponds to Android 'selected'.
+  # is_checkable      - Boolean indicating whether the element can be checked (default: nil).
+  #                     Corresponds to Android 'checkable'. Android only.
+  # is_focusable      - Boolean indicating whether the element can be focused (default: nil).
+  #                     Corresponds to Android 'focusable'. Android only.
+  # is_long_pressable - Boolean indicating whether the element can be long-pressed (default: nil).
+  #                     Corresponds to Android 'long-clickable'. Android only.
+  # is_scrollable     - Boolean indicating whether the element can be scrolled (default: nil).
+  #                     Corresponds to Android 'scrollable'. Android only.
+  # is_recordable     - Boolean indicating whether the element can be recorded (default: nil).
+  # x                 - Integer x coordinate of the element (default: nil).
+  # y                 - Integer y coordinate of the element (default: nil).
+  # width             - Integer width of the element (default: nil).
+  # height            - Integer height of the element (default: nil).
+  # number            - Integer channel number (default: nil). Channel elements only.
+  # start_time        - Integer start time (default: nil). Channel/show elements only.
+  # end_time          - Integer end time (default: nil). Channel/show elements only.
+  # coordinates       - Boolean indicating whether absolute coordinates are given (default: false).
+  # duration          - Integer press duration in milliseconds (default: 0).
+  # count             - Integer number of times to press (default: 1).
+  # info              - Array of Symbols specifying attributes to retrieve (default: []).
+  #                     By default, all attributes will be retrieved.
+  # min               - Integer minimum number of matching elements to require (default: 0).
+  #                     By default, no restriction is imposed.
+  # max               - Integer maximum number of matching elements to require (default: nil).
+  #                     By default, no restriction is imposed.
+  # timeout           - Integer total milliseconds to allow for element search (default: 30.sec).
+  # sleep_time        - Integer total milliseconds to sleep after interacting (default: 0).
+  #
+  # Returns a Boolean true if successfully tapped, otherwise false.
+  def tap?(*args)
+    args = args[0].merge(args[1] || {})
+    ret = selenium_post('tap', args)
+    sleep(args.fetch(:sleep_time, 0.sec))
+    !ret.nil?
+  end
+
+  # Public: Double-clicks an element or coordinates.
+  #         For any String criteria, a Regular Expression may be used by adding the 'regexp:' prefix.
+  #
+  # name              - String name of the element (default: nil). Corresponds to Android 'resource-id' and Ios 'name'.
+  # text              - String text of the element (default: nil). Corresponds to Android 'text' and Ios 'value'.
+  # type              - String type of the element (default: nil). Corresponds to element class/tag.
+  # description       - String description of the element (default: nil).
+  #                     Corresponds to Android 'content-desc' and Ios 'label'.
+  # selector          - String automation selector (default: nil).
+  # index             - Integer index of element to use among all matching elements (default: nil).
+  #                     By default, exactly one element must match.
+  # is_visible        - Boolean indicating whether the element is visible (default: nil).
+  #                     Corresponds to Ios 'visible'. Always true for Android.
+  # is_on_screen      - Boolean indicating whether any part of the element is within screen boundaries (default: nil).
+  # is_tappable       - Boolean indicating whether the element may be tapped (default: nil).
+  #                     Corresponds to Android 'clickable'. Android only.
+  # is_password       - Boolean indicating whether the element is a password field (default: nil).
+  #                     Corresponds to Android 'password'. Android only.
+  # is_enabled        - Boolean indicating whether the element is enabled (default: nil).
+  #                     Corresponds to Android and Ios 'enabled'.
+  # is_checked        - Boolean indicating whether the element is checked (default: nil).
+  #                     Corresponds to Android 'checked'. Android only.
+  # is_selected       - Boolean indicating whether the element is selected (default: nil).
+  #                     Corresponds to Android 'selected'.
+  # is_checkable      - Boolean indicating whether the element can be checked (default: nil).
+  #                     Corresponds to Android 'checkable'. Android only.
+  # is_focusable      - Boolean indicating whether the element can be focused (default: nil).
+  #                     Corresponds to Android 'focusable'. Android only.
+  # is_long_pressable - Boolean indicating whether the element can be long-pressed (default: nil).
+  #                     Corresponds to Android 'long-clickable'. Android only.
+  # is_scrollable     - Boolean indicating whether the element can be scrolled (default: nil).
+  #                     Corresponds to Android 'scrollable'. Android only.
+  # is_recordable     - Boolean indicating whether the element can be recorded (default: nil).
+  # x                 - Integer x coordinate of the element (default: nil).
+  # y                 - Integer y coordinate of the element (default: nil).
+  # width             - Integer width of the element (default: nil).
+  # height            - Integer height of the element (default: nil).
+  # number            - Integer channel number (default: nil). Channel elements only.
+  # start_time        - Integer start time (default: nil). Channel/show elements only.
+  # end_time          - Integer end time (default: nil). Channel/show elements only.
+  # coordinates       - Boolean indicating whether absolute coordinates are given (default: false).
+  # duration          - Integer press duration in milliseconds (default: 0).
+  # count             - Integer number of times to press (default: 2).
+  # info              - Array of Symbols specifying attributes to retrieve (default: []).
+  #                     By default, all attributes will be retrieved.
+  # min               - Integer minimum number of matching elements to require (default: 0).
+  #                     By default, no restriction is imposed.
+  # max               - Integer maximum number of matching elements to require (default: nil).
+  #                     By default, no restriction is imposed.
+  # timeout           - Integer total milliseconds to allow for element search (default: 30.sec).
+  # sleep_time        - Integer total milliseconds to sleep after interacting (default: 0).
+  #
+  # Returns a Boolean true if successfully double-clicked, otherwise false.
+  def double_click?(*args)
+    args = args[0].merge(args[1] || {})
+    ret = selenium_post('double-click', args)
+    sleep(args.fetch(:sleep_time, 0.sec))
+    !ret.nil?
+  end
+
+  # Public: Long-presses an element or coordinates.
+  #         For any String criteria, a Regular Expression may be used by adding the 'regexp:' prefix.
+  #
+  # name              - String name of the element (default: nil). Corresponds to Android 'resource-id' and Ios 'name'.
+  # text              - String text of the element (default: nil). Corresponds to Android 'text' and Ios 'value'.
+  # type              - String type of the element (default: nil). Corresponds to element class/tag.
+  # description       - String description of the element (default: nil).
+  #                     Corresponds to Android 'content-desc' and Ios 'label'.
+  # selector          - String automation selector (default: nil).
+  # index             - Integer index of element to use among all matching elements (default: nil).
+  #                     By default, exactly one element must match.
+  # is_visible        - Boolean indicating whether the element is visible (default: nil).
+  #                     Corresponds to Ios 'visible'. Always true for Android.
+  # is_on_screen      - Boolean indicating whether any part of the element is within screen boundaries (default: nil).
+  # is_tappable       - Boolean indicating whether the element may be tapped (default: nil).
+  #                     Corresponds to Android 'clickable'. Android only.
+  # is_password       - Boolean indicating whether the element is a password field (default: nil).
+  #                     Corresponds to Android 'password'. Android only.
+  # is_enabled        - Boolean indicating whether the element is enabled (default: nil).
+  #                     Corresponds to Android and Ios 'enabled'.
+  # is_checked        - Boolean indicating whether the element is checked (default: nil).
+  #                     Corresponds to Android 'checked'. Android only.
+  # is_selected       - Boolean indicating whether the element is selected (default: nil).
+  #                     Corresponds to Android 'selected'.
+  # is_checkable      - Boolean indicating whether the element can be checked (default: nil).
+  #                     Corresponds to Android 'checkable'. Android only.
+  # is_focusable      - Boolean indicating whether the element can be focused (default: nil).
+  #                     Corresponds to Android 'focusable'. Android only.
+  # is_long_pressable - Boolean indicating whether the element can be long-pressed (default: nil).
+  #                     Corresponds to Android 'long-clickable'. Android only.
+  # is_scrollable     - Boolean indicating whether the element can be scrolled (default: nil).
+  #                     Corresponds to Android 'scrollable'. Android only.
+  # is_recordable     - Boolean indicating whether the element can be recorded (default: nil).
+  # x                 - Integer x coordinate of the element (default: nil).
+  # y                 - Integer y coordinate of the element (default: nil).
+  # width             - Integer width of the element (default: nil).
+  # height            - Integer height of the element (default: nil).
+  # number            - Integer channel number (default: nil). Channel elements only.
+  # start_time        - Integer start time (default: nil). Channel/show elements only.
+  # end_time          - Integer end time (default: nil). Channel/show elements only.
+  # coordinates       - Boolean indicating whether absolute coordinates are given (default: false).
+  # duration          - Integer press duration in milliseconds (default: 2000).
+  # count             - Integer number of times to press (default: 1).
+  # info              - Array of Symbols specifying attributes to retrieve (default: []).
+  #                     By default, all attributes will be retrieved.
+  # min               - Integer minimum number of matching elements to require (default: 0).
+  #                     By default, no restriction is imposed.
+  # max               - Integer maximum number of matching elements to require (default: nil).
+  #                     By default, no restriction is imposed.
+  # timeout           - Integer total milliseconds to allow for element search (default: 30.sec).
+  # sleep_time        - Integer total milliseconds to sleep after interacting (default: 0).
+  #
+  # Returns a Boolean true if successfully long-pressed, otherwise false.
+  def long_press?(*args)
+    args = args[0].merge(args[1] || {})
+    ret = selenium_post('long-press', args)
+    sleep(args.fetch(:sleep_time, 0.sec))
+    !ret.nil?
+  end
+
+  # Public: Swipes from/to element(s), coordinates, or offsets.
+  #
+  # from       - Hash of attributes for element or coordinates from which to swipe.
+  #              See element for valid attributes.
+  # to         - Hash of attributes for element, coordinates, or offsets to which to swipe (default: nil).
+  #              See element for valid attributes. Offsets may be specified with the following keys:
+  #              :x_offset - Integer pixels or Float percent of screen/element to swipe on the X axis (default: -0.45).
+  #              :y_offset - Integer pixels or Float percent of screen/element to swipe on the Y axis (default: 0).
+  # duration   - Integer swipe duration in milliseconds (default: 500).
+  # sleep_time - Integer total milliseconds to sleep after flick (default: 0).
+  #
+  # Returns a Boolean true if successfully swiped, otherwise false.
+  def swipe?(*args)
+    args = args[0].merge(args[1] || {})
+    ret = selenium_post('swipe', args)
+    sleep(args.fetch(:sleep_time, 0.sec))
+    !ret.nil?
+  end
+
+  # Public: Scrolls from/to element(s), coordinates, or offsets.
+  #
+  # from       - Hash of attributes for element or coordinates from which to scroll.
+  #              See element for valid attributes.
+  # to         - Hash of attributes for element, coordinates, or offsets to which to scroll (default: nil).
+  #              See element for valid attributes. Offsets may be specified with the following keys:
+  #              :x_offset - Integer pixels or Float percent of screen/element to scroll on the X axis (default: 0).
+  #              :y_offset - Integer pixels or Float percent of screen/element to scroll on the Y axis (default: 0.45).
+  # duration   - Integer scroll duration in milliseconds (default: 1000).
+  # sleep_time - Integer total milliseconds to sleep after scroll (default: 0).
+  #
+  # Returns a Boolean true if successfully scrolled, otherwise false.
+  def scroll?(*args)
+    args = args[0].merge(args[1] || {})
+    ret = selenium_post('scroll', args)
+    sleep(args.fetch(:sleep_time, 0.sec))
+    !ret.nil?
+  end
+
+  # Public: Flicks from/to element(s), coordinates, or offsets.
+  #         For any String criteria, a Regular Expression may be used by adding the 'regexp:' prefix.
+  #
+  # from       - Hash of attributes for element or coordinates from which to flick.
+  #              See element for valid attributes.
+  # to         - Hash of attributes for element, coordinates, or offsets to which to flick (default: nil).
+  #              See element for valid attributes. Offsets may be specified with the following keys:
+  #              :x_offset - Integer pixels or Float percent of screen/element to flick on the X axis (default: -0.1).
+  #              :y_offset - Integer pixels or Float percent of screen/element to flick on the Y axis (default: 0.1).
+  # duration   - Integer flick duration in milliseconds (default: 200).
+  # sleep_time - Integer total milliseconds to sleep after flick (default: 0).
+  #
+  # Returns a Boolean true if successfully flicked, otherwise false.
+  def flick?(*args)
+    args = args[0].merge(args[1] || {})
+    ret = selenium_post('flick', args)
+    sleep(args.fetch(:sleep_time, 0.sec))
+    !ret.nil?
+  end
+
+  # Public: Gets the current screen orientation.
+  #
+  # Returns the Symbol screen orientation, which may be :portrait, :landscape, or nil if it could not be determined.
+  def orientation
+    ret = selenium_get('orientation')
+    begin
+      orientation = ret['orientation']
+        return orientation
+    rescue
+      return nil
+    end
+  end
+
+  # Public: Sets the current screen orientation.
+  #
+  # orientation - Symbol desired screen orientation as :portrait or :landscape.
+  #
+  # Returns a Boolean true if successfully set the orientation, otherwise false.
+  def orientation=(orientation)
+    ret = selenium_post('orientation', {'orientation' =>  orientation.to_s})
+    !ret.nil?
+  end
+
+  # Public: Gets the current image rotation.
+  #
+  # Returns the Symbol image rotation, which may be :portrait or :landscape.
+  def rotation
+    @rotation
+  end
+
+  # Public: Sets the current image rotation.
+  #
+  # rotation - Symbol desired image rotation as :portrait or :landscape.
+  #
+  # Returns a Boolean true if successfully set the rotation, otherwise false.
+  def rotation=(rotation)
+    ret = selenium_post('rotation', {'rotation' => rotation.to_s})
+    if ret.nil?
+      false
+    else
+      @rotation = rotation
+      true
+    end
+  end
+
+  # Public: Sets the current image rotation to landscape.
+  #
+  # sleep_time - Integer total milliseconds to wait after setting the rotation (default: 0).
+  #
+  # Returns a Boolean true if successfully set the rotation, otherwise false.
+  def rotate_landscape?(args={})
+    ret = self.rotation=(:landscape)
+    sleep(args.fetch(:sleep_time, 0.sec))
+    ret
+  end
+
+  # Public: Sets the current image rotation to portrait.
+  #
+  # sleep_time - Integer total milliseconds to wait after setting the rotation (default: 0).
+  #
+  # Returns a Boolean true if successfully set the rotation, otherwise false.
+  def rotate_portrait?(args={})
+    ret = self.rotation=(:portrait)
+    sleep(args.fetch(:sleep_time, 0.sec))
+    ret
+  end
+
+  # Public: Sets the current screen orientation to portrait.
+  #
+  # sleep_time - Integer total milliseconds to wait after setting the orientation (default: 0).
+  #
+  # Returns a Boolean true if successfully set the orientation, otherwise false.
+  def set_portrait?(args={})
+    ret = self.orientation=(:portrait)
+    sleep(args.fetch(:sleep_time, 0.sec))
+    ret
+  end
+
+  # Public: Sets the current screen orientation to landscape.
+  #
+  # sleep_time - Integer total milliseconds to wait after setting the orientation (default: 0).
+  #
+  # Returns a Boolean true if successfully set the orientation, otherwise false.
+  def set_landscape?(args={})
+    ret = self.orientation=(:landscape)
+    sleep(args.fetch(:sleep_time, 0.sec))
+    ret
+  end
+
+  # Public: Presses device Home button.
+  #
+  # sleep_time - Integer total milliseconds to wait after pressing Home (default: 0).
+  #
+  # Returns a Boolean true if successfully pressed Home, otherwise false.
+  def home?(args={})
+    ret = selenium_post('home', {})
+    sleep(args.fetch(:sleep_time, 0.sec))
+    !ret.nil?
+  end
+
+  # Public: Presses device Power button.
+  #
+  # sleep_time - Integer total milliseconds to wait after pressing Power (default: 0).
+  #
+  # Returns a Boolean true if successfully pressed Power, otherwise false.
+  def power?(args={})
+    ret = selenium_post('power', {})
+    sleep(args.fetch(:sleep_time, 0.sec))
+    !ret.nil?
+  end
+
+end