Skip to main content

Package providing common functionality for UI automation test packs

Project description

UiTestCore

This package helps with writing UI tests by providing a wrapper around Selenium and other useful functions. UiTestCore was designed with Page Object Model in mind, and makes it easy to create an acceptance test pack without the need to write any Selenium code.

The repository for this project can be found on GitHub: https://github.com/nhsuk/ui-test-core

Example

The below example shows how you can create a class representing a web page, in this case a login page.

from uitestcore.page import BasePage
from uitestcore.page_element import PageElement
from selenium.webdriver.common.by import By


class MyLoginPage(BasePage):

    # Define elements to interact with
    header_logo = PageElement(By.ID, "company-logo")
    username_field = PageElement(By.ID, "input-user")
    password_field = PageElement(By.CLASS_NAME, "field-password")
    login_button = PageElement(By.XPATH, "//button[text()='Login']")

    def open_login_page(self):
        self.interact.open_url("https://mysite.com/login")
        self.wait.for_page_to_load()

    def logo_visible(self):
        return self.interrogate.is_element_visible(self.header_logo)

    def enter_username(self, username):
        self.interact.enter_text(self.username_field, username)

    def enter_password(self, password):
        self.interact.enter_text(self.password_field, password)

    def click_login_button(self):
        self.interact.click_element(self.login_button)

The "BasePage" class is provided so that any page classes in the test pack can inherit from it, giving access to many useful functions which are separated into "find", "interrogate", "interact" and "wait". The "PageElement" class is used to define any elements which your tests need to interact with, so they can be reused without needing to remember whether you're looking for a class, ID etc (all Selenium selector types are supported).

The above page class could then be used in the test steps to perform any required actions and assertions. You must supply a selenium.webdriver driver object when instantiating the page

    login_page = MyLoginPage(driver)
    login_page.open_login_page()

Installation

This package is located on PyPI: https://pypi.org/project/uitestcore/ - it can be installed in the usual way i.e. pip install uitestcore

The easiest way to include this package in your project is by adding it to your requirements.txt. Here is an example of the line which should be added to this file, we recommend using a specific version but it's your call:

uitestcore==10.4.0

Using 10.4.0 in Linux and with Chromium

Please note, that due to a change in Selenium manager between versions 4.10 and 4.11.2, it is now necessary to set a local environment variable which points to the browser installation location. Failure to do so will result in the browser failing to initialise when running your tests. This is caused by Selenium Manager expecting a 'Chrome' installation; it does not currently fall back to check for Chromium.

Set:

    ENV SE_BROWSER_PATH=/usr/bin/chromium-browser

Deployment to PyPI

PyPI deployment is configured in the release pipeline of the NHS.UK Azure Devops project. Any changes merged into master will be automatically deployed to PyPI, and any changes pushed to a branch starting with "test/" will be automatically deployed to TestPyPI.

License

This project is licensed under the MIT License - see the LICENSE.md file for details

Dependencies

The package dependencies along with links to their licenses are as follows:

certifi - http://mozilla.org/MPL/2.0/
chardet - https://github.com/chardet/chardet/blob/master/LICENSE
idna - https://github.com/kjd/idna/blob/master/LICENSE.rst
pyhamcrest - https://github.com/hamcrest/PyHamcrest/blob/master/LICENSE.txt
python-dateutil - https://github.com/pganssle/dateutil/blob/master/LICENSE
requests - https://github.com/psf/requests/blob/master/LICENSE
selenium - https://github.com/SeleniumHQ/selenium/blob/master/LICENSE
six - https://github.com/benjaminp/six/blob/master/LICENSE
urllib3 - https://github.com/urllib3/urllib3/blob/master/LICENSE.txt

Contribute

Read our contributing guidelines to contribute to UiTestCore.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

uitestcore-10.6.0.tar.gz (37.8 kB view details)

Uploaded Source

Built Distribution

uitestcore-10.6.0-py3-none-any.whl (45.5 kB view details)

Uploaded Python 3

File details

Details for the file uitestcore-10.6.0.tar.gz.

File metadata

  • Download URL: uitestcore-10.6.0.tar.gz
  • Upload date:
  • Size: 37.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.4

File hashes

Hashes for uitestcore-10.6.0.tar.gz
Algorithm Hash digest
SHA256 226deac3e7898c608285fd4f29400029b29a7f47e53ba548cc7ccba0279d7892
MD5 2cd20fd36d746615dd10d214f3620187
BLAKE2b-256 275c4219e0682666841d93dbdba05580fb29efdf4e24deec8be9d3807eae2b7f

See more details on using hashes here.

File details

Details for the file uitestcore-10.6.0-py3-none-any.whl.

File metadata

  • Download URL: uitestcore-10.6.0-py3-none-any.whl
  • Upload date:
  • Size: 45.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.4

File hashes

Hashes for uitestcore-10.6.0-py3-none-any.whl
Algorithm Hash digest
SHA256 9332b9452ac7bb5811e29935e5975adc5f099fb96eba0507421ccb5baf6dbe6b
MD5 8b1251968787285f039067b45077c848
BLAKE2b-256 870e0044faa7430da2923b2c15284443f34f72698a93a78201b31f7a7f7a5cbf

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page