A nice way of implementing the Page Object pattern.
Project description
Stere is a library for writing Page Objects, designed to work on top of your existing automation library.
Design Philosophy
Many implementations of the Page Object model focus on removing the duplication of element locators. Stere goes one step further, offering a complete wrapper over the code that drives automation.
The goals of this project are to:
1 - Eliminate implementation code in test functions. Tests should read like a set of user actions.
2 - Reduce the need for hand-written helper methods in Page Objects.
3 - Provide a simple pattern for writing maintainable Page Objects.
No automation abilities are built directly into the project; it completely relies on being hooked into other libraries. However, a default implementation using Splinter is available out of the box.
Basic Usage
Fundementally, a Page Object is just a Python class.
A minimal Stere Page Object should:
1 - Subclass the Page class
2 - Declare Fields and Areas in the __init__ method
As an example, here’s the home page for Wikipedia:
from stere import Page
from stere.areas import Area, RepeatingArea
from stere.fields import Button, Input, Link, Root, Text
class WikipediaHome(Page):
def __init__(self):
self.search_form = Area(
query=Input('id', 'searchInput'),
submit=Button('xpath', '//*[@id="search-form"]/fieldset/button')
)
self.other_projects = RepeatingArea(
root=Root('xpath', '//*[@class="other-project"]'),
title=Link('xpath', '//*[@class="other-project-title"]'),
tagline=Text('xpath', '//*[@class="other-project-tagline"]')
)The search form is represented as an Area with two Fields inside it.
A Field represents a single item, while an Area represents a unique collection of Fields.
The query and submit Fields didn’t have to be placed inside an Area. However, doing so allows you to use Area’s perform() method.
The links to other products are represented as a RepeatingArea . A RepeatingArea represents a non-unique collection of Fields on the page. Using the root argument, RepeatingArea will find all instances of said root, then build the appropriate number of Areas with all the other Fields inside.
It’s just as valid to declare each of the other products as a separate Area one at a time, like so:
self.commons = Area(
root=Root('xpath', '//*[@class="other-project"][1]'),
title=Link('xpath', '//*[@class="other-project-title"]'),
tagline=Text('xpath', '//*[@class="other-project-tagline"]')
)
self.wikivoyage = Area(
root=Root('xpath', '//*[@class="other-project"][2]'),
title=Link('xpath', '//*[@class="other-project-title"]'),
tagline=Text('xpath', '//*[@class="other-project-tagline"]')
)Which style you pick depends entirely on how you want to model the page. RepeatingArea does the most good with collections where the number of areas and/or the contents of the areas can’t be predicted, such as inventory lists.
Using a Page Object in a test can be done like so:
def test_search_wikipedia():
WikipediaHome().search_form.perform('kittens')Documentation
License
Distributed under the terms of the MIT license, “Stere” is free and open source software
Issues
If you encounter any problems, please file an issue along with a detailed description.
Thanks
Cross-browser Testing Platform and Open Source <3 Provided by Sauce Labs
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.
Source Distribution
Built Distribution
File details
Details for the file stere-0.2.3.tar.gz.
File metadata
- Download URL: stere-0.2.3.tar.gz
- Upload date:
- Size: 13.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.2.0 requests-toolbelt/0.8.0 tqdm/4.26.0 CPython/3.6.1
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | b279c71c07dd3db2956554153f818466d515fd9c008d18c56b68cf8984df2220 |
|
| MD5 | c7910ed908855356f8b622a1dd0d57c7 |
|
| BLAKE2b-256 | a822a5bd2ef75a2ec9ac916ea160221b2a7001495dcff02c6181c1a5bf6a7eef |
Provenance
File details
Details for the file stere-0.2.3-py3-none-any.whl.
File metadata
- Download URL: stere-0.2.3-py3-none-any.whl
- Upload date:
- Size: 20.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.2.0 requests-toolbelt/0.8.0 tqdm/4.26.0 CPython/3.6.1
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 2d17b2860c44ce6b1df6f04bac8082243116b7b53fb1bd05f033d27d4569cecf |
|
| MD5 | dea38e35a2622240fa83e13f09469aac |
|
| BLAKE2b-256 | 019210fa87ffa7d9e56285fd5bdbe2db2a6ac751371826e5f71d7c893e702ee5 |
