j dZddlmZddlZddlZddlmZddlmZm Z m Z m Z ddl m Z mZmZmZddlmZdd lmZdd lmZmZdd lmZmZmZdd lmZmZdd lmZ ddl!m"Z"m#Z#ej$Z$ej%Z&Gddej'Z(dS)z2Sync Playwright launcher for invisible_playwright.) annotationsN)Path)AnyDictOptionalUnion)BrowserBrowserContext Playwrightsync_playwright)_session)resolve_cursor_engine)Profilegenerate_profile) SessionLocalepersona_cookiesprepare_session_geo)assert_wire_versionresolve_executable)configure_proxy) SessionToken guard_forcreZdZdZ d0ddddddddddddd d1d!Zd2d#Zd3d%Zd&Zd'Zd4d(Z d5d+Z d6d.Z d4d/Z dS)7InvisiblePlaywrightuVContext manager launching a patched Firefox with a deterministic profile. Usage: from invisible_playwright import InvisiblePlaywright # random seed (different fingerprint each call) with InvisiblePlaywright() as browser: page = browser.new_page() page.goto("https://example.com") # explicit seed → same profile every time with InvisiblePlaywright(seed=42) as browser: ... # human-like cursor motion, on by default: the ordinary Playwright # pointer calls move the cursor along a path drawn from `seed` with InvisiblePlaywright(humanize=True) as browser: page = browser.new_page() page.click("#submit") # the pointer travels there, it does not jump Optional ``pin`` forces specific fingerprint fields while the rest still varies with ``seed``:: with InvisiblePlaywright(seed=42, pin={"screen.width": 2560}) as browser: ... After construction, the chosen seed is available as ``self.seed`` - useful to reproduce a random run later. NFTauto) pinheadlessproxy extra_argshumanizelocaletimezone extra_prefs binary_path profile_dirprep_recaptcha show_cursorseed Optional[int]rOptional[Dict[str, Any]]rboolr Optional[Dict[str, str]]r!Optional[list[str]]r"Union[bool, float]r#strr$r%r& Optional[str]r'Optional[Union[str, Path]]r(r)Optional[bool]returnNonec |t|ntjd|_||_||_||_t|pg|_||_ t||_ | dnt| |_ ||_d|_||_| |_| |_| rt'| nd|_t| o|jdu|_t-|j|j|_d|_d|_d|_d|_t9|_t=|_d|_ d|_!d|_"d|_#dS)u Args: seed: Integer seed driving the Bayesian fingerprint sampler. Same seed → same fingerprint. ``None`` = fresh random. pin: Force specific fingerprint fields (see docs/pinning.md). headless: When ``True``, browser renders on a hidden virtual display (Xvfb on Linux, ``CreateDesktop`` on Windows) so Firefox stays in *headed* mode (real rendering pipeline, coherent fingerprint) without showing windows. proxy: ``{"server": "...", "username": "...", "password": "..."}``. ``socks5://`` / ``socks4://`` go through the patched ``nsProtocolProxyService``; ``http(s)://`` go through Playwright's own ``proxy=`` kwarg. extra_args: Extra command-line args forwarded to Firefox. humanize: Move the pointer along a curved, paced path instead of teleporting it. Applies to ``page.click`` / ``page.hover`` / ``locator.click`` / ``page.mouse.move`` and the rest of the ordinary Playwright pointer API - there is nothing new to call. Default ``True`` (~1.5 s cap per movement); ``False`` disables; a float caps a movement in seconds. The path is drawn from ``seed``, so the same seed replays the same motion. Set ``INVPW_CURSOR_ENGINE=binary`` to go back to letting the browser draw it, or ``=off`` to disable motion process-wide. locale: BCP-47 tag (e.g. ``"en-US"``) or ``"auto"`` (default). ``"auto"`` derives the locale from the egress country - the proxy egress IP, or the host's public IP without a proxy - exactly like ``timezone="auto"``, keeping the browser language consistent with the exit country (a French proxy → ``fr``). invisible_core makes the decision (``prepare_session_geo``) and turns the tag into the language list Firefox's own table gives it; every value reads that list: ``navigator.language``/``languages``, the locale prefs, the default context's locale and the q-valued ``Accept-Language`` header. A region with no Firefox build of its own reports the list's first entry everywhere (an Australian egress gives ``en-US, en``, so ``en-US``). timezone: IANA zone (e.g. ``"America/New_York"``) - used as-is when set, the only way to force a specific zone. ``""`` (default) or ``"auto"`` ALWAYS resolves from the egress IP: through the proxy when one is set, otherwise from the host's own public IP (one lookup + an offline mmdb). On failure: with a proxy it raises (a foreign proxy on the host TZ is the ``timezone_mismatch`` signal); without a proxy it falls back to the host TZ so a transient lookup failure can't break launch. extra_prefs: Optional dict of Firefox prefs overlayed on top of the generated profile - useful for niche tweaks without monkey-patching the package. profile_dir: Path to a persistent Firefox profile directory. When set, the session uses ``launch_persistent_context()`` so cookies, localStorage, sessionStorage, extensions, cache and prefs are kept on disk between runs. ``__enter__`` returns a ``BrowserContext`` (not a ``Browser``) - use it directly: ``with InvisiblePlaywright(profile_dir=p) as ctx: page = ctx.new_page()``. First run creates the dir; subsequent runs reuse it. Pair with a stable ``seed=`` to also pin the fingerprint identity across runs. show_cursor: Draw the pointer where the automation is, so a person watching the screen can follow the session - the Windows arrow, with the package logo's green halo around it. Default ``None``, meaning "not specified": the value is decided once, by ``invisible_core.prefs.DEFAULT_SHOW_CURSOR``, and today that is on. Pass ``False`` to draw nothing. What makes it safe either way is that it is drawn in the BROWSER'S OWN chrome window, which the page cannot reach - it is absent from ``page.screenshot()``, invisible to ``document.elementFromPoint``, and not a DOM node any site can enumerate. So it changes nothing a detector sees, and everything a PERSON sees: a dot gliding across a window with nobody touching the mouse reads as "this is a bot" to anyone glancing at the monitor. It is a demo and debugging switch, not a stealth one. N)rgr)$intsecretsrandbitsr*_pin _headless_proxylist _extra_args _humanizer_cursor_enginer- _show_cursor_locale_requested_locale _timezone _extra_prefs _binary_pathr _profile_dir_prep_recaptchar_profile_pw_browser_persistent_context_virtual_displayr_session_tokenr_lifetime_guard_webrtc_egress_ip_srflx_declared_ultimo_controllo_uscita_uscite_non_misurabili)selfr*rrr r!r"r#r$r%r&r'r(r)s NC:\Projects\Historical\venv\Lib\site-packages\invisible_playwright/launcher.py__init__zInvisiblePlaywright.__init___sj|'+&6TGrDr$r#rE egress_iprRsrflx_to_declarerSrrH_resolve_headless _build_prefs_configure_proxy_sharedrmintrP _build_envr startrLrImkdirfirefoxlaunch_persistent_contextr1r@_persistent_context_kwargsrN_bind_process_tree_arm_cursor_enginelaunchrMr BaseException _teardown_patch_new_context_defaults)rV_geo executable pw_headlessprefsplaywright_proxyrbs rW __enter__zInvisiblePlaywright.__enter__sa#4>4;@VWW{ !% $4466((9:: ,,.. !!##24;FF*/11ooe$$Y &((..00DH ,l!''t'DDD+U48+;+U ,"%d&7"8"8$' OO(',*) , ,5577 , ,('')))''(@AAA// H,33 #J$#(&% 4DM  . . .  # # % % % %    NN       ((777  ...}sCH4A$H H9Dict[str, Any]c*|S)aContext-level kwargs accepted by launch_persistent_context. Identical to ``_default_context_kwargs``: viewport / screen / DPR / color-scheme / locale / timezone_id. Up to firefox-4 we had to drop locale and timezone_id because Playwright's per-realm overrides called IDL methods (``docShell.languageOverride``, ``docShell.overrideTimezone``) that weren't exposed by our patched build, causing launch_persistent_context to hang for 180s. From firefox-5 (C7 chiusura), the C++ ``overrideTimezone`` method is present and ``languageOverride`` was already there, so the per-realm overrides land and the persistent context starts in ~20s like the non-persistent path. )_default_context_kwargsrVs rWroz.InvisiblePlaywright._persistent_context_kwargss++---rYg^@c|jr|jsdStj}||jz |jkrdS||_t j|j|j\}}|t jkr t j d|jd|d|t j kr>|xj dz c_ |j |j krt j d|j zdSd|_ dS)a\Refuses if the egress IP has changed since launch. A change mid-session cannot be recovered from: the IP we declare to the engine for the srflx was photographed at launch, so from that moment the page exits from one address and WebRTC announces another - the disagreement detectors look for. Updating it on the fly would not help: it would make the WebRTC IP change under the site's eyes, which is just as unnatural. If the egress does not hold for the session's duration, that proxy is not sticky and is not fit for this purpose. Nz9the proxy's egress IP changed during the session: it was z at launch, now it is a-. The WebRTC srflx candidate still declares the first one, so from this moment the page exits from one address and WebRTC announces another - the disagreement detectors look for. This proxy does not hold the session sticky for the required duration: use one that guarantees it, or shorten the session.r a,the egress IP was not verifiable for %d checks in a row. It is not drift - the probe did not respond at all - but it is not parity either: from here on the engine would keep declaring an address on every page that nobody confirms anymore. Check that the proxy is reachable, then relaunch the session.r)r>rRtime monotonicrT_INTERVALLO_CONTROLLO_USCITA_Sregress_ancora_validoUSCITA_DERIVATAProxyEgressDriftedUSCITA_NON_MISURABILErU_MAX_USCITE_NON_MISURABILIProxyEgressNonVerificabile)rVnowoutcomecurrents rW_assert_uscita_invariataz,InvisiblePlaywright._assert_uscita_invariatas { $"8  Fn . .1T T T F(+%#8 K/11 h. . .--)))7774 5 5 5 h4 4 4  ' '1 , ' '*d.MMM9< 1 2333 F&'###rYbrowserr c |jjj j fd  fd}||_|j fd}||_dS)a<Wrap ``browser.new_context`` AND ``browser.new_page`` so their defaults derive from the profile (viewport, screen, DPR, color-scheme, locale, timezone). Users get a coherent context for free; explicit kwargs still override. BOTH, because ``new_page`` does not go through the patched ``new_context``. Playwright's sync ``Browser.new_page`` forwards to the IMPLEMENTATION object, whose own ``new_page`` calls ``self.new_context`` - itself, the impl - so a wrapper installed on the sync-api object is never consulted. Read on the installed Playwright, and it is the call in this package's own README and docstring: ``browser.new_page()`` was opening a page with Playwright's stock 1280x720 viewport, the host's colour scheme and no locale or timezone override, against a fingerprint claiming the profile's screen. A viewport that contradicts ``screen.width`` is not a missing feature, it is an inconsistency, which is the one thing this package exists to avoid. Written through the public ``new_page`` rather than by reaching into the impl: that keeps Playwright's own ownership wiring (closing the page closes the context it owns) instead of reimplementing it against private attributes. cr |tdS#t$rYdSwxYwN) add_cookiesr Exception)ctxlocprofiles rW seed_cookieszEInvisiblePlaywright._patch_new_context_defaults..seed_cookiessL  = =>>>>>    s #( 66c t}||di|}r ||j fd}||_|S)Nc<di|SNrc)r)kw2 _new_page_ctxrVs rW_new_page_guardedz[InvisiblePlaywright._patch_new_context_defaults..patched.._new_page_guardeds+--///$}++s+++rYrc)rdictupdatenew_page) kwmergedrrrdefaultsoriginalpreprrVs @rWpatchedz@InvisiblePlaywright._patch_new_context_defaults..patcheds  ) ) + + +(^^F MM"   ($$V$$C " S!!!$ LM , , , , , ,-CLJrYct}||di|}|j}r ||Sr)rrrcontext) rrpagerr original_pagerrrVs rW patched_pagezEInvisiblePlaywright._patch_new_context_defaults..patched_page!sk  ) ) + + +(^^F MM"    =**6**D,C " S!!!KrYN) new_contextr~rJrKrEr) rVrrrrrrrrrrs ` @@@@@@@rWruz/InvisiblePlaywright._patch_new_context_defaultss.&//11#-l               B&(          (rYexcrc.|dSr)rt)rVrs rW__exit__zInvisiblePlaywright.__exit__.s rYch|j2 |jn#t$rYnwxYwd|_|j2 |jn#t$rYnwxYwd|_|j2 |jn#t$rYnwxYwd|_|j2 |jn#t$rYnwxYwd|_|jrF |j |jn#t$rYnwxYwt|_dSdSr) rNcloserrMrLstoprOrPrQreaprrs rWrtzInvisiblePlaywright._teardown1s  # / (..0000    '+D $ = $  ##%%%%     DM 8       DH  , %**,,,,    $(D !   1 $))$*=>>>>    "...D     1 1sT# 00A A)(A);B B"!B"4C CC-D DDr)r*r+rr,rr-r r.r!r/r"r0r#r1r$r1r%r,r&r2r'r3r(r-r)r4r5r6)r5rZ)r5r|)r5r6)rr r5r6)rrr5r6) __name__ __module__ __qualname____doc__rXr{rorrrrurrtrcrYrWrr?sB#c-)-*.*.'+04%)26$&*c-c-c-c-c-c-JF....&&+""#1(1(1(1(fU(U(U(U(p#1#1#1#1#1#1rYr))r __future__rr:rpathlibrtypingrrrr!invisible_playwright._pw.sync_apir r r r rr_cursorrinvisible_core._fpforgerrinvisible_corerrr_enginerrrrh_reaperrr_IANA_TO_POSIX_TZtz_env_tz_env CommonLaunchrrcrYrWrsy88"""""" ------------bbbbbbbbbbbb******========NNNNNNNNNN<<<<<<<<EEEEEE,,,,,,,,T. /U1U1U1U1U1(/U1U1U1U1U1rY