New pyauto translate hooks: always and never translate button.

chrome/test/pyautolib/pyauto.py

 #!/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.
 
 """PyAuto: Python Interface to Chromium's Automation Proxy.
 
 PyAuto uses swig to expose Automation Proxy interfaces to Python.
 For complete documentation on the functionality available,
@@ skipping 673 matching lines @@
     """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'always_translate_lang_button_showing': False,
+        u'never_translate_lang_button_showing': False,
+        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
@@ skipping 112 matching lines @@
   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
+    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
+    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
+    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.
+    decline_translation: Equivalent to selecting 'Nope' on the translate bar.
+    click_never_translate_lang_button: This button appears when the user has
+      declined translation of this language several times. Selecting it causes
+      the language to never be translated. Look at GetTranslateInfo to
+      determine if the button is showing.
+    click_always_translate_lang_button: This button appears when the user has
+      accepted translation of this language several times. Selecting it causes
+      the language to always be translated. Look at GetTranslateInfo to
+      determine if the button is showing.
 
     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)
@@ skipping 639 matching lines @@
     if self._options.verbose:
       verbosity = 2
     result = unittest.TextTestRunner(verbosity=verbosity).run(pyauto_suite)
     del loaded_tests  # Need to destroy test cases before the suite
     del pyauto_suite
     sys.exit(not result.wasSuccessful())
 
 
 if __name__ == '__main__':
   Main()