This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description


POM is Page-Object-Model microframework to develop web UI tests easy, quickly and with pleasure.


POM provides API to manipulate with web UI elements and pages in browser. Under hood it uses selenium. Before to act with UI element POM waits for its visibility, because in user cases user can’t interact with UI element if it isn’t visible at display. POM provides tree hirarchy to request UI elements with UI caching mechanism at each level.

POM doesn’t use implicit_wait method to wait UI element, because implicit_wait waits until element is present at DOM even if it isn’t visible. And also implicit_wait has conflict with caching mechanism, that leads to long requests in some cases.

So POM has own implementation to wait element before interact. It leads to additinal webdriver request before interact with UI element, but provide reliable and simple architecture, without speed degradation.

How to start

Let imagine simple testcase:

  • Go to
  • Fill login / password fields with 'admin' / 'admin' values
  • Click button login
  • Assert page to log in is opened
  • Assert alert message is opened

Its implementation with POM:

import unittest

import pom
from pom import ui
from import By

@ui.register_ui(field_login=ui.TextField(By.NAME, 'email'),
                field_password=ui.TextField(By.NAME, 'pass'))
class FormLogin(ui.Form):
    """Form to login."""

@ui.register_ui(form_login=FormLogin(By.ID, 'login_form'))
class PageMain(pom.Page):
    """Main page."""
    url = '/'

    alert_message=ui.Block(By.CSS_SELECTOR, 'div.uiContextualLayerPositioner'))
class PageLogin(pom.Page):
    """Login page."""
    url = '/login'

@pom.register_pages([PageMain, PageLogin])
class Facebook(pom.App):
    """Facebook web application."""
    def __init__(self):
        super(Facebook, self).__init__('', 'firefox')

class TestCase(unittest.TestCase):

    def setUp(self):
        self.fb = Facebook()

    def test_facebook_invalid_login(self):
        """User with invalid credentials can't login to facebook."""
        with self.fb.page_main.form_login as form:
            form.field_login.value = 'admin'
            form.field_password.value = 'admin'
        assert self.fb.current_page == self.fb.page_login
        assert self.fb.page_login.alert_message.is_present

To launch example:

  • Save example code in file
  • Install POM framework pip install python-pom
  • Launch test example python -m unittest test_pom

Full example of usage is in

Supported UI components

In progress…

Release History

Release History


This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
python_pom-1.0.2-py2-none-any.whl (16.2 kB) Copy SHA256 Checksum SHA256 2.7 Wheel Aug 26, 2016
python-pom-1.0.2.tar.gz (8.6 kB) Copy SHA256 Checksum SHA256 Source Aug 26, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting