Selenium Client Driver

Introduction

Python language bindings for Selenium WebDriver.

The selenium package is used automate web browser interaction from Python.

Home:	http://www.seleniumhq.org
Docs:	https://seleniumhq.github.io/selenium/docs/api/py/api.html
Dev:	https://github.com/SeleniumHQ/selenium
PyPI:	https://pypi.python.org/pypi/selenium
IRC:	#selenium channel on freenode

Several browsers/drivers are supported (Firefox, Chrome, Internet Explorer, PhantomJS), as well as the Remote protocol.

Supported Python Versions

Python 2.6, 2.7
Python 3.2+

Installing

If you have pip on your system, you can simply install or upgrade the Python bindings:

pip install -U selenium

Alternately, you can download the source distribution from PyPI (e.g. selenium-2.53.2.tar.gz), unarchive it, and run:

python setup.py install

Note: both of the methods described above install selenium as a system-wide package That will require administrative/root access to ther machine. You may consider using a virtualenv to create isolated Python environments instead.

Example 0:

open a new Firefox browser
load the page at the given URL

from selenium import webdriver

browser = webdriver.Firefox()
browser.get('http://seleniumhq.org/')

Example 1:

open a new Firefox browser
load the Yahoo homepage
search for “seleniumhq”
close the browser

from selenium import webdriver
from selenium.webdriver.common.keys import Keys

browser = webdriver.Firefox()

browser.get('http://www.yahoo.com')
assert 'Yahoo' in browser.title

elem = browser.find_element_by_name('p')  # Find the search box
elem.send_keys('seleniumhq' + Keys.RETURN)

browser.quit()

Example 2:

Selenium WebDriver is often used as a basis for testing web applications. Here is a simple example uisng Python’s standard unittest library:

import unittest

class GoogleTestCase(unittest.TestCase):

    def setUp(self):
        self.browser = webdriver.Firefox()
        self.addCleanup(self.browser.quit)

    def testPageTitle(self):
        self.browser.get('http://www.google.com')
        self.assertIn('Google', self.browser.title)

if __name__ == '__main__':
    unittest.main(verbosity=2)

Selenium Server (optional)

For normal WebDriver scripts (non-Remote), the Java server is not needed.

However, to use Selenium Webdriver Remote or the legacy Selenium API (Selenium-RC), you need to also run the Selenium server. The server requires a Java Runtime Environment (JRE).

Download the server separately, from: http://selenium-release.storage.googleapis.com/2.53/selenium-server-standalone-2.53.0.jar

Run the server from the command line:

java -jar selenium-server-standalone-2.53.0.jar

Then run your Python client scripts.

Use The Source Luke!

View source code online at https://github.com/SeleniumHQ/selenium/tree/master/py/

Metadata

Release files for selenium 2.53.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for selenium 2.53.6
File	Size	Uploaded
selenium-2.53.6.tar.gz	816.6 kB	Jun 28, 2016	Details

Built distribution (wheel)

Table of built distributions (wheels) for selenium 2.53.6
File	Interpreter	ABI	Platform	Reset
selenium-2.53.6-py2.py3-none-any.whl 884.6 kB Jun 28, 2016	Python 2, Python 3	none	any	Details

Total release size: 1.7 MB

Release files / selenium-2.53.6.tar.gz

Download URL	selenium-2.53.6.tar.gz
Size	816.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`f507181f13768d73b98dd9647a466ea5758ef5c7f07b62a285d2bd8de9b27016`
BLAKE2b-256 checksum How to use checksums	`c9d44c032f93dd8d198d51d06ce41005d02ae2e806d4e5b550255ddbeee4143b`
Upload date	Jun 28, 2016
Uploaded using Trusted Publishing? What is trusted publishing?	No

Release files / selenium-2.53.6-py2.py3-none-any.whl

Download URL	selenium-2.53.6-py2.py3-none-any.whl
Size	884.6 kB
Tags	Python 2 Python 3
SHA-256 checksum How to use checksums	`5071f43daa2e698d60d5633ab0a6630cc68a852b360be99144f1c4c1ace2746c`
BLAKE2b-256 checksum How to use checksums	`3ff8e46684764161fee7b7d2e0fd9b82d56915438b68e498181dc45183643c82`
Upload date	Jun 28, 2016
Uploaded using Trusted Publishing? What is trusted publishing?	No