Seleasy

A simplified Selenium wrapper library with a clean, chainable API for common browser automation tasks. Built on top of Selenium WebDriver and BeautifulSoup4.

Installation

pip install seleasy

Quick Start

from seleasy import Seleasy

# Initialize with your preferred browser
es = Seleasy(browser='edge')  # or 'chrome', 'firefox', 'safari'

# Navigate to a URL
es.get('https://www.example.com')

# Wait for and click an element
es.click_element('button', 'text', 'Login', delay=10)

# Type text into an input
es.input_text('input', 'id', 'username', text='myuser')

# Use JavaScript mode when the normal input/click path is intercepted
es.input_text('input', 'id', 'username', text='myuser', use_js=True)
es.click_element('button', 'text', 'Login', use_js=True)

# Scroll the page in fixed increments
es.roll_move('div', 'class', 'content-area', delta_y=400)

# Move the wheel to a target element, including elements far below the viewport
es.roll_to_element('button', 'id', 'submit')

# Get page source
html = es.get_html_source('page.html')

# Parse with BeautifulSoup
soup = es.get_soup()

# Clean up
es.quit()

Features

• Multi-browser support: Edge, Chrome, Firefox, Safari
• Smart element location: Find elements by tag + attribute + value
• Auto-wait: Built-in WebDriverWait with configurable timeout
• Optional JS interactions: Click or enter text via JavaScript to bypass interception
• Scroll & hover: Wheel scrolling, wheel-to-element, smooth scrollIntoView, hover actions
• iframe management: Switch into/out of frames with simple API
• BeautifulSoup integration: Parse page HTML directly
• Screenshots & page source: Save screenshots and HTML with one line

JavaScript Interaction Mode

use_js defaults to False, so calls use Selenium's normal browser interactions unless JavaScript is explicitly requested.

# Normal Selenium click and text input
es.click_element('button', 'id', 'submit')
es.input_text('input', 'id', 'username', text='myuser')

# JavaScript mode
es.click_element('button', 'id', 'submit', use_js=True)
es.input_text('input', 'id', 'username', text='myuser', use_js=True)

JavaScript text input uses the native input value setter and dispatches input and change events so React, Vue, and other listeners can observe the new value. It cannot bypass websites that explicitly require trusted keyboard events.

Supported Browsers

Requirements

• Python 3.8+
• selenium >= 4.0.0
• beautifulsoup4 >= 4.9.0
• A matching WebDriver for your browser (managed automatically by Selenium Manager)

License

MIT