Add a hook for capturing a user profile photo and saving it to file and 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 3649 matching lines @@
     Raises:
       pyauto_errors.JSONInterfaceError if the automation call returns an error.
     """
     cmd_dict = { 'command': 'SetMute' }
     cmd_dict = {
         'command': 'SetMute',
         'mute': mute,
     }
     return self._GetResultFromJSONRequest(cmd_dict, windex=-1)
 
+  def CaptureProfilePhoto(self):
+    """Captures user profile photo on ChromeOS.
+
+    This is done by driving the TakePhotoDialog. The image file is
+    saved on disk and its path is set in the local state preferences.
+
+    A user needs to be logged-in as a precondition. Note that the UI is not
+    destroyed afterwards, a browser restart is necessary if you want
+    to interact with the browser after this call in the same test case.
+
+    Raises:
+      pyauto_errors.JSONInterfaceError if the automation call returns an error.
+    """
+    cmd_dict = { 'command': 'CaptureProfilePhoto' }
+    return self._GetResultFromJSONRequest(cmd_dict)
+
   ## ChromeOS section -- end
 
 
 class _RemoteProxy():
   """Class for PyAuto remote method calls.
 
   Use this class along with RemoteHost.testRemoteHost to establish a PyAuto
   connection with another machine and make remote PyAuto calls. The RemoteProxy
   mimics a PyAuto object, so all json-style PyAuto calls can be made on it.
 
@@ skipping 498 matching lines @@
     successful = result.wasSuccessful()
     if not successful:
       pyauto_tests_file = os.path.join(self.TestsDir(), self._tests_filename)
       print >>sys.stderr, 'Tests can be disabled by editing %s. ' \
                           'Ref: %s' % (pyauto_tests_file, _PYAUTO_DOC_URL)
     sys.exit(not successful)
 
 
 if __name__ == '__main__':
   Main()