Add pyauto commands to access local state.

chrome/test/pyautolib/pyauto.py

 #!/usr/bin/python
 
 # Copyright (c) 2011 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 798 matching lines @@
 
     Args:
       keyword: the keyword string of the search engine to make default.
     """
     # Ensure that the search engine profile is loaded into data model.
     self._GetResultFromJSONRequest({'command': 'LoadSearchEngineInfo'})
     cmd_dict = {'command': 'PerformActionOnSearchEngine', 'keyword': keyword,
                 'action': 'default'}
     self._GetResultFromJSONRequest(cmd_dict)
 
+
+  def GetLocalStatePrefsInfo(self):
+    """Return info about preferences.
+
+    This represents a snapshot of the preferences. If you expect preferences

[Nirnimesh, 2011/05/24 19:49:02]

s/preferences/local state preferences/

[Miranda Callahan, 2011/05/24 20:42:34]

Done.

+    to have changed, you need to call this method again to get a fresh
+    snapshot.
+
+    Returns:
+      an instance of prefs_info.PrefsInfo
+    """
+    return prefs_info.PrefsInfo(
+        self._SendJSONRequest(0,
+                              json.dumps({'command': 'GetLocalStatePrefsInfo'}),
+                              self.action_max_timeout_ms()))
+
+  def SetLocalState(self, path, value):

[Nirnimesh, 2011/05/24 19:49:02]

How about SetLocalStatePrefs?

[Miranda Callahan, 2011/05/24 20:42:34]

Done.

+    """Set preference for the given path.

[Nirnimesh, 2011/05/24 19:49:02]

s/preference/local state preference/

[Miranda Callahan, 2011/05/24 20:42:34]

Done.

+
+    Preferences are stored by Chromium as a hierarchical dictionary.
+    dot-separated paths can be used to refer to a particular preference.
+    example: "session.restore_on_startup"
+
+    Some preferences are managed, that is, they cannot be changed by the
+    user. It's up to the user to know which ones can be changed. Typically,
+    the options available via Chromium preferences can be changed.
+
+    Args:
+      path: the path the preference key that needs to be changed
+            example: "session.restore_on_startup"
+            One of the equivalent names in chrome/common/pref_names.h could
+            also be used.
+      value: the value to be set. It could be plain values like int, bool,
+             string or complex ones like list.
+             The user has to ensure that the right value is specified for the
+             right key. It's useful to dump the preferences first to determine
+             what type is expected for a particular preference path.
+    """
+    cmd_dict = {
+      'command': 'SetLocalState',
+      'path': path,
+      'value': value,
+    }
+    self._GetResultFromJSONRequest(cmd_dict)
+
   def GetPrefsInfo(self):
     """Return info about preferences.
 
     This represents a snapshot of the preferences. If you expect preferences
     to have changed, you need to call this method again to get a fresh
     snapshot.
 
     Returns:
       an instance of prefs_info.PrefsInfo
     """
@@ skipping 2741 matching lines @@
     if self._options.verbose:
       verbosity = 2
     result = PyAutoTextTestRuner(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()