Functions to make life with Selenium easier.
Project description
webdrivertools
A Python library providing utility functions for simplifying interactions with Selenium, the popular web testing and automation framework.
webdrivertools exports three core functions:
click_element_area
find_element
click
These functions can be imported using:
from webdrivertools import click_element_area, find_element, click
Requirements
- Python 3.10+
- Selenium
Installation
To install webdrivertools, simply run:
pip install webdrivertools
Functions
click_element_area
click_element_area(driver: WebDriver, element: WebElement) -> None
Click on the element area, even if it is covered by an overlay. This function is useful when dealing with elements obstructed by modal overlays or other overlapping elements, which may cause issues when attempting to interact with the intended element using Selenium.
find_element
find_element(driver: WebDriver, value: str, by: str = By.CSS_SELECTOR, innerText: str | None = None) -> WebElement
Find a single HTML element within a webdriver page by attribute or criteria and optional inner text filtering, returning the matched WebElement.
click(driver: WebDriver, value: str, by: str = By.CSS_SELECTOR, innerText: str | None = None, retries: int = 3, sleep_between_retries: float = 1) -> None
Click on an element with an optional innerText filter. Number of retries and sleep between retries can be tweaked according to requirements.
Usage
from selenium import webdriver
from selenium.webdriver.common.by import By
from webdrivertools import click, find_element
# Instantiate a WebDriver instance
driver = webdriver.Chrome()
# Navigate to a webpage
driver.get("https://example.com")
# Find and click a button with a specific CSS selector and innerText
click(driver, ".button-class", By.CSS_SELECTOR, "Submit")
# Find an element using an xpath and optional innerText filtering
element = find_element(driver, '//div[contains(@class, "target-element")]', By.XPATH, "Target Text")
# Click on an area of the element even if it's covered by an overlay
click_element_area(driver, element)
# Close the webdriver instance
driver.quit()
License
MIT License
Contributing
Contributions are welcome. Please create a new issue or a pull request with your proposed changes.
Support
If you encounter any issues, please create a new issue on the GitHub repository.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for webdrivertools-0.0.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1ca6a57991dbbdaba60e4c6ca9581cefd2fca7cd05dc05e27cb87303c8d80694 |
|
MD5 | 39d79a5a4d4d9ef0e380161f2a495c73 |
|
BLAKE2b-256 | 0085ac3ac66c28c843875823f378826be62260bc796a54d86e832abd8cd79381 |