From e846afeb98d5609e6bf7d03353ee3577243d4455 Mon Sep 17 00:00:00 2001 From: Simon Willison Date: Thu, 22 Feb 2024 00:27:41 -0800 Subject: [PATCH] docs(python): Clarify Pytest v.s. Library on Python intro page (#29590) --- docs/src/intro-python.md | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/docs/src/intro-python.md b/docs/src/intro-python.md index acedbed197..09a493ae83 100644 --- a/docs/src/intro-python.md +++ b/docs/src/intro-python.md @@ -6,14 +6,18 @@ title: "Installation" Playwright was created specifically to accommodate the needs of end-to-end testing. Playwright supports all modern rendering engines including Chromium, WebKit, and Firefox. Test on Windows, Linux, and macOS, locally or on CI, headless or headed with native mobile emulation. +The [Playwright library](./library.md) can be used as a general purpose browser automation tool, providing a powerful set of APIs to automate web applications, for both sync and async Python. + +This introduction describes the Playwright Pytest plugin, which is the recommended way to write end-to-end tests. + **You will learn** -- [How to install Playwright](/intro.md#installing-playwright) +- [How to install Playwright Pytest](/intro.md#installing-playwright-pytest) - [How to run the example test](/intro.md#running-the-example-test) -## Installing Playwright +## Installing Playwright Pytest -Playwright recommends using the official [Playwright Pytest plugin](./test-runners.md) to write end-to-end tests. It provides context isolation, running it on multiple browser configurations out of the box. Alternatively you can use the [library](./library.md) to manually write the testing infrastructure with your preferred test-runner. The Pytest plugin utilizes the sync version of Playwright, there is also an async version accessible via the library. +Playwright recommends using the official [Playwright Pytest plugin](./test-runners.md) to write end-to-end tests. It provides context isolation, running it on multiple browser configurations out of the box. Get started by installing Playwright and running the example test to see it in action.