prettyfy docstrings in ChromiumOptions, Edge Options, and Service classes for clarity and consistency

Author: iampopovich

py/selenium/webdriver/chromium/options.py

@@ -38,8 +38,9 @@ def __init__(self) -> None:
 
     @property
     def binary_location(self) -> str:
-        """Returns:
-        The location of the binary, otherwise an empty string.
+        """
+        Returns:
+            The location of the binary, otherwise an empty string.
         """
         return self._binary_location
 
@@ -56,8 +57,9 @@ def binary_location(self, value: str) -> None:
 
     @property
     def debugger_address(self) -> Optional[str]:
-        """Returns:
-        The address of the remote devtools instance.
+        """
+        Returns:
+            The address of the remote devtools instance.
         """
         return self._debugger_address
 
@@ -75,8 +77,9 @@ def debugger_address(self, value: str) -> None:
 
     @property
     def extensions(self) -> list[str]:
-        """Returns:
-        A list of encoded extensions that will be loaded.
+        """
+        Returns:
+            A list of encoded extensions that will be loaded.
         """
 
         def _decode(file_data: BinaryIO) -> str:
@@ -122,8 +125,9 @@ def add_encoded_extension(self, extension: str) -> None:
 
     @property
     def experimental_options(self) -> dict:
-        """Returns:
-        A dictionary of experimental options for chromium.
+        """
+        Returns:
+            A dictionary of experimental options for chromium.
         """
         return self._experimental_options
 
@@ -138,9 +142,10 @@ def add_experimental_option(self, name: str, value: Union[str, int, dict, list[s
 
     @property
     def enable_webextensions(self) -> bool:
-        """Returns:
-        Whether webextension support is enabled for Chromium-based browsers.
-        True if webextension support is enabled, False otherwise.
+        """
+        Returns:
+            Whether webextension support is enabled for Chromium-based browsers.
+            True if webextension support is enabled, False otherwise.
         """
         return self._enable_webextensions
 

py/selenium/webdriver/edge/options.py

@@ -29,8 +29,9 @@ def __init__(self) -> None:
 
     @property
     def use_webview(self) -> bool:
-        """Returns:
-        Whether WebView2 is enabled for Edge browser.
+        """
+        Returns:
+            Whether WebView2 is enabled for Edge browser.
         """
         return self._use_webview
 
@@ -57,7 +58,8 @@ def to_capabilities(self) -> dict:
 
     @property
     def default_capabilities(self) -> dict:
-        """Returns:
-        The default capabilities for Edge browser.
+        """
+        Returns:
+            The default capabilities for Edge browser.
         """
         return DesiredCapabilities.EDGE.copy()

py/selenium/webdriver/edge/service.py

@@ -61,8 +61,9 @@ def __init__(
 
     @property
     def service_args(self) -> Sequence[str]:
-        """Returns:
-        The sequence of service arguments.
+        """
+        Returns:
+            The sequence of service arguments.
         """
         return self._service_args