robo_appian 0.0.8__py3-none-any.whl → 0.0.10__py3-none-any.whl

robo_appian/components/ButtonUtils.py

@@ -1,7 +1,7 @@
 from selenium.webdriver.common.by import By
 from selenium.webdriver.support import expected_conditions as EC
 from selenium.webdriver.support.ui import WebDriverWait
-from selenium.webdriver.remote.webdriver import WebDriver
+
 
 class ButtonUtils:
     """
@@ -37,7 +37,16 @@ class ButtonUtils:
         # This method locates a button that contains a span with the specified label text.
 
         xpath = f".//button[./span[contains(translate(normalize-space(.), '\u00a0', ' '), '{label}')]]"
-        component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
+        try:
+            component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
+        except TimeoutError as e:
+            raise TimeoutError(
+                f"Button with label '{label}' not found or not clickable."
+            ) from e
+        except Exception as e:
+            raise RuntimeError(
+                f"Button with label '{label}' not found or not clickable."
+            ) from e
         return component
 
     @staticmethod
@@ -54,6 +63,7 @@ class ButtonUtils:
         """
         component = ButtonUtils.find(wait, label)
         component.click()
+
     @staticmethod
     def clickInputButtonById(wait: WebDriverWait, id: str):
         """
@@ -67,5 +77,15 @@ class ButtonUtils:
             ButtonUtils.clickInputButtonById(wait, "button_id")
 
         """
-        component = wait.until(EC.element_to_be_clickable((By.ID, id)))
-        component.click()
+        try:
+            component = wait.until(EC.element_to_be_clickable((By.ID, id)))
+        except TimeoutError as e:
+            raise TimeoutError(
+                f"Input button with id '{id}' not found or not clickable."
+            ) from e
+        except Exception as e:
+            raise RuntimeError(
+                f"Input button with id '{id}' not found or not clickable."
+            ) from e
+
+        component.click()

robo_appian/components/DateUtils.py

@@ -1,7 +1,6 @@
 from selenium.webdriver.common.by import By
 from selenium.webdriver.support import expected_conditions as EC
 from selenium.webdriver.support.ui import WebDriverWait
-from selenium.webdriver.remote.webdriver import WebDriver
 from selenium.webdriver.remote.webelement import WebElement
 
 from robo_appian.components.InputUtils import InputUtils
@@ -37,11 +36,18 @@ class DateUtils:
         """
 
         xpath = f".//div/label[text()='{label}']"
-        component: WebElement = wait.until(
-            EC.element_to_be_clickable((By.XPATH, xpath))
-        )
-        if not component:
-            raise ValueError(f"Could not find date component with label '{label}'.")
+        try:
+            component: WebElement = wait.until(
+                EC.element_to_be_clickable((By.XPATH, xpath))
+            )
+        except TimeoutError as e:
+            raise TimeoutError(
+                f"Could not find clickable date component with label '{label}': {e}"
+            )
+        except Exception as e:
+            raise Exception(
+                f"Could not find clickable date component with label '{label}': {e}"
+            )
 
         attribute: str = "for"
         component_id = component.get_attribute(attribute)  # type: ignore[reportUnknownMemberType]
@@ -50,7 +56,16 @@ class DateUtils:
                 f"Could not find component using {attribute} attribute for label '{label}'."
             )
 
-        component = wait.until(EC.element_to_be_clickable((By.ID, component_id)))
+        try:
+            component = wait.until(EC.element_to_be_clickable((By.ID, component_id)))
+        except TimeoutError as e:
+            raise TimeoutError(
+                f"Could not find clickable date input with id '{component_id}': {e}"
+            )
+        except Exception as e:
+            raise Exception(
+                f"Could not find clickable date input with id '{component_id}': {e}"
+            )
         return component
 
     @staticmethod
@@ -101,7 +116,7 @@ class DateUtils:
         # It sets the value of the input element and submits it.
 
         component = DateUtils.findComponent(wait, label)
-        InputUtils.setValueAndSubmitUsingComponent(component, value)
+        InputUtils.setValueAndSubmitByComponent(component, value)
 
         return component
 

robo_appian/components/DropdownUtils.py

@@ -1,9 +1,6 @@
-import stat
-from turtle import st
 from selenium.webdriver.common.by import By
 from selenium.webdriver.support import expected_conditions as EC
 from selenium.webdriver.support.ui import WebDriverWait
-from selenium.webdriver.remote.webdriver import WebDriver
 from selenium.webdriver.remote.webelement import WebElement
 
 from robo_appian.components.InputUtils import InputUtils
@@ -26,10 +23,18 @@ class DropdownUtils:
 
     @staticmethod
     def __findDropdownComponentsByXpath(wait: WebDriverWait, xpath: str):
-
         try:
             # Wait for at least one element to be present
-            wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
+            try:
+                wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
+            except TimeoutError as e:
+                raise TimeoutError(
+                    f'No clickable dropdown component found for xpath "{xpath}": {str(e)}'
+                )
+            except Exception as e:
+                raise Exception(
+                    f'No clickable dropdown component found for xpath "{xpath}": {str(e)}'
+                )
 
             # Find all matching elements
             driver = wait._driver
@@ -59,12 +64,23 @@ class DropdownUtils:
 
     @staticmethod
     def selectDropdownValueByComponent(wait, combobox, value):
-        dropdown_id = combobox.get_attribute("aria-controls")  # type: ignore[reportUnknownMemberType]
+        dropdown_id = combobox.get_attribute("aria-controls")
         combobox.click()
 
         option_xpath = f'.//div/ul[@id="{dropdown_id}"]/li[./div[normalize-space(text())="{value}"]]'
-        component = wait.until(EC.presence_of_element_located((By.XPATH, option_xpath)))
-        component = wait.until(EC.element_to_be_clickable((By.XPATH, option_xpath)))
+        try:
+            component = wait.until(
+                EC.presence_of_element_located((By.XPATH, option_xpath))
+            )
+            component = wait.until(EC.element_to_be_clickable((By.XPATH, option_xpath)))
+        except TimeoutError as e:
+            raise TimeoutError(
+                f'Could not find or click dropdown option "{value}" with xpath "{option_xpath}": {str(e)}'
+            )
+        except Exception as e:
+            raise Exception(
+                f'Could not find or click dropdown option "{value}" with xpath "{option_xpath}": {str(e)}'
+            )
         component.click()
 
     @staticmethod
@@ -78,7 +94,6 @@ class DropdownUtils:
     def selectDropdownValueByLabelText(
         wait: WebDriverWait, dropdown_label: str, value: str
     ):
-
         xpath = f'.//div[./div/span[normalize-space(text())="{dropdown_label}"]]/div/div/div/div[@role="combobox" and @tabindex="0"]'
         DropdownUtils.__selectDropdownValueByXpath(wait, xpath, value)
 
@@ -86,13 +101,11 @@ class DropdownUtils:
     def selectDropdownValueByPartialLabelText(
         wait: WebDriverWait, dropdown_label: str, value: str
     ):
-
         xpath = f'.//div[./div/span[contains(normalize-space(text()), "{dropdown_label}")]]/div/div/div/div[@role="combobox" and @tabindex="0"]'
         DropdownUtils.__selectDropdownValueByXpath(wait, xpath, value)
 
     @staticmethod
     def __selectSearchDropdownValueByXpath(wait, xpath, value):
-
         components = DropdownUtils.__findDropdownComponentsByXpath(wait, xpath)
 
         for component in components:
@@ -102,13 +115,33 @@ class DropdownUtils:
                 component.click()
 
                 input_component_id = str(component_id) + "_searchInput"
-                input_component = wait.until(
-                    EC.element_to_be_clickable((By.ID, input_component_id))
-                )
+                try:
+                    input_component = wait.until(
+                        EC.element_to_be_clickable((By.ID, input_component_id))
+                    )
+                except TimeoutError as e:
+                    raise TimeoutError(
+                        f'Could not find or click search input component with id "{input_component_id}": {str(e)}'
+                    )
+                except Exception as e:
+                    raise Exception(
+                        f'Could not find or click search input component with id "{input_component_id}": {str(e)}'
+                    )
                 InputUtils._setComponentValue(input_component, value)
 
                 xpath = f'.//ul[@id="{dropdown_id}"]/li[./div[normalize-space(text())="{value}"]][1]'
-                component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
+                try:
+                    component = wait.until(
+                        EC.element_to_be_clickable((By.XPATH, xpath))
+                    )
+                except TimeoutError as e:
+                    raise TimeoutError(
+                        f'Could not find or click search dropdown option "{value}" with xpath "{xpath}": {str(e)}'
+                    )
+                except Exception as e:
+                    raise Exception(
+                        f'Could not find or click search dropdown option "{value}" with xpath "{xpath}": {str(e)}'
+                    )
                 component.click()
 
     @staticmethod
@@ -122,7 +155,6 @@ class DropdownUtils:
     def selectSearchDropdownValueByPartialLabelText(
         wait: WebDriverWait, dropdown_label: str, value: str
     ):
-
         xpath = f'.//div[./div/span[contains(normalize-space(text()), "{dropdown_label}")]]/div/div/div/div[@role="combobox" and @tabindex="0"]'
         DropdownUtils.__selectSearchDropdownValueByXpath(wait, xpath, value)
 
@@ -130,7 +162,16 @@ class DropdownUtils:
     def selectValueByDropdownWrapperComponent(
         wait: WebDriverWait, component: WebElement, value: str
     ):
-        xpath = f'./div/div[@role="combobox" and @tabindex="0"]'
-        combobox = component.find_element(By.XPATH, xpath)
+        xpath = './div/div[@role="combobox" and @tabindex="0"]'
+        try:
+            combobox = component.find_element(By.XPATH, xpath)
+        except TimeoutError as e:
+            raise TimeoutError(
+                f'Could not find combobox element with xpath "{xpath}" in the provided component: {str(e)}'
+            )
+        except Exception as e:
+            raise Exception(
+                f'Could not find combobox element with xpath "{xpath}" in the provided component: {str(e)}'
+            )
         DropdownUtils.selectDropdownValueByComponent(wait, combobox, value)
         return combobox

robo_appian/components/InputUtils.py

@@ -1,12 +1,9 @@
-import stat
-from numpy import size
 from robo_appian.utils.ComponentUtils import ComponentUtils
 from selenium.webdriver.common.by import By
 from selenium.webdriver.common.keys import Keys
 from selenium.webdriver.support import expected_conditions as EC
 from selenium.webdriver.support.ui import WebDriverWait
 from selenium.webdriver.remote.webelement import WebElement
-from typing import List
 
 
 class InputUtils:
@@ -22,7 +19,7 @@ class InputUtils:
     """
 
     @staticmethod
-    def setValueAndSubmitUsingComponent(component: WebElement, value: str):
+    def setValueAndSubmitByComponent(component: WebElement, value: str):
         """
         Sets a value in an input component and submits it using the provided component element.
 
@@ -34,7 +31,7 @@ class InputUtils:
             The Selenium WebElement for the input component after setting the value and submitting.
 
         Example:
-            InputUtils.setValueAndSubmitUsingComponent(component, "test_user")
+            InputUtils.setValueAndSubmitByComponent(component, "test_user")
 
         """
         # This method assumes that the component is already found and passed as an argument.
@@ -49,29 +46,38 @@ class InputUtils:
         return component
 
     @staticmethod
-    def __findInputComponentsByLabelPath(wait: WebDriverWait, xpath: str):
+    def __findInputComponentsByXpath(wait: WebDriverWait, xpath: str):
         label_components = ComponentUtils.findComponentsByXPath(wait, xpath)
         input_components = []
         for label_component in label_components:
             attribute: str = "for"
             component_id = label_component.get_attribute(attribute)  # type: ignore[reportUnknownMemberType]
             if component_id:
-                component = wait.until(
-                    EC.element_to_be_clickable((By.ID, component_id))
-                )
-                input_components.append(component)
+                try:
+                    component = wait.until(
+                        EC.element_to_be_clickable((By.ID, component_id))
+                    )
+                    input_components.append(component)
+                except TimeoutError as e:
+                    raise TimeoutError(
+                        f"Timeout or error finding input component with id '{component_id}': {e}"
+                    )
+                except Exception as e:
+                    raise Exception(
+                        f"Timeout or error finding input component with id '{component_id}': {e}"
+                    )
         return input_components
 
     @staticmethod
     def __findInputComponentsByPartialLabel(wait: WebDriverWait, label: str):
         xpath = f'.//div/label[contains(normalize-space(text()), "{label}")]'
-        components = InputUtils.__findInputComponentsByLabelPath(wait, xpath)
+        components = InputUtils.__findInputComponentsByXpath(wait, xpath)
         return components
 
     @staticmethod
     def __findInputComponentsByLabel(wait: WebDriverWait, label: str):
         xpath = f'.//div/label[normalize-space(text())="{label}"]'
-        components = InputUtils.__findInputComponentsByLabelPath(wait, xpath)
+        components = InputUtils.__findInputComponentsByXpath(wait, xpath)
         return components
 
     @staticmethod
@@ -109,6 +115,15 @@ class InputUtils:
 
     @staticmethod
     def setValueById(wait: WebDriverWait, component_id: str, value: str):
-        component = wait.until(EC.element_to_be_clickable((By.ID, component_id)))
+        try:
+            component = wait.until(EC.element_to_be_clickable((By.ID, component_id)))
+        except TimeoutError as e:
+            raise TimeoutError(
+                f"Timeout or error finding input component with id '{component_id}': {e}"
+            )
+        except Exception as e:
+            raise Exception(
+                f"Timeout or error finding input component with id '{component_id}': {e}"
+            )
         InputUtils._setComponentValue(component, value)
         return component

robo_appian/components/LabelUtils.py

@@ -1,7 +1,6 @@
 from selenium.webdriver.common.by import By
 from selenium.webdriver.support import expected_conditions as EC
 from selenium.webdriver.support.ui import WebDriverWait
-from selenium.webdriver.remote.webdriver import WebDriver
 
 
 class LabelUtils:
@@ -36,7 +35,17 @@ class LabelUtils:
         # It uses XPath to find the element that matches the text.
 
         xpath = f".//*[normalize-space(text())='{label}']"
-        component = wait.until(EC.presence_of_element_located((By.XPATH, xpath)))
+        try:
+            component = wait.until(EC.presence_of_element_located((By.XPATH, xpath)))
+        except TimeoutError as e:
+            raise TimeoutError(
+                f"Label '{label}' not found within the timeout period."
+            ) from e
+        except Exception as e:
+            raise Exception(
+                f"Label '{label}' not found within the timeout period."
+            ) from e
+
         return component
 
     @staticmethod

robo_appian/components/LinkUtils.py

@@ -1,11 +1,9 @@
 from selenium.webdriver.common.by import By
 from selenium.webdriver.support import expected_conditions as EC
 from selenium.webdriver.support.ui import WebDriverWait
-from selenium.webdriver.remote.webdriver import WebDriver
 
 
 class LinkUtils:
-    
     """
     Utility class for interacting with link components in Appian UI.
 
@@ -16,15 +14,22 @@ class LinkUtils:
         LinkUtils.click(wait, "Learn More")
 
     """
+
     @staticmethod
     def find(wait: WebDriverWait, label: str):
         xpath = f'.//a[normalize-space(text())="{label}"]'
-        component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
+        try:
+            component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
+        except TimeoutError as e:
+            raise TimeoutError(
+                f"Could not find clickable link with label '{label}': {e}"
+            )
+        except Exception as e:
+            raise Exception(f"Could not find clickable link with label '{label}': {e}")
         return component
 
     @staticmethod
     def click(wait: WebDriverWait, label: str):
-
         """
         Clicks a link identified by its label.
 
@@ -35,7 +40,7 @@ class LinkUtils:
         Example:
             LinkUtils.click(wait, "Learn More")
         """
-        
-        component = LinkUtils.find(wait. label)
+
+        component = LinkUtils.find(wait, label)
         component.click()
         return component

robo_appian/components/SearchInputUtils.py

@@ -6,7 +6,6 @@ from robo_appian.utils.ComponentUtils import ComponentUtils
 
 
 class SearchInputUtils:
-
     @staticmethod
     def __findSearchInputComponentsByLabelPathAndSelectValue(
         wait: WebDriverWait, xpath: str, value: str
@@ -19,9 +18,18 @@ class SearchInputUtils:
             if dropdown_list_id:
                 InputUtils._setComponentValue(search_input_component, value)
                 xpath = f".//ul[@id='{dropdown_list_id}' and @role='listbox' ]/li[@role='option']/div/div/div/div/div/div/p[text()='{value}'][1]"
-                drop_down_item = wait.until(
-                    EC.element_to_be_clickable((By.XPATH, xpath))
-                )
+                try:
+                    drop_down_item = wait.until(
+                        EC.element_to_be_clickable((By.XPATH, xpath))
+                    )
+                except TimeoutError as e:
+                    raise TimeoutError(
+                        f"Dropdown item with value '{value}' not found for component '{search_input_component.text}'."
+                    ) from e
+                except Exception as e:
+                    raise RuntimeError(
+                        f"Dropdown item with value '{value}' not found for component '{search_input_component.text}'."
+                    ) from e
                 drop_down_item.click()
             else:
                 raise ValueError(
@@ -52,7 +60,6 @@ class SearchInputUtils:
 
     @staticmethod
     def selectSearchDropdownByLabelText(wait: WebDriverWait, label: str, value: str):
-
         SearchInputUtils.__selectSearchInputComponentsByLabelText(wait, label, value)
 
     @staticmethod

robo_appian/components/TabUtils.py

@@ -10,15 +10,15 @@ class TabUtils:
 
         # Select a tab by its label
         from robo_appian.components.TabUtils import TabUtils
-        TabUtils.select_tab(wait, "Settings")
+        TabUtils.selectInactiveTab(wait, "Settings")
 
         # Find the currently selected tab by its label
         from robo_appian.components.TabUtils import TabUtils
-        selected_tab = TabUtils.find_selected_tab(wait, "Settings")
+        selected_tab = TabUtils.findSelectedTab(wait, "Settings")
     """
 
     @staticmethod
-    def find_selected_tab(wait, label):
+    def findSelectedTab(wait, label):
         """
         Finds the currently selected tab by its label.
 
@@ -30,16 +30,21 @@ class TabUtils:
             The Selenium WebElement for the selected tab.
 
         Example:
-            TabUtils.find_selected_tab(wait, "Settings")
+            TabUtils.findSelectedTab(wait, "Settings")
         """
         # This method locates a tab that is currently selected and contains the specified label.
 
         xpath = f".//div[./div[./div/div/div/div/div/p/strong[normalize-space(text())='{label}']]/span[text()='Selected Tab.']]/div[@role='link']"
-        component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
+        try:
+            component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
+        except TimeoutError as e:
+            raise TimeoutError(f"Could not find selected tab with label '{label}': {e}")
+        except Exception as e:
+            raise RuntimeError(f"Could not find selected tab with label '{label}': {e}")
         return component
 
     @staticmethod
-    def select_tab(wait, label):
+    def selectInactiveTab(wait, label):
         """
         Selects a tab by its label.
 
@@ -48,11 +53,16 @@ class TabUtils:
             label: The visible text label of the tab to select.
 
         Example:
-            TabUtils.select_tab(wait, "Settings")
+            TabUtils.selectInactiveTab(wait, "Settings")
         """
         # This method locates a tab that contains a label with the specified text.
 
         xpath = f".//div[@role='link']/div/div/div/div/div[./p/span[text()='{label}']]"
         # xpath=f".//div[./div[./div/div/div/div/div/p/strong[normalize-space(text())='{label}']]/span[text()='Selected Tab.']]/div[@role='link']"
-        component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
+        try:
+            component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
+        except TimeoutError as e:
+            raise TimeoutError(f"Could not find tab with label '{label}': {e}")
+        except Exception as e:
+            raise RuntimeError(f"Could not find tab with label '{label}': {e}")
         component.click()

robo_appian/components/TableUtils.py

@@ -1,7 +1,6 @@
 from selenium.webdriver.common.by import By
 from selenium.webdriver.support import expected_conditions as EC
 from selenium.webdriver.support.ui import WebDriverWait
-from selenium.webdriver.remote.webdriver import WebDriver
 
 
 class TableUtils:
@@ -12,12 +11,12 @@ class TableUtils:
 
         # Find a table using a column name
         from robo_appian.components.TableUtils import TableUtils
-        table = TableUtils.findTableUsingColumnName(wait, "Status")
+        table = TableUtils.findTableByColumnName(wait, "Status")
 
     """
 
     @staticmethod
-    def findTableUsingColumnName(wait: WebDriverWait, columnName: str):
+    def findTableByColumnName(wait: WebDriverWait, columnName: str):
         """
         Finds a table component that contains a column with the specified name.
 
@@ -29,7 +28,7 @@ class TableUtils:
             The Selenium WebElement for the table component.
 
         Example:
-            table = TableUtils.findTableUsingColumnName(wait, "Status")
+            table = TableUtils.findTableByColumnName(wait, "Status")
 
         """
         # This method locates a table that contains a header cell with the specified column name.
@@ -38,65 +37,18 @@ class TableUtils:
 
         # xpath = f".//table[./thead/tr/th[@abbr='{columnName}']]"
         xpath = f'.//table[./thead/tr/th[@abbr="{columnName}"]]'
-        component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
+        try:
+            component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
+        except TimeoutError as e:
+            raise TimeoutError(
+                f"Could not find table with column name '{columnName}': {e}"
+            )
+        except Exception as e:
+            raise RuntimeError(
+                f"Could not find table with column name '{columnName}': {e}"
+            )
         return component
 
-    @staticmethod
-    def clickOnLinkUsingHoverText(wait, columnName, rowNumber, hoverText):
-        """
-        Clicks on a link in a table cell identified by its column name, row number, and the hover text of the link.
-
-        Parameters:
-            wait: Selenium WebDriverWait instance.
-            columnName: The name of the column where the link is located.
-            rowNumber: The row number (0-based index) where the link is located.
-            hoverText: The text that appears when hovering over the link.
-
-        Example:
-            TableUtils.clickOnLinkUsingHoverText(wait, "Status", 2, "View Details")
-
-        """
-
-        # This method locates a link within a specific table cell based on the column name and row number.
-        # It constructs an XPath that targets the table cell containing the link with the specified hover text.
-        # The XPath first identifies the table by the column name, then finds the specific row and cell,
-        # and finally looks for the link with the specified hover text.
-
-        xpath = f".//table[./thead/tr/th[@abbr='{columnName}']]/tbody/tr[@data-dnd-name='row {rowNumber + 1}']/td[not (@data-empty-grid-message)]/div/p/a[./span[text()='{hoverText}']]"
-        # xpath=f".//table[./thead/tr/th/div[text()='{columnName}']][1]/tbody/tr[@data-dnd-name='row {rowNumber}']/td/div/p/a[./span[text()='{hoverText}']]"
-        component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
-        component.click()
-
-    @staticmethod
-    def clickOnButtonUsingHoverText(wait, columnName, rowNumber, hoverText):
-        """
-        Clicks on a button in a table cell identified by its column name, row number, and the hover text of the button.
-
-        Parameters:
-            wait: Selenium WebDriverWait instance.
-            columnName: The name of the column where the button is located.
-            rowNumber: The row number (0-based index) where the button is located.
-            hoverText: The text that appears when hovering over the button.
-
-        Example:
-            TableUtils.clickOnButtonUsingHoverText(wait, "Actions", 2, "Delete")
-
-        """
-        # This method locates a button within a specific table cell based on the column name and row number.
-        # It constructs an XPath that targets the table cell containing the button with the specified hover text.
-        # The XPath first identifies the table by the column name, then finds the specific row and cell,
-        # and finally looks for the button with the specified hover text.
-
-        # TODO rowNumber = rowNumber + 1  # Adjusting for 1-based index in XPath
-
-        xpath = f".//table[./thead/tr/th[@abbr='{columnName}']]/tbody/tr[@data-dnd-name='row {rowNumber}']/td[not (@data-empty-grid-message)]"
-        component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
-        component.click()
-
-        xpath = f".//table[./thead/tr/th[@abbr='{columnName}']]/tbody/tr[@data-dnd-name='row {rowNumber}']/td[not (@data-empty-grid-message)]/div/div/button[./span[text()='{hoverText}']]"
-        component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
-        component.click()
-
     @staticmethod
     def rowCount(tableObject):
         """
@@ -120,7 +72,7 @@ class TableUtils:
         return len(rows)
 
     @staticmethod
-    def findColumNumberUsingColumnName(tableObject, columnName):
+    def findColumNumberByColumnName(tableObject, columnName):
         """
         Finds the column number in a table based on the column name.
 
@@ -132,7 +84,7 @@ class TableUtils:
             The index of the column (0-based).
 
         Example:
-            column_number = TableUtils.findColumNumberUsingColumnName(table, "Status")
+            column_number = TableUtils.findColumNumberByColumnName(table, "Status")
 
         """
         # This method locates the column header cell with the specified column name
@@ -142,8 +94,10 @@ class TableUtils:
         component = tableObject.find_element(By.XPATH, xpath)
 
         if component is None:
-            raise ValueError(f"Could not find a column with abbr '{columnName}' in the table header.")
-        
+            raise ValueError(
+                f"Could not find a column with abbr '{columnName}' in the table header."
+            )
+
         class_string = component.get_attribute("class")
         partial_string = "headCell_"
         words = class_string.split()
@@ -154,13 +108,15 @@ class TableUtils:
                 selected_word = word
 
         if selected_word is None:
-            raise ValueError(f"Could not find a class containing '{partial_string}' in the column header for '{columnName}'.")
-        
+            raise ValueError(
+                f"Could not find a class containing '{partial_string}' in the column header for '{columnName}'."
+            )
+
         data = selected_word.split("_")
         return int(data[1])
 
     @staticmethod
-    def find_component_from_tabele_cell(wait, rowNumber, columnName):
+    def findComponentFromTableCell(wait, rowNumber, columnName):
         """
         Finds a component within a specific table cell based on the row number and column name.
 
@@ -173,22 +129,29 @@ class TableUtils:
             The Selenium WebElement for the component within the specified table cell.
 
         Example:
-            component = TableUtils.find_component_from_tabele_cell(wait, 2, "Status")
+            component = TableUtils.findComponentFromTableCell(wait, 2, "Status")
 
         """
         # This method locates a specific component within a table cell based on the provided row number
         # and column name. It constructs an XPath that targets the table cell containing the specified column
         # and row, and then retrieves the component within that cell.
 
-        tableObject = TableUtils.findTableUsingColumnName(wait, columnName)
-        columnNumber = TableUtils.findColumNumberUsingColumnName(
-            tableObject, columnName
-        )
+        tableObject = TableUtils.findTableByColumnName(wait, columnName)
+        columnNumber = TableUtils.findColumNumberByColumnName(tableObject, columnName)
         # xpath=f'./tbody/tr[@data-dnd-name="row {rowNumber+1}"]/td[not (@data-empty-grid-message)][{columnNumber}]'
         # component = tableObject.find_elements(By.XPATH, xpath)
         rowNumber = rowNumber + 1
         columnNumber = columnNumber + 1
         xpath = f'.//table[./thead/tr/th[@abbr="{columnName}"]]/tbody/tr[@data-dnd-name="row {rowNumber}"]/td[not (@data-empty-grid-message)][{columnNumber}]/*'
-        component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
+        try:
+            component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
+        except TimeoutError as e:
+            raise TimeoutError(
+                f"Could not find component in cell at row {rowNumber}, column '{columnName}': {e}"
+            )
+        except Exception as e:
+            raise RuntimeError(
+                f"Could not find component in cell at row {rowNumber}, column '{columnName}': {e}"
+            )
         # childComponent=component.find_element(By.xpath("./*"))
         return component

robo_appian/controllers/ComponentDriver.py

@@ -1,6 +1,5 @@
 from robo_appian.components.ButtonUtils import ButtonUtils
 from selenium.webdriver.support.ui import WebDriverWait
-from robo_appian.utils.ComponentUtils import ComponentUtils
 from robo_appian.components.DateUtils import DateUtils
 from robo_appian.components.DropdownUtils import DropdownUtils
 from robo_appian.components.InputUtils import InputUtils
@@ -35,7 +34,6 @@ class ComponentDriver:
         # This method executes an action on a specified component type based on the provided parameters.
 
         match type:
-
             case "Date":
                 match action:
                     case "Set Value":
@@ -77,7 +75,9 @@ class ComponentDriver:
             case "Search Drop Down":
                 match action:
                     case "Select":
-                        DropdownUtils.selectSearchDropdownValueByLabelText(wait, label, value)
+                        DropdownUtils.selectSearchDropdownValueByLabelText(
+                            wait, label, value
+                        )
                     case _:
                         raise ValueError(f"Unsupported action for {type}: {action}")
             case "Button":
@@ -89,7 +89,7 @@ class ComponentDriver:
             case "Tab":
                 match action:
                     case "Find":
-                        TabUtils.find_selected_tab(wait, label)
+                        TabUtils.findSelectedTab(wait, label)
                     case _:
                         raise ValueError(f"Unsupported action for {type}: {action}")
             case _:

robo_appian/utils/ComponentUtils.py

@@ -203,7 +203,7 @@ class ComponentUtils:
         Raises:
             Exception: If no components are found.
         """
-        
+
         # Wait for at least one element to be present
         wait.until(EC.presence_of_element_located((By.XPATH, xpath)))
 

{robo_appian-0.0.8.dist-info → robo_appian-0.0.10.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: robo_appian
-Version: 0.0.8
+Version: 0.0.10
 Summary: Automate your Appian code testing with Python. Boost quality, save time.
 Author: Dinil Mithra
 Author-email: dinilmithra@mailme@gmail.com

robo_appian-0.0.10.dist-info/RECORD

@@ -0,0 +1,21 @@
+robo_appian/__init__.py,sha256=6u9n2W7P1IKSSr5IPGsg7LhVR1o1uYv424mXDjJLgb0,720
+robo_appian/components/ButtonUtils.py,sha256=oezrvj3n95KE7O-O-bkyvtfzrCzD3GJw7Za9QCYnGuc,2793
+robo_appian/components/DateUtils.py,sha256=yewRjKarXj6xMA0RtiXu_ZshGXEkkhAu1bmq01uug74,5117
+robo_appian/components/DropdownUtils.py,sha256=Fh6RxepV45QMF8bIlrmPtbXE_i3kQlaHCSBVznOSxR4,7736
+robo_appian/components/InputUtils.py,sha256=GDLn3ZZ8YrO6NfNgiRH9q1qaHdsE8v1nZTSH4jc3tgw,5102
+robo_appian/components/LabelUtils.py,sha256=bhMM2_lTyx8839ia__8qXVqAhTvnsgPCe7AIcEFYEN0,1654
+robo_appian/components/LinkUtils.py,sha256=R8B4xj7V6agyz9m2GFt_jQQE8yjHPd6R5T3Pn8YRxCk,1397
+robo_appian/components/SearchInputUtils.py,sha256=EKajPjmeuEHwY4aswHXAEhO8I4igS3icWovK_rZV6K8,3064
+robo_appian/components/TabUtils.py,sha256=e3zk9hPXwynyA0aEIr5DEm2wpSvT8yewqKAUyWYUjzw,2575
+robo_appian/components/TableUtils.py,sha256=X0iA7saWm72Qgz_oZ4dnE3wp8-44Xdj16zzUnazGUIQ,6062
+robo_appian/components/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+robo_appian/controllers/ComponentDriver.py,sha256=6-zJ9UTpRAwOqk0wlVlE0PCD05DnV54pXFuxw4Mbbk0,4345
+robo_appian/controllers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+robo_appian/exceptions/MyCustomError.py,sha256=DVAkytXNNQNjqyTyCjk6FFd6fr3AsBe57Y19erDSqVs,222
+robo_appian/exceptions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+robo_appian/utils/ComponentUtils.py,sha256=gxSmF2LvlNpK6qnKt9JAq76dQjAXq74FDfABsZ36w9o,8390
+robo_appian/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+robo_appian-0.0.10.dist-info/LICENSE,sha256=g-xR4dRa9_4iFkMoJmED-wE-J5hoxbk3105Knhfpjm0,1068
+robo_appian-0.0.10.dist-info/METADATA,sha256=bd5Wja8dut9ScwgtK6yrYvtQ0xTYMPjkPLj9wyDBHFw,4105
+robo_appian-0.0.10.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
+robo_appian-0.0.10.dist-info/RECORD,,

robo_appian-0.0.8.dist-info/RECORD

@@ -1,21 +0,0 @@
-robo_appian/__init__.py,sha256=6u9n2W7P1IKSSr5IPGsg7LhVR1o1uYv424mXDjJLgb0,720
-robo_appian/components/ButtonUtils.py,sha256=fzxVG_OWzAwwMc_L7cBE48a_aih_diMTWj4UtVfttrI,2171
-robo_appian/components/DateUtils.py,sha256=mmvyYVgp0thiIQ2uaUiEV-aXwsyCp2d1W8hKR6j_E4M,4599
-robo_appian/components/DropdownUtils.py,sha256=5p6Twef2dYf8Zta_SP3sIcWbaZqVI-yeMNOywHHitHw,5720
-robo_appian/components/InputUtils.py,sha256=DwsC8G7e4lVdd2wxmUfCiX_9PDf6WXQfkrPOO2mF_B4,4393
-robo_appian/components/LabelUtils.py,sha256=cPu4p7z-5kNTxxLY4d1dMDhNtkLnNaM88Kl6ptHvvHo,1382
-robo_appian/components/LinkUtils.py,sha256=owUUJ4-pYDf0oRV1M146kqBfBb96rH7nCK3iA_t2Mpo,1177
-robo_appian/components/SearchInputUtils.py,sha256=WbPrsDVWnagtz1Vkj0gftf6jfTYivODEeqz2E12oXUc,2576
-robo_appian/components/TabUtils.py,sha256=A3Zeu5Lg7JcD_c_xCtIm7Xkjm53VTLtBhzFGLyY0FoA,2058
-robo_appian/components/TableUtils.py,sha256=CeYYmFdOD0F78UkkVXlRmrZatPr94oSVCHyGf_fgfuw,8583
-robo_appian/components/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-robo_appian/controllers/ComponentDriver.py,sha256=faeC_T06aT9XbDnUPqGwpG5ng7wULPmZigyU8TXLCu4,4354
-robo_appian/controllers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-robo_appian/exceptions/MyCustomError.py,sha256=DVAkytXNNQNjqyTyCjk6FFd6fr3AsBe57Y19erDSqVs,222
-robo_appian/exceptions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-robo_appian/utils/ComponentUtils.py,sha256=uq1y6_DxH3O-m7vCvtdVE5640Wx8Je8ydA7pbKDrKVw,8398
-robo_appian/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-robo_appian-0.0.8.dist-info/LICENSE,sha256=g-xR4dRa9_4iFkMoJmED-wE-J5hoxbk3105Knhfpjm0,1068
-robo_appian-0.0.8.dist-info/METADATA,sha256=2CuricJFVWA7LSyv6RBAqxXjjtH8HRT0cKc83zcFPTc,4104
-robo_appian-0.0.8.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
-robo_appian-0.0.8.dist-info/RECORD,,