robo_appian 0.0.4__py3-none-any.whl → 0.0.5__py3-none-any.whl

robo_appian/__init__.py

@@ -1,12 +1,12 @@
-from robo_appian.utils.components.ButtonUtils import ButtonUtils
-from robo_appian.utils.components.ComponentUtils import ComponentUtils
-from robo_appian.utils.components.DateUtils import DateUtils
-from robo_appian.utils.components.DropdownUtils import DropdownUtils
-from robo_appian.utils.components.InputUtils import InputUtils
-from robo_appian.utils.components.LabelUtils import LabelUtils
-from robo_appian.utils.components.LinkUtils import LinkUtils
-from robo_appian.utils.components.TableUtils import TableUtils
-from robo_appian.utils.components.TabUtils import TabUtils
+from robo_appian.components.ButtonUtils import ButtonUtils
+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
+from robo_appian.components.LabelUtils import LabelUtils
+from robo_appian.components.LinkUtils import LinkUtils
+from robo_appian.components.TableUtils import TableUtils
+from robo_appian.components.TabUtils import TabUtils
 
 __version__ = "0.0.2"
 

{robo_appian_source_backup/utils → robo_appian}/components/ButtonUtils.py

@@ -10,7 +10,7 @@ class ButtonUtils:
         Usage Example:
 
         from selenium.webdriver.support.ui import WebDriverWait
-        from robo_appian.utils.components.ButtonUtils import ButtonUtils
+        from robo_appian.components.ButtonUtils import ButtonUtils
 
         wait = WebDriverWait(driver, 10)
         ButtonUtils.click(wait, "Login")

{robo_appian_source_backup/utils → robo_appian}/components/DateUtils.py

@@ -4,7 +4,7 @@ from selenium.webdriver.support.ui import WebDriverWait
 from selenium.webdriver.remote.webdriver import WebDriver
 from selenium.webdriver.remote.webelement import WebElement
 
-from robo_appian.utils.components.InputUtils import InputUtils
+from robo_appian.components.InputUtils import InputUtils
 
 
 class DateUtils:
@@ -14,7 +14,7 @@ class DateUtils:
         Usage Example:
 
         # Set a date value
-        from robo_appian.utils.components.DateUtils import DateUtils
+        from robo_appian.components.DateUtils import DateUtils
         DateUtils.setDateValue(wait, "Start Date", "01/01/2024")
 
     """
@@ -75,7 +75,7 @@ class DateUtils:
         # component = wait.until(EC.element_to_be_clickable((By.XPATH, f".//div/label[text()='{label}']/following-sibling::input")))
 
         component = DateUtils.findComponent(wait, label)
-        InputUtils.setValueUsingComponent(component, value)
+        InputUtils._setComponentValue(component, value)
         return component
 
     @staticmethod

robo_appian/components/DropdownUtils.py

@@ -0,0 +1,136 @@
+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
+
+
+class DropdownUtils:
+    """
+    Utility class for interacting with dropdown components in Appian UI.
+
+        Usage Example:
+
+        # Select a value from a dropdown
+        from robo_appian.components.DropdownUtils import DropdownUtils
+        DropdownUtils.selectDropdownValueByLabelText(wait, "Status", "Approved")
+
+        # Select a value from a search dropdown
+        from robo_appian.components.DropdownUtils import DropdownUtils
+        DropdownUtils.selectSearchDropdownValueByLabelText(wait, "Category", "Finance")
+    """
+
+    @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)))
+
+            # Find all matching elements
+            driver = wait._driver
+            components = driver.find_elements(By.XPATH, xpath)
+
+            # Filter for clickable and displayed components
+            valid_components = []
+            for component in components:
+                try:
+                    if component.is_displayed() and component.is_enabled():
+                        valid_components.append(component)
+                except Exception:
+                    continue
+
+            if not valid_components:
+                raise Exception(
+                    f'No valid dropdown components with xpath "{xpath}" found.'
+                )
+
+            # Return single component if only one found, list if multiple
+            return valid_components
+
+        except Exception as e:
+            raise Exception(
+                f'Dropdown component with xpath "{xpath}" not found: {str(e)}'
+            )
+
+    @staticmethod
+    def selectDropdownValueByComponent(wait, combobox, value):
+        dropdown_id = combobox.get_attribute("aria-controls")  # type: ignore[reportUnknownMemberType]
+        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)))
+        component.click()
+
+    @staticmethod
+    def __selectDropdownValueByXpath(wait, xpath, value):
+        components = DropdownUtils.__findDropdownComponentsByXpath(wait, xpath)
+        for combobox in components:
+            if combobox.is_displayed() and combobox.is_enabled():
+                DropdownUtils.selectDropdownValueByComponent(wait, combobox, value)
+
+    @staticmethod
+    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)
+
+    @staticmethod
+    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:
+            if component.is_displayed() and component.is_enabled():
+                component_id = component.get_attribute("aria-labelledby")  # type: ignore[reportUnknownMemberType]
+                dropdown_id = component.get_attribute("aria-controls")  # type: ignore[reportUnknownMemberType]
+                component.click()
+
+                input_component_id = str(component_id) + "_searchInput"
+                input_component = wait.until(
+                    EC.element_to_be_clickable((By.ID, input_component_id))
+                )
+                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)))
+                component.click()
+
+    @staticmethod
+    def selectSearchDropdownValueByLabelText(
+        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.__selectSearchDropdownValueByXpath(wait, xpath, value)
+
+    @staticmethod
+    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)
+
+    @staticmethod
+    def selectValueByDropdownWrapperComponent(
+        wait: WebDriverWait, component: WebElement, value: str
+    ):
+        xpath = f'./div/div[@role="combobox" and @tabindex="0"]'
+        combobox = component.find_element(By.XPATH, xpath)
+        DropdownUtils.selectDropdownValueByComponent(wait, combobox, value)
+        return combobox

robo_appian/components/InputUtils.py

@@ -0,0 +1,107 @@
+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:
+    """
+    Utility class for interacting with input components in Appian UI.
+
+        Usage Example:
+
+        # Set a value in an input field
+        from robo_appian.components.InputUtils import InputUtils
+        InputUtils.setValueByLabelText(wait, "Username", "test_user")
+
+    """
+
+    @staticmethod
+    def setValueAndSubmitUsingComponent(component: WebElement, value: str):
+        """
+        Sets a value in an input component and submits it using the provided component element.
+
+        Parameters:
+            component: The Selenium WebElement for the input component.
+            value: The value to set in the input field.
+
+        Returns:
+            The Selenium WebElement for the input component after setting the value and submitting.
+
+        Example:
+            InputUtils.setValueAndSubmitUsingComponent(component, "test_user")
+
+        """
+        # This method assumes that the component is already found and passed as an argument.
+
+        if not component.is_displayed():
+            raise Exception(
+                f"Component with label '{component.text}' is not displayed."
+            )
+
+        component = InputUtils._setComponentValue(component, value)
+        component.send_keys(Keys.ENTER)
+        return component
+
+    @staticmethod
+    def __findInputComponentsByLabelPath(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)
+        return input_components
+
+    @staticmethod
+    def __findInputComponentsByPartialLabel(wait: WebDriverWait, label: str):
+        xpath = f'.//div/label[contains(normalize-space(text()), "{label}")]'
+        components = InputUtils.__findInputComponentsByLabelPath(wait, xpath)
+        return components
+
+    @staticmethod
+    def __findInputComponentsByLabel(wait: WebDriverWait, label: str):
+        xpath = f'.//div/label[normalize-space(text())="{label}"]'
+        components = InputUtils.__findInputComponentsByLabelPath(wait, xpath)
+        return components
+
+    @staticmethod
+    def _setComponentValue(component: WebElement, value: str):
+        component.clear()
+        component.send_keys(value)
+        return component
+
+    @staticmethod
+    def __setValueByComponents(wait: WebDriverWait, input_components, value: str):
+        """
+        Sets a value in an input component identified by its label text.
+        Parameters:
+            wait: Selenium WebDriverWait instance.
+            label: The visible text label of the input component.
+            value: The value to set in the input field.
+        Returns:
+            None
+        Example:
+            InputUtils.setValueByLabelText(wait, "Username", "test_user")
+        """
+
+        for component in input_components:
+            InputUtils._setComponentValue(component, value)
+
+    @staticmethod
+    def setValueByPartialLabelText(wait: WebDriverWait, label: str, value: str):
+        input_components = InputUtils.__findInputComponentsByPartialLabel(wait, label)
+        InputUtils.__setValueByComponents(wait, input_components, value)
+
+    @staticmethod
+    def setValueByLabelText(wait: WebDriverWait, label: str, value: str):
+        input_components = InputUtils.__findInputComponentsByLabel(wait, label)
+        InputUtils.__setValueByComponents(wait, input_components, value)

{robo_appian_source_backup/utils → robo_appian}/components/LabelUtils.py

@@ -11,7 +11,7 @@ class LabelUtils:
         Usage Example:
 
         # Find a label component
-        from robo_appian.utils.components.LabelUtils import LabelUtils
+        from robo_appian.components.LabelUtils import LabelUtils
         label_component = LabelUtils.find(wait, "Username")
 
     """

{robo_appian_source_backup/utils → robo_appian}/components/LinkUtils.py

@@ -12,7 +12,7 @@ class LinkUtils:
         Usage Example:
 
         # Click a link with a specific label
-        from robo_appian.utils.components.LinkUtils import LinkUtils
+        from robo_appian.components.LinkUtils import LinkUtils
         LinkUtils.click(wait, "Learn More")
 
     """

robo_appian/components/SearchInputUtils.py

@@ -0,0 +1,64 @@
+from selenium.webdriver.support.ui import WebDriverWait
+from selenium.webdriver.common.by import By
+from selenium.webdriver.support import expected_conditions as EC
+from robo_appian.components.InputUtils import InputUtils
+from robo_appian.utils.ComponentUtils import ComponentUtils
+
+
+class SearchInputUtils:
+
+    @staticmethod
+    def __findSearchInputComponentsByLabelPathAndSelectValue(
+        wait: WebDriverWait, xpath: str, value: str
+    ):
+        search_input_components = ComponentUtils.findComponentsByXPath(wait, xpath)
+        input_components = []
+        for search_input_component in search_input_components:
+            attribute: str = "aria-controls"
+            dropdown_list_id = search_input_component.get_attribute(attribute)
+            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))
+                )
+                drop_down_item.click()
+            else:
+                raise ValueError(
+                    f"Search input component with label '{search_input_component.text}' does not have 'aria-controls' attribute."
+                )
+
+        return input_components
+
+    @staticmethod
+    def __selectSearchInputComponentsByPartialLabelText(
+        wait: WebDriverWait, label: str, value: str
+    ):
+        xpath = f".//div[./div/span[contains(normalize-space(text())='{label}']]/div/div/div/input[@role='combobox']"
+        SearchInputUtils.__findSearchInputComponentsByLabelPathAndSelectValue(
+            wait, xpath, value
+        )
+
+    @staticmethod
+    def __selectSearchInputComponentsByLabelText(
+        wait: WebDriverWait, label: str, value: str
+    ):
+        xpath = (
+            f".//div[./div/span[text()='{label}']]/div/div/div/input[@role='combobox']"
+        )
+        SearchInputUtils.__findSearchInputComponentsByLabelPathAndSelectValue(
+            wait, xpath, value
+        )
+
+    @staticmethod
+    def selectSearchDropdownByLabelText(wait: WebDriverWait, label: str, value: str):
+
+        SearchInputUtils.__selectSearchInputComponentsByLabelText(wait, label, value)
+
+    @staticmethod
+    def selectSearchDropdownByPartialLabelText(
+        wait: WebDriverWait, label: str, value: str
+    ):
+        SearchInputUtils.__selectSearchInputComponentsByPartialLabelText(
+            wait, label, value
+        )

{robo_appian_source_backup/utils → robo_appian}/components/TabUtils.py

@@ -9,11 +9,11 @@ class TabUtils:
     Usage Example:
 
         # Select a tab by its label
-        from robo_appian.utils.components.TabUtils import TabUtils
+        from robo_appian.components.TabUtils import TabUtils
         TabUtils.select_tab(wait, "Settings")
 
         # Find the currently selected tab by its label
-        from robo_appian.utils.components.TabUtils import TabUtils
+        from robo_appian.components.TabUtils import TabUtils
         selected_tab = TabUtils.find_selected_tab(wait, "Settings")
     """
 

{robo_appian_source_backup/utils → robo_appian}/components/TableUtils.py

@@ -11,7 +11,7 @@ class TableUtils:
         Usage Example:
 
         # Find a table using a column name
-        from robo_appian.utils.components.TableUtils import TableUtils
+        from robo_appian.components.TableUtils import TableUtils
         table = TableUtils.findTableUsingColumnName(wait, "Status")
 
     """
@@ -140,6 +140,10 @@ class TableUtils:
 
         xpath = f'./thead/tr/th[@scope="col" and @abbr="{columnName}"]'
         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.")
+        
         class_string = component.get_attribute("class")
         partial_string = "headCell_"
         words = class_string.split()
@@ -149,6 +153,9 @@ class TableUtils:
             if partial_string in word:
                 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}'.")
+        
         data = selected_word.split("_")
         return int(data[1])
 

{robo_appian_source_backup/utils → robo_appian}/controllers/ComponentDriver.py

@@ -1,10 +1,13 @@
-from robo_appian.utils.components.ComponentUtils import ComponentUtils
-from robo_appian.utils.components.DateUtils import DateUtils
-from robo_appian.utils.components.DropdownUtils import DropdownUtils
-from robo_appian.utils.components.InputUtils import InputUtils
-from robo_appian.utils.components.LabelUtils import LabelUtils
-from robo_appian.utils.components.LinkUtils import LinkUtils
-from robo_appian.utils.components.TabUtils import TabUtils
+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
+from robo_appian.components.LabelUtils import LabelUtils
+from robo_appian.components.LinkUtils import LinkUtils
+from robo_appian.components.TabUtils import TabUtils
+from robo_appian.components.SearchInputUtils import SearchInputUtils
 
 
 class ComponentDriver:
@@ -17,7 +20,7 @@ class ComponentDriver:
     """
 
     @staticmethod
-    def execute(wait : WebDriverWait, type, action, label, value):
+    def execute(wait: WebDriverWait, type, action, label, value):
         """
         Executes an action on a specified component type.
         Parameters:
@@ -42,13 +45,15 @@ class ComponentDriver:
             case "Input Text":
                 match action:
                     case "Set Value":
-                        InputUtils.setInputValue(wait, label, value)
+                        InputUtils.setValueByLabelText(wait, label, value)
                     case _:
                         raise ValueError(f"Unsupported action for {type}: {action}")
             case "Search Input Text":
                 match action:
                     case "Select":
-                        InputUtils.setSearchInputValue(wait, label, value)
+                        SearchInputUtils.selectSearchDropdownByLabelText(
+                            wait, label, value
+                        )
                     case _:
                         raise ValueError(f"Unsupported action for {type}: {action}")
             case "Label":
@@ -66,19 +71,19 @@ class ComponentDriver:
             case "Drop Down":
                 match action:
                     case "Select":
-                        DropdownUtils.selectDropdownValue(wait, label, value)
+                        DropdownUtils.selectDropdownValueByLabelText(wait, label, value)
                     case _:
                         raise ValueError(f"Unsupported action for {type}: {action}")
             case "Search Drop Down":
                 match action:
                     case "Select":
-                        DropdownUtils.selectSearchDropdownValue(wait, label, value)
+                        DropdownUtils.selectSearchDropdownValueByLabelText(wait, label, value)
                     case _:
                         raise ValueError(f"Unsupported action for {type}: {action}")
             case "Button":
                 match action:
                     case "Click":
-                        ComponentUtils.click_button(wait, label)
+                        ButtonUtils.click(wait, label)
                     case _:
                         raise ValueError(f"Unsupported action for {type}: {action}")
             case "Tab":

{robo_appian_source_backup/utils/components → robo_appian/utils}/ComponentUtils.py

@@ -37,97 +37,6 @@ class ComponentUtils:
         yesterday_formatted = yesterday.strftime("%m/%d/%Y")
         return yesterday_formatted
 
-    # @staticmethod
-    # def find_dropdown_id(wait, dropdown_label):
-    #     label_class_name = "FieldLayout---field_label"
-    #     xpath = f'.//div/span[normalize-space(text())="{dropdown_label}" and @class="{label_class_name}"]'
-    #     span_element = wait.until(EC.presence_of_element_located((By.XPATH, xpath)))
-    #     span_element_id = span_element.get_attribute('id')
-    #     return span_element_id
-
-    # @staticmethod
-    # def find_input_id(wait, label_text):
-    #     label_class_name = "FieldLayout---field_label"
-    #     xpath = f'.//div/div/label[@class="{label_class_name}" and contains(normalize-space(text()), "{label_text}")]'
-    #     label_element = wait.until(EC.presence_of_element_located((By.XPATH, xpath)))
-    #     input_element_id = label_element.get_attribute('for')
-    #     return input_element_id
-
-    # @staticmethod
-    # def set_input_value(wait, label_text, value):
-    #     input_element_id = ComponentUtils.find_input_id(wait, label_text)
-    #     input_element = ComponentUtils.set_input_value_using_id(wait, input_element_id, value)
-    #     return input_element
-
-    # @staticmethod
-    # def set_input_value_using_id(wait, input_element_id, value):
-    #     input_element = wait.until(EC.presence_of_element_located((By.ID, input_element_id)))
-    #     input_element = wait.until(EC.element_to_be_clickable((By.ID, input_element_id)))
-    #     input_element.clear()
-    #     input_element.send_keys(value)
-    #     input_element.send_keys(Keys.RETURN)
-    #     return input_element
-
-    # @staticmethod
-    # def select_search_dropdown_value(wait, label, value):
-    #     span_element_id = ComponentUtils.find_dropdown_id(wait, label)
-    #     xpath = f'.//div[@id="{span_element_id}_value"]'
-    #     combobox = wait.until(EC.presence_of_element_located((By.XPATH, xpath)))
-    #     disabled = combobox.get_attribute("aria-disabled")
-    #     if disabled == "true":
-    #         return
-    #     aria_controls = combobox.get_attribute("aria-controls")
-    #     combobox = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
-    #     combobox.click()
-
-    #     input_element_id = span_element_id + "_searchInput"
-    #     ComponentUtils.set_input_value_using_id(wait, input_element_id, value)
-
-    #     xpath = f'.//ul[@id="{aria_controls}"]/li[./div[normalize-space(text())="{value}"]]'
-    #     component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
-    #     component.click()
-
-    # @staticmethod
-    # def selectDropdownValue(wait, combobox, value):
-
-    #     aria_controls = combobox.get_attribute("aria-controls")
-    #     combobox.click()
-
-    #     xpath = f'.//div/ul[@id="{aria_controls}"]/li[./div[normalize-space(text())="{value}"]]'
-    #     component = wait.until(EC.presence_of_element_located((By.XPATH, xpath)))
-    #     component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
-    #     component.click()
-
-    # @staticmethod
-    # def select_dropdown_value(wait, label, value):
-    #     span_element_id = ComponentUtils.find_dropdown_id(wait, label)
-
-    #     xpath = f'.//div[@id="{span_element_id}_value"]'
-    #     combobox = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
-    #     disabled = combobox.get_attribute("aria-disabled")
-    #     if disabled == "true":
-    #         return
-
-    #     combobox = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
-    #     ComponentUtils.selectDropdownValue(wait, combobox, value)
-
-    # @staticmethod
-    # def findButton(wait, button_text):
-    #     xpath = f'.//button[.//span/span[contains(normalize-space(text()), "{button_text}")]]'
-    #     component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
-    #     return component
-
-    # @staticmethod
-    # def click_button(wait, button_text):
-    #     component = ComponentUtils.findButton(wait, button_text)
-    #     component.click()
-
-    # @staticmethod
-    # def select_tab(wait, tab_label_text):
-    #     xpath = f'.//div[@role="presentation"]/div/div/p[./span[normalize-space(text())="{tab_label_text}"]]'
-    #     component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
-    #     component.click()
-
     @staticmethod
     def findSuccessMessage(wait: WebDriverWait, message: str):
         """
@@ -261,15 +170,6 @@ class ComponentUtils:
 
         return length
 
-    # @staticmethod
-    # def findComponent(wait, label):
-    #     xpath = f".//div/label[text()='{label}']"
-    #     component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
-    #     component_id = component.get_attribute("for")
-
-    #     component = wait.until(EC.element_to_be_clickable((By.ID, component_id)))
-    #     return component
-
     @staticmethod
     def tab(driver: WebDriver):
         """
@@ -287,3 +187,40 @@ class ComponentUtils:
 
         actions = ActionChains(driver)
         actions.send_keys(Keys.TAB).perform()
+
+    @staticmethod
+    def findComponentsByXPath(wait: WebDriverWait, xpath: str):
+        """
+        Finds multiple components that match the same XPath.
+
+        Parameters:
+            wait: Selenium WebDriverWait instance.
+            xpath: The XPath expression to find components.
+
+        Returns:
+            List of WebElement objects that match the XPath.
+
+        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)))
+
+        # Find all matching elements
+        driver = wait._driver
+        components = driver.find_elements(By.XPATH, xpath)
+
+        # Filter for clickable and displayed components
+        valid_components = []
+        for component in components:
+            try:
+                if component.is_displayed() and component.is_enabled():
+                    valid_components.append(component)
+            except Exception:
+                continue
+
+        if len(valid_components) > 0:
+            return valid_components
+
+        raise Exception(f"No valid components found for XPath: {xpath}")

robo_appian/utils/__init__.py

@@ -1 +0,0 @@
-# Bytecode package

{robo_appian-0.0.4.dist-info → robo_appian-0.0.5.dist-info}/METADATA

@@ -1,43 +1,20 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.3
 Name: robo_appian
-Version: 0.0.4
-Summary: Selenium-based automation utilities for Appian applications
-Home-page: https://github.com/yourusername/robo_appian
-Author: Your Name
-Author-email: your.email@example.com
-Project-URL: Bug Reports, https://github.com/yourusername/robo_appian/issues
-Project-URL: Source, https://github.com/yourusername/robo_appian
-Project-URL: Documentation, https://robo-appian.readthedocs.io/
-Keywords: selenium,automation,testing,appian,ui
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: Topic :: Software Development :: Testing
-Classifier: Topic :: Software Development :: Quality Assurance
-Classifier: License :: OSI Approved :: MIT License
+Version: 0.0.5
+Summary: Automate your Appian code testing with Python. Boost quality, save time.
+Author: Dinil Mithra
+Author-email: dinilmithra@mailme@gmail.com
+Requires-Python: >=3.12,<4.0
+Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
-Requires-Python: >=3.8
+Classifier: Programming Language :: Python :: 3.13
+Requires-Dist: numpy
+Requires-Dist: requests (>=2.25.1,<3.0.0)
+Requires-Dist: selenium (>=4.34.0)
+Project-URL: Homepage, https://github.com/dinilmithra/robo_appian
+Project-URL: Repository, https://github.com/dinilmithra/robo_appian.git
 Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: selenium>=4.34.0
-Requires-Dist: requests>=2.25.0
-Requires-Dist: numpy>=1.21.0
-Dynamic: author
-Dynamic: author-email
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: home-page
-Dynamic: keywords
-Dynamic: license-file
-Dynamic: project-url
-Dynamic: requires-dist
-Dynamic: requires-python
-Dynamic: summary
 
 # Robo Appian
 

robo_appian-0.0.5.dist-info/RECORD

@@ -0,0 +1,21 @@
+robo_appian/__init__.py,sha256=6u9n2W7P1IKSSr5IPGsg7LhVR1o1uYv424mXDjJLgb0,720
+robo_appian/components/ButtonUtils.py,sha256=1bBWsnr51idniVs2rHqOpPNPR6g-AGYjCwx2YWyYy4o,2198
+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=BFvNwFoNy3enAspKr0uTxfJrdVye3FuGiZz3QuNf-e8,4125
+robo_appian/components/LabelUtils.py,sha256=qajWEHEpFcBf5sSrkLA6Q0qX_FiHcZjOZeY_P8qXt1o,1224
+robo_appian/components/LinkUtils.py,sha256=0wE2Pr-6X5g3oLrKNSSo0Zo-fcZo5WQXdQTw4Z2dvI8,1414
+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.5.dist-info/LICENSE,sha256=g-xR4dRa9_4iFkMoJmED-wE-J5hoxbk3105Knhfpjm0,1068
+robo_appian-0.0.5.dist-info/METADATA,sha256=xbaYUrn9O378n6Hr2u_LjslomPmdu1tDk322mRo-mJk,4104
+robo_appian-0.0.5.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
+robo_appian-0.0.5.dist-info/RECORD,,

{robo_appian-0.0.4.dist-info → robo_appian-0.0.5.dist-info}/WHEEL

@@ -1,5 +1,4 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.9.0)
+Generator: poetry-core 2.1.3
 Root-Is-Purelib: true
 Tag: py3-none-any
-

robo_appian/utils/components/__init__.py

@@ -1 +0,0 @@
-# Bytecode package

robo_appian/utils/controllers/__init__.py

@@ -1 +0,0 @@
-# Bytecode package

robo_appian/utils/exceptions/__init__.py

@@ -1 +0,0 @@
-# Bytecode package

robo_appian-0.0.4.dist-info/RECORD

@@ -1,37 +0,0 @@
-robo_appian/__init__.py,sha256=AiMpl0fcPrlwMyUH0ZRzVYAlv4WY6e225XQCMuJa0Zk,779
-robo_appian/utils/__init__.py,sha256=GqOJu-ZZRLzA9Nby6uXo82hxkSOPW_ZxBtMCn0xgoB8,19
-robo_appian/utils/components/ButtonUtils.pyc,sha256=J90p3zU4Q7vgklQZvLk7-4v-kosISmnyGYcFeoTiOdg,1919
-robo_appian/utils/components/ComponentUtils.pyc,sha256=Uw3oEqCJ_8rgZpfs0hBqYJkwiaCcdJxpWtbdVSAwUiw,4579
-robo_appian/utils/components/DateUtils.pyc,sha256=O8q1YI8elSEJJaa_rw7msop9GVSTBRF7BGFp_pD64O8,2852
-robo_appian/utils/components/DropdownUtils.pyc,sha256=nWNngNDP52jPNw27EkbN9GSAIf_4YeCcfNcprCr4t-A,4334
-robo_appian/utils/components/InputUtils.pyc,sha256=tj7K8cbzwKxktSEW7-yRcwaPVlIdQGNToJIcdfigHmg,4530
-robo_appian/utils/components/LabelUtils.pyc,sha256=EBWhbr1xHRttUjG2o3YGmDMpc36g0RcHCk3ZbyAjvks,1086
-robo_appian/utils/components/LinkUtils.pyc,sha256=ojrwAHobkXBLFRTOUC5KnDhNPjSFymcfXd_Ug33ICJM,1133
-robo_appian/utils/components/TabUtils.pyc,sha256=cWs1KGtMkb6pkfXDsVvp6oHXVMRiKwTEoqWMF99lohI,1494
-robo_appian/utils/components/TableUtils.pyc,sha256=2nyaYzsOcYuspRf-Hg8-8ZB0yJ8qlN1dCLqkB2ulpmY,4532
-robo_appian/utils/components/__init__.py,sha256=GqOJu-ZZRLzA9Nby6uXo82hxkSOPW_ZxBtMCn0xgoB8,19
-robo_appian/utils/controllers/ComponentDriver.pyc,sha256=VdV-KUlG6REm6OSJ4uDlMEcE6opRbgDIJexI7jCD-ks,2983
-robo_appian/utils/controllers/__init__.py,sha256=GqOJu-ZZRLzA9Nby6uXo82hxkSOPW_ZxBtMCn0xgoB8,19
-robo_appian/utils/exceptions/MyCustomError.pyc,sha256=duaUZ7I3lL9L5-LOKBUkLyRuGAUIVjoX5oWsDzCodlM,672
-robo_appian/utils/exceptions/__init__.py,sha256=GqOJu-ZZRLzA9Nby6uXo82hxkSOPW_ZxBtMCn0xgoB8,19
-robo_appian-0.0.4.dist-info/licenses/LICENSE,sha256=g-xR4dRa9_4iFkMoJmED-wE-J5hoxbk3105Knhfpjm0,1068
-robo_appian_source_backup/__init__.py,sha256=AiMpl0fcPrlwMyUH0ZRzVYAlv4WY6e225XQCMuJa0Zk,779
-robo_appian_source_backup/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-robo_appian_source_backup/utils/components/ButtonUtils.py,sha256=Go_F2yJbGHho06notteHU3kXAdpA9EvXw1zm4zp260s,2204
-robo_appian_source_backup/utils/components/ComponentUtils.py,sha256=-6CSRa2mBCPt9BrKXXO1cP6IsZ6Tle1X3rlfoJZlpjc,11779
-robo_appian_source_backup/utils/components/DateUtils.py,sha256=r-4XnuGwA_cSHjWQub7-qoQQ29eBsG14uumXZkXpcDI,4615
-robo_appian_source_backup/utils/components/DropdownUtils.py,sha256=rIqkkJYYJnWsOOppMa-tHeQx9WGQYeNpBSJxnulFUH8,6369
-robo_appian_source_backup/utils/components/InputUtils.py,sha256=tuyzWDhxXdHqJ3XGS8O1TA22CaNSLEDpKFWf0QSlsQA,7278
-robo_appian_source_backup/utils/components/LabelUtils.py,sha256=5ovTy9OY-QtLS8UoBXeqi4MQDvlPqVWDnp7SIcXWkJw,1230
-robo_appian_source_backup/utils/components/LinkUtils.py,sha256=T7dJ5xSXp436VXhczWrQHC13L5wXTXxxgAvBdyKuYM4,1420
-robo_appian_source_backup/utils/components/TabUtils.py,sha256=_KsImdeVITxmotphaqVARwhOhAvs4CLWHlx9wr-qZTk,2070
-robo_appian_source_backup/utils/components/TableUtils.py,sha256=W-5fpjRStCmSLlryeHvBiOH83qCXNHgeVukMS3iAs6o,8276
-robo_appian_source_backup/utils/components/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-robo_appian_source_backup/utils/controllers/ComponentDriver.py,sha256=Lzhlf7W85FjZn_0j9eybrgC8wSCzUEvsAbgbGNvTMLY,4128
-robo_appian_source_backup/utils/controllers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-robo_appian_source_backup/utils/exceptions/MyCustomError.py,sha256=DVAkytXNNQNjqyTyCjk6FFd6fr3AsBe57Y19erDSqVs,222
-robo_appian_source_backup/utils/exceptions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-robo_appian-0.0.4.dist-info/METADATA,sha256=LpZLjkHL-r978F_hEzlh-oHQ2HaOUpV0-RGJVZ_ZdQw,4880
-robo_appian-0.0.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-robo_appian-0.0.4.dist-info/top_level.txt,sha256=UuP4kHKT_rk8Cj08kDZHMv-SMu-c1gouluxYURCUgtk,38
-robo_appian-0.0.4.dist-info/RECORD,,

robo_appian-0.0.4.dist-info/top_level.txt

@@ -1,2 +0,0 @@
-robo_appian
-robo_appian_source_backup

robo_appian_source_backup/__init__.py

@@ -1,23 +0,0 @@
-from robo_appian.utils.components.ButtonUtils import ButtonUtils
-from robo_appian.utils.components.ComponentUtils import ComponentUtils
-from robo_appian.utils.components.DateUtils import DateUtils
-from robo_appian.utils.components.DropdownUtils import DropdownUtils
-from robo_appian.utils.components.InputUtils import InputUtils
-from robo_appian.utils.components.LabelUtils import LabelUtils
-from robo_appian.utils.components.LinkUtils import LinkUtils
-from robo_appian.utils.components.TableUtils import TableUtils
-from robo_appian.utils.components.TabUtils import TabUtils
-
-__version__ = "0.0.2"
-
-__all__ = [
-    "ButtonUtils",
-    "ComponentUtils", 
-    "DateUtils",
-    "DropdownUtils",
-    "InputUtils",
-    "LabelUtils",
-    "LinkUtils",
-    "TableUtils",
-    "TabUtils"
-]

robo_appian_source_backup/utils/components/DropdownUtils.py

@@ -1,141 +0,0 @@
-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.utils.components.InputUtils import InputUtils
-
-
-class DropdownUtils:
-    """
-    Utility class for interacting with dropdown components in Appian UI.
-
-        Usage Example:
-
-        # Select a value from a dropdown
-        from robo_appian.utils.components.DropdownUtils import DropdownUtils
-        DropdownUtils.selectDropdownValue(wait, "Status", "Approved")
-
-        # Select a value from a search dropdown
-        from robo_appian.utils.components.DropdownUtils import DropdownUtils
-        DropdownUtils.selectSearchDropdownValue(wait, "Category", "Finance")
-    """
-
-    @staticmethod
-    def findDropdownEnabled(wait: WebDriverWait, dropdown_label: str):
-        """
-        Finds a dropdown component that is enabled and has the specified label.
-
-        Parameters:
-            wait: Selenium WebDriverWait instance.
-            dropdown_label: The visible text label of the dropdown component.
-
-        Returns:
-            The Selenium WebElement for the dropdown component.
-
-        Example:
-            DropdownUtils.findDropdownEnabled(wait, "Status")
-
-        """
-        # This method locates a dropdown component that contains a label with the specified text.
-        # It then retrieves the component's ID and uses it to find the actual dropdown element.
-        # The dropdown is identified by its role as a combobox and tabindex attribute.
-        # The XPath searches for a div that contains a span with the specified label text.
-        # It ensures that the dropdown is clickable and ready for interaction.
-        # The dropdown component is expected to have a structure where the label is within a span inside a div.
-
-        # xpath = f'.//div[./div/span[normalize-space(text())="{dropdown_label}"]]/div/div/div/div[@role="combobox" and @tabindex="0"]'
-        # V0.0.4
-        xpath = f'.//div[./div/span[contains(normalize-space(text()), "{dropdown_label}")]]/div/div/div/div[@role="combobox" and @tabindex="0"][0]'
-        component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
-        return component
-
-    @staticmethod
-    def selectValueUsingComponent(
-        wait: WebDriverWait, combobox: WebElement, value: str
-    ) -> None:
-        """
-        Selects a value from a dropdown component using the provided combobox element.
-
-        Parameters:
-            wait: Selenium WebDriverWait instance.
-            combobox: The Selenium WebElement for the combobox.
-            value: The value to select from the dropdown.
-
-        Example:
-            DropdownUtils.selectValueUsingComponent(wait, combobox, "Approved")
-
-        """
-        # This method assumes that the combobox is already found and passed as an argument.
-        # It retrieves the aria-controls attribute to find the dropdown list and selects the specified value.
-
-        if not combobox:
-            raise ValueError(f"Dropdown component object is not valid.")
-
-        component: WebElement = combobox.find_element(By.XPATH, "./div/div")  # type: ignore[reportUnknownMemberType]
-        aria_controls = component.get_attribute("aria-controls")  # type: ignore[reportUnknownMemberType]
-        component.click()
-
-        xpath = f'.//div/ul[@id="{aria_controls}"]/li[./div[normalize-space(text())="{value}"]]'
-        # component = wait.until(EC.presence_of_element_located((By.XPATH, xpath)))
-        component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
-        component.click()
-
-    @staticmethod
-    def selectDropdownValue(wait: WebDriverWait, label: str, value: str) -> None:
-        """
-        Selects a value from a dropdown component identified by its label.
-
-        Parameters:
-            wait: Selenium WebDriverWait instance.
-            label: The visible text label of the dropdown component.
-            value: The value to select from the dropdown.
-
-        Example:
-            DropdownUtils.selectDropdownValue(wait, "Status", "Approved")
-
-        """
-        # This method finds the dropdown component by its label, retrieves the aria-controls attribute,
-        # and then clicks on the dropdown to display the options.
-
-        combobox = DropdownUtils.findDropdownEnabled(wait, label)
-        aria_controls = combobox.get_attribute("aria-controls")  # type: ignore[reportUnknownMemberType]
-        combobox.click()
-
-        xpath = f'.//div/ul[@id="{aria_controls}"]/li[./div[normalize-space(text())="{value}"]]'
-        component = wait.until(EC.presence_of_element_located((By.XPATH, xpath)))
-        component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
-        component.click()
-
-    @staticmethod
-    def selectSearchDropdownValue(wait: WebDriverWait, dropdown_label: str, value: str):
-        """
-        Selects a value from a search-enabled dropdown component identified by its label.
-
-        Parameters:
-            wait: Selenium WebDriverWait instance.
-            dropdown_label: The visible text label of the search dropdown component.
-            value: The value to select from the dropdown.
-
-        Example:
-            DropdownUtils.selectSearchDropdownValue(wait, "Category", "Finance")
-
-        """
-        # This method finds the search-enabled dropdown component by its label, retrieves the aria-controls attribute
-        # and the component ID, clicks on the dropdown to display the search input,
-
-        component = DropdownUtils.findDropdownEnabled(wait, dropdown_label)
-        component_id = component.get_attribute("aria-labelledby")  # type: ignore[reportUnknownMemberType]
-        aria_controls = component.get_attribute("aria-controls")  # type: ignore[reportUnknownMemberType]
-        component.click()
-
-        input_component_id = str(component_id) + "_searchInput"
-        input_component = wait.until(
-            EC.element_to_be_clickable((By.ID, input_component_id))
-        )
-        InputUtils.setValueUsingComponent(input_component, value)
-
-        xpath = f'.//ul[@id="{aria_controls}"]/li[./div[normalize-space(text())="{value}"]][1]'
-        component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
-        component.click()

robo_appian_source_backup/utils/components/InputUtils.py

@@ -1,193 +0,0 @@
-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.webdriver import WebDriver
-from selenium.webdriver.remote.webelement import WebElement
-
-
-class InputUtils:
-    """
-    Utility class for interacting with input components in Appian UI.
-
-        Usage Example:
-
-        # Set a value in an input field
-        from robo_appian.utils.components.InputUtils import InputUtils
-        InputUtils.setInputValue(wait, "Username", "test_user")
-
-    """
-
-    @staticmethod
-    def findComponent(wait: WebDriverWait, label: str):
-        """
-        Finds an input component by its label.
-
-        Parameters:
-            wait: Selenium WebDriverWait instance.
-            label: The visible text label of the input component.
-
-        Returns:
-            The Selenium WebElement for the input component.
-
-        Example:
-            InputUtils.findComponent(wait, "Username")
-
-        """
-        # This method locates an input component that contains a label with the specified text.
-        # It then retrieves the component's ID and uses it to find the actual input element.
-
-        # xpath = f".//div/label[text()='{label}']"
-        # V0.0.4        
-        xpath = f".//div/label[contains(normalize-space(text()), '{label}')]"
-        component: WebElement = wait.until(
-            EC.element_to_be_clickable((By.XPATH, xpath))
-        )
-
-        attribute: str = "for"
-        component_id = component.get_attribute(attribute)  # type: ignore[reportUnknownMemberType]
-        if not component_id:
-            raise ValueError(
-                f"Could not find component using {attribute} attribute for label '{label}'."
-            )
-
-        component = wait.until(EC.element_to_be_clickable((By.ID, component_id)))
-        return component
-
-    @staticmethod
-    def setValueUsingComponent(component: WebElement, value: str):
-        """
-        Sets a value in an input component using the provided component element.
-
-        Parameters:
-            component: The Selenium WebElement for the input component.
-            value: The value to set in the input field.
-
-        Returns:
-            The Selenium WebElement for the input component after setting the value.
-
-        Example:
-            InputUtils.setValueUsingComponent(component, "test_user")
-
-        """
-        # This method assumes that the component is already found and passed as an argument.
-        # It clears the existing value and sets the new value in the input field.
-
-        if not component.is_displayed():
-            raise Exception(
-                f"Component with label '{component.text}' is not displayed."
-            )
-
-        component.clear()
-        component.send_keys(value)
-        return component
-
-    @staticmethod
-    def setValueAndSubmitUsingComponent(component: WebElement, value: str):
-        """
-        Sets a value in an input component and submits it using the provided component element.
-
-        Parameters:
-            component: The Selenium WebElement for the input component.
-            value: The value to set in the input field.
-
-        Returns:
-            The Selenium WebElement for the input component after setting the value and submitting.
-
-        Example:
-            InputUtils.setValueAndSubmitUsingComponent(component, "test_user")
-
-        """
-        # This method assumes that the component is already found and passed as an argument.
-
-        if not component.is_displayed():
-            raise Exception(
-                f"Component with label '{component.text}' is not displayed."
-            )
-
-        component = InputUtils.setValueUsingComponent(component, value)
-        component.send_keys(Keys.ENTER)
-        return component
-
-    @staticmethod
-    def setInputValue(wait: WebDriverWait, label: str, value: str):
-        """
-        Sets a value in an input component identified by its label.
-
-        Parameters:
-            wait: Selenium WebDriverWait instance.
-            label: The visible text label of the input component.
-            value: The value to set in the input field.
-
-        Returns:
-            The Selenium WebElement for the input component after setting the value.
-
-        Example:
-            InputUtils.setInputValue(wait, "Username", "test_user")
-
-        """
-        # This method finds the input component by its label and sets the specified value in it.
-        # It retrieves the component's ID and uses it to find the actual input element.
-
-        component = InputUtils.findComponent(wait, label)
-        InputUtils.setValueUsingComponent(component, value)
-        return component
-
-    @staticmethod
-    def setValueAndSubmit(wait: WebDriverWait, label: str, value: str):
-        """
-        Sets a value in an input component identified by its label and submits it.
-
-        Parameters:
-            wait: Selenium WebDriverWait instance.
-            label: The visible text label of the input component.
-            value: The value to set in the input field.
-
-        Returns:
-            The Selenium WebElement for the input component after setting the value and submitting.
-
-        Example:
-            InputUtils.setValueAndSubmit(wait, "Username", "test_user")
-
-        """
-        # This method finds the input component by its label, sets the specified value in it,
-        # and submits the form by sending an ENTER key.
-
-        component = InputUtils.findComponent(wait, label)
-        component = InputUtils.setValueAndSubmitUsingComponent(component, value)
-        return component
-
-    @staticmethod
-    def setSearchInputValue(wait: WebDriverWait, label: str, value: str):
-        """
-        Sets a value in a search-enabled input component identified by its label.
-
-        Parameters:
-            wait: Selenium WebDriverWait instance.
-            label: The visible text label of the search input component.
-            value: The value to set in the search input field.
-
-        Returns:
-            None
-        Example:
-            InputUtils.setSearchInputValue(wait, "Search", "Appian")
-
-        """
-        # This method finds the search-enabled input component by its label, retrieves the aria-controls attribute
-        # and the component ID, clicks on the input to display the search input,
-        # and sets the specified value in the search input field.
-
-        # xpath = (
-        #     f".//div[./div/span[text()='{label}']]/div/div/div/input[@role='combobox']"
-        # )
-        # V0.0.4
-        xpath = f".//div[./div/span[contains(normalize-space(text())='{label}']]/div/div/div/input[@role='combobox']"
-        search_input_component = wait.until(
-            EC.element_to_be_clickable((By.XPATH, xpath))
-        )
-        aria_controls = search_input_component.get_attribute("aria-controls")  # type: ignore[reportUnknownMemberType]
-        InputUtils.setValueUsingComponent(search_input_component, value)
-
-        xpath = f".//ul[@id='{aria_controls}' 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)))
-        drop_down_item.click()