spydr 0.2.2

Selenium Webdriver wrapper with Selenium IDE-like functionality

spydr

Selenium WebDriver (Python binding) wrapper with Selenium IDE-like functionality

spydr Documentation

Install

pip install spydr

Supported locator

Spydr WebDriver supports locator using the following how=what strategies to locate elements:

• css=.btn
• class=btn-primary
• id=frame1
• link_text=text
• name=j_username
• partial_link_text=text
• tag_name=span
• xpath=//span/a
• yml=today_page.dashboard.search_field

If how is not specified, locator starting with / or ( will be parsed as xpath, while ., [ and # are treated as css.

locator also supports css pseudo selector :eq(), like using .tab:eq(2) to locate 3rd element of .tab.

Using Sypdr WebDriver

# Basic Example 1:
# - Google search 'webdriver'
from spydr.webdriver import Spydr

s = Spydr()
s.maximize_window()
s.open('https://www.google.com/')
s.send_keys('name=q', 'webdriver', s.keys.ENTER)
s.save_screenshot('sample-1')
s.quit()

# Basic Example 2:
# - Firefox driver, in headless mode, with 1920x1080 resolution
# - Switch frame and window
from spydr.webdriver import Spydr

s = Spydr(browser='firefox', headless=True, window_size='1920,1080')
s.log('JSFiddle: Test "Open New Tab/Winodw"')
s.maximize_window()
s.open('https://jsfiddle.net/s7gcx1du/')
s.switch_to_frame('name=result')
s.click('link_text=New Window') # Open Google Search
s.wait_until_number_of_windows_to_be(2)
s.switch_to_last_window_handle()
s.save_screenshot(s.timestamp(prefix='sample-'))
s.quit()

# Handle Basic/Digest HTTP AUTH using Chrome
from spydr.webdriver import Spydr

s = Spydr(auth_username='guest', auth_password='guest')
s.open('https://jigsaw.w3.org/HTTP/Basic/')
s.save_screenshot('basic')
s.open('https://jigsaw.w3.org/HTTP/Digest/')
s.save_screenshot('digest')
s.quit()

# Handle Basic/Digest HTTP AUTH using non-Chrome
from spydr.webdriver import Spydr

s = Spydr(browser='firefox', auth_username='guest', auth_password='guest')
s.open_with_auth('https://jigsaw.w3.org/HTTP/Basic/')
s.save_screenshot('basic')
s.open_with_auth('https://jigsaw.w3.org/HTTP/Digest/')
s.save_screenshot('digest')
s.quit()

Using YML: Dot Notation (for environment values, locator, etc)

# conf.yml
env:
  url: 'https://dev.company.com/today'

today_page:
  dashboard:
    search_field: '#dashboard-search'
    search_string: 'name is {name}'

from spydr.webdriver import Spydr

s = Spydr(yml='conf.yml')

url = s.t('env.url')
search_string = s.t('today_page.dashboard.search_string', name='spydr')

s.open(url)
s.send_keys('yml=today_page.dashboard.search_field', search_string)

Development Environment

cd spydr
pip install -e .
pip install autopep8
pip install pylint
pip install twine
pip install sphinx
pip install sphinxcontrib-napoleon

Build Docs

cd spydr
sphinx/make html

Upload Package

cd spydr
python setup.py bdist_wheel
twine upload dist/*

Project Home

https://pypi.org/project/spydr/