selmate 1.0.1__tar.gz

selmate-1.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 FINWAX
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

selmate-1.0.1/PKG-INFO

@@ -0,0 +1,140 @@
+Metadata-Version: 2.3
+Name: selmate
+Version: 1.0.1
+Summary: A utility library for Selenium WebDriver to enable human-like interactions, robust exception handling, and web automation tasks like popup handling and URL normalization.
+License: MIT License
+         
+         Copyright (c) 2025 FINWAX
+         
+         Permission is hereby granted, free of charge, to any person obtaining a copy
+         of this software and associated documentation files (the "Software"), to deal
+         in the Software without restriction, including without limitation the rights
+         to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+         copies of the Software, and to permit persons to whom the Software is
+         furnished to do so, subject to the following conditions:
+         
+         The above copyright notice and this permission notice shall be included in all
+         copies or substantial portions of the Software.
+         
+         THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+         IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+         FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+         AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+         LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+         OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+         SOFTWARE.
+Keywords: selenium,web automation,human-like,web scraping,browser automation,popup handling,url normalization,testing
+Author: FINWAX
+Author-email: waxbid@gmail.com
+Requires-Python: >=3.10
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Testing
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Requires-Dist: beautifulsoup4 (>=4.13.4,<5.0.0)
+Requires-Dist: lxml (>=5.4.0,<6.0.0)
+Requires-Dist: rapidfuzz (>=3.13.0,<4.0.0)
+Requires-Dist: selenium (>=4.33.0,<5.0.0)
+Project-URL: Homepage, https://github.com/FINWAX/selmate.py
+Project-URL: Repository, https://github.com/FINWAX/selmate.py
+Description-Content-Type: text/markdown
+
+# Selmate
+
+Selmate is a Python utility library designed to enhance Selenium WebDriver automation by providing human-like
+interactions, robust exception handling, and utilities for common web automation tasks. It simplifies interactions with
+web elements, handles popups, normalizes URLs, and simulates natural user behavior like mouse movements and scrolling.
+
+## Features
+
+- **Safe Element Interactions**: Wrappers for Selenium operations (clicks, scrolls, etc.) with built-in exception
+  handling for stale elements, timeouts, and more.
+- **Human-Like Behavior**: Simulates realistic mouse movements, scrolling, and latency to mimic human interactions.
+- **Popup Handling**: Automatically detects and handles popup banners, including those within iframes, with options to
+  accept or close them.
+- **URL Normalization**: Utilities to normalize URLs relative to a base URL, with configurable handling of query
+  strings, fragments, and parameters.
+- **JavaScript Integration**: Execute JavaScript for advanced interactions like smooth scrolling, element removal, and
+  visibility checks.
+- **Text Similarity**: Identify confirmation buttons or close buttons using fuzzy text matching.
+
+## Installation
+
+Install Selmate via pip:
+
+```bash
+pip install selmate
+```
+
+## Usage
+
+Here are some examples of using Selmate's core functionalities:
+
+### Example 1: Safe Element Click
+
+```python
+from selenium import webdriver
+from selmate.composites import complex_click
+from selmate.selenium_primitives import find_element_safely
+from selenium.webdriver.common.by import By
+
+driver = webdriver.Chrome()
+driver.get("https://example.com")
+
+# Safely find and click a button
+button = find_element_safely(By.ID, "submit-button", driver)
+if button and complex_click(button, driver):
+    print("Button clicked successfully")
+
+driver.quit()
+```
+
+### Example 2: Handling Popup Banners
+
+```python
+from selenium import webdriver
+from selmate.composites import bypass_popup_banners
+
+driver = webdriver.Chrome()
+driver.get("https://example.com")
+
+# Automatically handle popup banners
+bypass_popup_banners(driver, observation_capacity=50, success_capacity=3, try_close=True)
+print("Popups handled")
+
+driver.quit()
+```
+
+### Example 3: Human-Like Mouse Movement
+
+```python
+from selenium import webdriver
+from selmate.composites import wander_between_2_elements
+from selmate.selenium_primitives import find_element_safely
+from selenium.webdriver.common.by import By
+
+driver = webdriver.Chrome()
+driver.get("https://example.com")
+
+# Find two elements and simulate mouse movement between them
+element1 = find_element_safely(By.ID, "element1", driver)
+element2 = find_element_safely(By.ID, "element2", driver)
+if element1 and element2:
+    wander_between_2_elements(element1, element2, driver)
+
+driver.quit()
+```
+
+## License
+
+Selmate is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
+
+## Contact
+
+For questions or support, open an issue or contact the maintainer at waxbid@gmail.com.

selmate-1.0.1/README.md

@@ -0,0 +1,93 @@
+# Selmate
+
+Selmate is a Python utility library designed to enhance Selenium WebDriver automation by providing human-like
+interactions, robust exception handling, and utilities for common web automation tasks. It simplifies interactions with
+web elements, handles popups, normalizes URLs, and simulates natural user behavior like mouse movements and scrolling.
+
+## Features
+
+- **Safe Element Interactions**: Wrappers for Selenium operations (clicks, scrolls, etc.) with built-in exception
+  handling for stale elements, timeouts, and more.
+- **Human-Like Behavior**: Simulates realistic mouse movements, scrolling, and latency to mimic human interactions.
+- **Popup Handling**: Automatically detects and handles popup banners, including those within iframes, with options to
+  accept or close them.
+- **URL Normalization**: Utilities to normalize URLs relative to a base URL, with configurable handling of query
+  strings, fragments, and parameters.
+- **JavaScript Integration**: Execute JavaScript for advanced interactions like smooth scrolling, element removal, and
+  visibility checks.
+- **Text Similarity**: Identify confirmation buttons or close buttons using fuzzy text matching.
+
+## Installation
+
+Install Selmate via pip:
+
+```bash
+pip install selmate
+```
+
+## Usage
+
+Here are some examples of using Selmate's core functionalities:
+
+### Example 1: Safe Element Click
+
+```python
+from selenium import webdriver
+from selmate.composites import complex_click
+from selmate.selenium_primitives import find_element_safely
+from selenium.webdriver.common.by import By
+
+driver = webdriver.Chrome()
+driver.get("https://example.com")
+
+# Safely find and click a button
+button = find_element_safely(By.ID, "submit-button", driver)
+if button and complex_click(button, driver):
+    print("Button clicked successfully")
+
+driver.quit()
+```
+
+### Example 2: Handling Popup Banners
+
+```python
+from selenium import webdriver
+from selmate.composites import bypass_popup_banners
+
+driver = webdriver.Chrome()
+driver.get("https://example.com")
+
+# Automatically handle popup banners
+bypass_popup_banners(driver, observation_capacity=50, success_capacity=3, try_close=True)
+print("Popups handled")
+
+driver.quit()
+```
+
+### Example 3: Human-Like Mouse Movement
+
+```python
+from selenium import webdriver
+from selmate.composites import wander_between_2_elements
+from selmate.selenium_primitives import find_element_safely
+from selenium.webdriver.common.by import By
+
+driver = webdriver.Chrome()
+driver.get("https://example.com")
+
+# Find two elements and simulate mouse movement between them
+element1 = find_element_safely(By.ID, "element1", driver)
+element2 = find_element_safely(By.ID, "element2", driver)
+if element1 and element2:
+    wander_between_2_elements(element1, element2, driver)
+
+driver.quit()
+```
+
+## License
+
+Selmate is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
+
+## Contact
+
+For questions or support, open an issue or contact the maintainer at waxbid@gmail.com.

selmate-1.0.1/pyproject.toml

@@ -0,0 +1,40 @@
+[project]
+name = "selmate"
+version = "1.0.1"
+description = "A utility library for Selenium WebDriver to enable human-like interactions, robust exception handling, and web automation tasks like popup handling and URL normalization."
+authors = [{ name = "FINWAX", email = "waxbid@gmail.com" }]
+license = { file = "LICENSE" }
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+    "selenium (>=4.33.0,<5.0.0)",
+    "rapidfuzz (>=3.13.0,<4.0.0)",
+    "beautifulsoup4 (>=4.13.4,<5.0.0)",
+    "lxml (>=5.4.0,<6.0.0)"
+]
+keywords = ["selenium", "web automation", "human-like", "web scraping", "browser automation", "popup handling", "url normalization", "testing"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "Topic :: Software Development :: Testing",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Operating System :: OS Independent",
+]
+
+[project.urls]
+Homepage = "https://github.com/FINWAX/selmate.py"
+Repository = "https://github.com/FINWAX/selmate.py"
+
+[tool.poetry]
+
+[tool.poetry.group.dev.dependencies]
+docker-chrome-session-manager = "^1.0.2"
+
+[build-system]
+requires = ["poetry-core>=2.0.0,<3.0.0"]
+build-backend = "poetry.core.masonry.api"

selmate-1.0.1/selmate/__init__.py

@@ -0,0 +1,3 @@
+import logging
+
+logging.getLogger(__name__).addHandler(logging.NullHandler())