Home | History | Annotate | Download | only in touch_ScrollDirection
      1 # Copyright (c) 2014 The Chromium OS Authors. All rights reserved.
      2 # Use of this source code is governed by a BSD-style license that can be
      3 # found in the LICENSE file.
      4 
      5 import logging
      6 
      7 from autotest_lib.client.common_lib import error
      8 from autotest_lib.client.common_lib.cros import chrome
      9 from autotest_lib.client.cros import touch_playback_test_base
     10 
     11 
     12 class touch_ScrollDirection(touch_playback_test_base.touch_playback_test_base):
     13     """Plays back scrolls and checks for correct page movement."""
     14     version = 1
     15 
     16     _DIRECTIONS = ['down', 'up', 'right', 'left']
     17     _REVERSES = {'down': 'up', 'up': 'down', 'right': 'left', 'left': 'right'}
     18     _FILENAME_FMT_STR = 'scroll-%s'
     19 
     20 
     21     def _check_scroll_direction(self, filepath, expected):
     22         """Playback and raise error if scrolling does not match down value.
     23 
     24         @param filepath: Gesture file's complete path for playback.
     25         @param expected: String, expected direction in which test page scroll
     26                          should move for the gesture file being played.
     27 
     28         @raises TestFail if actual scrolling did not match expected.
     29 
     30         """
     31         is_vertical = expected == 'up' or expected == 'down'
     32         is_down_or_right = expected == 'down' or expected == 'right'
     33 
     34         self._set_default_scroll_position(is_vertical)
     35         self._playback(filepath)
     36         self._wait_for_scroll_position_to_settle(is_vertical)
     37         delta = self._get_scroll_position(is_vertical) - self._DEFAULT_SCROLL
     38         logging.info('Scroll delta was %d', delta)
     39 
     40         # Check if scrolling went in correct direction.
     41         if ((is_down_or_right and delta <= 0) or
     42             (not is_down_or_right and delta >= 0)):
     43             raise error.TestFail('Page scroll was in wrong direction! '
     44                                  'Delta=%d, Australian=%s, Touchscreen=%s'
     45                                   % (delta, self._australian_state,
     46                                      self._has_touchscreen))
     47 
     48 
     49     def _verify_scrolling(self):
     50         """Check scrolling direction for down then up."""
     51 
     52         if not self._australian_state:
     53             for direction in self._DIRECTIONS:
     54                 self._check_scroll_direction(self._filepaths[direction],
     55                                              direction)
     56         else:
     57             for direction in self._DIRECTIONS:
     58                 self._check_scroll_direction(self._filepaths[direction],
     59                                              self._REVERSES[direction])
     60 
     61 
     62     def _is_testable(self):
     63         """Return True if test can run on this device, else False.
     64 
     65         @raises: TestError if host has no touchpad when it should.
     66 
     67         """
     68         # Raise error if no touchpad detected.
     69         if not self._has_touchpad:
     70             raise error.TestError('No touchpad found on this device!')
     71 
     72         # Check if playback files are available on DUT to run test.
     73         self._filepaths = self._find_test_files_from_directions(
     74                 'touchpad', self._FILENAME_FMT_STR, self._DIRECTIONS)
     75         if not self._filepaths:
     76             logging.info('Missing gesture files, Aborting test.')
     77             return False
     78 
     79         return True
     80 
     81 
     82     def run_once(self):
     83         """Entry point of this test."""
     84         if not self._is_testable():
     85             return
     86 
     87         # Log in and start test.
     88         with chrome.Chrome(autotest_ext=True) as cr:
     89             # Setup.
     90             self._set_autotest_ext(cr.autotest_ext)
     91             self._open_test_page(cr)
     92             self._emulate_mouse()
     93             self._center_cursor()
     94 
     95             # Check default scroll - Australian for touchscreens.
     96             self._australian_state = self._has_touchscreen
     97             logging.info('Expecting Australian=%s', self._australian_state)
     98             self._verify_scrolling()
     99 
    100             # Toggle Australian scrolling and check again.
    101             self._australian_state = not self._australian_state
    102             self._set_australian_scrolling(value=self._australian_state)
    103             self._verify_scrolling()
    104