robo_appian 0.0.12__tar.gz → 0.0.14__tar.gz

robo_appian-0.0.14/PKG-INFO

@@ -0,0 +1,66 @@
+Metadata-Version: 2.3
+Name: robo_appian
+Version: 0.0.14
+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
+
+## 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.14/README.md

@@ -0,0 +1,47 @@
+# 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
+
+## 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.12 → robo_appian-0.0.14}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "robo_appian"
-version = "0.0.12"
+version = "0.0.14"
 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.12 → robo_appian-0.0.14}/robo_appian/components/ButtonUtils.py

@@ -13,7 +13,7 @@ class ButtonUtils:
     """
 
     @staticmethod
-    def __findByLabelText(wait: WebDriverWait, label: str):
+    def __findByPartialLabelText(wait: WebDriverWait, label: str):
         """
         Finds a button by its label.
 
@@ -35,6 +35,42 @@ class ButtonUtils:
             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.

robo_appian-0.0.14/robo_appian/utils/ComponentUtils.py

@@ -0,0 +1,188 @@
+from selenium.common.exceptions import NoSuchElementException
+from selenium.webdriver import ActionChains
+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.remote.webdriver import WebDriver
+from selenium.webdriver.remote.webelement import WebElement
+from selenium.webdriver.support.ui import WebDriverWait
+
+
+class ComponentUtils:
+    @staticmethod
+    def today():
+        """
+        Returns today's date formatted as MM/DD/YYYY.
+        """
+
+        from datetime import date
+
+        today = date.today()
+        yesterday_formatted = today.strftime("%m/%d/%Y")
+        return yesterday_formatted
+
+    @staticmethod
+    def yesterday():
+        """
+        Returns yesterday's date formatted as MM/DD/YYYY.
+        """
+
+        from datetime import date, timedelta
+
+        yesterday = date.today() - timedelta(days=1)
+        yesterday_formatted = yesterday.strftime("%m/%d/%Y")
+        return yesterday_formatted
+
+    @staticmethod
+    def findChildComponent(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
+        :param component: Parent WebElement to search within
+        :param xpath: XPath string to locate the child component
+        :return: WebElement if found, raises NoSuchElementException otherwise
+        Example usage:
+        from selenium.webdriver.support.ui import WebDriverWait
+        from selenium import webdriver
+
+        driver = webdriver.Chrome()
+        wait = WebDriverWait(driver, 10)
+        parent_component = driver.find_element(By.ID, "parent")
+        xpath = ".//button[@class='child']"
+        child_component = ComponentUtils.findChildComponent(wait, parent_component, xpath)
+        """
+        return component.find_element(By.XPATH, xpath)
+
+    @staticmethod
+    def findComponentUsingXpathAndClick(wait: WebDriverWait, xpath: str):
+        """Finds a component using the given XPath and clicks it.
+
+        :param wait: WebDriverWait instance to wait for elements
+        :param xpath: XPath string to locate the component
+        :return: None
+        Example usage:
+        from selenium.webdriver.support.ui import WebDriverWait
+        from selenium import webdriver
+
+        driver = webdriver.Chrome()
+        wait = WebDriverWait(driver, 10)
+        xpath = "//button[@id='submit']"
+        ComponentUtils.findComponentUsingXpathAndClick(wait, xpath)
+        """
+        component = ComponentUtils.findComponentUsingXpath(wait, xpath)
+        component.click()
+
+    @staticmethod
+    def findComponentUsingXpath(wait: WebDriverWait, xpath: str):
+        """Finds a component using the given XPath in the current WebDriver instance.
+
+        :param wait: WebDriverWait instance to wait for elements
+        :param xpath: XPath string to locate the component
+        :return: WebElement if found, raises NoSuchElementException otherwise
+        Example usage:
+        component = ComponentUtils.findComponentUsingXpath(wait, "//button[@id='submit']")
+        component.click()
+        """
+        component = wait.until(EC.presence_of_element_located((By.XPATH, xpath)))
+        return component
+
+    @staticmethod
+    def checkComponentExistsByXpath(wait: WebDriverWait, xpath: str):
+        """Checks if a component with the given XPath exists in the current WebDriver instance."""
+        status = False
+        try:
+            ComponentUtils.findComponentUsingXpath(wait, xpath)
+            status = True
+        except NoSuchElementException:
+            pass
+
+        return status
+
+    @staticmethod
+    def checkComponentExistsById(driver: WebDriver, id: str):
+        """Checks if a component with the given ID exists in the current WebDriver instance.
+
+        :param driver: WebDriver instance to check for the component
+        :param id: ID of the component to check
+        :return: True if the component exists, False otherwise
+        Example usage:
+        exists = ComponentUtils.checkComponentExistsById(driver, "submit-button")
+        print(f"Component exists: {exists}")
+        """
+        status = False
+        try:
+            driver.find_element(By.ID, id)
+            status = True
+        except NoSuchElementException:
+            pass
+
+        return status
+
+    @staticmethod
+    def findCount(wait: WebDriverWait, xpath: str):
+        """Finds the count of components matching the given XPath.
+
+        :param wait: WebDriverWait instance to wait for elements
+        :param xpath: XPath string to locate components
+        :return: Count of components matching the XPath
+        Example usage:
+        count = ComponentUtils.findCount(wait, "//div[@class='item']")
+        print(f"Number of items found: {count}")
+        """
+
+        length = 0
+
+        try:
+            component = wait.until(EC.presence_of_all_elements_located((By.XPATH, xpath)))
+            length = len(component)
+        except NoSuchElementException:
+            pass
+
+        return length
+
+    @staticmethod
+    def tab(wait: WebDriverWait):
+        """Simulates a tab key press in the current WebDriver instance.
+
+        :param wait: WebDriverWait instance to wait for elements
+        :return: None
+        Example usage:
+        ComponentUtils.tab(wait)
+        """
+        driver = wait._driver
+        actions = ActionChains(driver)
+        actions.send_keys(Keys.TAB).perform()
+
+    @staticmethod
+    def findComponentsByXPath(wait: WebDriverWait, xpath: str):
+        """Finds all components matching the given XPath and returns a list of valid components
+        that are clickable and displayed.
+
+        :param wait: WebDriverWait instance to wait for elements
+        :param xpath: XPath string to locate components
+        :return: List of valid WebElement components
+        Example usage:
+        components = ComponentUtils.findComponentsByXPath(wait, "//button[@class='submit']")
+        for component in components:
+            component.click()
+        """
+        # Wait for the presence of elements matching the XPath
+        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-0.0.12/PKG-INFO

@@ -1,140 +0,0 @@
-Metadata-Version: 2.3
-Name: robo_appian
-Version: 0.0.12
-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
-
-**Automate your Appian code testing with Python. Boost quality, save time.**
-
-[![PyPI version](https://badge.fury.io/py/robo-appian.svg)](https://badge.fury.io/py/robo-appian)
-[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
-[![Documentation](https://img.shields.io/badge/docs-mkdocs-blue.svg)](https://dinilmithra.github.io/robo_appian/)
-
-## 🚀 Quick Start
-
-### Installation
-
-```bash
-pip install robo-appian
-```
-
-### Basic Usage
-
-```python
-from selenium import webdriver
-from selenium.webdriver.support.ui import WebDriverWait
-from robo_appian import ButtonUtils, InputUtils, TableUtils
-
-# Setup your driver
-driver = webdriver.Chrome()
-wait = WebDriverWait(driver, 10)
-
-# Interact with Appian components
-ButtonUtils.click(wait, "Submit")
-InputUtils.set_text(wait, "Username", "john.doe")
-TableUtils.click_cell_link(wait, "Actions", 1, "Edit")
-```
-
-## 📚 Features
-
-### Components
-- **ButtonUtils**: Find and click buttons
-- **DateUtils**: Interact with date fields and date pickers  
-- **DropdownUtils**: Interact with dropdown/select components
-- **InputUtils**: Interact with input fields and text areas
-- **LabelUtils**: Find and interact with labels
-- **LinkUtils**: Click links and navigate
-- **TableUtils**: Interact with tables and grids
-- **TabUtils**: Switch between tabs
-- **ComponentUtils**: General component utilities
-
-### Controllers
-- **ComponentDriver**: High-level interface for component interaction
-
-### Exceptions
-- **MyCustomError**: Custom exceptions for better error handling
-
-## 📖 Documentation
-
-Visit our [full documentation](https://dinilmithra.github.io/robo_appian/) for:
-- Detailed API reference
-- Complete examples and tutorials
-- Installation guide
-- Best practices
-
-## 🛠️ Requirements
-
-- Python 3.12+
-- Selenium WebDriver 4.34.0+
-- Compatible web browser (Chrome, Firefox, etc.)
-
-## 🤝 Contributing
-
-Contributions are welcome! Please feel free to submit a Pull Request.
-
-## 📄 License
-
-This project is licensed under the MIT License.
-
-## 🔗 Links
-
-- [Documentation](https://dinilmithra.github.io/robo_appian/)
-- [PyPI Package](https://pypi.org/project/robo-appian/)
-- [GitHub Repository](https://github.com/dinilmithra/robo_appian)
-    ButtonUtils, ComponentUtils, DateUtils, DropdownUtils, InputUtils,
-    LabelUtils, LinkUtils, TableUtils, TabUtils
-)
-
-# Example: Set a Date Value
-    DateUtils.set_date_value("date_field_id", "2023-10-01")
-    
-# Example: Click a Button
-    ButtonUtils.click_button("submit_button_id")
-
-# Example: Select a Dropdown Value
-    DropdownUtils.select_value("dropdown_id", "Option 1")
-
-# Example: Enter Text in an Input Field
-    InputUtils.enter_text("input_field_id", "Sample Text")
-
-# Example: Click a Link
-    LinkUtils.click_link("link_id")
-
-# Example: Click a Tab
-    TabUtils.click_tab("tab_id")
-
-# Example: Get a Table Cell Value
-    TableUtils.get_cell_value("table_id", 1, 2)  # Row 1, Column 2
-
-# Example: Get a Label Value
-    LabelUtils.get_label_value("label_id")
-
-# Example: Get a Component Value
-    ComponentUtils.get_component_value("component_id")
-
-# Example: Use the Component Driver
-    from robo_appian.utils.controllers.ComponentDriver import ComponentDriver
-    ComponentDriver.execute(wait, "Button", "Click", "Submit", None)
-
-## Dependencies
-
-    Python >= 3.8
-    Uses selenium
-
-## License
-
-    MIT License. See LICENSE.

robo_appian-0.0.12/README.md

@@ -1,122 +0,0 @@
-# Robo Appian
-
-**Automate your Appian code testing with Python. Boost quality, save time.**
-
-[![PyPI version](https://badge.fury.io/py/robo-appian.svg)](https://badge.fury.io/py/robo-appian)
-[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
-[![Documentation](https://img.shields.io/badge/docs-mkdocs-blue.svg)](https://dinilmithra.github.io/robo_appian/)
-
-## 🚀 Quick Start
-
-### Installation
-
-```bash
-pip install robo-appian
-```
-
-### Basic Usage
-
-```python
-from selenium import webdriver
-from selenium.webdriver.support.ui import WebDriverWait
-from robo_appian import ButtonUtils, InputUtils, TableUtils
-
-# Setup your driver
-driver = webdriver.Chrome()
-wait = WebDriverWait(driver, 10)
-
-# Interact with Appian components
-ButtonUtils.click(wait, "Submit")
-InputUtils.set_text(wait, "Username", "john.doe")
-TableUtils.click_cell_link(wait, "Actions", 1, "Edit")
-```
-
-## 📚 Features
-
-### Components
-- **ButtonUtils**: Find and click buttons
-- **DateUtils**: Interact with date fields and date pickers  
-- **DropdownUtils**: Interact with dropdown/select components
-- **InputUtils**: Interact with input fields and text areas
-- **LabelUtils**: Find and interact with labels
-- **LinkUtils**: Click links and navigate
-- **TableUtils**: Interact with tables and grids
-- **TabUtils**: Switch between tabs
-- **ComponentUtils**: General component utilities
-
-### Controllers
-- **ComponentDriver**: High-level interface for component interaction
-
-### Exceptions
-- **MyCustomError**: Custom exceptions for better error handling
-
-## 📖 Documentation
-
-Visit our [full documentation](https://dinilmithra.github.io/robo_appian/) for:
-- Detailed API reference
-- Complete examples and tutorials
-- Installation guide
-- Best practices
-
-## 🛠️ Requirements
-
-- Python 3.12+
-- Selenium WebDriver 4.34.0+
-- Compatible web browser (Chrome, Firefox, etc.)
-
-## 🤝 Contributing
-
-Contributions are welcome! Please feel free to submit a Pull Request.
-
-## 📄 License
-
-This project is licensed under the MIT License.
-
-## 🔗 Links
-
-- [Documentation](https://dinilmithra.github.io/robo_appian/)
-- [PyPI Package](https://pypi.org/project/robo-appian/)
-- [GitHub Repository](https://github.com/dinilmithra/robo_appian)
-    ButtonUtils, ComponentUtils, DateUtils, DropdownUtils, InputUtils,
-    LabelUtils, LinkUtils, TableUtils, TabUtils
-)
-
-# Example: Set a Date Value
-    DateUtils.set_date_value("date_field_id", "2023-10-01")
-    
-# Example: Click a Button
-    ButtonUtils.click_button("submit_button_id")
-
-# Example: Select a Dropdown Value
-    DropdownUtils.select_value("dropdown_id", "Option 1")
-
-# Example: Enter Text in an Input Field
-    InputUtils.enter_text("input_field_id", "Sample Text")
-
-# Example: Click a Link
-    LinkUtils.click_link("link_id")
-
-# Example: Click a Tab
-    TabUtils.click_tab("tab_id")
-
-# Example: Get a Table Cell Value
-    TableUtils.get_cell_value("table_id", 1, 2)  # Row 1, Column 2
-
-# Example: Get a Label Value
-    LabelUtils.get_label_value("label_id")
-
-# Example: Get a Component Value
-    ComponentUtils.get_component_value("component_id")
-
-# Example: Use the Component Driver
-    from robo_appian.utils.controllers.ComponentDriver import ComponentDriver
-    ComponentDriver.execute(wait, "Button", "Click", "Submit", None)
-
-## Dependencies
-
-    Python >= 3.8
-    Uses selenium
-
-## License
-
-    MIT License. See LICENSE.

robo_appian-0.0.12/robo_appian/utils/ComponentUtils.py

@@ -1,229 +0,0 @@
-from selenium.common.exceptions import NoSuchElementException
-from selenium.webdriver import ActionChains
-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.remote.webdriver import WebDriver
-from selenium.webdriver.remote.webelement import WebElement
-from selenium.webdriver.support.ui import WebDriverWait
-
-
-class ComponentUtils:
-    """
-    Utility class for interacting with various components in Appian UI.
-
-    """
-
-    @staticmethod
-    def today():
-        """
-        Returns today's date formatted as MM/DD/YYYY.
-        """
-
-        from datetime import date
-
-        today = date.today()
-        yesterday_formatted = today.strftime("%m/%d/%Y")
-        return yesterday_formatted
-
-    @staticmethod
-    def yesterday():
-        """
-        Returns yesterday's date formatted as MM/DD/YYYY.
-        """
-
-        from datetime import date, timedelta
-
-        yesterday = date.today() - timedelta(days=1)
-        yesterday_formatted = yesterday.strftime("%m/%d/%Y")
-        return yesterday_formatted
-
-    @staticmethod
-    def findChildComponent(wait: WebDriverWait, component: WebElement, xpath: str):
-        return component.find_element(By.XPATH, xpath)
-
-    @staticmethod
-    def findSuccessMessage(wait: WebDriverWait, message: str):
-        """
-        Finds a success message in the UI by its text.
-        Parameters:
-            wait: Selenium WebDriverWait instance.
-            message: The text of the success message to find.
-        Returns:
-            The Selenium WebElement for the success message.
-        Example:
-            ComponentUtils.findSuccessMessage(wait, "Operation completed successfully")
-        """
-        # This method locates a success message that contains a strong tag with the specified text.
-        # The message is normalized to handle any extra spaces.
-        # It uses the presence_of_element_located condition to ensure the element is present in the DOM.
-
-        xpath = f'.//div/div/p/span/strong[normalize-space(text())="{message}"]'
-        component = wait.until(EC.presence_of_element_located((By.XPATH, xpath)))
-        return component
-
-    @staticmethod
-    def findComponentUsingXpathAndClick(wait: WebDriverWait, xpath: str):
-        """
-        Finds a component using its XPath and clicks it.
-        Parameters:
-            wait: Selenium WebDriverWait instance.
-            xpath: The XPath of the component to find and click.
-        Example:
-            ComponentUtils.findComponentUsingXpathAndClick(wait, "//button[@id='submit']")
-
-        """
-        # This method locates a component using the provided XPath and clicks it.
-        # It uses the presence_of_element_located condition to ensure the element is present in the DOM.
-        # After locating the component, it clicks it to perform the action.
-        component = ComponentUtils.findComponentUsingXpath(wait, xpath)
-        component.click()
-
-    @staticmethod
-    def findComponentUsingXpath(wait: WebDriverWait, xpath: str):
-        """
-        Finds a component using its XPath.
-        Parameters:
-            wait: Selenium WebDriverWait instance.
-            xpath: The XPath of the component to find.
-        Returns:
-            The Selenium WebElement for the component.
-        Example:
-            ComponentUtils.findComponentUsingXpath(wait, "//button[@id='submit']")
-        """
-        # This method locates a component using the provided XPath.
-        # It uses the presence_of_element_located condition to ensure the element is present in the DOM.
-        # The method returns the WebElement for further interaction.
-        component = wait.until(EC.presence_of_element_located((By.XPATH, xpath)))
-        return component
-
-    @staticmethod
-    def checkComponentExistsByXpath(wait: WebDriverWait, xpath: str):
-        """
-        Checks if a component exists using its XPath.
-        Parameters:
-            wait: Selenium WebDriverWait instance.
-            xpath: The XPath of the component to check.
-        Returns:
-            True if the component exists, False otherwise.
-        Example:
-            ComponentUtils.checkComponentExistsByXpath(wait, "//button[@id='submit']")
-        """
-        # This method checks if a component exists by attempting to find it using the provided XPath.
-        # If the component is found, it returns True; otherwise, it catches the NoSuchElementException and returns False.
-        # It uses the presence_of_element_located condition to ensure the element is present in the DOM.
-
-        status = False
-        try:
-            ComponentUtils.findComponentUsingXpath(wait, xpath)
-            status = True
-        except NoSuchElementException:
-            pass
-
-        return status
-
-    @staticmethod
-    def checkComponentExistsById(driver: WebDriver, id: str):
-        """
-        Checks if a component exists using its ID.
-        Parameters:
-            driver: Selenium WebDriver instance.
-            id: The ID of the component to check.
-        Returns:
-            True if the component exists, False otherwise.
-        Example:
-            ComponentUtils.checkComponentExistsById(driver, "submit-button")
-        """
-        # This method checks if a component exists by attempting to find it using the provided ID.
-        # If the component is found, it returns True; otherwise, it catches the NoSuchElementException and returns False.
-        # It uses the find_element method to locate the element by its ID.
-
-        status = False
-        try:
-            driver.find_element(By.ID, id)
-            status = True
-        except NoSuchElementException:
-            pass
-
-        return status
-
-    @staticmethod
-    def findCount(wait: WebDriverWait, xpath: str):
-        """
-        Finds the count of components matching the given XPath.
-        Parameters:
-            wait: Selenium WebDriverWait instance.
-            xpath: The XPath of the components to count.
-        Returns:
-            The count of components matching the XPath.
-        Example:
-            count = ComponentUtils.findCount(wait, "//div[@class='item']")
-        """
-        # This method locates all components matching the provided XPath and returns their count.
-        # It uses the presence_of_all_elements_located condition to ensure all elements are present in the DOM.
-        # If no elements are found, it catches the NoSuchElementException and returns 0.
-
-        length = 0
-
-        try:
-            component = wait.until(EC.presence_of_all_elements_located((By.XPATH, xpath)))
-            length = len(component)
-        except NoSuchElementException:
-            pass
-
-        return length
-
-    @staticmethod
-    def tab(driver: WebDriver):
-        """
-        Simulates a TAB key press in the browser.
-
-        Parameters:
-            driver: Selenium WebDriver instance.
-        Example:
-            ComponentUtils.tab(driver)
-        """
-        # This method simulates a TAB key press in the browser using ActionChains.
-        # It creates an ActionChains instance, sends the TAB key, and performs the action.
-        # This is useful for navigating through form fields or components in the UI.
-        # It uses the ActionChains class to perform the key press action.
-
-        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}")