pytest-playwright-enhanced 0.1.4

A pytest plugin for playwright python

pytest-playwright-enhanced

[!CAUTION] pytest-playwright-enhanced is in the alpha stage.

pytest-playwright-enhanced is a batteries included pytest plugin for the playwright python bindings that offers extended functionality with a focus on removing boilerplate code for projects that wish to test modern web applications and APIs. pytest-playwright-enhanced plans to offer the following:

• Automatic, browser management and installation if required (TBD)
• Improved, human readable APIs that build on top of playwrights API.
• Improved artifacting and debugability.
• Asynchronous support.
• Custom hooks to allow you to plugin and modify behaviour at runtime.
• Much More...

pytest-playwright-enhanced is currently implementing core plugin functionality, the main enhancements will follow shortly.

pytest-playwright-enhanced right now treats browsers, contexts and pages at a function level. This allows easily per test overrides at the small cost of slightly less performance creating browsers, for now it is worth it as it offers much more flexibility and user defined configurations.

---

Quick Start

Quickly get running by doing the following:

• pip install pytest-playwright-enhanced
• pytest <posargs> --acquire-binaries=with-deps

---

Fixtures

---

• pw_playwright - At present this returns the sync Playwright instance.
• pw_multi_browser - Automatically run a test on chromium, firefox and webkit.
• pw_headed - Returns if the browser is running headlessly or not.
• pw_slow_mo - Returns the currently throttle in milliseconds, defaults to 0.
• pw_is_chromium - Returns if the current browser is chromium.
• pw_is_webkit - Returns if the current browser is webkit.
• pw_is_firefox - Returns if the current browser is firefox.
• pw_root_url - Returns the base url auto loaded by Page objects.
• pw_browser - Returns the current Browser instance.
• pw_browser_engine - A string representing the type of browser for this test.
• pw_context_kwargs - An overridable fixture to control arguments to playwright Context instances.
• pw_page - Returns a new Page instance.
• pw_is_debugging - Returns if playwright will be using PW_DEBUG mode.
• pw_browser_kwargs - An overridable fixture to control arguments to playwright `Browser nstances.

---

Hooks

pytest_playwright_acquire_binaries: Hook in and customise binary acquisition at runtime. pytest_playwright_is_debugging: User defined behaviour for detecting if an IDE is debugging. pytest_playwright_browser_env: Control the environment passed on to playwright browser instances.

---

Markers

• @pytest.mark.only_on_browsers - Only run on a subset of browsers when using the pw_multi_browser fixture.
• @pytest.mark.context_kwargs - Per test level overrides to the context object.
• @pytest.mark.browser_kwargs - Per test level overrides to the browser object.

---