replacing unformatted leftovers

Author: iampopovich

py/selenium/webdriver/firefox/webdriver.py

@@ -86,6 +86,11 @@ def quit(self) -> None:
             self.service.stop()
 
     def set_context(self, context) -> None:
+        """Sets the context that Selenium commands are running in.
+
+        Args:
+            context: Context to set, should be one of CONTEXT_CHROME or CONTEXT_CONTENT.
+        """
         self.execute("SET_CONTEXT", {"context": context})
 
     @contextmanager
@@ -94,11 +99,11 @@ def context(self, context):
         `with` statement. The state of the context on the server is saved
         before entering the block, and restored upon exiting it.
 
-        :param context: Context, may be one of the class properties
-            `CONTEXT_CHROME` or `CONTEXT_CONTENT`.
-
-        Usage example::
+        Args:
+            context: Context, may be one of the class properties
+                `CONTEXT_CHROME` or `CONTEXT_CONTENT`.
 
+        Example:
             with selenium.context(selenium.CONTEXT_CHROME):
                 # chrome scope
                 ... do stuff ...
@@ -116,13 +121,15 @@ def install_addon(self, path, temporary=False) -> str:
         Returns identifier of installed addon. This identifier can later
         be used to uninstall addon.
 
-        :param temporary: allows you to load browser extensions temporarily during a session
-        :param path: Absolute path to the addon that will be installed.
+        Args:
+            path: Absolute path to the addon that will be installed.
+            temporary: Allows you to load browser extensions temporarily during a session.
 
-        :Usage:
-            ::
+        Returns:
+            Identifier of installed addon.
 
-                driver.install_addon("/path/to/firebug.xpi")
+        Example:
+            driver.install_addon("/path/to/firebug.xpi")
         """
 
         if os.path.isdir(path):
@@ -147,10 +154,11 @@ def install_addon(self, path, temporary=False) -> str:
     def uninstall_addon(self, identifier) -> None:
         """Uninstalls Firefox addon using its identifier.
 
-        :Usage:
-            ::
+        Args:
+            identifier: The addon identifier to uninstall.
 
-                driver.uninstall_addon("[email protected]")
+        Example:
+            driver.uninstall_addon("[email protected]")
         """
         self.execute("UNINSTALL_ADDON", {"id": identifier})
 
@@ -163,10 +171,8 @@ def get_full_page_screenshot_as_file(self, filename) -> bool:
             filename: The full path you wish to save your screenshot to. This
                 should end with a `.png` extension.
 
-        Usage:
-            ::
-
-                driver.get_full_page_screenshot_as_file("/Screenshots/foo.png")
+        Example:
+            driver.get_full_page_screenshot_as_file("/Screenshots/foo.png")
         """
         if not filename.lower().endswith(".png"):
             warnings.warn(
@@ -192,40 +198,43 @@ def save_full_page_screenshot(self, filename) -> bool:
             filename: The full path you wish to save your screenshot to. This
                 should end with a `.png` extension.
 
-        Usage:
-            ::
-
-                driver.save_full_page_screenshot("/Screenshots/foo.png")
+        Example:
+            driver.save_full_page_screenshot("/Screenshots/foo.png")
         """
         return self.get_full_page_screenshot_as_file(filename)
 
     def get_full_page_screenshot_as_png(self) -> bytes:
         """Gets the full document screenshot of the current window as a binary
         data.
 
-        :Usage:
-            ::
+        Returns:
+            Binary data of the screenshot.
 
-                driver.get_full_page_screenshot_as_png()
+        Example:
+            driver.get_full_page_screenshot_as_png()
         """
         return base64.b64decode(self.get_full_page_screenshot_as_base64().encode("ascii"))
 
     def get_full_page_screenshot_as_base64(self) -> str:
         """Gets the full document screenshot of the current window as a base64
         encoded string which is useful in embedded images in HTML.
 
-        :Usage:
-            ::
+        Returns:
+            Base64 encoded string of the screenshot.
 
-                driver.get_full_page_screenshot_as_base64()
+        Example:
+            driver.get_full_page_screenshot_as_base64()
         """
         return self.execute("FULL_PAGE_SCREENSHOT")["value"]
 
     def download_file(self, *args, **kwargs):
+        """Download file functionality is not implemented for Firefox driver."""
         raise NotImplementedError
 
     def get_downloadable_files(self, *args, **kwargs):
+        """Get downloadable files functionality is not implemented for Firefox driver."""
         raise NotImplementedError
 
     def delete_downloadable_files(self, *args, **kwargs):
+        """Delete downloadable files functionality is not implemented for Firefox driver."""
         raise NotImplementedError