Skip to content

Live server & client

These instruments allow you to lunch a live servers and live clients, e.g. for UI testing purposes.

Functions

liveclient

1
liveclient()

Runs a live client. Available as a context manager.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
def test_live(liveserver, liveclient):

    with liveserver() as server:

        # Let's run Firefox using Selenium.
        with liveclient('selenium', browser='firefox') as client:
            selenium = client.handle  # Selenium driver is available in .handle

            # Let's open server's root URL and check heading 1 on that page
            selenium.get(server.url)
            assert selenium.find_element('tag name', 'h1').text == 'Not Found'

liveserver

1
liveserver() -> type[LiveServer]

Runs a live server. Available as a context manager.

Warning

For Django >= 4.0

1
2
3
4
def test_live(liveserver):

    with liveserver() as server:
        print(f'Live server is available at: {server.url}')

Classes

LiveClient

1
LiveClient(browser: str)

Base class for live clients.

SeleniumLiveClient

1
SeleniumLiveClient(browser: str)

LiveClient

This live client wraps Selenium.

https://selenium-python.readthedocs.io/