Skip to main content

A webdriver wrapper api for the slickqa project (and anyone else who wants it).

Project description

Website at: http://www.slickqa.com/webdriver/python

Webdriver wrapper for SlickQA Project
=====================================

Don't let the name fool you, this wrapper can be used by any project. It was written by the people who brought you
the slick project, hence the name. This wrapper has the purpose of making the selenium interface more reliable
for tests with less, more readable code by:

* Wrapping all actions with log statements (using python's builtin logging framework) that detail everything it's doing
* Providing a nice readable api, making your tests readable
* Waiting for elements to exist (with customizable timeout) so that you don't have to
* Providing a Page api that allows for easy organization of locators
* Page api allows for flat (Page -> locator) and nested (FrameworkElement -> Page -> Container -> Locator) api
* No need to instantiate every page class individually (avoiding boilerplate code)
* Event based api where you can add your own pre and post actions as part of standard calls (like taking a screenshot on click)
* more good tidbits


Example Usage
-------------

What does a test using this fabulous framework look like? Let me show you:

```python
from slickwd import BrowserType, Browser, Container, WebElementLocator, Find
from nose import with_setup
from nose.tools import assert_regexp_matches

# Page Classes --------------------------------------------------
class GoogleSearchPage(Container):
Search_Query_Text_Field = WebElementLocator("Search Box", Find.by_name("q"))
Search_Button = WebElementLocator("Search Button", Find.by_name("btnG"))

def is_current_page(self, browser):
return browser.exists(GoogleSearchPage.Search_Query_Text_Field, timeout=0, log=False)

class SearchResultsPage(Container):
Results_Div = WebElementLocator("Results Div", Find.by_id("ires"))

def is_current_page(self, browser):
return browser.exists(SearchResultsPage.Results_Div, timeout=0, log=False)

# Tests ---------------------------------------------------------
browser = None


def s():
global browser
if browser is not None:
browser.quit()
browser = Browser(BrowserType.FIREFOX)

def cleanup():
global browser
if browser is not None:
browser.quit()

@with_setup(s, cleanup)
def test_google_search():
global browser
browser.go_to('http://www.google.com')
browser.wait_for_page(GoogleSearchPage)
browser.click_and_type(GoogleSearchPage.Search_Query_Text_Field, "Slick Test Manager")
browser.click(GoogleSearchPage.Search_Button)
browser.wait_for_page(SearchResultsPage)
assert_regexp_matches(browser.get_page_text(), '.*SlickQA:.*')
```

The test is written so the code can be read, easily modified if something in the page is changed,
and allow for code reuse (page classes). Normally page classes would be held in a different module
for better organization. This is what is referred to in the documentation as the "static page class
model". There is also a different way to structure page classes that allows for nesting of containers
(page classes) to make a hierarchy and enable code completion in IDEs.

Project details


Download files

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

Files for slick-webdriver, version 1.0.3
Filename, size File type Python version Upload date Hashes
Filename, size slick_webdriver-1.0.3-py2-none-any.whl (10.6 kB) File type Wheel Python version 2.7 Upload date Hashes View
Filename, size slick_webdriver-1.0.3-py3-none-any.whl (10.6 kB) File type Wheel Python version 3.4 Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page