adding Authenticate Alert API to python

Author: lukeis

py/CHANGES

@@ -1,5 +1,6 @@
 Selenium 2.47.0 (in development)
 * Adding ability to make remote call for webelement screenshots in accordance to the W3C spec
+* Adding api to authenticate HTTP Auth modal dialogs via driver.switch_to.alert (beta)
 
 Selenium 2.46.0
 * Firefox support up to 38

py/selenium/webdriver/common/alert.py

@@ -26,11 +26,11 @@ class Alert(object):
     """
     Allows to work with alerts.
 
-    Use this class to interact with alert prompts.  It contains methods for dismissing, 
+    Use this class to interact with alert prompts.  It contains methods for dismissing,
     accepting, inputting, and getting text from alert prompts.
 
     Accepting / Dismissing alert prompts::
-    
+
         Alert(driver).accept()
         Alert(driver).dismiss()
 
@@ -86,6 +86,19 @@ def send_keys(self, keysToSend):
         :Args:
          - keysToSend: The text to be sent to Alert.
 
-        
+
         """
         self.driver.execute(Command.SET_ALERT_VALUE, {'text': keysToSend})
+
+    def authenticate(self, username, password):
+        """
+        Send the username / password to an Authenticated dialog (like with Basic HTTP Auth)
+
+        Usage::
+        driver.switch_to.alert.authenticate('cheese', 'secretGouda')
+
+        :Args:
+         -username: string to be set in the username section of the dialog
+         -password: string to be set in the password section of the dialog
+        """
+        self.driver.execute(Command.SET_ALERT_AUTHENTICATION, {'username':username, 'password':password})

py/selenium/webdriver/remote/command.py

@@ -97,6 +97,7 @@ class Command(object):
     ACCEPT_ALERT = "acceptAlert"
     SET_ALERT_VALUE = "setAlertValue"
     GET_ALERT_TEXT = "getAlertText"
+    SET_ALERT_AUTHENTICATION = "setAuthentication"
 
     # Advanced user interactions
     CLICK = "mouseClick"
@@ -142,7 +143,7 @@ class Command(object):
     SET_SESSION_STORAGE_ITEM = "setSessionStorageItem"
     CLEAR_SESSION_STORAGE = "clearSessionStorage"
     GET_SESSION_STORAGE_SIZE = "getSessionStorageSize"
-    
+
     # Mobile
     GET_NETWORK_CONNECTION = "getNetworkConnection"
     SET_NETWORK_CONNECTION = "setNetworkConnection"

py/selenium/webdriver/remote/remote_connection.py

@@ -275,6 +275,8 @@ def __init__(self, remote_server_addr, keep_alive=False):
                 ('POST', '/session/$sessionId/alert_text'),
             Command.GET_ALERT_TEXT:
                 ('GET', '/session/$sessionId/alert_text'),
+            Command.SET_ALERT_AUTHENTICATION:
+                ('POST', '/session/$sessionId/authenticate'),
             Command.CLICK:
                 ('POST', '/session/$sessionId/click'),
             Command.DOUBLE_CLICK: