WebDriver Plus.
Project description
[![Build Status](https://secure.travis-ci.org/tomchristie/webdriverplus.png?branch=master)](http://travis-ci.org/tomchristie/webdriverplus)
The most simple and powerful way to use Selenium with Python
WebDriver Plus is an extension to the Python bindings for Selenium WebDriver, which gives you a more concise and expressive API.
It helps you to quickly write readable, robust tests.
What’s so great about WebDriver Plus?
Browser instances that support pooling and automatic quit on exit.
A concise API for finding elements, and a wide range of selectors.
JQuery-style traversal and filtering for locating elements without using complex xpath expressions.
Perform actions on elements without having to use ActionChains.
Element highlighting makes working from the Python console a joy.
WebDriver Plus is not yet ready for use. It is in active development. Contributions welcome!
Getting started
Install webdriverplus using pip.
pip install webdriverplus
Now fire up your Python console…
>>> from webdriverplus import WebDriver >>> browser = WebDriver().get('http://www.google.com')
Ok, let’s do a search.
>>> browser.find(name='q').send_keys('selenium\n')
Now let’s get the headings for all the search results.
>>> browser.find(id='search').find('h3') WebElementSet( <h3 class="r"><a href="http://seleniumhq.org/" class="l" onmousedown="retur... <h3 class="r"><a href="http://www.google.co.uk/url?sa=t&rct=j&q=sel... <h3 class="r"><a href="http://en.wikipedia.org/wiki/Selenium" class="l" onm... <h3 class="r"><a href="http://en.wikipedia.org/wiki/Selenium_%28software%29... <h3 class="r"><a href="http://ods.od.nih.gov/factsheets/selenium" class="l"... <h3 class="r"><a href="http://www.nlm.nih.gov/medlineplus/druginfo/natural/... <h3 class="r"><a href="http://www.hollandandbarrett.com/selenium-050" class... <h3 class="r"><a href="http://www.whfoods.com/genpage.php?dbid=95&tname... <h3 class="r"><a href="http://www.patient.co.uk/doctor/Selenium.htm" class=... <h3 class="r"><a href="/search?q=selenium&hl=en&biw=940&bih=938... <h3 class="r"><a href="http://www.umm.edu/altmed/articles/selenium-000325.h... )
Notice that WebDriver Plus has highlighted the selected elements for you, which is super helpful for when you’re writing tests and trying to make sure you’re selecting the correct elements:
![image](https://raw.github.com/tomchristie/webdriverplus/master/docs/screenshot.png)
Next steps
When you’re ready to get going, head over to the [full documentation](http://webdriver-plus.readthedocs.org/).
If you want to help contribute to the project, please read the [contribution notes](http://webdriver-plus.readthedocs.org/en/latest/topics/contributing.html).
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.