selenium-page-factory

A Page Factory is one way of implementing a Page Object Model. In order to support the Page Object pattern. As in Java we are using @findBy, here we are declaring all web element in dictionary. Dictionary keys become WebElement or class member variable with having all extended WebElement methods.

Main Features

• Initialise all the webElements declared in Point at a time.
• All WebElements methods are re-define to add extra features eg- click method extended to have explicit wait for element to be clickable.
• Cent percent unittest coverage.
• Added Selenium 4 support for ActionChains methods
• Supports Selenium 4 ActionChains methods
• Raised custom Page factory exceptions

Installation

  pip install selenium-page-factory

Pre-Requisite

Every Page in Page Object Model should have WebDriver object as class member as shown below

class PageClass(PageFactory):

    def __init__(self,driver):
        self.driver = driver    	# Required
        self.timeout = 15      		#(Optional - Customise your explicit wait for every webElement,Default 10sec)
        self.highlight = True   	#(Optional - To highlight every webElement in PageClass)
		self.mobile_test = False    #(Optional - Added for Appium support)

Extended WebElements Methods

set_text	get_text
clear_text	click_button
double_click	get_list_item_count
select_element_by_text	select_element_by_index
select_element_by_value	get_all_list_item
get_list_selected_item	highlight
is_Enabled	is_Checked
getAttribute	hover
visibility_of_element_located	invisibility_of_element_located
element_to_be_clickable	text_to_be_present_in_element
context_click	execute_script
click_and_hold	release
hover_with_offset	Coming soon...

Note: Every WebElement will be created after verifying it's Presence and visibility on Page at Run-Time.

Project Page

https://github.com/NayakwadiS/selenium-page-factory

Documentation

https://selenium-page-factory.readthedocs.io