New pyauto hook for the translate feature.

Review URL: http://codereview.chromium.org/3026016 git-svn-id: svn://svn.chromium.org/chrome/trunk/src@53791 0039d316-1c4b-4281-b951-d872f2087c98
author: alyssad@chromium.org <alyssad@chromium.org@0039d316-1c4b-4281-b951-d872f2087c98> 2010-07-27 16:35:42 +0000
committer: alyssad@chromium.org <alyssad@chromium.org@0039d316-1c4b-4281-b951-d872f2087c98> 2010-07-27 16:35:42 +0000
commit: 3dda5b0f1bb73a437ca6e6f2741580451030ac25 (patch)
tree: 4546385566b7b28211e416a4862fbe4699ea7b0d /chrome/test
parent: 0f86277de42193b543d0b33e4c82c750f0642141 (diff)
download: chromium_src-3dda5b0f1bb73a437ca6e6f2741580451030ac25.zip
chromium_src-3dda5b0f1bb73a437ca6e6f2741580451030ac25.tar.gz
chromium_src-3dda5b0f1bb73a437ca6e6f2741580451030ac25.tar.bz2
3 files changed, 234 insertions, 0 deletions
diff --git a/chrome/test/functional/PYAUTO_TESTS b/chrome/test/functional/PYAUTO_TESTS
index 7097c12..cf57c7e 100644
--- a/chrome/test/functional/PYAUTO_TESTS
+++ b/chrome/test/functional/PYAUTO_TESTS
@@ -40,6 +40,7 @@
     'special_tabs',
     'test_basic.SimpleTest.testCanOpenGoogle',
     'themes',
+    'translate',
   ],
 
   'win': [
diff --git a/chrome/test/functional/translate.py b/chrome/test/functional/translate.py
new file mode 100644
index 0000000..4b7aabb
--- /dev/null
+++ b/chrome/test/functional/translate.py
@@ -0,0 +1,138 @@
+#!/usr/bin/python
+# Copyright (c) 2010 The Chromium Authors. All rights reserved.
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+
+import pyauto_functional  # Must be imported before pyauto
+import pyauto
+
+
+class TranslateTest(pyauto.PyUITest):
+  """Tests that translate works correctly"""
+
+  spanish_google = 'http://www.google.com/webhp?hl=es'
+  spanish = 'es'
+  after_translate = 'AFTER_TRANSLATE'
+  before_translate = 'BEFORE_TRANSLATE'
+  translating = 'TRANSLATING'
+  translation_error = 'TRANSLATION_ERROR'
+
+  def Debug(self):
+    """ Test method for experimentation. """
+    import pprint
+    pp = pprint.PrettyPrinter(indent=2)
+    while True:
+      raw_input('Hit <enter> to dump translate info.. ')
+      pp.pprint(self.GetTranslateInfo())
+
+  def _NavigateAndWaitForBar(self, url):
+    self.NavigateToURL(url)
+    self.WaitForInfobarCount(1)
+
+  def _ClickTranslateUntilSuccess(self):
+    """Since the translate can fail due to server error, continue trying until
+       it is successful or until it has tried too many times."""
+    max_tries = 10
+    curr_try = 0
+    while curr_try < max_tries and not self.ClickTranslateBarTranslate():
+      curr_try = curr_try + 1
+    if curr_try == 10:
+      self.fail('Translation failed more than %d times.' % max_tries)
+
+  def testTranslate(self):
+    """Tests that a page was translated if the user chooses to translate."""
+    self._NavigateAndWaitForBar(self.spanish_google)
+    self._ClickTranslateUntilSuccess()
+    translate_info = self.GetTranslateInfo()
+    self.assertEqual(self.spanish, translate_info['original_language'])
+    self.assertTrue(translate_info['page_translated'])
+    self.assertTrue(translate_info['can_translate_page'])
+    self.assertTrue('translate_bar' in translate_info)
+    self.assertEquals(self.after_translate,
+                      translate_info['translate_bar']['bar_state'])
+
+  def testNoTranslate(self):
+    """Tests that a page isn't translated if the user declines translate."""
+    self._NavigateAndWaitForBar(self.spanish_google)
+    self.PerformActionOnInfobar('dismiss', 0)
+    translate_info = self.GetTranslateInfo()
+    self.assertEqual(self.spanish, translate_info['original_language'])
+    self.assertFalse(translate_info['page_translated'])
+    self.assertTrue(translate_info['can_translate_page'])
+    # If the user goes to the site again, the infobar should drop down but
+    # the page should not be automatically translated.
+    self._NavigateAndWaitForBar(self.spanish_google)
+    translate_info = self.GetTranslateInfo()
+    self.assertFalse(translate_info['page_translated'])
+    self.assertTrue(translate_info['can_translate_page'])
+    self.assertTrue('translate_bar' in translate_info)
+    self.assertEquals(self.before_translate,
+                      translate_info['translate_bar']['bar_state'])
+
+  def testNeverTranslateLanguage(self):
+    """Tests that blacklisting a language for translate works."""
+    self._NavigateAndWaitForBar(self.spanish_google)
+    self.SelectTranslateOption('never_translate_language')
+    translate_info = self.GetTranslateInfo()
+    self.assertEqual(self.spanish, translate_info['original_language'])
+    self.assertFalse(translate_info['page_translated'])
+    self.assertFalse(translate_info['can_translate_page'])
+    spanish_wikipedia = 'http://es.wikipedia.org/wiki/Wikipedia:Portada'
+    self.NavigateToURL(spanish_wikipedia)
+    translate_info = self.GetTranslateInfo()
+    self.assertEqual(self.spanish, translate_info['original_language'])
+    self.assertFalse(translate_info['page_translated'])
+    self.assertFalse(translate_info['can_translate_page'])
+
+  def testAlwaysTranslateLanguage(self):
+    """Tests that the always translate a language option works."""
+    self._NavigateAndWaitForBar(self.spanish_google)
+    self.SelectTranslateOption('toggle_always_translate')
+    self._ClickTranslateUntilSuccess()
+    translate_info = self.GetTranslateInfo()
+    self.assertEquals(self.spanish, translate_info['original_language'])
+    self.assertTrue(translate_info['page_translated'])
+    self.assertTrue(translate_info['can_translate_page'])
+    self.assertTrue('translate_bar' in translate_info)
+    self.assertEquals(self.after_translate,
+                      translate_info['translate_bar']['bar_state'])
+    # Go to another spanish site and verify that it is translated.
+    # Note that the 'This page has been translated..." bar will show up.
+    self._NavigateAndWaitForBar(
+        'http://es.wikipedia.org/wiki/Wikipedia:Portada')
+    translate_info = self.GetTranslateInfo()
+    self.assertTrue('translate_bar' in translate_info)
+    curr_bar_state = translate_info['translate_bar']['bar_state']
+    # We don't care whether the translation has finished, just that it is
+    # trying to translate.
+    self.assertTrue(curr_bar_state is self.after_translate or
+                    self.translating or self.translation_error,
+                    'Bar state was %s.' % curr_bar_state)
+
+  def testNeverTranslateSite(self):
+    """Tests that blacklisting a site for translate works."""
+    self._NavigateAndWaitForBar(self.spanish_google)
+    self.SelectTranslateOption('never_translate_site')
+    translate_info = self.GetTranslateInfo()
+    self.assertFalse(translate_info['page_translated'])
+    self.assertFalse(translate_info['can_translate_page'])
+    french_google = 'http://www.google.com/webhp?hl=fr'
+    # Go to another page in the same site and verify that the page can't be
+    # translated even though it's in a different language.
+    self.NavigateToURL(french_google)
+    translate_info = self.GetTranslateInfo()
+    self.assertFalse(translate_info['page_translated'])
+    self.assertFalse(translate_info['can_translate_page'])
+
+  def testRevert(self):
+    """Tests that reverting a site to its original language works."""
+    self._NavigateAndWaitForBar(self.spanish_google)
+    self._ClickTranslateUntilSuccess()
+    self.RevertPageTranslation()
+    translate_info = self.GetTranslateInfo()
+    self.assertFalse(translate_info['page_translated'])
+    self.assertTrue(translate_info['can_translate_page'])
+
+
+if __name__ == '__main__':
+  pyauto_functional.Main()
diff --git a/chrome/test/pyautolib/pyauto.py b/chrome/test/pyautolib/pyauto.py
index 28e39ed..4cd634f 100644
--- a/chrome/test/pyautolib/pyauto.py
+++ b/chrome/test/pyautolib/pyauto.py
@@ -646,6 +646,101 @@ class PyUITest(pyautolib.PyUITestBase, unittest.TestCase):
     return history_info.HistoryInfo(
         self._SendJSONRequest(0, json.dumps(cmd_dict)))
 
+  def GetTranslateInfo(self, tab_index=0, window_index=0):
+    """Returns info about translate for the given page.
+
+    If the translate bar is showing, also returns information about the bar.
+
+    Args:
+      tab_index: The tab index, default is 0.
+      window_index: The window index, default is 0.
+
+    Returns:
+      A dictionary of information about translate for the page. Example:
+      { u'can_translate_page': True,
+        u'original_language': u'es',
+        u'page_translated': False,
+        # The below will only appear if the translate bar is showing.
+        u'translate_bar': { u'bar_state': u'BEFORE_TRANSLATE',
+                            u'original_lang_code': u'es',
+                            u'target_lang_code': u'en'}}
+    """
+    cmd_dict = {  # Prepare command for the json interface
+      'command': 'GetTranslateInfo',
+      'tab_index': tab_index
+    }
+    return self._GetResultFromJSONRequest(cmd_dict, windex=window_index)
+
+  def ClickTranslateBarTranslate(self, tab_index=0, window_index=0):
+    """If the translate bar is showing, clicks the 'Translate' button on the
+       bar. This will show the 'this page has been translated...' infobar.
+
+    Args:
+      tab_index: The index of the tab, default is 0.
+      window_index: The index of the window, default is 0.
+
+    Returns:
+      True if the translation was successful or false if there was an error.
+      Note that an error shouldn't neccessarily mean a failed test - retry the
+      call on error.
+
+    Raises:
+      pyauto_errors.JSONInterfaceError if the automation returns an error.
+    """
+    cmd_dict = {  # Prepare command for the json interface
+      'command': 'SelectTranslateOption',
+      'tab_index': tab_index,
+      'option': 'translate_page'
+    }
+    return self._GetResultFromJSONRequest(
+        cmd_dict, windex=window_index)['translation_success']
+
+  def RevertPageTranslation(self, tab_index=0, window_index=0):
+    """Select the 'Show original' button on  the 'this page has been
+       translated...' infobar. This will remove the infobar and revert the
+       page translation.
+
+    Args:
+      tab_index: The index of the tab, default is 0.
+      window_index: The index of the window, default is 0.
+    """
+    cmd_dict = {  # Prepare command for the json interface
+      'command': 'SelectTranslateOption',
+      'tab_index': tab_index,
+      'option': 'revert_translation'
+    }
+    self._GetResultFromJSONRequest(cmd_dict, windex=window_index)
+
+  def SelectTranslateOption(self, option, tab_index=0, window_index=0):
+    """Selects one of the options in the drop-down menu for the translate bar.
+
+    Args:
+      option: One of 'never_translate_language', 'never_translate_site', or
+              'toggle_always_translate'. See notes on each below.
+      tab_index: The index of the tab, default is 0.
+      window_index: The index of the window, default is 0.
+
+    *Notes*
+    never translate language:  Selecting this means that no sites in this
+      language will be translated. This dismisses the infobar.
+    never translate site: Selecting this means that this site will never be
+      translated, regardless of the language. This dismisses the infobar.
+    toggle always translate: This does not dismiss the infobar or translate the
+      page. See ClickTranslateBarTranslate and PerformActioOnInfobar to do
+      those. If a language is selected to be always translated, then whenver
+      the user visits a page with that language, the infobar will show the
+      'This page has been translated...' message.
+
+    Raises:
+      pyauto_errors.JSONInterfaceError if the automation returns an error.
+    """
+    cmd_dict = {  # Prepare command for the json interface
+      'command': 'SelectTranslateOption',
+      'option': option,
+      'tab_index': tab_index
+    }
+    self._GetResultFromJSONRequest(cmd_dict, windex=window_index)
+
   def FillAutoFillProfile(self, profiles=None, credit_cards=None,
                           tab_index=0, window_index=0):
     """Set the autofill profile to contain the given profiles and credit cards.
author	alyssad@chromium.org <alyssad@chromium.org@0039d316-1c4b-4281-b951-d872f2087c98>	2010-07-27 16:35:42 +0000
committer	alyssad@chromium.org <alyssad@chromium.org@0039d316-1c4b-4281-b951-d872f2087c98>	2010-07-27 16:35:42 +0000
commit	3dda5b0f1bb73a437ca6e6f2741580451030ac25 (patch)
tree	4546385566b7b28211e416a4862fbe4699ea7b0d /chrome/test
parent	0f86277de42193b543d0b33e4c82c750f0642141 (diff)
download	chromium_src-3dda5b0f1bb73a437ca6e6f2741580451030ac25.zip chromium_src-3dda5b0f1bb73a437ca6e6f2741580451030ac25.tar.gz chromium_src-3dda5b0f1bb73a437ca6e6f2741580451030ac25.tar.bz2