Playwright Python — Browser Automation and Testing Guide

# Step 1: Install the Python bindings
pip install playwright

# Step 2: Provision the browser binaries
# Using --with-deps ensures OS-level dependencies (like libgbm) are present
playwright install --with-deps

# Verify the installation
python -c "from playwright.sync_api import sync_playwright; print('Playwright initialized successfully')"

from playwright.sync_api import sync_playwright

# io.thecodeforge package naming convention applied to logic flow
def run_basic_automation():
    with sync_playwright() as p:
        # launch headless=False for visual debugging
        browser = p.chromium.launch(headless=False)
        context = browser.new_context()
        page = context.new_page()

        page.goto("https://thecodeforge.io")

        # Logging page metadata
        print(f"Navigated to: {page.title()}")

        # High-res screenshot for visual regression
        page.screenshot(path="io_thecodeforge_home.png", full_page=True)

        browser.close()

if __name__ == "__main__":
    run_basic_automation()

from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch()
    page = browser.new_page()
    page.goto("https://github.com/login")

    # Best Practice: Use Roles and Labels
    page.get_by_label("Username or email address").fill("thecodeforge_admin")
    page.get_by_label("Password").fill("secure_password_123")

    # Semantic button click
    page.get_by_role("button", name="Sign in").click()

    # Actionability: Playwright automatically waits for the URL and page state
    page.wait_for_url("**/dashboard")
    
    # Extract text from the first available heading locator
    welcome_msg = page.get_by_role("heading").first.inner_text()
    print(f"Dashboard Status: {welcome_msg}")

    browser.close()

# Install the plugin
pip install pytest-playwright

# io/thecodeforge/tests/test_search.py
import pytest
from playwright.sync_api import Page, expect

def test_homepage_integrity(page: Page):
    """Verify the main page loads with correct SEO title."""
    page.goto("https://thecodeforge.io")
    expect(page).to_have_title("TheCodeForge — Free Programming Tutorials")

def test_search_results_visibility(page: Page):
    """Check that the search interface returns valid results."""
    page.goto("https://thecodeforge.io")
    
    # Search for Java tutorials
    search_box = page.get_by_placeholder("Search tutorials...")
    search_box.fill("Java")
    search_box.press("Enter")
    
    # Assert that the search results container is visible
    results = page.get_by_role("region", name="Search results")
    expect(results).to_be_visible()

import asyncio
from playwright.async_api import async_playwright

async def fetch_metadata(url: str) -> dict:
    async with async_playwright() as p:
        browser = await p.chromium.launch()
        page = await browser.new_page(viewport={'width': 1920, 'height': 1080})
        await page.goto(url, wait_until="domcontentloaded")
        title = await page.title()
        await browser.close()
        return {"url": url, "title": title}

async def main():
    urls = ["https://thecodeforge.io/java", "https://thecodeforge.io/python"]
    tasks = [fetch_metadata(url) for url in urls]
    results = await asyncio.gather(*tasks)
    for res in results: print(f"Captured: {res['title']}")

if __name__ == "__main__":
    asyncio.run(main())