docs(python): Clarify Pytest v.s. Library on Python intro page (#29590)

This commit is contained in:
Simon Willison 2024-02-22 00:27:41 -08:00 committed by GitHub
parent 82b17bdda1
commit e846afeb98
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -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.