seletools

What it is and what it does

Seletools is a collection of utility functions that extend WebDriver with features and workarounds not available natively. It addresses a known drag-and-drop bug in the WebDriver protocol by using JavaScript simulation instead, provides smart scrolling that accounts for fixed overlays like navbars, and adds convenience methods for interacting with browser storage (IndexedDB and Local Storage) and retrieving WebDriver wait configuration values.

The package is designed for developers writing test automation or web scraping scripts who encounter limitations in the native API. It has no external runtime dependencies, making it lightweight to add to existing projects. However, the repository has been dormant since 2024-05-12, so users should verify compatibility with their specific WebDriver version and browser environment before relying on it for new projects.

Use it for:

• Work around the known drag-and-drop bug by using JavaScript-based simulation instead of native WebDriver actions.
• Scroll to elements on pages with fixed headers or footers that would otherwise obscure the target element.
• Read and modify IndexedDB data during browser automation when you need to inspect or manipulate application state.
• Get and set Local Storage values programmatically without writing custom JavaScript snippets for each operation.
• Retrieve implicit wait, page load, and script timeout values from a WebDriver instance in versions prior to 4.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides helper functions for Selenium WebDriver that work around known bugs and add missing features like drag-and-drop, smart scrolling, wait introspection, and browser storage access.

Yes, if you are actively using WebDriver and encounter the specific issues it addresses (drag-and-drop, storage access, scrolling obstacles). The low install friction and permissive MIT license make it a safe addition. However, proceed with caution for new projects: the dormant maintenance status (no updates since 2024-05-12) means you should test compatibility with your WebDriver and browser versions first and be prepared to maintain a fork if critical issues arise.

Install

seletools on PyPI

pip install seletools

uv add seletools

poetry add seletools

Installing seletools

Before you install

Low friction installation with no runtime dependencies. Maintenance is dormant—last release was 2024-05-12 with no commits since—so expect no active bug fixes or updates, though the package remains functional for its current scope.

License in practice

MIT license permits free use, modification, and distribution with minimal restrictions, making it safe to use in commercial and open-source projects.

Quickstart

pip install seletools

from seletools.actions import drag_and_drop

driver = webdriver.Chrome()
source = driver.find_element(By.CSS_SELECTOR, "...")
target = driver.find_element(By.CSS_SELECTOR, "...")
drag_and_drop(driver, source, target)

Requires Python >=3.8 and an active WebDriver instance; IndexedDB features require logging enabled on the webdriver.

Verify before relying

• Current compatibility with WebDriver versions released after 2024-05-12
• Whether JavaScript-based drag-and-drop workaround remains effective in modern browser versions
• Active maintenance status and responsiveness to issues given dormant repository state

Package facts

Evidence: seletools-1.5.0-py3-none-any.whl

Tags

More Testing packages