Fluent Selectors

A Python library for creating a readable, fluent API for Selenium browser automation.

Installation

Install the package using pip:

pip install fluent-selectors

Usage

Here's a simple example of how to use fluent-selectors:

from selenium import webdriver
from fluent_selectors import ClassNameLocator, IdLocator, NameLocator, Selector

# Initialize the WebDriver
driver = webdriver.Chrome()
driver.get("http://www.python.org")

# Create a Selector instance
s = Selector(driver)

# Select an element and interact with it
search_bar = s.select(NameLocator("q"))
search_bar.set_text("pycon")

go_button = s.select(IdLocator("submit"))
go_button.click()

# Perform checks
assert bool(s.select(ClassNameLocator("list-recent-events")).is_displayed)

driver.quit()

API

Selector(driver: WebDriver, *locators: Locator)

The main class for selecting and interacting with elements.

Traversal and Selection

• select(locator: Locator) -> Selector: Select a descendant of the current element.
• child(index: int) -> Selector: Select a child by its index.
• children() -> list[Selector]: Get a list of all children selectors.
• parent: Selector | None: The parent selector.
• parents: list[Selector]: A list of all parent selectors.

Element Actions

• click(): Clicks the element.
• type_text(text: str): Types text into the element.
• clear(): Clears the text from the element.
• set_text(text: str): Clears the element and then types text into it.
• upload_file(path: Path): Uploads a file to a file input element.
• scroll_into_view(): Scrolls the element into view.

Element Properties

• element: WebElement | None: The Selenium WebElement.
• elements: list[WebElement]: A list of Selenium WebElements.
• text: str | None: The text of the element.
• tag_name: str | None: The tag name of the element.
• accessible_name: str | None: The accessible name of the element.
• aria_role: str | None: The ARIA role of the element.
• id: str | None: The ID of the element.
• location: Location | None: The location of the element.
• size: Size | None: The size of the element.
• attribute(name: str) -> str | None: The value of an attribute.

Checks

These methods return Check objects from the fluent-checks library.

• is_present: Checks if the element is present in the DOM.
• is_displayed: Checks if the element is visible.
• is_enabled: Checks if the element is enabled.
• is_selected: Checks if the element is selected.
• is_stale: Checks if the element is stale.
• has_text(text: str): Checks if the element's text contains the given text.
• has_exact_text(text: str): Checks if the element's text exactly matches the given text.
• has_attribute(name: str): Checks if the element has the given attribute.
• has_attribute_value(name: str, value: str): Checks if the attribute has the given value.

Example of a check:

bool(s.select(IdLocator("my-element")).is_displayed)
bool(s.select(IdLocator("my-element")).has_text("Hello"))

License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.