Deprecates the use of backslash escaping for ASCII and NAMED Keys.

Author: HelioGuilherme66

src/Selenium2Library/keywords/_element.py

@@ -479,20 +479,27 @@ def simulate(self, locator, event):
     def press_key(self, locator, key):
         """Simulates user pressing key on element identified by `locator`.
 
-        `key` is either a single character, or a numerical ASCII code of the key
-        lead by '\\\\'.
+        `key` is either a single character, a numerical ASCII code of the key,\
+         or a NAMED KEY as described at https://selenium.googlecode.com/git/docs/api/py/webdriver/selenium.webdriver.common.keys.html
 
         Examples:
-        | Press Key | text_field   | q                |                                               |
-        | Press Key | login_button | \\\\13           | # ASCII code for enter key                    |
-        | Press Key | nav_console  | \\\\\\\\ARROW_UP | # selenium.webdriver.common.keys ARROW_UP KEY |
-        """
-        if key.startswith('\\\\') and len(key) > 1:
-            key = getattr(Keys,key[2:])
-        elif key.startswith('\\') and len(key) > 1:
-            key = self._map_ascii_key_code_to_key(int(key[1:]))
-        #if len(key) > 1:
-        #    raise ValueError("Key value '%s' is invalid.", key)
+        | Press Key | text_field   | q        |                                               |
+        | Press Key | login_button | \\\\13   | # ASCII code for Enter key (DEPRECATED)       |
+        | Press Key | login_button | 10       | # ASCII code for Return key                   |
+        | Press Key | nav_console  | ARROW_UP | # selenium.webdriver.common.keys ARROW_UP KEY |
+        
+        NAMED KEY value is new in Selenium2Library 1.7.3.
+        """
+        if len(key) > 1:
+            if key.startswith('\\'):
+                self._warn("Press Key: Escaped ASCII codes are deprecated. Use plain numeric value: '%s'" % (key[1:]))
+                key = self._map_ascii_key_code_to_key(int(key[1:]))
+            else:
+                try:
+                    key = (key.isdecimal() and self._map_ascii_key_code_to_key(int(key))) or\
+                          ((not key.isdecimal()) and self._map_named_key_code_to_special_key(key))
+                except:
+                    raise ValueError("Key value '%s' is invalid." % (key))
         element = self._element_find(locator, True, True)
         #select it
         element.send_keys(key)
@@ -751,6 +758,15 @@ def _map_ascii_key_code_to_key(self, key_code):
             key = chr(key_code)
         return key
 
+    def _map_named_key_code_to_special_key(self, key_name):
+        try:
+           return getattr(Keys, key_name)
+        except:
+           message = "Unknown key named '%s'." % (key_name)
+           self._debug(message)
+           raise ValueError(message)
+        return Keys.NULL
+
     def _parse_attribute_locator(self, attribute_locator):
         parts = attribute_locator.rpartition('@')
         if len(parts[0]) == 0:

test/acceptance/keywords/textfields.robot

@@ -30,19 +30,21 @@ Press Key
     [Setup]    Go To Page "forms/login.html"
     #Cannot Be Executed in IE
     Input Text    username_field    James Bond
-    Press Key    username_field    \\\\HOME
-    Press Key    username_field    \\\\END
-    Press Key    username_field    \\\\ARROW_LEFT
-    Press Key    username_field    \\\\ARROW_LEFT
-    Press Key    username_field    \\\\ARROW_LEFT
-    Press Key    username_field    \\\\ARROW_LEFT
-    Press Key    username_field    \\\\ARROW_RIGHT
-    Press Key    username_field    \\108    #This is the 'l' char
+    Press Key    username_field    HOME
+    Press Key    username_field    END
+    Press Key    username_field    ARROW_LEFT
+    Press Key    username_field    ARROW_LEFT
+    Press Key    username_field    ARROW_LEFT
+    Press Key    username_field    DELETE
+    Press Key    username_field    ARROW_LEFT
+    Press Key    username_field    ARROW_RIGHT
+    Press Key    username_field    \\108    #This is the 'l' char (deprecated style)
+    Press Key    username_field    111    #This is the 'o' char
     ${text} =    Get Value    username_field
     Should Be Equal    ${text}    James Blond
     Press Key    password_field    f
-    Press Key    password_field    \\9
-    Press Key    login_button    \\10
+    Press Key    password_field    9
+    Press Key    login_button    10
     Verify Location Is "forms/submit.html"
 
 Attempt Clear Element Text On Non-Editable Field