Selenium Pagemodel implementation for Python.
Project description
Selenium-PageModel
This project helps Test Engineers by abstracting out the implementation – in this case Selenium – from the actual set of Actions necessary to perform a single Test Scenario. The Selenium-PageModel library does this by defining a set of well defined PageModel constructs that Test Engineers can extend/implement to describe a Website. These PageModel constructs includes the following:
WebPage
Button
Checkbox
Dropdown
Link
Table
TextElement
TextField
Widget
Using these constructs, you can describe a WebPage as having the following web-elements:
- A Header Widget containing:
A Home Link
A Login Link
A Register Link
- A form Widget containing:
A username TextField
A password TextField
A Submit Button
A potential Error message TextElement (in the event of a login failure)
Once a PageModel is defined, a login test for an imaginary website may look like this:
homePage.open(); loginPage.waitForPageLoad().validate(); loginPage.loginForm.userName.type("myuser"); loginPage.loginForm.password.type("mypassword"); loginPage.loginForm.submitButton.click(); homePage.waitForPageLoad().isLoggedIn();
Please see the project’s Homepage for more information: Selenium-PageModel
Installation
The library can be installed via:
pip install seleniumpm
Or if you want to install from src:
pip install git+https://github.com/gradeawarrior/python-seleniumpm.git
Usage
Here is the ever so popular Google example using seleniumpm:
from selenium import webdriver from seleniumpm.examples.google_page import GooglePage """ Setup for Remote execution against a local standalone-selenium-server and using the PhantomJS driver. This can be changed of course to using the driver of your choice (e.g. Chrome or Firefox) """ driver = webdriver.Remote(command_executor="http://localhost:4444/wd/hub", desired_capabilities=webdriver.DesiredCapabilities.PHANTOMJS) # Instantiate Google Page google = GooglePage(driver, url="https://www.google.com") # Open + wait for page load + validate Google google.open().wait_for_page_load().validate() # Print the page title print google.get_title() # Search for 'Cheese!' search_str = "Cheese!" google.search_field.type(search_str) google.search_field.submit() # Ensure that the page is refreshed from your search print google.wait_for_title(search_str).get_title()
Creating your PageObject’s
The GooglePage used in the above example looks like the following:
from selenium.webdriver.common.by import By from seleniumpm.webpage import Webpage from seleniumpm.webelements.textfield import TextField from seleniumpm.locator import Locator class GooglePage(Webpage): def __init__(self, driver, url=None): super(GooglePage, self).__init__(driver, url) self.search_field = TextField(driver, Locator.by_name('q')) def get_result_links(self): links = [] elements = self.driver.find_elements(By.XPATH, "//h3[contains(@class, 'r')]/a") for element in elements: links.append(element.get_attribute("href")) return links
You should notice that most of the operations except for get_result_links() are not visible on the GooglePage class. That is because the basic behaviors are either part of the Webpage or the TextField (aka an Element) type.
For more information about writing your PageObject’s in SeleniumPM, please direct your attention to Creating-your-PageObject-with-SeleniumPM
Language Support
The Selenium PageModel implementation is not limited to just one language. Here are other language implementations:
Java - Java-SeleniumPM
Ruby - In consideration depending on needs and popularity.
Contributing to SeleniumPM
Check out the latest master to make sure the feature hasn’t been implemented or the bug hasn’t been fixed yet.
Check out the issue tracker to make sure someone already hasn’t requested it and/or contributed it.
Fork the project.
Start a feature/bugfix branch.
Commit and push until you are happy with your contribution.
Make sure to add tests for it. This is important so I don’t break it in a future version unintentionally.
Please try not to mess with the version or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so that I can cherry-pick around it.
References
A huge shoutout to Peter Downs for his very easy-to-follow instructions for submitting a Python package to the community. See first time with pypi for his instructions.
Also see the following:
selenium-server-runner - If you’re running on a Mac, this project helps you setup and run the standalone-selenium-server on your laptop
Java-SeleniumPM - The Java version of SeleniumPM
requestests - An API testing library
Package Dependencies:
seleniumpm installs the following upstream packages as of the latest release:
Copyright
Copyright (c) 2017 Peter Salas. See LICENSE for further details.
Release History
FUTURE (UN-RELEASED)
New Features:
Fixed:
Moving upload of wheel to use to twine instead of setup.py. See the following link for why: https://packaging.python.org/distributing/#wheels
2.9.0 (2017-03-27)
New Features:
Implement a get_texts() which returns back all the text (in a List) given a locator. This is available for all Element types
Implement hover_over() capability to Element
Fixed:
Add more unittests for IFrame
Fix wait_for_present_and_visible() timeout for the check for visibility. There are scenarios in which an element may be present, but not immediately visible
2.8.0 (2017-03-24)
Adding click() operations to a Widget. This is to support the fact that sometimes an entire section of a page can be “clickable”
Adding new IFrame type
Fixed:
Fixing issue with get_element_attr() method on both a Widget and a Webpage. The problem was that if you marked Widget type as do_not_check, then it should respect both the Widget and all of its embedded elements. The issue was that it would respect that the Widget was marked as do_not_check, but would still enumerate over all of its sub-elements.
Fixing another issue with get_element_attr() method on both a Widget and a Webpage. The problem was related to Widget’s that are marked “invisible”. Similar to do_not_check, sub-elements should not be checked if the top-level Widget is already “invisible”.
2.7.2 (2017-03-20)
New Features:
Fixed:
Both Webpage and Widget validate() methods should return self
Fixing force_check_visibility parameter in Webpage.wait_for_page_load(). The default was set to True instead of False
2.7.1 (2017-03-20)
New Features:
Fixed:
Fixed HISTORY.rst and README.rst files that are malformed sometime after 2.5.1 release
Hopefully fixing other issues with 2.7.0 not being installable
2.7.0 (2017-03-20)
New Features:
Adding a new ability to mark an Element type as ‘invisible’ so that validations on a Widget or Webpage can be done simply on presence
Adding a new ability to mark an Element type as ‘do not check’ so that you could potentially define an Element that you simply don’t validate using the default validation() operation defined on a Widget or a Webpage. This feature should be used sparingly as there are better design patterns to handle most cases that you may think that you need to avoid validating the presence of specific Element types.
Fixed:
2.6.0 (2017-03-17)
New Features:
Adding get_tuple() to Locator object. This is to make passing between SeleniumPM and the Selenium libraries eaiser
- Adding simpler way of defining Locators. Locators can now be created via Locator.by_xpath(path) or Locator.by_css_selector(path). The following types are supported:
by_xpath(path)
by_css_selector(path)
by_name(path)
by_class_name(path)
by_id(path)
by_link_text(path)
by_partial_link_text(path)
by_tag_name(path)
Adding wait_for_selected() to Element
Adding wait_for_clickable() and click_invisible() to Clickable
Adding send_keys_delayed() and type_delayed() to TextField
Adding new Panel type that simply extends Widget. Conceptually they’re exactly the same, but Panel appears to be a more generally acceptable term for a section of a page
Fixed: - Simplifying README for more of a project overview. Details should be located on the wiki
2.5.2 (2017-03-07)
New Features:
Fixed:
Fixing issue with setup.py throwing error missing HISTORY.rst from package data
2.5.1 (2017-03-07) - BROKEN
New Features:
Fixed:
Fixing issue with set_focus() or scroll_into_view(). They were apparently not included in 2.5.0 release
2.5.0 (2017-03-07) - BROKEN
New Features:
Addition of RadioButton type
Addition of Dropdown type
Addition of Image type
Add new method get_element_attr() to Webpage and Widget type. This will give developers access to all define Element attributes on a Webpage or within a Widget. This method all supports retrieving a specific Element type (e.g. Button, Link, Checkbox)
Changing default wait_for_page_load() and validate() methods to use the above mentioned get_element_attr(). This can still be overridden, and does not affect previous implementations.
Adding new seleniumpm.examples.widgets package
Element class now implements a get_action_chains() method to return back an ActionChains type.
Element class now implements a set_focus() or scroll_into_view() functionality, for those pesky webelements that are need to be visible, but are corrently scrolled off page somehow.
Fixed:
Adding type-checking to constructor of the Element, Widget, and Webpage types. These classes will now throw an AttributeError if not passed in a legitimate RemoteWebdriver, URL, or Locator type as parameters.
2.4.2 (2017-02-13)
New Features:
Fixed:
Fixing issue appending two .rst files together to generate the long_description
Using setuptools for setup.py.
2.4.1 (2017-02-13)
New Features:
Fixed:
Using disutils.core instead of setuptools for setup.py. Hoping this fixes pretty-print of rst files on PyPi
2.4.0 (2017-02-13)
New Features:
Better support for Table type and interacting with them on a page. This includes support for ‘search’ operations and enumerating over rows and columns
Additional methods to Locator object to assist in managing them
implemented get_webelement() and get_webelements() for all Elements. This will return the Selenium WebElement object(s).
Implementation of object equality for all Selenium Page Model classes
UnitTests are now using PhantomJS (Headless) target
Removal of requestest dependency to keep the project simple
Fixed:
The Widget type was missing in 2.3.0 release
Expanding of the UnitTest coverage to ensure libraries are working correctly
Fixing issue with get_text() in Python Selenium. Apparently, this call in Python (versus Java) is simply called ‘text’
Conversion of README and HISTORY files to rst. This is so that they are rendered correctly on PyPi server
2.3.0 (2017-02-06)
New Features:
Provides a full implementation of the current Java v2.3 of Selenium PageModel
2.0.0 (2017-01-10)
New Features:
First release of seleniumpm for the world
Contains minimum proof-of-concept for testing search on Google
Project details
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.