Skip to main content

WebDriver Plus.

Project description

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.

Note: If you’re interested in helping maintain WebDriver Plus in the long term please get in touch. Most of the author’s open source time is currently devoted to working on Django REST framework.

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&amp;rct=j&amp;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&amp;tname...
  <h3 class="r"><a href="http://www.patient.co.uk/doctor/Selenium.htm" class=...
  <h3 class="r"><a href="/search?q=selenium&amp;hl=en&amp;biw=940&amp;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:

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

This version
History Node

0.1.5

History Node

0.1.4

History Node

0.1.3

History Node

0.1.2

History Node

0.1.1

History Node

0.1.0

History Node

0.0.4

History Node

0.0.3

History Node

0.0.2

History Node

0.0.1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
webdriverplus-0.1.5.tar.gz (12.9 kB) Copy SHA256 hash SHA256 Source None May 31, 2013

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page