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

robo_appian/utils/__init__.py

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

robo_appian/utils/components/__init__.py

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

robo_appian/utils/controllers/__init__.py

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

robo_appian/utils/exceptions/__init__.py

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

robo_appian-0.0.4.dist-info/METADATA

@@ -0,0 +1,163 @@
+Metadata-Version: 2.4
+Name: robo_appian
+Version: 0.0.4
+Summary: Selenium-based automation utilities for Appian applications
+Home-page: https://github.com/yourusername/robo_appian
+Author: Your Name
+Author-email: your.email@example.com
+Project-URL: Bug Reports, https://github.com/yourusername/robo_appian/issues
+Project-URL: Source, https://github.com/yourusername/robo_appian
+Project-URL: Documentation, https://robo-appian.readthedocs.io/
+Keywords: selenium,automation,testing,appian,ui
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Testing
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: selenium>=4.34.0
+Requires-Dist: requests>=2.25.0
+Requires-Dist: numpy>=1.21.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# Robo Appian
+
+**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.4.dist-info/RECORD

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

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

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

robo_appian-0.0.4.dist-info/top_level.txt

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

robo_appian_source_backup/__init__.py

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

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

@@ -45,15 +45,15 @@ class DropdownUtils:
         # It ensures that the dropdown is clickable and ready for interaction.
         # The dropdown component is expected to have a structure where the label is within a span inside a div.
 
-        xpath = f'.//div[./div/span[normalize-space(text())="{dropdown_label}"]]/div/div/div/div[@role="combobox" and @tabindex="0"]'
+        # xpath = f'.//div[./div/span[normalize-space(text())="{dropdown_label}"]]/div/div/div/div[@role="combobox" and @tabindex="0"]'
+        # V0.0.4
+        xpath = f'.//div[./div/span[contains(normalize-space(text()), "{dropdown_label}")]]/div/div/div/div[@role="combobox" and @tabindex="0"][0]'
         component = wait.until(EC.element_to_be_clickable((By.XPATH, xpath)))
         return component
 
     @staticmethod
     def selectValueUsingComponent(
-        wait: WebDriverWait, 
-        combobox: WebElement, 
-        value: str
+        wait: WebDriverWait, combobox: WebElement, value: str
     ) -> None:
         """
         Selects a value from a dropdown component using the provided combobox element.
@@ -74,7 +74,7 @@ class DropdownUtils:
             raise ValueError(f"Dropdown component object is not valid.")
 
         component: WebElement = combobox.find_element(By.XPATH, "./div/div")  # type: ignore[reportUnknownMemberType]
-        aria_controls = component.get_attribute("aria-controls") # type: ignore[reportUnknownMemberType]
+        aria_controls = component.get_attribute("aria-controls")  # type: ignore[reportUnknownMemberType]
         component.click()
 
         xpath = f'.//div/ul[@id="{aria_controls}"]/li[./div[normalize-space(text())="{value}"]]'
@@ -100,7 +100,7 @@ class DropdownUtils:
         # and then clicks on the dropdown to display the options.
 
         combobox = DropdownUtils.findDropdownEnabled(wait, label)
-        aria_controls = combobox.get_attribute("aria-controls") # type: ignore[reportUnknownMemberType]
+        aria_controls = combobox.get_attribute("aria-controls")  # type: ignore[reportUnknownMemberType]
         combobox.click()
 
         xpath = f'.//div/ul[@id="{aria_controls}"]/li[./div[normalize-space(text())="{value}"]]'
@@ -126,8 +126,8 @@ class DropdownUtils:
         # and the component ID, clicks on the dropdown to display the search input,
 
         component = DropdownUtils.findDropdownEnabled(wait, dropdown_label)
-        component_id = component.get_attribute("aria-labelledby") # type: ignore[reportUnknownMemberType]
-        aria_controls = component.get_attribute("aria-controls") # type: ignore[reportUnknownMemberType]
+        component_id = component.get_attribute("aria-labelledby")  # type: ignore[reportUnknownMemberType]
+        aria_controls = component.get_attribute("aria-controls")  # type: ignore[reportUnknownMemberType]
         component.click()
 
         input_component_id = str(component_id) + "_searchInput"

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

@@ -37,7 +37,9 @@ class InputUtils:
         # This method locates an input component that contains a label with the specified text.
         # It then retrieves the component's ID and uses it to find the actual input element.
 
-        xpath = f".//div/label[text()='{label}']"
+        # xpath = f".//div/label[text()='{label}']"
+        # V0.0.4        
+        xpath = f".//div/label[contains(normalize-space(text()), '{label}')]"
         component: WebElement = wait.until(
             EC.element_to_be_clickable((By.XPATH, xpath))
         )
@@ -175,9 +177,11 @@ class InputUtils:
         # and the component ID, clicks on the input to display the search input,
         # and sets the specified value in the search input field.
 
-        xpath = (
-            f".//div[./div/span[text()='{label}']]/div/div/div/input[@role='combobox']"
-        )
+        # xpath = (
+        #     f".//div[./div/span[text()='{label}']]/div/div/div/input[@role='combobox']"
+        # )
+        # V0.0.4
+        xpath = f".//div[./div/span[contains(normalize-space(text())='{label}']]/div/div/div/input[@role='combobox']"
         search_input_component = wait.until(
             EC.element_to_be_clickable((By.XPATH, xpath))
         )

robo_appian-0.0.3.dist-info/METADATA

@@ -1,91 +0,0 @@
-Metadata-Version: 2.3
-Name: robo_appian
-Version: 0.0.3
-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
-
-Python library for automating Appian web UI test cases!
-
-# Modules
-## Components
-
-    ButtonUtils: Find and click buttons.
-    DateUtils: Interact with date fields.
-    DropdownUtils: Interact with dropdowns.
-    InputUtils: Interact with input fields.
-    LabelUtils: Find labels.
-    LinkUtils: Click links.
-    TableUtils: Interact with tables.
-    TabUtils: Interact with tabs.
-    ComponentUtils: General utilities for components (input, dropdown, tab, etc).
-
-## Controllers
-
-    ComponentDriver: High-level interface to execute actions on components.
-
-## Exceptions
-
-    MyCustomError: Custom exception for specific error conditions.
-
-# Usage
-
-Import the utilities in your test scripts:
-
-from robo_appian import (
-    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.3.dist-info/RECORD

@@ -1,20 +0,0 @@
-robo_appian/__init__.py,sha256=AiMpl0fcPrlwMyUH0ZRzVYAlv4WY6e225XQCMuJa0Zk,779
-robo_appian/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-robo_appian/utils/components/ButtonUtils.py,sha256=Go_F2yJbGHho06notteHU3kXAdpA9EvXw1zm4zp260s,2204
-robo_appian/utils/components/ComponentUtils.py,sha256=-6CSRa2mBCPt9BrKXXO1cP6IsZ6Tle1X3rlfoJZlpjc,11779
-robo_appian/utils/components/DateUtils.py,sha256=r-4XnuGwA_cSHjWQub7-qoQQ29eBsG14uumXZkXpcDI,4615
-robo_appian/utils/components/DropdownUtils.py,sha256=GbH5iHvjunENhm5K4WUXEQhmsEtSBn54Z04Ow1QDEwE,6216
-robo_appian/utils/components/InputUtils.py,sha256=AlVbSNMXgbGa1eoTWSGJlOoaQxZxgsSKkhsA__FHRVA,7032
-robo_appian/utils/components/LabelUtils.py,sha256=5ovTy9OY-QtLS8UoBXeqi4MQDvlPqVWDnp7SIcXWkJw,1230
-robo_appian/utils/components/LinkUtils.py,sha256=T7dJ5xSXp436VXhczWrQHC13L5wXTXxxgAvBdyKuYM4,1420
-robo_appian/utils/components/TabUtils.py,sha256=_KsImdeVITxmotphaqVARwhOhAvs4CLWHlx9wr-qZTk,2070
-robo_appian/utils/components/TableUtils.py,sha256=W-5fpjRStCmSLlryeHvBiOH83qCXNHgeVukMS3iAs6o,8276
-robo_appian/utils/components/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-robo_appian/utils/controllers/ComponentDriver.py,sha256=Lzhlf7W85FjZn_0j9eybrgC8wSCzUEvsAbgbGNvTMLY,4128
-robo_appian/utils/controllers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-robo_appian/utils/exceptions/MyCustomError.py,sha256=DVAkytXNNQNjqyTyCjk6FFd6fr3AsBe57Y19erDSqVs,222
-robo_appian/utils/exceptions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-robo_appian-0.0.3.dist-info/LICENSE,sha256=g-xR4dRa9_4iFkMoJmED-wE-J5hoxbk3105Knhfpjm0,1068
-robo_appian-0.0.3.dist-info/METADATA,sha256=Vawue3RBemMAIGR0Eczb5_3BVm-vD-rj26yNox28FWQ,2586
-robo_appian-0.0.3.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
-robo_appian-0.0.3.dist-info/RECORD,,