robo_appian 0.0.11__tar.gz → 0.0.12__tar.gz

{robo_appian-0.0.11 → robo_appian-0.0.12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: robo_appian
-Version: 0.0.11
+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

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

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

@@ -4,8 +4,30 @@ 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 find(wait: WebDriverWait, label: str):
+    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[contains(translate(normalize-space(.), '\u00a0', ' '), '{label}')]]"
         try:
             component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
@@ -14,22 +36,20 @@ class ButtonUtils:
         return component
 
     @staticmethod
-    def click(wait: WebDriverWait, label: str):
-        """
-        Clicks a button identified by its label.
+    def clickByLabelText(wait: WebDriverWait, label: str):
+        """Finds a button by its label and clicks it.
 
         Parameters:
             wait: Selenium WebDriverWait instance.
-            label: The visible text label of the button.
-        Example:
-            ButtonUtils.click(wait, "Submit")
-
+            label: The label of the button to click.
+            Example:
+                ButtonUtils.clickByLabelText(wait, "Button Label")
         """
-        component = ButtonUtils.find(wait, label)
+        component = ButtonUtils.__findByLabelText(wait, label)
         component.click()
 
     @staticmethod
-    def clickInputButtonById(wait: WebDriverWait, id: str):
+    def clickById(wait: WebDriverWait, id: str):
         """
         Finds and clicks an input button by its HTML id attribute.
 
@@ -38,13 +58,11 @@ class ButtonUtils:
             id: The HTML id of the input button.
 
         Example:
-            ButtonUtils.clickInputButtonById(wait, "button_id")
+            ButtonUtils.clickById(wait, "button_id")
 
         """
         try:
             component = wait.until(EC.element_to_be_clickable((By.ID, id)))
-        except TimeoutError as e:
-            raise TimeoutError(f"Input button with id '{id}' not found or not clickable.") from e
         except Exception as e:
             raise RuntimeError(f"Input button with id '{id}' not found or not clickable.") from e
 

robo_appian-0.0.12/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.12}/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.12/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

robo_appian-0.0.12/robo_appian/components/LabelUtils.py

@@ -0,0 +1,46 @@
+from selenium.webdriver.common.by import By
+from selenium.webdriver.support import expected_conditions as EC
+from selenium.webdriver.support.ui import WebDriverWait
+
+
+class LabelUtils:
+    """
+    Utility class for interacting with label components in Appian UI.
+    Usage Example:
+        # Find a label by its text
+        component = LabelUtils.findByLabelText(wait, "Submit")
+        # Click a label by its text
+        LabelUtils.clickByLabelText(wait, "Submit")
+    """
+
+    @staticmethod
+    def findByLabelText(wait: WebDriverWait, label: str):
+        """
+        Finds a label element by its text.
+
+        :param wait: Selenium WebDriverWait instance.
+        :param label: The text of the label to find.
+        :return: WebElement representing the label.
+        Example:
+            component = LabelUtils.findByLabelText(wait, "Submit")
+        """
+        xpath = f".//*[normalize-space(text())='{label}']"
+        try:
+            component = wait.until(EC.presence_of_element_located((By.XPATH, xpath)))
+        except Exception as e:
+            raise RuntimeError(f"Label with text '{label}' not found.") from e
+
+        return component
+
+    @staticmethod
+    def clickByLabelText(wait: WebDriverWait, label: str):
+        """
+        Clicks a label element identified by its text.
+
+        :param wait: Selenium WebDriverWait instance.
+        :param label: The text of the label to click.
+        Example:
+            LabelUtils.clickByLabelText(wait, "Submit")
+        """
+        component = LabelUtils.findByLabelText(wait, label)
+        component.click()

{robo_appian-0.0.11 → robo_appian-0.0.12}/robo_appian/components/LinkUtils.py

@@ -5,14 +5,16 @@ from selenium.webdriver.support.ui import WebDriverWait
 
 class LinkUtils:
     """
-    Utility class for interacting with link components in Appian UI.
-
-        Usage Example:
-
-        # Click a link with a specific label
+    Utility class for handling link operations in Selenium WebDriver.
+    Example usage:
+        from selenium import webdriver
+        from selenium.webdriver.support.ui import WebDriverWait
         from robo_appian.components.LinkUtils import LinkUtils
-        LinkUtils.click(wait, "Learn More")
 
+        driver = webdriver.Chrome()
+        wait = WebDriverWait(driver, 10)
+        LinkUtils.click(wait, "Learn More")
+        driver.quit()
     """
 
     @staticmethod
@@ -21,9 +23,7 @@ class LinkUtils:
         try:
             component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
         except TimeoutError as e:
-            raise TimeoutError(
-                f"Could not find clickable link with label '{label}': {e}"
-            )
+            raise TimeoutError(f"Could not find clickable link with label '{label}': {e}")
         except Exception as e:
             raise Exception(f"Could not find clickable link with label '{label}': {e}")
         return component

{robo_appian-0.0.11 → robo_appian-0.0.12}/robo_appian/components/SearchDropdownUtils.py

@@ -20,7 +20,7 @@ class SearchDropdownUtils:
             input_component = wait.until(EC.element_to_be_clickable((By.ID, input_component_id)))
         except Exception as e:
             raise RuntimeError(f"Failed to locate or click input component with ID '{input_component_id}': {e}")
-        InputUtils._setComponentValue(input_component, value)
+        InputUtils._setValueByComponent(input_component, value)
 
         xpath = f'.//ul[@id="{dropdown_option_id}"]/li[./div[normalize-space(text())="{value}"]][1]'
         try: