robo_appian 0.0.11__tar.gz → 0.0.13__tar.gz

robo_appian-0.0.13/PKG-INFO

@@ -0,0 +1,67 @@
+Metadata-Version: 2.3
+Name: robo_appian
+Version: 0.0.13
+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.12
+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
+
+# Robo Appian
+
+Robo Appian is a Python library for automated UI testing of Appian applications. It provides user-friendly utilities and best practices to help you write robust, maintainable, and business-focused test automation.
+
+## Features
+- Simple, readable API for Appian UI automation
+- Utilities for buttons, inputs, dropdowns, tables, tabs, and more
+- Data-driven and workflow testing support
+- Error handling and debugging helpers
+- Designed for both technical and business users
+
+## Documentation
+Full documentation, guides, and API reference are available at:
+
+➡️ [Robo Appian Documentation](https://dinilmithra.github.io/robo_appian/)
+
+## Quick Start
+1. Install Robo Appian:
+   ```bash
+   pip install robo_appian
+   ```
+2. See the [Getting Started Guide](docs/getting-started/installation.md) for setup and your first test.
+
+## Example Usage
+```python
+from robo_appian.components import InputUtils, ButtonUtils
+
+# Set value in a text field by label
+InputUtils.setValueByLabelText(wait, "Username", "testuser")
+
+# Click a button by label
+ButtonUtils.clickByLabelText(wait, "Sign In")
+```
+
+## Project Structure
+- `robo_appian/` - Library source code
+- `docs/` - Documentation and guides
+- `examples/` - Example test scripts
+
+## Contributing
+Contributions are welcome! Please see the [contributing guidelines](CONTRIBUTING.md) or open an issue to get started.
+
+## License
+MIT License. See [LICENSE](LICENSE) for details.
+
+---
+
+For questions or support, contact [Dinil Mithra](mailto:dinilmithra.mailme@gmail.com) or connect on [LinkedIn](https://www.linkedin.com/in/dinilmithra).
+

robo_appian-0.0.13/README.md

@@ -0,0 +1,48 @@
+# Robo Appian
+
+Robo Appian is a Python library for automated UI testing of Appian applications. It provides user-friendly utilities and best practices to help you write robust, maintainable, and business-focused test automation.
+
+## Features
+- Simple, readable API for Appian UI automation
+- Utilities for buttons, inputs, dropdowns, tables, tabs, and more
+- Data-driven and workflow testing support
+- Error handling and debugging helpers
+- Designed for both technical and business users
+
+## Documentation
+Full documentation, guides, and API reference are available at:
+
+➡️ [Robo Appian Documentation](https://dinilmithra.github.io/robo_appian/)
+
+## Quick Start
+1. Install Robo Appian:
+   ```bash
+   pip install robo_appian
+   ```
+2. See the [Getting Started Guide](docs/getting-started/installation.md) for setup and your first test.
+
+## Example Usage
+```python
+from robo_appian.components import InputUtils, ButtonUtils
+
+# Set value in a text field by label
+InputUtils.setValueByLabelText(wait, "Username", "testuser")
+
+# Click a button by label
+ButtonUtils.clickByLabelText(wait, "Sign In")
+```
+
+## Project Structure
+- `robo_appian/` - Library source code
+- `docs/` - Documentation and guides
+- `examples/` - Example test scripts
+
+## Contributing
+Contributions are welcome! Please see the [contributing guidelines](CONTRIBUTING.md) or open an issue to get started.
+
+## License
+MIT License. See [LICENSE](LICENSE) for details.
+
+---
+
+For questions or support, contact [Dinil Mithra](mailto:dinilmithra.mailme@gmail.com) or connect on [LinkedIn](https://www.linkedin.com/in/dinilmithra).

{robo_appian-0.0.11 → robo_appian-0.0.13}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "robo_appian"
-version = "0.0.11"
+version = "0.0.13"
 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.13/robo_appian/components/ButtonUtils.py

@@ -0,0 +1,105 @@
+from selenium.webdriver.common.by import By
+from selenium.webdriver.support import expected_conditions as EC
+from selenium.webdriver.support.ui import WebDriverWait
+
+
+class ButtonUtils:
+    """
+    Utility class for interacting with button components in Appian UI.
+    Usage Example:
+        # Click a button by its label
+        from robo_appian.components.ButtonUtils import ButtonUtils
+        ButtonUtils.clickByLabelText(wait, "Submit")
+    """
+
+    @staticmethod
+    def __findByPartialLabelText(wait: WebDriverWait, label: str):
+        """
+        Finds a button by its label.
+
+        Parameters:
+            wait: Selenium WebDriverWait instance.
+            label: The label of the button to find.
+            label: The label of the button to find.
+
+        Returns:
+            WebElement representing the button.
+
+        Example:
+            component = ButtonUtils.__findByLabelText(wait, "Submit")
+        """
+        xpath = f".//button[./span[contains(translate(normalize-space(.), '\u00a0', ' '), '{label}')]]"
+        try:
+            component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
+        except Exception as e:
+            raise RuntimeError(f"Button with label '{label}' not found or not clickable.") from e
+        return component
+
+    @staticmethod
+    def __findByLabelText(wait: WebDriverWait, label: str):
+        """
+        Finds a button by its label.
+
+        Parameters:
+            wait: Selenium WebDriverWait instance.
+            label: The label of the button to find.
+            label: The label of the button to find.
+
+        Returns:
+            WebElement representing the button.
+
+        Example:
+            component = ButtonUtils.__findByLabelText(wait, "Submit")
+        """
+        xpath = f".//button[./span[normalize-space(text())='{label}']]"
+        try:
+            component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
+        except Exception as e:
+            raise RuntimeError(f"Button with label '{label}' not found or not clickable.") from e
+        return component
+
+    @staticmethod
+    def clickByPartialLabelText(wait: WebDriverWait, label: str):
+        """Finds a button by its partial label and clicks it.
+
+        Parameters:
+            wait: Selenium WebDriverWait instance.
+            label: The partial label of the button to click.
+            Example:
+                ButtonUtils.clickByPartialLabelText(wait, "Button Label")
+        """
+        component = ButtonUtils.__findByPartialLabelText(wait, label)
+        component.click()
+
+    @staticmethod
+    def clickByLabelText(wait: WebDriverWait, label: str):
+        """Finds a button by its label and clicks it.
+
+        Parameters:
+            wait: Selenium WebDriverWait instance.
+            label: The label of the button to click.
+            Example:
+                ButtonUtils.clickByLabelText(wait, "Button Label")
+        """
+        component = ButtonUtils.__findByLabelText(wait, label)
+        component.click()
+
+    @staticmethod
+    def clickById(wait: WebDriverWait, id: str):
+        """
+        Finds and clicks an input button by its HTML id attribute.
+
+        Parameters:
+            wait: Selenium WebDriverWait instance.
+            id: The HTML id of the input button.
+
+        Example:
+            ButtonUtils.clickById(wait, "button_id")
+
+        """
+        try:
+            component = wait.until(EC.element_to_be_clickable((By.ID, id)))
+        except Exception as e:
+            raise RuntimeError(f"Input button with id '{id}' not found or not clickable.") from e
+
+        component.click()

robo_appian-0.0.13/robo_appian/components/DateUtils.py

@@ -0,0 +1,77 @@
+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.components.InputUtils import InputUtils
+
+
+class DateUtils:
+    """
+    Utility class for interacting with date components in Appian UI.
+    Usage Example:
+        # Set a date value in a date component
+        from robo_appian.components.DateUtils import DateUtils
+        DateUtils.setValueByLabelText(wait, "Start Date", "2023-10-01")
+    """
+
+    @staticmethod
+    def __findComponent(wait: WebDriverWait, label: str):
+        """
+        Finds a date component by its label.
+        :param wait: WebDriverWait instance to wait for elements.
+        :param label: The label of the date component.
+        :return: The WebElement representing the date component.
+        Example:
+            DateUtils.__findComponent(wait, "Start Date")
+        """
+        # xpath = f".//div/label[text()='{label}']"
+        # try:
+        #     component: WebElement = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
+        # 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]
+        # if component_id is None:
+        #     raise ValueError(f"Could not find component using {attribute} attribute for label '{label}'.")
+
+        # try:
+        #     component = wait.until(EC.element_to_be_clickable((By.ID, component_id)))
+        # except Exception as e:
+        #     raise Exception(f"Could not find clickable date input with id '{component_id}': {e}")
+
+        xpath = f'.//div[./div/label[text()="{label}"]]/div/div/div/input'
+        try:
+            component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
+        except Exception as e:
+            raise Exception(f"Could not find clickable date component with label '{label}': {e}")
+        return component
+
+    @staticmethod
+    def setValueByLabelText(wait: WebDriverWait, label: str, value: str):
+        """
+        Sets the value of a date component.
+        :param wait: WebDriverWait instance to wait for elements.
+        :param label: The label of the date component.
+        :param value: The value to set in the date component.
+        :return: The WebElement representing the date component.
+        Example:
+            DateUtils.setValueByLabelText(wait, "Start Date", "2023-10-01")
+        """
+        component = DateUtils.__findComponent(wait, label)
+        InputUtils._setValueByComponent(component, value)
+        return component
+
+    @staticmethod
+    def clickByLabelText(wait: WebDriverWait, label: str):
+        """
+        Clicks on the date component to open the date picker.
+        :param wait: WebDriverWait instance to wait for elements.
+        :param label: The label of the date component.
+        :return: The WebElement representing the date component.
+        Example:
+            DateUtils.clickByLabelText(wait, "Start Date")
+        """
+        component = DateUtils.__findComponent(wait, label)
+        component.click()
+        return component

{robo_appian-0.0.11 → robo_appian-0.0.13}/robo_appian/components/DropdownUtils.py

@@ -16,7 +16,16 @@ class DropdownUtils:
 
     @staticmethod
     def __findComboboxByPartialLabelText(wait: WebDriverWait, label: str):
-        xpath = f'.//div[./div/span[contains(normalize-space(text()), "{label}")]]/div/div/div/div[@role="combobox" and not(@aria-disabled="true")]'
+        """
+        Finds a combobox by its partial label text.
+
+        :param wait: Selenium WebDriverWait instance.
+        :param label: The partial label of the combobox to find.
+        :return: WebElement representing the combobox.
+        Example:
+            component = DropdownUtils.__findComboboxByPartialLabelText(wait, "Dropdown Label")
+        """
+        xpath = f'.//div[./div/span[contains(normalize-space(text()), "{label}")]]/div/div/div/div[@role="combobox" and not(@aria-disabled="true")]'  # noqa: E501
         try:
             component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
         except Exception as e:
@@ -26,7 +35,16 @@ class DropdownUtils:
 
     @staticmethod
     def __findComboboxByLabelText(wait: WebDriverWait, label: str):
-        xpath = f'.//div[./div/span[normalize-space(text())="{label}"]]/div/div/div/div[@role="combobox" and not(@aria-disabled="true")]'
+        """
+        Finds a combobox by its label text.
+
+        :param wait: Selenium WebDriverWait instance.
+        :param label: The label of the combobox to find.
+        :return: WebElement representing the combobox.
+        Example:
+            component = DropdownUtils.__findComboboxByLabelText(wait, "Dropdown Label")
+        """
+        xpath = f'.//div[./div/span[normalize-space(text())="{label}"]]/div/div/div/div[@role="combobox" and not(@aria-disabled="true")]'  # noqa: E501
         try:
             component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
         except Exception as e:
@@ -36,10 +54,27 @@ class DropdownUtils:
 
     @staticmethod
     def __clickCombobox(wait: WebDriverWait, combobox: WebElement):
+        """
+        Clicks the combobox to open the dropdown options.
+
+        :param wait: WebDriverWait instance to wait for elements.
+        :param combobox: The combobox WebElement.
+        Example:
+            DropdownUtils.__clickCombobox(wait, combobox)
+        """
         combobox.click()
 
     @staticmethod
     def __findDropdownOptionId(wait: WebDriverWait, combobox: WebElement):
+        """
+        Finds the dropdown option id from the combobox.
+
+        :param wait: WebDriverWait instance to wait for elements.
+        :param combobox: The combobox WebElement.
+        :return: The id of the dropdown options list.
+        Example:
+            dropdown_option_id = DropdownUtils.__findDropdownOptionId(wait, combobox)
+        """
         dropdown_option_id = combobox.get_attribute("aria-controls")
         if dropdown_option_id is None:
             raise Exception('Dropdown component does not have a valid "aria-controls" attribute.')
@@ -47,9 +82,23 @@ class DropdownUtils:
 
     @staticmethod
     def __checkDropdownOptionValueExistsByDropdownOptionId(wait: WebDriverWait, dropdown_option_id: str, value: str):
-        option_xpath = f'.//div/ul[@id="{dropdown_option_id}"]/li[./div[normalize-space(text())="{value}"]]'
+        """
+        Checks if a dropdown option value exists by its option id and value.
+
+        :param wait: WebDriverWait instance to wait for elements.
+        :param dropdown_option_id: The id of the dropdown options list.
+        :param value: The value to check in the dropdown.
+        Example:
+            exists = DropdownUtils.checkDropdownOptionValueExistsByDropdownOptionId(wait, "dropdown_option_id", "Option Value")
+            if exists:
+                print("The value exists in the dropdown.")
+            else:
+                print("The value does not exist in the dropdown.")
+        """
+
+        xpath = f'.//div/ul[@id="{dropdown_option_id}"]/li[./div[normalize-space(text())="{value}"]]'
         try:
-            wait.until(EC.element_to_be_clickable((By.XPATH, option_xpath)))
+            wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
             return True
         except NoSuchElementException:
             return False
@@ -58,6 +107,15 @@ class DropdownUtils:
 
     @staticmethod
     def __selectDropdownValueByDropdownOptionId(wait: WebDriverWait, dropdown_option_id: str, value: str):
+        """
+        Selects a value from a dropdown by its option id and value.
+
+        :param wait: WebDriverWait instance to wait for elements.
+        :param dropdown_option_id: The id of the dropdown options list.
+        :param value: The value to select from the dropdown.
+        Example:
+            DropdownUtils.selectDropdownValueByDropdownOptionId(wait, "dropdown_option_id", "Option Value")
+        """
         option_xpath = f'.//div/ul[@id="{dropdown_option_id}"]/li[./div[normalize-space(text())="{value}"]]'
         try:
             try:
@@ -65,7 +123,7 @@ class DropdownUtils:
                 component = wait.until(EC.element_to_be_clickable((By.XPATH, option_xpath)))
             except Exception as e:
                 raise Exception(
-                    f'Could not locate or click dropdown option "{value}" with dropdown option id "{dropdown_option_id}": {str(e)}'
+                    f'Could not locate or click dropdown option "{value}" with dropdown option id "{dropdown_option_id}": {str(e)}'  # noqa: E501
                 )
         except Exception as e:
             raise Exception(f'Could not find or click dropdown option "{value}" with xpath "{option_xpath}": {str(e)}')
@@ -101,6 +159,19 @@ class DropdownUtils:
 
     @staticmethod
     def checkReadOnlyStatusByLabelText(wait: WebDriverWait, label: str):
+        """
+        Checks if a dropdown is read-only by its label text.
+
+        :param wait: WebDriverWait instance to wait for elements.
+        :param label: The label of the dropdown.
+        :return: True if the dropdown is read-only, False otherwise.
+        Example:
+            is_read_only = DropdownUtils.checkReadOnlyStatusByLabelText(wait, "Dropdown Label")
+            if is_read_only:
+                print("The dropdown is read-only.")
+            else:
+                print("The dropdown is editable.")
+        """
         xpath = f'.//div[./div/span[normalize-space(text())="{label}"]]/div/div/p[text()]'
         try:
             wait._driver.find_element(By.XPATH, xpath)
@@ -112,20 +183,61 @@ class DropdownUtils:
 
     @staticmethod
     def selectDropdownValueByComboboxComponent(wait: WebDriverWait, combobox: WebElement, value: str):
+        """
+        Selects a value from a dropdown using the combobox component.
+
+        :param wait: WebDriverWait instance to wait for elements.
+        :param combobox: The combobox WebElement.
+        :param value: The value to select from the dropdown.
+        Example:
+            DropdownUtils.selectDropdownValueByComboboxComponent(wait, combobox, "Option Value")
+        """
         dropdown_option_id = DropdownUtils.__findDropdownOptionId(wait, combobox)
         DropdownUtils.__clickCombobox(wait, combobox)
         DropdownUtils.__selectDropdownValueByDropdownOptionId(wait, dropdown_option_id, value)
 
     @staticmethod
     def selectDropdownValueByLabelText(wait: WebDriverWait, dropdown_label: str, value: str):
+        """
+        Selects a value from a dropdown by its label text.
+
+        :param wait: WebDriverWait instance to wait for elements.
+        :param dropdown_label: The label of the dropdown.
+        :param value: The value to select from the dropdown.
+        Example:
+            DropdownUtils.selectDropdownValueByLabelText(wait, "Dropdown Label", "Option Value")
+        """
         DropdownUtils.__selectDropdownValueByLabelText(wait, dropdown_label, value)
 
     @staticmethod
     def selectDropdownValueByPartialLabelText(wait: WebDriverWait, dropdown_label: str, value: str):
+        """
+        Selects a value from a dropdown by its partial label text.
+
+        :param wait: WebDriverWait instance to wait for elements.
+        :param dropdown_label: The partial label of the dropdown.
+        :param value: The value to select from the dropdown.
+        Example:
+            DropdownUtils.selectDropdownValueByPartialLabelText(wait, "Dropdown Label", "Option Value")
+        """
         DropdownUtils.__selectDropdownValueByPartialLabelText(wait, dropdown_label, value)
 
     @staticmethod
     def checkDropdownOptionValueExists(wait: WebDriverWait, dropdown_label: str, value: str):
+        """
+        Checks if a dropdown option value exists by its label text.
+
+        :param wait: WebDriverWait instance to wait for elements.
+        :param dropdown_label: The label of the dropdown.
+        :param value: The value to check in the dropdown.
+        :return: True if the value exists, False otherwise.
+        Example:
+            exists = DropdownUtils.checkDropdownOptionValueExists(wait, "Dropdown Label", "Option Value")
+            if exists:
+                print("The value exists in the dropdown.")
+            else:
+                print("The value does not exist in the dropdown.")
+        """
         combobox = DropdownUtils.__findComboboxByLabelText(wait, dropdown_label)
         DropdownUtils.__clickCombobox(wait, combobox)
         dropdown_option_id = DropdownUtils.__findDropdownOptionId(wait, combobox)

robo_appian-0.0.13/robo_appian/components/InputUtils.py

@@ -0,0 +1,165 @@
+from robo_appian.utils.ComponentUtils import ComponentUtils
+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 InputUtils:
+    """
+    Utility class for interacting with input components in Appian UI.
+    Usage Example:
+        from robo_appian.components.InputUtils import InputUtils
+
+        # Set a value in an input component by its label
+        InputUtils.setValueByLabelText(wait, "Username", "test_user")
+
+        # Set a value in an input component by its ID
+        InputUtils.setValueById(wait, "inputComponentId", "test_value")
+    """
+
+    @staticmethod
+    def __findInputComponentsByXpath(wait: WebDriverWait, xpath: str):
+        """
+        Finds input components by their XPath.
+
+        Parameters:
+            wait: Selenium WebDriverWait instance.
+            xpath: The XPath expression to locate the input components.
+
+        Returns:
+            A list of Selenium WebElement representing the input components.
+
+        Example:
+            InputUtils.__findInputComponentsByXpath(wait, './/div/label[normalize-space(text())="Username"]')
+        """
+        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:
+                try:
+                    component = wait.until(EC.element_to_be_clickable((By.ID, component_id)))
+                    input_components.append(component)
+                except Exception as e:
+                    raise Exception(f"Could not find clickable input component with id '{component_id}': {e}")
+            else:
+                raise ValueError(f"Input component with label '{label_component.text}' does not have 'for' attribute.")
+        return input_components
+
+    @staticmethod
+    def __findInputComponentsByPartialLabel(wait: WebDriverWait, label: str):
+        """Finds input components by their label text, allowing for partial matches.
+
+        Parameters:
+            wait: Selenium WebDriverWait instance.
+            label: The visible text label of the input component, allowing for partial matches.
+
+        Returns:
+            A list of Selenium WebElement representing the input components.
+
+        Example:
+            InputUtils.__findInputComponentsByPartialLabel(wait, "Username")
+        """
+        xpath = f'.//div/label[contains(normalize-space(text()), "{label}")]'
+        components = InputUtils.__findInputComponentsByXpath(wait, xpath)
+        return components
+
+    @staticmethod
+    def __findComponentsByLabel(wait: WebDriverWait, label: str):
+        """Finds input components by their label text.
+
+        Parameters:
+            wait: Selenium WebDriverWait instance.
+            label: The visible text label of the input component.
+
+        Returns:
+            A list of Selenium WebElement representing the input components.
+
+        Example:
+            InputUtils.__findComponentsByLabel(wait, "Username")
+        """
+        xpath = f'.//div/label[normalize-space(text())="{label}"]'
+        components = InputUtils.__findInputComponentsByXpath(wait, xpath)
+        return components
+
+    @staticmethod
+    def _setValueByComponent(component: WebElement, value: str):
+        """
+        Sets a value in an input component.
+        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._setValueByComponent(component, "test_value")
+        """
+        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._setValueByComponent(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):
+        """
+        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")
+        """
+        input_components = InputUtils.__findComponentsByLabel(wait, label)
+        InputUtils.__setValueByComponents(wait, input_components, value)
+
+    @staticmethod
+    def setValueById(wait: WebDriverWait, component_id: str, value: str):
+        """
+        Sets a value in an input component identified by its ID.
+
+        Parameters:
+            wait: Selenium WebDriverWait instance.
+            component_id: The ID 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.setValueById(wait, "inputComponentId", "test_value")
+        """
+        try:
+            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)
+        return component