refactor: standardize parameter and variable naming conventions across multiple files

Author: iampopovich

py/selenium/webdriver/remote/shadowroot.py

@@ -45,7 +45,7 @@ def __repr__(self) -> str:
     def id(self) -> str:
         return self._id
 
-    def find_element(self, by: str = By.ID, value: str = None)-> WebElement:
+    def find_element(self, by: str = By.ID, value: str = None) -> WebElement:
         """Find an element inside a shadow root given a By strategy and
         locator.
 
@@ -65,7 +65,7 @@ def find_element(self, by: str = By.ID, value: str = None)-> WebElement:
             The first matching `WebElement` found on the page.
 
         Example:
-            >>> element = driver.find_element(By.ID, 'foo')
+            >>> element = driver.find_element(By.ID, "foo")
         """
         if by == By.ID:
             by = By.CSS_SELECTOR
@@ -100,7 +100,7 @@ def find_elements(self, by: str = By.ID, value: str = None) -> list[WebElement]:
             List of `WebElements` matching locator strategy found on the page.
 
         Example:
-            >>> element = driver.find_elements(By.ID, 'foo')
+            >>> element = driver.find_elements(By.ID, "foo")
         """
         if by == By.ID:
             by = By.CSS_SELECTOR

py/selenium/webdriver/remote/webdriver.py

@@ -504,9 +504,9 @@ def execute_script(self, script: str, *args):
             *args: Any applicable arguments for your JavaScript.
 
         Example:
-            >>> input_id = "username"
-            >>> input_value = "test_user"
-            >>> driver.execute_script("document.getElementById(arguments[0]).value = arguments[1];", input_id, input_value)
+            >>> id = "username"
+            >>> value = "test_user"
+            >>> driver.execute_script("document.getElementById(arguments[0]).value = arguments[1];", id, value)
         """
         if isinstance(script, ScriptKey):
             try:
@@ -1302,8 +1302,8 @@ def input(self):
 
         Examples:
             >>> from selenium.webdriver.common.bidi.input import KeySourceActions, KeyDownAction, KeyUpAction
-            >>> key_actions = KeySourceActions(id="keyboard", actions=[KeyDownAction(value="a"), KeyUpAction(value="a")])
-            >>> driver.input.perform_actions(driver.current_window_handle, [key_actions])
+            >>> actions = KeySourceActions(id="keyboard", actions=[KeyDownAction(value="a"), KeyUpAction(value="a")])
+            >>> driver.input.perform_actions(driver.current_window_handle, [actions])
             >>> driver.input.release_actions(driver.current_window_handle)
         """
         if not self._websocket_connection:

py/selenium/webdriver/remote/webelement.py

@@ -531,7 +531,7 @@ def find_element(self, by=By.ID, value=None) -> WebElement:
             The first matching `WebElement` found on the page.
 
         Example:
-            >>> element = driver.find_element(By.ID, 'foo')
+            >>> element = driver.find_element(By.ID, "foo")
         """
         by, value = self._parent.locator_converter.convert(by, value)
         return self._execute(Command.FIND_CHILD_ELEMENT, {"using": by, "value": value})["value"]

py/selenium/webdriver/safari/options.py

@@ -66,13 +66,13 @@ class Options(ArgOptions):
     SAFARI_TECH_PREVIEW = "Safari Technology Preview"
 
     # creating descriptor objects
-    automatic_inspection : bool = _SafariOptionsDescriptor(AUTOMATIC_INSPECTION, bool)
+    automatic_inspection: bool = _SafariOptionsDescriptor(AUTOMATIC_INSPECTION, bool)
     """Whether to enable automatic inspection."""
 
-    automatic_profiling : bool = _SafariOptionsDescriptor(AUTOMATIC_PROFILING, bool)
+    automatic_profiling: bool = _SafariOptionsDescriptor(AUTOMATIC_PROFILING, bool)
     """Whether to enable automatic profiling."""
 
-    use_technology_preview : bool = _SafariOptionsDescriptor(SAFARI_TECH_PREVIEW, bool)
+    use_technology_preview: bool = _SafariOptionsDescriptor(SAFARI_TECH_PREVIEW, bool)
     """Whether to use Safari Technology Preview."""
 
     @property

py/selenium/webdriver/support/expected_conditions.py

@@ -558,7 +558,7 @@ def staleness_of(element: WebElement) -> Callable[[Any], bool]:
         >>> from selenium.webdriver.common.by import By
         >>> from selenium.webdriver.support.ui import WebDriverWait
         >>> from selenium.webdriver.support import expected_conditions as EC
-        >>> is_element_stale = WebDriverWait(driver, 10).until(EC.staleness_of(driver.find_element(By.CLASS_NAME, "foo")))
+        >>> is_stale = WebDriverWait(driver, 10).until(EC.staleness_of(driver.find_element(By.CLASS_NAME, "foo")))
     """
 
     def _predicate(_):