WebDriver API is designed to be abstract enough. That is why it usually needs exdending when it comes to using Selenium in practice. If using API out of the box it leads to code duplicates and finding solutions for similar goals every time since it privides only basic classes such as WebDriver or WebElement. Webium library helps you to extend Web Driver API to whatever deep UI object structure you need. You can describe basic UI elements (e.g. Link, Button, Input), construct more complex elements from smaller parts and eventually put them all into your Page Objects. Webium is free and open-source. In my talk I'll explain how to use it efficiently in case you use or are going to use Python + Selenium for writing tests.

1. Webium: Page Object в Python
Uladzimir Franskevich
QA Automation Team Lead
Wargaming.NET

2. Prehistory
• No suitable alternatives were found in Python
• Inspired by HtmlElements
(http://htmlelements.qatools.ru/)

3. Tool requirements
• Extend WebElement – not just wrap it
• Ability to describe single & multiple elements
(find_element & find_elements)
• Search context support
• Lazy element initialization

4. Alternatives?

5. Robot Framework Page Objects
https://github.com/ncbi/robotframework-pageobjects

6. holmium.core
https://github.com/alisaifee/holmium.core

7. wtframework
https://github.com/wiredrive/wtframework

8. What’s about Webium?

9. BasePage
• Specify page url
• If required set a custom instance of driver
• Describe page structure using Find

10. Find
• by – search strategy
• value – search expression
• WebElement instance is returned when a
corresponding field is accessed

11. BasePage - Usage Example
text_field & button are instances of WebElement class

12. Extending WebElement
• Inherit from WebElement
• Add or override WebElement class members

13. Custom Controls Usage
>> Text to search: webium
Extended WebElement with custom property

14. Finds
is used like Find returns a list of elements

15. Finds
supports custom control classes
webium.controls
contains some of most
frequent controls!

16. Containers

17. Containers
• Ability to search for elements using context
• Code reuse among several page objects
• Containers are subclasses of WebElement

18. Containers – Usage example

19. Logical containers

20. is_element_present
• Standard action in tests
• Almost everyone has own
alternative to this function
• It is not trivial to do this check right
http://seleniumcamp.com/archive/selenium-
camp-2013/materials/mistakes-of-beginners/

21. is_element_present
>> True
>> False

22. is_element_present
• Method is included in BasePage and in any
container
• Parameters:
– element_name – class attribute name
– just_in_dom – whether to check element
presence in DOM only
– timeout – wait for True for specified time

23. Parameterized Pages

24. Parameterized Pages

25. Dynamic Content Loading
• https://pypi.python.org/pypi/waiting/
• Handling WebDriverException

26. Settings
• webium.settings
– wait_timeout = 30
– default_search_type = By.ID
• local_webium_settings – to override
Webium settings locally

27. implicitly_wait
• webium.settings.implicit_timeout
• 30 seconds by default
• Disabled by default for Finds

28. WebDriver settings
• webium.settings.driver_class
• Nose plugin for closing browser after tests
• Initialize WebDriver out of Webium and pass
its instance to BasePage

29. Thanks!
Q&A
• Links:
– https://github.com/wgnet/webium
– http://wgnet.github.io/webium/
– https://pypi.python.org/pypi/webium
• Contacts:
Uladzimir Franskevich
v_franskevich@wargaming.net
Igor Khrol
khroliz@gmail.com