add an example test

Author: ks6088ts

Makefile

@@ -16,6 +16,7 @@ info: ## show information
 install-deps-dev: ## install dependencies for development
 	uv sync --all-extras
 	uv run pre-commit install
+	uv run playwright install
 
 .PHONY: install-deps
 install-deps: ## install dependencies for production

docs/index.md

@@ -1 +1,16 @@
 # workshop-playwright-python
+
+## Installation
+
+To set up the environment, details are provided in [Playwright for Python > Installation](https://playwright.dev/python/docs/intro).
+In this workshop, we provide a script to install the necessary dependencies.
+
+```bash
+git clone https://github.com/ks6088ts-labs/workshop-playwright-python.git
+cd workshop-playwright-python
+
+# Install the dependencies
+make install-deps-dev
+```
+
+- [[BUG] Host system is missing dependencies to run browsers (WSL2) #19100](https://github.com/microsoft/playwright/issues/19100)

pyproject.toml

@@ -5,6 +5,7 @@ description = "A GitHub template repository for Python"
 readme = "README.md"
 requires-python = ">=3.10"
 dependencies = [
+    "playwright>=1.52.0",
     "pytest-playwright>=0.7.0",
 ]
 

tests/test_core.py

@@ -1,4 +1,7 @@
 import logging
+import re
+
+from playwright.sync_api import Page, expect
 
 from workshop_playwright_python.core import hello_world
 
@@ -13,3 +16,20 @@ def test_hello_world_non_verbose(caplog):
     with caplog.at_level(logging.DEBUG):
         hello_world(verbose=False)
     assert "Hello, world!" not in caplog.text
+
+
+def test_has_title(page: Page):
+    page.goto("https://playwright.dev/")
+
+    # Expect a title "to contain" a substring.
+    expect(page).to_have_title(re.compile("Playwright"))
+
+
+def test_get_started_link(page: Page):
+    page.goto("https://playwright.dev/")
+
+    # Click the get started link.
+    page.get_by_role("link", name="Get started").click()
+
+    # Expects page to have a heading with the name of Installation.
+    expect(page.get_by_role("heading", name="Installation")).to_be_visible()