robo_appian 0.0.17__py3-none-any.whl → 0.0.19__py3-none-any.whl

robo_appian/components/ButtonUtils.py

@@ -2,6 +2,7 @@ from selenium.webdriver.common.by import By
 from selenium.webdriver.support import expected_conditions as EC
 from selenium.webdriver.support.ui import WebDriverWait
 from selenium.webdriver.remote.webelement import WebElement
+from robo_appian.utils.ComponentUtils import ComponentUtils
 
 
 class ButtonUtils:
@@ -36,32 +37,18 @@ class ButtonUtils:
         """
         xpath = f".//button[./span[contains(translate(normalize-space(.), '\u00a0', ' '), '{label}')]]"
         try:
-            component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
+            component = ComponentUtils.findVisibleComponentByXpath(wait, 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")
-        """
+    def __findByLabelText(wait: WebDriverWait, label: str):
         xpath = f".//button[./span[normalize-space(.)='{label}']]"
         try:
-            component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
+            component = ComponentUtils.findVisibleComponentByXpath(wait, xpath)
         except Exception as e:
-            raise RuntimeError(f"Button with label '{label}' not found or not clickable.") from e
+            raise RuntimeError(f"Button with label '{label}' not found.") from e
         return component
 
     @staticmethod
@@ -87,7 +74,7 @@ class ButtonUtils:
             Example:
                 ButtonUtils.clickByLabelText(wait, "Button Label")
         """
-        component = ButtonUtils._findByLabelText(wait, label)
+        component = ButtonUtils.__findByLabelText(wait, label)
         ButtonUtils.__click(wait, component)
 
     @staticmethod
@@ -109,3 +96,19 @@ class ButtonUtils:
             raise RuntimeError(f"Input button with id '{id}' not found or not clickable.") from e
 
         ButtonUtils.__click(wait, component)
+
+    @staticmethod
+    def checkButtonExistsByLabelText(wait: WebDriverWait, label: str):
+        try:
+            ButtonUtils.__findByLabelText(wait, label)
+        except Exception:
+            return False
+        return True
+
+    @staticmethod
+    def checkButtonExistsByPartialLabelText(wait: WebDriverWait, label: str):
+        try:
+            ButtonUtils.__findByLabelText(wait, label)
+        except Exception:
+            return False
+        return True

robo_appian/components/InputUtils.py

@@ -1,5 +1,4 @@
 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
@@ -19,70 +18,53 @@ class InputUtils:
     """
 
     @staticmethod
-    def __findInputComponentsByXpath(wait: WebDriverWait, xpath: str):
+    def __findComponentByPartialLabel(wait: WebDriverWait, label: str):
         """
-        Finds input components by their XPath.
+        Finds an input component by its label text, allowing for partial matches.
 
         Parameters:
             wait: Selenium WebDriverWait instance.
-            xpath: The XPath expression to locate the input components.
+            label: The visible text label of the input component, allowing for partial matches.
 
         Returns:
-            A list of Selenium WebElement representing the input components.
+            A Selenium WebElement representing the input component.
 
         Example:
-            InputUtils.__findInputComponentsByXpath(wait, './/div/label[normalize-space(.)="Username"]')
+            InputUtils.__findInputComponentByPartialLabel(wait, "User")
         """
-        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.
+        xpath = f'.//div/label[contains(normalize-space(.), "{label}")]'
+        label_component = ComponentUtils.findVisibleComponentByXpath(wait, xpath)
 
-        Returns:
-            A list of Selenium WebElement representing the input components.
+        input_id = label_component.get_attribute("for")
+        if input_id is None:
+            raise ValueError(f"Label component with text '{label}' does not have a 'for' attribute.")
 
-        Example:
-            InputUtils.__findInputComponentsByPartialLabel(wait, "Username")
-        """
-        xpath = f'.//div/label[contains(normalize-space(.), "{label}")]'
-        components = InputUtils.__findInputComponentsByXpath(wait, xpath)
-        return components
+        component = ComponentUtils.findComponentById(wait, input_id)
+        return component
 
     @staticmethod
-    def __findComponentsByLabel(wait: WebDriverWait, label: str):
-        """Finds input components by their label text.
-
+    def __findComponentByLabel(wait: WebDriverWait, label: str):
+        """Finds a component by its 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.
+            A Selenium WebElement representing the input component.
 
         Example:
-            InputUtils.__findComponentsByLabel(wait, "Username")
+            InputUtils.__findComponentByLabel(wait, "Username")
         """
+
         xpath = f'.//div/label[normalize-space(.)="{label}"]'
-        components = InputUtils.__findInputComponentsByXpath(wait, xpath)
-        return components
+        label_component = ComponentUtils.findVisibleComponentByXpath(wait, xpath)
+        input_id = label_component.get_attribute("for")
+        if input_id is None:
+            raise ValueError(f"Label component with text '{label}' does not have a 'for' attribute.")
+
+        component = ComponentUtils.findComponentById(wait, input_id)
+        return component
 
     @staticmethod
     def _setValueByComponent(wait: WebDriverWait, component: WebElement, value: str):
@@ -102,26 +84,20 @@ class InputUtils:
         return component
 
     @staticmethod
-    def __setValueByComponents(wait: WebDriverWait, input_components, value: str):
+    def setValueByPartialLabelText(wait: WebDriverWait, label: str, value: str):
         """
-        Sets a value in an input component identified by its label text.
+        Sets a value in an input component identified by its partial label text.
+
         Parameters:
             wait: Selenium WebDriverWait instance.
-            label: The visible text label of the input component.
+            label: The visible text label of the input component (partial match).
             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(wait, component, value)
-
-    @staticmethod
-    def setValueByPartialLabelText(wait: WebDriverWait, label: str, value: str):
-        input_components = InputUtils.__findInputComponentsByPartialLabel(wait, label)
-        InputUtils.__setValueByComponents(wait, input_components, value)
+        component = InputUtils.__findComponentByPartialLabel(wait, label)
+        InputUtils._setValueByComponent(wait, component, value)
 
     @staticmethod
     def setValueByLabelText(wait: WebDriverWait, label: str, value: str):
@@ -139,17 +115,17 @@ class InputUtils:
         Example:
             InputUtils.setValueByLabelText(wait, "Username", "test_user")
         """
-        input_components = InputUtils.__findComponentsByLabel(wait, label)
-        InputUtils.__setValueByComponents(wait, input_components, value)
+        component = InputUtils.__findComponentByLabel(wait, label)
+        InputUtils._setValueByComponent(wait, component, value)
 
     @staticmethod
-    def setValueById(wait: WebDriverWait, component_id: str, value: str):
+    def setValueById(wait: WebDriverWait, 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.
+            id: The ID of the input component.
             value: The value to set in the input field.
 
         Returns:
@@ -158,9 +134,28 @@ class InputUtils:
         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}")
+        # 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}")
+        component = ComponentUtils.findComponentById(wait, id)
+        InputUtils._setValueByComponent(wait, component, value)
+
+    @staticmethod
+    def setValueByPlaceholderText(wait: WebDriverWait, text: str, value: str):
+        """Sets a value in an input component identified by its placeholder text.
+
+        Parameters:
+            wait: Selenium WebDriverWait instance.
+            text: The placeholder text of the input component.
+            value: The value to set in the input field.
+
+        Returns:
+            None
+
+        Example:
+            InputUtils.setValueByPlaceholderText(wait, "Enter your name", "John Doe")
+        """
+        xpath = f'.//input[@placeholder="{text}"]'
+        component = ComponentUtils.findVisibleComponentByXpath(wait, xpath)
         InputUtils._setValueByComponent(wait, component, value)
-        return component

robo_appian/components/LabelUtils.py

@@ -1,6 +1,6 @@
-from selenium.webdriver.common.by import By
 from selenium.webdriver.support import expected_conditions as EC
 from selenium.webdriver.support.ui import WebDriverWait
+from robo_appian.utils.ComponentUtils import ComponentUtils
 
 
 class LabelUtils:
@@ -26,7 +26,8 @@ class LabelUtils:
         """
         xpath = f".//*[normalize-space(.)='{label}']"
         try:
-            component = wait.until(EC.visibility_of_element_located((By.XPATH, xpath)))
+            # component = wait.until(EC.visibility_of_element_located((By.XPATH, xpath)))
+            component = ComponentUtils.findVisibleComponentByXpath(wait, xpath)
         except Exception as e:
             raise RuntimeError(f"Label with text '{label}' not found.") from e
 

robo_appian/components/TabUtils.py

@@ -1,5 +1,7 @@
 from selenium.webdriver.common.by import By
 from selenium.webdriver.support import expected_conditions as EC
+from selenium.webdriver.support.ui import WebDriverWait
+from selenium.webdriver.remote.webelement import WebElement
 from robo_appian.utils.ComponentUtils import ComponentUtils
 
 
@@ -22,9 +24,16 @@ class TabUtils:
 
         driver.quit()
     """
+    @staticmethod
+    def __click(wait: WebDriverWait, component: WebElement, label: str):
+        try:
+            component = wait.until(EC.element_to_be_clickable(component))
+            component.click()
+        except Exception:
+            raise Exception(f"Tab with label '{label}' is not clickable.")
 
     @staticmethod
-    def findTabByLabelText(wait, label):
+    def findTabByLabelText(wait: WebDriverWait, label: str) -> WebElement:
         xpath = f'//div/div[@role="link" ]/div/div/div/div/div/p[normalize-space(.)="{label}"]'
         try:
             component = wait.until(EC.visibility_of_element_located((By.XPATH, xpath)))
@@ -33,16 +42,12 @@ class TabUtils:
         return component
 
     @staticmethod
-    def selectTabByLabelText(wait, label):
+    def selectTabByLabelText(wait: WebDriverWait, label: str):
         component = TabUtils.findTabByLabelText(wait, label)
-        try:
-            component = wait.until(EC.element_to_be_clickable(component))
-        except Exception:
-            raise Exception(f"Tab with label '{label}' is not clickable.")
-        component.click()
+        TabUtils.__click(wait, component, label)
 
     @staticmethod
-    def checkTabSelectedByLabelText(wait, label):
+    def checkTabSelectedByLabelText(wait: WebDriverWait, label: str):
         component = TabUtils.findTabByLabelText(wait, label)
 
         select_text = "Selected Tab."

robo_appian/utils/ComponentUtils.py

@@ -73,21 +73,31 @@ class ComponentUtils:
         xpath = "//button[@id='submit']"
         ComponentUtils.findComponentUsingXpathAndClick(wait, xpath)
         """
-        component = ComponentUtils.findComponentUsingXpath(wait, xpath)
+        component = ComponentUtils.findVisibleComponentByXpath(wait, xpath)
         component.click()
 
     @staticmethod
-    def findComponentUsingXpath(wait: WebDriverWait, xpath: str):
-        """Finds a component using the given XPath in the current WebDriver instance.
+    def findComponentById(wait: WebDriverWait, id: str):
+        try:
+            component = wait.until(EC.presence_of_element_located((By.ID, id)))
+        except Exception:
+            raise Exception(f"Component with ID '{id}' not found.")
+        return component
+
+    @staticmethod
+    def findVisibleComponentByXpath(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
 
-        :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 = ComponentUtils.findVisibleComponentByXpath(wait, "//button[@id='submit']")
+            component.click()
         """
-        component = wait.until(EC.presence_of_element_located((By.XPATH, xpath)))
+        component = wait.until(EC.visibility_of_element_located((By.XPATH, xpath)))
         return component
 
     @staticmethod
@@ -95,7 +105,7 @@ class ComponentUtils:
         """Checks if a component with the given XPath exists in the current WebDriver instance."""
         status = False
         try:
-            ComponentUtils.findComponentUsingXpath(wait, xpath)
+            ComponentUtils.findVisibleComponentByXpath(wait, xpath)
             status = True
         except NoSuchElementException:
             pass

{robo_appian-0.0.17.dist-info → robo_appian-0.0.19.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: robo_appian
-Version: 0.0.17
+Version: 0.0.19
 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.17.dist-info → robo_appian-0.0.19.dist-info}/RECORD

@@ -1,22 +1,22 @@
 robo_appian/__init__.py,sha256=6u9n2W7P1IKSSr5IPGsg7LhVR1o1uYv424mXDjJLgb0,720
-robo_appian/components/ButtonUtils.py,sha256=qFe84Pv3J64X2oqBvbOEnyZPudcCOK_Rrz-PAEAahM4,3874
+robo_appian/components/ButtonUtils.py,sha256=4zF7lDvn1DMIX3nI7Nl9glC1NYfFpvVj43a8N215Bx4,3990
 robo_appian/components/DateUtils.py,sha256=3iptq3IDCy4IwefEyPtvEQ1nUFI1OVpTF3dAnViHIoM,3258
 robo_appian/components/DropdownUtils.py,sha256=X_ucR4uCiU3fnsMXGnJC9PTfwbfW3w3ulzyuURh1Vlw,11149
-robo_appian/components/InputUtils.py,sha256=LNPNX2TYubPS7sgOx329JPixTrbtZZ7XhhpUolC9XYw,6514
-robo_appian/components/LabelUtils.py,sha256=Fue3BDpqvHKGK_vBOtMld3Lai3ZQ2wzZPeQJESrjUF8,1860
+robo_appian/components/InputUtils.py,sha256=78O7G8mNjEBVdrZUjlL9PMvDzTZ9uHEm0rDB5MsuYRQ,6050
+robo_appian/components/LabelUtils.py,sha256=d0IUm330RokFRny3CdRGNOzGtDHYqZT0WzVS1TgSscI,1958
 robo_appian/components/LinkUtils.py,sha256=_m9dpHW9mUJFMcLp95K2s-YDYAvG-RlPF6giw3dmYcE,1389
 robo_appian/components/SearchDropdownUtils.py,sha256=rjsC3kd8Z-eHAAzF4OBJVchStRV5pCB2dtpVEL6cdCQ,4519
 robo_appian/components/SearchInputUtils.py,sha256=7sI8D6MXDzBPwbkIQodtxvXD2aA-8HiqvDCEJUlekZo,3263
-robo_appian/components/TabUtils.py,sha256=uW90mZxO1OaU79NKarC62dVyBsKPjbCkjyh004TH2fo,1923
+robo_appian/components/TabUtils.py,sha256=k-HkIK8ca-KnHXSDTXDV4190jT5P84tZ3frWSCndn5I,2257
 robo_appian/components/TableUtils.py,sha256=SmtB4jq0XGZc0smMTe1HRvcCurQTXz3CytswbogfwTY,6059
 robo_appian/components/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 robo_appian/controllers/ComponentDriver.py,sha256=jNaQrbKCFFyahpLKmipsA0v3p3bpjy9dMgW36IdE-Fw,4353
 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=sHHT-mcdhZs9hHIAVD3KkrgLFXn4gIo58NsHHhI156w,7088
+robo_appian/utils/ComponentUtils.py,sha256=AR9Z_RYH939KZv4yX2cpilIaZ83-DVXWCYUcuke81iE,7424
 robo_appian/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-robo_appian-0.0.17.dist-info/LICENSE,sha256=g-xR4dRa9_4iFkMoJmED-wE-J5hoxbk3105Knhfpjm0,1068
-robo_appian-0.0.17.dist-info/METADATA,sha256=JBsZBNYNEG84cOfOJXYNbQYmu-VVK0PeXVld9QnajOw,2261
-robo_appian-0.0.17.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
-robo_appian-0.0.17.dist-info/RECORD,,
+robo_appian-0.0.19.dist-info/LICENSE,sha256=g-xR4dRa9_4iFkMoJmED-wE-J5hoxbk3105Knhfpjm0,1068
+robo_appian-0.0.19.dist-info/METADATA,sha256=RW32QbdJS10nDZOjv74t8j_E0VeQe-Cn7pHjjUxSXSU,2261
+robo_appian-0.0.19.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
+robo_appian-0.0.19.dist-info/RECORD,,