Chapitre 02.10 — Infrastructure#

Tout ce qui touche aux ressources externes : pool de drivers, builders, screenshotters, compteur d’acts, et les adapters Selenium qui implémentent ces abstractions. Depuis la 1.1.3, un infra/playwright/ parallèle livre les mêmes contrats en saveur Playwright — même pool, même builder, mêmes ports.

Plan#

BuiltWebDriver[Driver]#

type BuiltWebDriver[Driver] = tuple[Driver, Effect]

C’est l’unité d’échange entre le builder et la pool : un tuple (driver, dispose). Le dispose est un Effect (sans argument, sans retour) qui sait nettoyer ce driver précisément (driver.quit() + suppression du profile tmp si nécessaire).

Cette signature simple est la garantie de portabilité : n’importe quelle techno peut produire un BuiltWebDriver[Driver] du moment qu’elle expose un dispose: Effect. Ocarina le prouve en livrant deux backends — Selenium et, depuis la 1.1.3, Playwright — et rien n’empêche d’ajouter Puppeteer ou un fake driver.

WebDriversPool[Driver]#

                     ┌────────────────────────┐
                     │   WebDriversPool       │
                     │   (Semaphore, Queue)   │
                     └──────────┬─────────────┘
                                │ create_driver=lambda: ...
                                ▼
                     ┌────────────────────────┐
                     │   DriverBuilder        │
                     │   (profile, tmpdir)    │
                     └──────────┬─────────────┘
                                │ build_driver=lambda profile_path: ...
                                ▼
                     ┌────────────────────────┐
                     │   create_selenium_     │
                     │   driver (per browser  │
                     │   _build_firefox/etc)  │
                     └────────────────────────┘

atexit.register(pool.shutdown)#

Côté adapter (infra/selenium/create_drivers_pool.py) :

drivers_pool = WebDriversPool(create_driver=..., max_size=max_size, warmup_timeout=warmup_timeout)
atexit.register(drivers_pool.shutdown)
return drivers_pool

L’enregistrement atexit garantit qu’il n’y ait pas de zombie quelle que soit la façon dont le programme s’arrête.