jzdZddlmZddlZddlZddlmZddlmZm Z ddl m Z ddl m Z mZmZdd ZddZddZdS)aaEvery route from a chosen path to a spawned Firefox goes through here. ``binary_path=`` (and ``INVPW_BINARY_PATH``, which the test suite and the e2e scripts turn into ``binary_path=``) never reaches ``ensure_binary()``, so none of the download-side checks run on that route. The guard therefore sits on the resolved executable, not inside the fetcher. ) annotationsN)Path)OptionalUnion) ensure_binary)EngineMismatch active_seal verify_engine binary_pathOptional[Union[str, Path]]returnrct}|r"tt||d|St|S)us``binary_path=`` skips the download path entirely, so the guard sits on the resolved executable rather than inside the fetcher. ⛔ This used to say "binary_path= and INVPW_BINARY_PATH", and the second half was false: nothing here reads that variable. It is translated into ``binary_path=`` by the test scripts and by ``run_e2e.py``, so it is a convention of this repo's harness and not a feature of the library. Corrected 2026-08-14 - a docstring that promises an env var the code never reads sends the reader looking for a bug in the wrong function. Driving an engine the packaged seal does not describe is done with ``binary_path=`` plus ``INVISIBLE_SEAL_FILE`` pointing at a seal generated for it; without that, ``verify_engine`` refuses, and refusing is correct - the prefs and the spoofed User-Agent describe the sealed build. z binary_path=)source)seal)r r rr)r rs LC:\Projects\Muse2API\.venv\Lib\site-packages\invisible_playwright/_engine.pyresolve_executablersM ==D[T+..=YK=Y=YZZZZ d # # ##Nonec H|dSt}t|dd}t|tsdS|dd}|r6||jkr-td|d|jd|jd |j d dSdS) aCompare what the engine reports over the protocol with the seal. browser.version is a cached property from the connection initializer (Juggler Browser.getInfo -> MOZ_APP_VERSION_DISPLAY), so this costs zero round trips and no pref can spoof it. It is the only check that also catches a hand-edited application.ini. Not available on the persistent context path, where Playwright exposes no Browser. Nversion/ziengine/seal mismatch after launch - the running browser is not the sealed build protocol says: Firefox z seal says : Firefox z (tag z, build z) why : application.ini can be edited; this value comes from the running engine itself. fix : python -m invisible_playwright fetch) r getattr isinstancestrsplitstripupstream_versionrtagbuild_id)browserrrawreporteds rassert_wire_versionr%)s ==D '9b ) )C c3  yy~~b!''))HEH 555 D(0 D D(,(= D DEIX D D] D D DEE EEE55rc t}|jr|jsdSddlm}dd}||j||cxkr||jkrnndSd|d|jd |jd |jd |jd }t jd dkrtj |tddSt|)zThe Juggler protocol schema is closed-world: a client outside the range the binary was tested with dies at context creation, or silently loses a feature. The range travels in the seal, so widening it does not need a wrapper release.Nr)rvrcg}|dddD]E}dd|D}|t|pdFt |dgdt |z zzS)N.rc3BK|]}||VdS)N)isdigit).0cs r z5assert_playwright_range..t.._s/<<1 .t\sGGCLL!$ ) )DWW<<<<<<" (or set INVISIBLE_PLAYWRIGHT_SKEW=allow to proceed anyway)INVISIBLE_PLAYWRIGHT_SKEWallow) stacklevel)r'r) r playwright_minplaywright_max&invisible_playwright._pw._repo_versionrr osenvirongetwarningswarnRuntimeWarning RuntimeError)rhaver8msgs rassert_playwright_rangerIGsH ==D  d&9GFFFFF1111 q 4BBBBAAd.A,B,BBBBBB I I I" I I(,(; I IQUQY I I-1,?  I I IC  z~~122g== c>a8888883r)r r r r)r r)__doc__ __future__rr@rCpathlibrtypingrrinvisible_corerinvisible_core.sealrr r rr%rIrrrQs#""""" """"""""((((((JJJJJJJJJJ$$$$,EEEE<' ' ' ' ' ' r