Guided Walkthrough — POM, pytest Suite, Allure Report

# test_connectivity.py (throw away after this step)
def test_session_creates(driver):
    from appium.webdriver.common.appiumby import AppiumBy
    username_field = driver.find_element(AppiumBy.ACCESSIBILITY_ID, "test-Username")
    assert username_field.is_displayed(), "Username field not visible"
    print(f"Current activity: {driver.current_activity}")

# pages/login_page.py
from appium.webdriver.common.appiumby import AppiumBy
from pages.base_page import BasePage
 
 
class LoginPage(BasePage):
    USERNAME_FIELD = (AppiumBy.ACCESSIBILITY_ID, "test-Username")
    PASSWORD_FIELD = (AppiumBy.ACCESSIBILITY_ID, "test-Password")
    LOGIN_BUTTON   = (AppiumBy.ACCESSIBILITY_ID, "test-LOGIN")
    ERROR_MESSAGE  = (AppiumBy.ACCESSIBILITY_ID, "test-Error message")
 
    def login(self, username: str, password: str) -> "HomePage":
        self.clear_and_type(self.USERNAME_FIELD, username)
        self.clear_and_type(self.PASSWORD_FIELD, password)
        self.driver.hide_keyboard()
        self.tap(self.LOGIN_BUTTON)
        from pages.home_page import HomePage
        return HomePage(self.driver)
 
    def get_error_message(self) -> str:
        return self.wait_for_visible(self.ERROR_MESSAGE).text
 
    def is_error_visible(self) -> bool:
        return self.is_visible(self.ERROR_MESSAGE, timeout=3)

# conftest.py
import os
import pytest
from appium import webdriver
from appium.options import UiAutomator2Options
 
 
@pytest.hookimpl(tryfirst=True, hookwrapper=True)
def pytest_runtest_makereport(item, call):
    outcome = yield
    rep = outcome.get_result()
    setattr(item, f"rep_{rep.when}", rep)
 
 
@pytest.fixture(scope="function")
def driver(request):
    options = UiAutomator2Options()
    options.device_name = os.getenv("ANDROID_DEVICE", "emulator-5554")
    options.app = os.path.abspath("apps/saucelabs.apk")
    options.auto_grant_permissions = True
    options.no_reset = False  # Fresh app state for each test
 
    d = webdriver.Remote(
        os.getenv("APPIUM_SERVER", "http://127.0.0.1:4723"),
        options=options
    )
    yield d
 
    if hasattr(request.node, "rep_call") and request.node.rep_call.failed:
        os.makedirs("screenshots", exist_ok=True)
        d.get_screenshot_as_file(f"screenshots/{request.node.name}.png")
 
    try:
        d.quit()
    except Exception:
        pass

# tests/test_login.py
import pytest
import allure
from pages.login_page import LoginPage
 
 
@allure.epic("Authentication")
@allure.feature("Login")
class TestLogin:
 
    @pytest.mark.smoke
    @pytest.mark.regression
    @allure.story("Standard user")
    @allure.severity(allure.severity_level.BLOCKER)
    def test_standard_user_login(self, driver):
        home = LoginPage(driver).login("standard_user", "secret_sauce")
        assert home.get_product_count() > 0
 
    @pytest.mark.regression
    @allure.story("Locked out user")
    @allure.severity(allure.severity_level.CRITICAL)
    def test_locked_out_user(self, driver):
        page = LoginPage(driver)
        page.login("locked_out_user", "secret_sauce")
        error = page.get_error_message()
        assert "locked out" in error.lower()
 
    @pytest.mark.regression
    @pytest.mark.parametrize("username,password,expected_fragment", [
        ("invalid_user",   "secret_sauce", "do not match"),
        ("standard_user",  "wrong_pass",   "do not match"),
        ("",               "",             "Username is required"),
        ("standard_user",  "",             "Password is required"),
    ], ids=["wrong_user", "wrong_pass", "empty_both", "no_password"])
    @allure.story("Validation errors")
    def test_invalid_credentials(self, driver, username, password, expected_fragment):
        page = LoginPage(driver)
        page.login(username, password)
        error = page.get_error_message()
        assert expected_fragment in error, \
            f"Expected '{expected_fragment}' in error '{error}' for user '{username}'"

# pages/home_page.py
from appium.webdriver.common.appiumby import AppiumBy
from pages.base_page import BasePage
 
 
class HomePage(BasePage):
    PRODUCT_TITLE = (AppiumBy.ACCESSIBILITY_ID, "test-PRODUCTS")
    PRODUCT_ITEMS = (AppiumBy.ACCESSIBILITY_ID, "test-Item")
 
    def __init__(self, driver):
        super().__init__(driver)
        # Verify we're on the home page
        self.wait_for_visible(self.PRODUCT_TITLE, timeout=10)
 
    def get_product_count(self) -> int:
        return len(self.find_all(self.PRODUCT_ITEMS))

pytest tests/test_login.py -m smoke -v

pytest tests/test_login.py -v

pytest tests/test_login.py --alluredir=allure-results
allure serve allure-results