======================
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**: | `selenium package API <http://selenium.googlecode.com/git/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, 3.3
Installing
==========
If you have `pip <http://www.pip-installer.org>`_ 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 <http://pypi.python.org/pypi/selenium>`_ (e.g. selenium-2.48.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 <http://www.virtualenv.org/>`_ 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 <http://docs.python.org/3/library/unittest.html>`_ 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.48/selenium-server-standalone-2.48.0.jar
Run the server from the command line::
java -jar selenium-server-standalone-2.48.8.jar
Then run your Python client scripts.
Use The Source Luke!
====================
View source code online at https://github.com/SeleniumHQ/selenium/tree/master/py/
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**: | `selenium package API <http://selenium.googlecode.com/git/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, 3.3
Installing
==========
If you have `pip <http://www.pip-installer.org>`_ 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 <http://pypi.python.org/pypi/selenium>`_ (e.g. selenium-2.48.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 <http://www.virtualenv.org/>`_ 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 <http://docs.python.org/3/library/unittest.html>`_ 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.48/selenium-server-standalone-2.48.0.jar
Run the server from the command line::
java -jar selenium-server-standalone-2.48.8.jar
Then run your Python client scripts.
Use The Source Luke!
====================
View source code online at https://github.com/SeleniumHQ/selenium/tree/master/py/
5 maintainers
Metadata
5 maintainers
Release files for selenium 2.48.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| selenium-2.48.0.tar.gz | 805.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| selenium-2.48.0-py2-none-any.whl | Python 2 | none | any | Details |
Total release size: 1.7 MB
Release files / selenium-2.48.0.tar.gz
| Download URL | selenium-2.48.0.tar.gz |
|---|---|
| Size | 805.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d5dca746955315dc83ec789acff1f298b8517732cf23a24809e4e5939eb919d8
|
|
BLAKE2b-256 checksum How to use checksums |
d14616760572785e62262da64b2624acf3b51e50a1581b14aea17aa61e145309
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Release files / selenium-2.48.0-py2-none-any.whl
| Download URL | selenium-2.48.0-py2-none-any.whl |
|---|---|
| Size | 872.4 kB |
| Tags | Python 2 |
|
SHA-256 checksum How to use checksums |
30b97338c0d9f1e60e72ecee0579b0f0845d55025342c3d5ccb224fb8a07b787
|
|
BLAKE2b-256 checksum How to use checksums |
cc2159ee8189b8597bf3f6f83b650d6f55c802347dc6507361fe42b9c90cafa8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
