Modified and add some comments

Author: soncuteanca

modules/browser_object_navigation.py

@@ -362,8 +362,8 @@ def add_bookmark_via_toolbar_other_bookmark_context_menu(
     ) -> BasePage:
         """
         Add a bookmark via the toolbar's Other Bookmarks context menu.
-        Arguments
-        ----------
+
+        Arguments:
         bookmark_data : A Bookmark object containing the bookmark details to be added (name, url, tags, keyword)
         ba : BrowserActions utility
         """
@@ -386,8 +386,9 @@ def add_bookmark_via_toolbar_other_bookmark_context_menu(
 
     @BasePage.context_chrome
     def toggle_bookmarks_toolbar_with_key_combo(self) -> BasePage:
-        """Use Cmd/Ctrl + B to open the Print Preview, wait for load"""
-
+        """
+        Use Cmd/Ctrl + B to open the Print Preview, wait for load
+        """
         if self.sys_platform() == "Darwin":
             mod_key = Keys.COMMAND
         else:
@@ -433,8 +434,8 @@ def delete_bookmark_from_other_bookmarks_via_context_menu(
     ) -> BasePage:
         """
         Deletes a bookmark from Other Bookmarks via context menu.
+
         Argument:
-        ----------
         bookmark_name: The display name of the bookmark to delete
         """
         self.click_on("other-bookmarks-toolbar")
@@ -446,8 +447,8 @@ def delete_bookmark_from_other_bookmarks_via_context_menu(
     def delete_bookmark_from_bookmarks_toolbar(self, bookmark_name: str) -> BasePage:
         """
         Delete bookmark from bookmarks toolbar via context menu
+
         Argument:
-        ----------
         bookmark_name: The display name of the bookmark to delete
         """
         self.panel_ui.context_click("bookmark-by-title", labels=[bookmark_name])
@@ -460,8 +461,8 @@ def verify_bookmark_exists_in_toolbar_other_bookmarks_folder(
     ) -> BasePage:
         """
         Verify bookmark exists in Other Bookmarks folder from toolbar
-        Arguments
-        ----------
+
+        Argument:
         bookmark_name : The exact name/title of the bookmark to search for in the Other Bookmarks folder.
         """
         self.click_on("other-bookmarks-toolbar")  # Navigation selector
@@ -486,8 +487,8 @@ def verify_bookmark_does_not_exist_in_toolbar_other_bookmarks_folder(
     ) -> BasePage:
         """
         Verify bookmark does not exist in Other Bookmarks folder from toolbar
-        Arguments
-        ----------
+
+        Argument:
         bookmark_name : The exact name/title of the bookmark to search for in the Other Bookmarks folder.
         """
         self.click_on("other-bookmarks-toolbar")
@@ -508,12 +509,10 @@ def verify_bookmark_does_not_exist_in_bookmarks_toolbar(
     def edit_bookmark_via_star_button(self, new_name: str, location: str) -> BasePage:
         """
         Edit bookmark details by opening the edit bookmark panel via the star button
-        Arguments
-        ----------
-        new_name : str
-            The new name/title to assign to the bookmark
-        location : str
-            The folder location where the bookmark should be saved
+
+        Arguments:
+        new_name : The new name/title to assign to the bookmark
+        location : The folder location where the bookmark should be saved
         """
         self.click_on("star-button")
         self.panel_ui.get_element("edit-bookmark-panel").send_keys(new_name)
@@ -523,6 +522,7 @@ def edit_bookmark_via_star_button(self, new_name: str, location: str) -> BasePag
         elif location == "Bookmarks Toolbar":
             self.panel_ui.click_on("bookmark-location")
             self.panel_ui.click_on("bookmarks-toolbar")
+        # for else add Bookmark Menu option if needed in the future
         self.panel_ui.click_on("save-bookmark-button")
         return self
 
@@ -549,7 +549,8 @@ def verify_edit_bookmark_panel_not_visible_after_navigation(self) -> BasePage:
     def open_bookmark_from_toolbar(self, bookmark_title: str) -> BasePage:
         """
         Right-clicks bookmark and opens it in a new private window via context menu
-        Arguments:
+
+        Argument:
             bookmark_title: The title of the bookmark to open
         """
         self.panel_ui.element_clickable("bookmark-by-title", labels=[bookmark_title])
@@ -562,7 +563,8 @@ def open_bookmark_in_new_window_via_context_menu(
     ) -> BasePage:
         """
         Right-click bookmark and opens it in a new window via context menu
-        Arguments:
+
+        Argument:
             bookmark_title: The title of the bookmark to open
         """
         self.panel_ui.element_clickable("bookmark-by-title", labels=[bookmark_title])
@@ -576,7 +578,8 @@ def open_bookmark_in_new_private_window_via_context_menu(
     ) -> BasePage:
         """
         Right-clicks bookmark and opens it in a new private window via context menu
-        Arguments:
+
+        Argument:
             bookmark_title: The title of the bookmark to open
         """
         self.panel_ui.element_clickable("bookmark-by-title", labels=[bookmark_title])
@@ -598,8 +601,7 @@ def expect_bookmarks_toolbar_visibility(self, expected: bool) -> None:
         """
         Assert the visibility state of the Bookmarks Toolbar.
 
-        Arguments:
-        ----------
+        Argument:
         expected (bool):
             If True, asserts that the toolbar is visible (collapsed="false").
             If False, asserts that the toolbar is hidden (collapsed="true")

modules/browser_object_panel_ui.py

@@ -230,7 +230,9 @@ def enable_bookmark_tagging(self) -> BasePage:
     def edit_bookmark_from_hamburger_menu(
         self, new_name: str, tags: str, location: str
     ) -> BasePage:
-        """Edit bookmark details from hamburger menu"""
+        """
+        Edit bookmark details from hamburger menu
+        """
         self.open_bookmarks_panel_from_hamburger_menu()
         self.click_on("bookmark-current-tab")