Simpler webdriver API through a wrapper
Project description
Python wrapper for interacting with Selenium through XPath and CSS selectors. The main difference is that you can use use XPaths like:
//div/text()
Which will return you a string, something selenium does not support easily. E.g. you could do:
from xpathwebdriver.simple_xpath_browser import SimpleXpathBrowser
browser = SimpleXpathBrowser()
browser.get_url('https://duckduckgo.com/')
browser.fill(".//*[@id='search_form_input_homepage']", 'xpathwebdriver\n')
# Using xpath that returns text
for idx, t in enumerate(browser.select_xpath('//div/text()')):
print(idx, t)
# Using css selector which returns elements
for idx, elem in enumerate(browser.select_css('.result__title')):
print(idx, elem.text)Example
Unit Test for web site.
import unittest
from xpathwebdriver.simple_xpath_browser import SimpleXpathBrowser
class SearchEnginesDemo(unittest.TestCase):
def setUp(self):
# Get Xpath browser
self.browser = SimpleXpathBrowser()
def tearDown(self):
# Make sure we quit those webdrivers created in this specific "level of life"
del self.browser
def test_duckduckgo(self):
# Load a local page for the demo
self.browser.get_url('https://duckduckgo.com/')
# Type smoothtest and press enter
self.browser.fill(".//*[@id='search_form_input_homepage']", 'xpathwebdriver\n')Install
Installing selenium and the browser driver
Make sure you installed selenium and webdriver and that they are working. You can test selenium with:
from selenium import webdriver
import time
driver = webdriver.Chrome()
driver.maximize_window()
driver.get('https://www.google.com')
print('You can 10 secs to check the browser window')
time.sleep(10)Find the easiest way to install selenium in your environment, for example in ubuntu, you can do:
apt install python-pip python-selenium # Or in case of python3 use: python3-pip python3-selenium packages
Then install driver for chrome and gecko from:
PhantomJs: http://phantomjs.org/download.html (has the driver embedded)
Decompressed executables should be in yor PATH. If you update python’s webdriver package make sure you update browsers and drivers.
Installing Xpathwebdriver
Once selenium is working you can easily install this wrapper.
pip install xpathwebdriver
Running the interactive shell
Install ipython package (in Ubuntu probably you can install ipython or ipython3 package)
pip install ipython
You then can run from command line
xpathshell
Or opening a website:
xpathshell duckduckgo.com
To open https://duckduckgo.com
You will get an IPython interactive shell like:
XpathBrowser in 'b' or 'browser' variables Current url: https://duckduckgo.com/ In [1]:
You can check XpathBrowser api at:
Useful links for working with XPath
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.
