holmium.core

Introduction

holmium.core provides utility classes to simplify writing pageobjects for webpages using selenium.

Nothing beats an example. Conventionally automated tests integrating with python-selenium are written similarly to the following code block (using seleniumhq.org).

import selenium.webdriver
import unittest

class SeleniumHQTest(unittest.TestCase):
    def setUp(self):
        self.driver = selenium.webdriver.Firefox()
        self.url = "http://seleniumhq.org"
    def test_header_links(self):
        self.driver.get(self.url)
        elements = self.driver.find_elements_by_css_selector("div#header ul>li")
        self.assertTrue(len(elements) > 0)
        expected_link_list = ["Projects", "Download", "Documentation", "Support", "About"]
        actual_link_list = [el.text for el in elements]
        self.assertEquals( sorted(expected_link_list), sorted(actual_link_list))

    def test_about_selenium_heading(self):
        self.driver.get(self.url)
        about_link = self.driver.find_element_by_css_selector("div#header ul>li#menu_about>a")
        about_link.click()
        heading = self.driver.find_element_by_css_selector("#mainContent>h2")
        self.assertEquals(heading.text, "About Selenium")

    def tearDown(self):
        if self.driver:
            self.driver.quit()

if __name__ == "__main__":
    unittest.main()

The above example does what most selenium tests do:

initialize a webdriver upon setUp
query for one or more web elements using either class name, id, css_selector or xpath
assert on the number of occurances / value of certain elements.
tear down the webdriver after each test case

It suffers from the typical web development problem of coupling the test case with the HTML plumbing of the page its testing rather than the functionality its meant to excercise. The concept of PageObjects reduces this coupling and allow for test authors to separate the layout of the page under test and the functional behavior being tested. This separation also results in more maintainable test code (i.e. if an element name changes - all tests dont have to be updated, just the pageobject).

Lets take the above test case for a spin with holmium. Take note of the following:

The initialization and reset of the webdriver is delegated to the TestCase base class (alternatively the class could subclass unittest.TestCase and be run with the holmium nose plugin.
the page elements are accessed in the test only via Element & ElementMap.

from holmium.core import TestCase, Page, Element, Locators, ElementMap
import unittest

class SeleniumHQPage(Page):
    nav_links = ElementMap( Locators.CSS_SELECTOR
                            , "div#header ul>li"
                            , key = lambda element : element.find_element_by_tag_name("a").text
                            , value = lambda element: element.find_element_by_tag_name("a") )

    header_text = Element(Locators.CSS_SELECTOR, "#mainContent>h2")


class SeleniumHQTest(TestCase):
    def setUp(self):
        self.page = SeleniumHQPage(self.driver, "http://seleniumhq.org")

    def test_header_links(self):
        self.assertTrue( len(self.page.nav_links) > 0 )
        self.assertEquals( sorted(["Projects", "Download", "Documentation", "Support", "About"])
                        ,  sorted(self.page.nav_links.keys() ) )

    def test_about_selenium_heading(self):
        self.page.nav_links["About"].click()
        self.assertEquals(self.page.header_text.text, "About Selenium")

if __name__ == "__main__":
    unittest.main()

Which can then be executed in a few different ways as shown below.

# if using TestCase as the base class run as:
export HO_BROWSER=firefox;nosetests test_selenium_hq.py
# or..
export HO_BROWSER=firefox;python test_selenium_hq.py
# if using unittest.TestCase as the base class run as:
nosetests test_selenium_hq.py --holmium-browser=firefox

History

0.5.2 2013-12-09

PyPy support
Allow customization of WebElements by exposing ElementEnhancer

0.5.1 2013-12-01

Re-added python 2.6 support

0.5.0 2013-12-01

Python 3.3 now supported and tested.

0.4.2 2013-12-01

New parameter only_if (callable that accepts the webelement that was found) accepted by Element, Elements, ElementMap that allows for waiting for an element to become valid according to the response of only_if. The callable will be checked uptil the timeout parameter set on the Element.

0.4.1 2013-11-29

Bug fix for config module being reused between test runs.

0.4 2013-11-28

Old style class names removed (Deprecated old class names)
Introduced Facets
Introduced Cucumber Features integration with fresher.
General refactoring and code cleanup.

0.3.4 2013-11-21

Added support to ignore ssl certificate errors on chrome, firefox & phantomjs
code cleanup
improved test coverage

0.3.3 2013-10-29

Improved back reference access in Config object by allowing variable references without requiring a prefix of default or the environment name. The resolution order is current environment and then default.

For example, the following config will resolve login_url as http://mysite.com/login and profile_url as http://mysite.com/profile/prod_user respectively, when holmium.environment is set to production
```
config = { "default" : {
                "login_url" : "{{url}}/login"
                , "profile_url":"{{url}}/profiles/{{username}}"}
          , "production": {
                "url": "http://mysite.com"
                , "username":"prod_user"}
        }
```

0.3.2 2013-10-10

Fluent response from page objects only when page method returns None

0.3.1 2013-09-17

Allow indexing of Sections objects

0.3 2013-09-16

Bug Fix for instantiating multiple instances of the same the Page object (https://github.com/alisaifee/holmium.core/issues/4)
Section object introduced

0.2 2013-09-11

Deprecated old class names (PageObject, PageElement, PageElements, PageElementMap & HolmiumTestCase)
Added more tests for holmium.core.TestCase
New Config object.

0.1.8.4 2013-09-04

Bug Fix : installation via pip was failing due to missing HISTORY.rst file.

0.1.8.3 2013-08-12

Bug fix
- improved error handling and logging for missing/malformed config file.

0.1.8 2013-03-18

Added iphone/android/phantomjs to supported browsers
Bug fix
- fixed phantomjs build in travis

Metadata

Release files for holmium.core 0.5.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for holmium.core 0.5.2
File	Size	Uploaded
holmium.core-0.5.2.tar.gz	265.3 kB	Dec 9, 2013	Details

Built distribution (wheel)

Table of built distributions (wheels) for holmium.core 0.5.2
File	Interpreter	ABI	Platform	Reset
holmium.core-0.5.2-py2.7.egg 285.8 kB Dec 9, 2013	Legacy Egg format	-	-	Details

Total release size: 551.1 kB

Release files / holmium.core-0.5.2.tar.gz

Download URL	holmium.core-0.5.2.tar.gz
Size	265.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`cac09384ac8d3d3e2a2864bcd53310df083202adfd39db808aa5d89501f7e605`
BLAKE2b-256 checksum How to use checksums	`f8c4c974ed8a5e8550a75ab6363f8da010a7655a577f78907bbfdfa5e4bc3fb1`
Upload date	Dec 9, 2013
Uploaded using Trusted Publishing? What is trusted publishing?	No

Release files / holmium.core-0.5.2-py2.7.egg

Download URL	holmium.core-0.5.2-py2.7.egg
Size	285.8 kB
Tags	Egg
SHA-256 checksum How to use checksums	`18aa1765e68a0f5423196176f7da324db4d8ed7d66c2d8d678c9cd82ecc96056`
BLAKE2b-256 checksum How to use checksums	`921561d7e0e597cfdef1d1517e8bc0f6a89dce90887ed367734ba9fe42515ae6`
Upload date	Dec 9, 2013
Uploaded using Trusted Publishing? What is trusted publishing?	No