kawa/ImpTune
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity
Files
main
ImpTune/.planning/phases/09-ux-tech-debt-closure/09-02-SUMMARY.md
T
kawa 55516ee10f Commit initial
2026-04-15 17:57:12 +02:00

6.2 KiB
Raw Permalink Blame History

phase, plan, subsystem, tags, requires, provides, affects, tech-stack, key-files, key-decisions, patterns-established, requirements-completed, duration, completed
phase plan subsystem tags requires provides affects tech-stack key-files key-decisions patterns-established requirements-completed duration completed
09-ux-tech-debt-closure 02 testing
playwright
e2e
chromium
uvicorn
alpine-js
pytest
phase provides
09-01 final printer_form.html with stable ids and inline upload form
Playwright headless e2e test suite infrastructure (tests/e2e/ package)
UX-02 evidence: live chromium verification of PRNT-03 Alpine IP->port auto-derivation
Session-scoped live_server fixture (uvicorn thread, free port, /health readiness)
09-03
phase-10-rtval
future-e2e
added patterns
pytest-playwright
playwright
uvicorn (as test server)
session-scoped-live-server
playwright-fill-alpine-input
e2e-isolated-from-unit-tests
created modified
tests/e2e/__init__.py
tests/e2e/conftest.py
tests/e2e/test_port_autofill.py
requirements-dev.txt
.planning/phases/09-ux-tech-debt-closure/09-VALIDATION.md
Route /printers used for e2e test (full-page route via printers.html extending base.html with Alpine.js loaded) — no new /printers/new route needed
conftest.py adapted from plan: config uses string paths (not Path objects), init_db() reads DB_PATH from imptune.config directly
playwright install chromium run separately after pip install -r requirements-dev.txt
E2E fixture pattern: patch imptune.config.* string attrs, call init_db(), start uvicorn thread, poll /health before yielding base_url
Alpine @input tested via page.fill() which dispatches native input event + page.wait_for_function for synchronous handler stability
UX-02
3min 2026-04-13

Phase 09 Plan 02: Playwright Port Autofill Summary

Playwright headless chromium test verifying Alpine IP->port_name auto-derivation at /printers, with session-scoped uvicorn live_server fixture, closing UX-02

Performance

  • Duration: 3 min
  • Started: 2026-04-13T08:54:19Z
  • Completed: 2026-04-13T08:57:31Z
  • Tasks: 2
  • Files modified: 5

Accomplishments

  • Playwright e2e package scaffolded (tests/e2e/__init__.py + conftest.py) with session-scoped live_server fixture running uvicorn in a background thread against an isolated tmp data dir
  • UX-02 Playwright test written and verified green: headless chromium loads /printers, fills ip_address, asserts port_name equals IP_192_168_1_100 — Alpine @input handler confirmed working in real browser
  • 112 unit tests unaffected (pytest tests/ -x -q --ignore=tests/e2e still passes)

Printer Form Route

The test uses /printers (the full-page printers.html that extends base.html and embeds printer_form.html). No new route was needed — the existing /printers route renders the Alpine x-data wrapper with <script defer src="/static/alpine.min.js"> loaded.

Pytest Command and Green Output

pytest tests/e2e/test_port_autofill.py -v
============================= test session starts =============================
platform win32 -- Python 3.14.3, pytest-9.0.3
plugins: anyio-4.13.0, base-url-2.1.0, playwright-0.7.2
collected 1 item
tests/e2e/test_port_autofill.py::test_port_autofill[chromium] PASSED     [100%]
========================== 1 passed in 6.76s ==============================

09-VALIDATION.md UX-02 Citation

Evidence path: tests/e2e/test_port_autofill.py Command: pytest tests/e2e/test_port_autofill.py -v Result: 1 passed (commit 322fc20)

Both 09-02-01 and 09-02-02 rows in 09-VALIDATION.md marked green. Wave 0 e2e items checked.

Task Commits

Each task was committed atomically:

  1. Task 1: Add Playwright dev deps + e2e package scaffolding - 4e9bd9b (chore)
  2. Task 2: Write UX-02 Playwright test for IP->port auto-fill - 322fc20 (test)

Plan metadata: (docs commit follows)

Files Created/Modified

  • requirements-dev.txt - Added pytest-playwright and playwright dev deps
  • tests/e2e/__init__.py - Empty package marker for e2e test suite
  • tests/e2e/conftest.py - Session-scoped live_server fixture (uvicorn + /health poll + tmp data dir)
  • tests/e2e/test_port_autofill.py - UX-02 Playwright headless chromium test (PRNT-03 evidence)
  • .planning/phases/09-ux-tech-debt-closure/09-VALIDATION.md - UX-02 tasks marked green, Wave 0 items checked

Decisions Made

  • Route used: /printers (not /printers/new) — the existing full-page printers.html route already loads Alpine.js via base.html and embeds printer_form.html inline, no new route needed
  • Config adaptation: The plan's conftest.py used Path objects but imptune/config.py uses string paths; adapted to patch cfg.DATA_DIR, cfg.DB_PATH, cfg.DRIVERS_DIR, cfg.ICONS_DIR as strings and call init_db() with no args (reads from patched cfg.DB_PATH)

Deviations from Plan

Auto-fixed Issues

1. [Rule 1 - Bug] Adapted conftest.py to match actual imptune config API

  • Found during: Task 1 (creating tests/e2e/conftest.py)
  • Issue: Plan's template used _cfg.DATA_DIR = data_dir (Path object) and init_db(data_dir / "imptune.db") but actual imptune.config uses string attributes and init_db() takes no arguments
  • Fix: Patched cfg.DATA_DIR/DB_PATH/DRIVERS_DIR/ICONS_DIR as strings, called init_db() with no args, also set DATA_DIR env var for lifespan handler
  • Files modified: tests/e2e/conftest.py
  • Verification: Server starts successfully, /health returns 200, Playwright test passes
  • Committed in: 4e9bd9b (Task 1 commit)

Total deviations: 1 auto-fixed (1 bug — API mismatch in plan template) Impact on plan: Fix required for test to run. No scope creep.

Issues Encountered

None beyond the config API mismatch documented above.

User Setup Required

None - no external service configuration required. pip install -r requirements-dev.txt && playwright install chromium is all that's needed in dev environments.

Next Phase Readiness

  • UX-02 closed: pytest tests/e2e/test_port_autofill.py -v is the permanent regression guard for PRNT-03 Alpine port auto-derivation
  • 09-03 (script download links) can proceed — e2e infrastructure in place for any future e2e tests
  • Unit test suite unaffected: 112 tests green

Phase: 09-ux-tech-debt-closure Completed: 2026-04-13

Reference in New Issue View Git Blame Copy Permalink