EasySelenium

A simplified Selenium wrapper library with a clean, chainable API for common browser automation tasks.

Installation

pip install seleasy

Quick Start

from seleasy import EasySelenium

# Initialize with your preferred browser
es = EasySelenium(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')

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

# 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
• JS clicks: Click via JavaScript to bypass overlay issues
• Scroll & hover: Mouse wheel scroll, 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

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