robo_appian 0.0.15__tar.gz → 0.0.17__tar.gz

{robo_appian-0.0.15 → robo_appian-0.0.17}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: robo_appian
-Version: 0.0.15
+Version: 0.0.17
 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.15 → robo_appian-0.0.17}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "robo_appian"
-version = "0.0.15"
+version = "0.0.17"
 description = "Automate your Appian code testing with Python. Boost quality, save time."
 authors = ["Dinil Mithra <dinilmithra@mailme@gmail.com>"]
 readme = "README.md"

{robo_appian-0.0.15 → robo_appian-0.0.17}/robo_appian/components/ButtonUtils.py

@@ -1,6 +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.webelement import WebElement
 
 
 class ButtonUtils:
@@ -12,6 +13,11 @@ class ButtonUtils:
         ButtonUtils.clickByLabelText(wait, "Submit")
     """
 
+    @staticmethod
+    def __click(wait: WebDriverWait, component: WebElement):
+        wait.until(EC.element_to_be_clickable(component))
+        component.click()
+
     @staticmethod
     def _findByPartialLabelText(wait: WebDriverWait, label: str):
         """
@@ -69,7 +75,7 @@ class ButtonUtils:
                 ButtonUtils.clickByPartialLabelText(wait, "Button Label")
         """
         component = ButtonUtils._findByPartialLabelText(wait, label)
-        component.click()
+        ButtonUtils.__click(wait, component)
 
     @staticmethod
     def clickByLabelText(wait: WebDriverWait, label: str):
@@ -82,7 +88,7 @@ class ButtonUtils:
                 ButtonUtils.clickByLabelText(wait, "Button Label")
         """
         component = ButtonUtils._findByLabelText(wait, label)
-        component.click()
+        ButtonUtils.__click(wait, component)
 
     @staticmethod
     def clickById(wait: WebDriverWait, id: str):
@@ -102,4 +108,4 @@ class ButtonUtils:
         except Exception as e:
             raise RuntimeError(f"Input button with id '{id}' not found or not clickable.") from e
 
-        component.click()
+        ButtonUtils.__click(wait, component)

{robo_appian-0.0.15 → robo_appian-0.0.17}/robo_appian/components/DateUtils.py

@@ -59,7 +59,7 @@ class DateUtils:
             DateUtils.setValueByLabelText(wait, "Start Date", "2023-10-01")
         """
         component = DateUtils.__findComponent(wait, label)
-        InputUtils._setValueByComponent(component, value)
+        InputUtils._setValueByComponent(wait, component, value)
         return component
 
     @staticmethod

{robo_appian-0.0.15 → robo_appian-0.0.17}/robo_appian/components/InputUtils.py

@@ -85,7 +85,7 @@ class InputUtils:
         return components
 
     @staticmethod
-    def _setValueByComponent(component: WebElement, value: str):
+    def _setValueByComponent(wait: WebDriverWait, component: WebElement, value: str):
         """
         Sets a value in an input component.
         Parameters:
@@ -96,6 +96,7 @@ class InputUtils:
         Example:
             InputUtils._setValueByComponent(component, "test_value")
         """
+        wait.until(EC.element_to_be_clickable(component))
         component.clear()
         component.send_keys(value)
         return component
@@ -115,7 +116,7 @@ class InputUtils:
         """
 
         for component in input_components:
-            InputUtils._setValueByComponent(component, value)
+            InputUtils._setValueByComponent(wait, component, value)
 
     @staticmethod
     def setValueByPartialLabelText(wait: WebDriverWait, label: str, value: str):
@@ -161,5 +162,5 @@ class InputUtils:
             component = wait.until(EC.element_to_be_clickable((By.ID, component_id)))
         except Exception as e:
             raise Exception(f"Timeout or error finding input component with id '{component_id}': {e}")
-        InputUtils._setValueByComponent(component, value)
+        InputUtils._setValueByComponent(wait, component, value)
         return component

{robo_appian-0.0.15 → robo_appian-0.0.17}/robo_appian/components/LabelUtils.py

@@ -14,7 +14,7 @@ class LabelUtils:
     """
 
     @staticmethod
-    def _findByLabelText(wait: WebDriverWait, label: str):
+    def __findByLabelText(wait: WebDriverWait, label: str):
         """
         Finds a label element by its text.
 
@@ -26,7 +26,7 @@ class LabelUtils:
         """
         xpath = f".//*[normalize-space(.)='{label}']"
         try:
-            component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
+            component = wait.until(EC.visibility_of_element_located((By.XPATH, xpath)))
         except Exception as e:
             raise RuntimeError(f"Label with text '{label}' not found.") from e
 
@@ -42,5 +42,14 @@ class LabelUtils:
         Example:
             LabelUtils.clickByLabelText(wait, "Submit")
         """
-        component = LabelUtils._findByLabelText(wait, label)
+        component = LabelUtils.__findByLabelText(wait, label)
+        wait.until(EC.element_to_be_clickable(component))
         component.click()
+
+    @staticmethod
+    def checkLabelExists(wait: WebDriverWait, label: str):
+        try:
+            LabelUtils.__findByLabelText(wait, label)
+        except Exception:
+            return False
+        return True

{robo_appian-0.0.15 → robo_appian-0.0.17}/robo_appian/components/LinkUtils.py

@@ -22,8 +22,6 @@ class LinkUtils:
         xpath = f'.//a[normalize-space(.)="{label}"]'
         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

{robo_appian-0.0.15 → robo_appian-0.0.17}/robo_appian/components/SearchDropdownUtils.py

@@ -1,6 +1,7 @@
 from selenium.webdriver.support.ui import WebDriverWait
 from selenium.webdriver.support import expected_conditions as EC
 from selenium.webdriver.common.by import By
+from selenium.webdriver.remote.webelement import WebElement
 from robo_appian.components.InputUtils import InputUtils
 
 
@@ -14,13 +15,19 @@ class SearchDropdownUtils:
     """
 
     @staticmethod
-    def __selectSearchDropdownValueByDropdownOptionId(wait, component_id, dropdown_option_id, value):
+    def __selectSearchDropdownValueByDropdownId(wait: WebDriverWait, component_id: str, value: str):
+        if not component_id:
+            raise ValueError("Invalid component_id provided.")
+
         input_component_id = str(component_id) + "_searchInput"
         try:
+            wait.until(EC.presence_of_element_located((By.ID, input_component_id)))
             input_component = wait.until(EC.element_to_be_clickable((By.ID, input_component_id)))
         except Exception as e:
             raise RuntimeError(f"Failed to locate or click input component with ID '{input_component_id}': {e}")
-        InputUtils._setValueByComponent(input_component, value)
+        InputUtils._setValueByComponent(wait, input_component, value)
+
+        dropdown_option_id = str(component_id) + "_list"
 
         xpath = f'.//ul[@id="{dropdown_option_id}"]/li[./div[normalize-space(.)="{value}"]][1]'
         try:
@@ -33,26 +40,35 @@ class SearchDropdownUtils:
     def __selectSearchDropdownValueByPartialLabelText(wait: WebDriverWait, label: str, value: str):
         xpath = f'.//div[./div/span[contains(normalize-space(.), "{label}")]]/div/div/div/div[@role="combobox" and not(@aria-disabled="true")]'
         try:
-            component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
+            combobox = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
         except Exception as e:
             raise RuntimeError(f"Failed to locate or click dropdown component with XPath '{xpath}': {e}")
-        component_id = component.get_attribute("aria-labelledby")
-        dropdown_id = component.get_attribute("aria-controls")
-        component.click()
 
-        SearchDropdownUtils.__selectSearchDropdownValueByDropdownOptionId(wait, component_id, dropdown_id, value)
+        SearchDropdownUtils._selectSearchDropdownValueByComboboxComponent(wait, combobox, value)
 
     @staticmethod
     def __selectSearchDropdownValueByLabelText(wait: WebDriverWait, label: str, value: str):
-        xpath = f'.//div[./div/span[normalize-space(.)="{label}"]]/div/div/div/div[@role="combobox" and not(@aria-disabled="true")]'
+        xpath = (
+            f'.//div[./div/span[normalize-space(.)="{label}"]]/div/div/div/div[@role="combobox" and not(@aria-disabled="true")]'
+        )
         try:
-            component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
+            combobox = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
         except Exception as e:
             raise RuntimeError(f"Failed to locate or click dropdown component with XPath '{xpath}': {e}")
-        component_id = component.get_attribute("aria-labelledby")
-        dropdown_option_id = component.get_attribute("aria-controls")
-        component.click()
-        SearchDropdownUtils.__selectSearchDropdownValueByDropdownOptionId(wait, component_id, dropdown_option_id, value)
+        SearchDropdownUtils._selectSearchDropdownValueByComboboxComponent(wait, combobox, value)
+
+    @staticmethod
+    def _selectSearchDropdownValueByComboboxComponent(wait: WebDriverWait, combobox: WebElement, value: str):
+        id = combobox.get_attribute("id")
+        if id is not None:
+            component_id = id.rsplit("_value", 1)[0]
+        else:
+            raise RuntimeError("Combobox element does not have an 'id' attribute.")
+
+        wait.until(EC.element_to_be_clickable(combobox))
+        combobox.click()
+
+        SearchDropdownUtils.__selectSearchDropdownValueByDropdownId(wait, component_id, value)
 
     @staticmethod
     def selectSearchDropdownValueByLabelText(wait: WebDriverWait, dropdown_label: str, value: str):

{robo_appian-0.0.15 → robo_appian-0.0.17}/robo_appian/components/SearchInputUtils.py

@@ -27,15 +27,11 @@ class SearchInputUtils:
             attribute: str = "aria-controls"
             dropdown_list_id = search_input_component.get_attribute(attribute)
             if dropdown_list_id:
-                InputUtils._setValueByComponent(search_input_component, value)
+                InputUtils._setValueByComponent(wait, search_input_component, value)
                 xpath = f'.//ul[@id="{dropdown_list_id}" and @role="listbox" ]/li[@role="option" and @tabindex="-1" and ./div/div/div/div/div/div/p[normalize-space(.)="{value}"][1]]'
                 try:
                     drop_down_item = wait.until(EC.presence_of_element_located((By.XPATH, xpath)))
                     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}'."

robo_appian-0.0.17/robo_appian/components/TabUtils.py

@@ -0,0 +1,55 @@
+from selenium.webdriver.common.by import By
+from selenium.webdriver.support import expected_conditions as EC
+from robo_appian.utils.ComponentUtils import ComponentUtils
+
+
+class TabUtils:
+    """
+    Utility class for handling tab components in a web application using Selenium.
+    Example usage:
+        from selenium import webdriver
+        from selenium.webdriver.support.ui import WebDriverWait
+        from robo_appian.components.TabUtils import TabUtils
+
+        driver = webdriver.Chrome()
+        wait = WebDriverWait(driver, 10)
+
+        # Find a selected tab by its label
+        selected_tab = TabUtils.findSelectedTabByLabelText(wait, "Tab Label")
+
+        # Select an inactive tab by its label
+        TabUtils.selectTabByLabelText(wait, "Inactive Tab Label")
+
+        driver.quit()
+    """
+
+    @staticmethod
+    def findTabByLabelText(wait, label):
+        xpath = f'//div/div[@role="link" ]/div/div/div/div/div/p[normalize-space(.)="{label}"]'
+        try:
+            component = wait.until(EC.visibility_of_element_located((By.XPATH, xpath)))
+        except Exception:
+            raise Exception(f"Tab with label '{label}' not found.")
+        return component
+
+    @staticmethod
+    def selectTabByLabelText(wait, label):
+        component = TabUtils.findTabByLabelText(wait, label)
+        try:
+            component = wait.until(EC.element_to_be_clickable(component))
+        except Exception:
+            raise Exception(f"Tab with label '{label}' is not clickable.")
+        component.click()
+
+    @staticmethod
+    def checkTabSelectedByLabelText(wait, label):
+        component = TabUtils.findTabByLabelText(wait, label)
+
+        select_text = "Selected Tab."
+        xpath = f'./span[normalize-space(.)="{select_text}"]'
+        try:
+            component = ComponentUtils.findChildComponentByXpath(wait, component, xpath)
+        except Exception:
+            return False
+
+        return True

{robo_appian-0.0.15 → robo_appian-0.0.17}/robo_appian/components/TableUtils.py

@@ -1,6 +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 robo_appian.utils.ComponentUtils import ComponentUtils
 
 
 class TableUtils:
@@ -34,11 +35,14 @@ class TableUtils:
 
         xpath = f'.//table[./thead/tr/th[@abbr="{columnName}"]]'
         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}")
+            component = wait.until(EC.visibility_of_element_located((By.XPATH, xpath)))
+        except Exception as e:
+            raise Exception(f"Could not find table with column name '{columnName}': {e}")
+
+        try:
+            component = wait.until(EC.element_to_be_clickable(component))
         except Exception as e:
-            raise RuntimeError(f"Could not find table with column name '{columnName}': {e}")
+            raise Exception(f"Table found by column name '{columnName}' is not clickable: {e}")
         return component
 
     @staticmethod
@@ -56,7 +60,7 @@ class TableUtils:
         try:
             rows = tableObject.find_elements(By.XPATH, xpath)
         except Exception as e:
-            raise RuntimeError(f"Could not count rows in table: {e}")
+            raise Exception(f"Could not count rows in table: {e}")
         return len(rows)
 
     @staticmethod
@@ -92,6 +96,12 @@ class TableUtils:
         data = selected_word.split("_")
         return int(data[1])
 
+    @staticmethod
+    def __findRowByColumnNameAndRowNumber(wait, rowNumber, columnName):
+        xpath = f'.//table[./thead/tr/th/div[normalize-space(.)="{columnName}"] ]/tbody/tr[@data-dnd-name="row {rowNumber + 1}"]'
+        row = wait.until(EC.presence_of_element_located((By.XPATH, xpath)))
+        return row
+
     @staticmethod
     def findComponentFromTableCell(wait, rowNumber, columnName):
         """
@@ -107,16 +117,31 @@ class TableUtils:
 
         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}]/*'
         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("./*"))
+            raise Exception(f"Could not find component in cell at row {rowNumber}, column '{columnName}': {e}")
+        return component
+
+    @staticmethod
+    def selectRowFromTableByColumnNameAndRowNumber(wait, rowNumber, columnName):
+        row = TableUtils.__findRowByColumnNameAndRowNumber(wait, rowNumber, columnName)
+        row = wait.until(EC.element_to_be_clickable(row))
+        row.click()
+
+    @staticmethod
+    def findComponentByColumnNameAndRowNumber(wait, rowNumber, columnName):
+        xpath = f'.//table/thead/tr/th[./div[normalize-space(.)="{columnName}"]]'
+        column = wait.until(EC.visibility_of_element_located((By.XPATH, xpath)))
+        id = column.get_attribute("id")
+        parts = id.rsplit("_", 1)
+        columnNumber = int(parts[-1])
+
+        tableRow = TableUtils.__findRowByColumnNameAndRowNumber(wait, rowNumber, columnName)
+        xpath = f"./td[{columnNumber + 1}]/*"
+        component = ComponentUtils.findChildComponentByXpath(wait, tableRow, xpath)
+        component = wait.until(EC.element_to_be_clickable(component))
         return component

{robo_appian-0.0.15 → robo_appian-0.0.17}/robo_appian/controllers/ComponentDriver.py

@@ -56,7 +56,7 @@ class ComponentDriver:
             case "Label":
                 match action:
                     case "Find":
-                        LabelUtils._findByLabelText(wait, label)
+                        LabelUtils.checkLabelExists(wait, label)
                     case _:
                         raise ValueError(f"Unsupported action for {type}: {action}")
             case "Link":
@@ -86,7 +86,7 @@ class ComponentDriver:
             case "Tab":
                 match action:
                     case "Find":
-                        TabUtils.findSelectedTabByLabelText(wait, label)
+                        TabUtils.selectTabByLabelText(wait, label)
                     case _:
                         raise ValueError(f"Unsupported action for {type}: {action}")
             case _:

{robo_appian-0.0.15 → robo_appian-0.0.17}/robo_appian/utils/ComponentUtils.py

@@ -34,7 +34,7 @@ class ComponentUtils:
         return yesterday_formatted
 
     @staticmethod
-    def findChildComponent(wait: WebDriverWait, component: WebElement, xpath: str):
+    def findChildComponentByXpath(wait: WebDriverWait, component: WebElement, xpath: str):
         """Finds a child component using the given XPath within a parent component.
 
         :param wait: WebDriverWait instance to wait for elements
@@ -49,9 +49,13 @@ class ComponentUtils:
         wait = WebDriverWait(driver, 10)
         parent_component = driver.find_element(By.ID, "parent")
         xpath = ".//button[@class='child']"
-        child_component = ComponentUtils.findChildComponent(wait, parent_component, xpath)
+        child_component = ComponentUtils.findChildComponentByXpath(wait, parent_component, xpath)
         """
-        return component.find_element(By.XPATH, xpath)
+        try:
+            component = wait.until(lambda comp: component.find_element(By.XPATH, xpath))
+        except Exception:
+            raise Exception(f"Child component with XPath '{xpath}' not found within the given parent component.")
+        return component
 
     @staticmethod
     def findComponentUsingXpathAndClick(wait: WebDriverWait, xpath: str):

robo_appian-0.0.15/robo_appian/components/TabUtils.py

@@ -1,63 +0,0 @@
-from selenium.webdriver.common.by import By
-from selenium.webdriver.support import expected_conditions as EC
-
-
-class TabUtils:
-    """
-    Utility class for handling tab components in a web application using Selenium.
-    Example usage:
-        from selenium import webdriver
-        from selenium.webdriver.support.ui import WebDriverWait
-        from robo_appian.components.TabUtils import TabUtils
-
-        driver = webdriver.Chrome()
-        wait = WebDriverWait(driver, 10)
-
-        # Find a selected tab by its label
-        selected_tab = TabUtils.findSelectedTabByLabelText(wait, "Tab Label")
-
-        # Select an inactive tab by its label
-        TabUtils.selectInactiveTabByLabelText(wait, "Inactive Tab Label")
-
-        driver.quit()
-    """
-
-    @staticmethod
-    def findSelectedTabByLabelText(wait, label):
-        """
-        Finds the currently selected tab by its label.
-
-        :param wait: Selenium WebDriverWait instance.
-        :param label: The label of the tab to find.
-        :return: WebElement representing the selected tab.
-        Example:
-            component = TabUtils.findSelectedTabByLabelText(wait, "Tab Label")
-        """
-        xpath = f".//div[./div[./div/div/div/div/div/p/strong[normalize-space(.)='{label}']]/span[text()='Selected Tab.']]/div[@role='link']"
-        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 selectInactiveTabByLabelText(wait, label):
-        """
-        Selects an inactive tab by its label.
-
-        :param wait: Selenium WebDriverWait instance.
-        :param label: The label of the tab to select.
-        :return: None
-        Example:
-            TabUtils.selectInactiveTabByLabelText(wait, "Tab Label")
-        """
-        xpath = f".//div[@role='link']/div/div/div/div/div[./p/span[text()='{label}']]"
-        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()