a 7jL@sDdZddlZddlZddlmZGdddZd ejdddZdS) ab The SeleniumBase Driver as a Python Context Manager or a returnable object. ########################################################################### The SeleniumBase Driver as a context manager: Usage --> ``with DriverContext() as driver:`` Example --> ```python from seleniumbase import DriverContext with DriverContext(uc=True) as driver: driver.get("https://google.com/ncr") ``` # (The browser exits automatically after the "with" block ends.) ########################################################################### # Above: The driver as a context manager. (Used with a "with" statement.) # # ----------------------------------------------------------------------- # # Below: The driver as a returnable object. (Used with "return" command.) # ########################################################################### The SeleniumBase Driver as a returnable object: Usage --> ``driver = Driver()`` Example --> ```python from seleniumbase import Driver driver = Driver(uc=True) driver.get("https://google.com/ncr") ``` ########################################################################### N) sb_driverc@s$eZdZddZddZddZdS) DriverContextcOst|i||_dSN)Driverdriver)selfargskwargsr IE:\soccer\ml_env\Lib\site-packages\seleniumbase/plugins/driver_manager.py__init__-szDriverContext.__init__cCs|jSr)r)rr r r __enter__0szDriverContext.__enter__cCsPz8t|dr6t|jdr6dtjvs,|jjjr6|jWntyJYn0dS)Nrquitwin32F)hasattrrsysplatformZserviceprocessr Exception)rexc_typeexc_valexc_tbr r r __exit__3s  zDriverContext.__exit__N)__name__ __module__ __qualname__r r rr r r r r,sr)returncLs<Cs ddlm}Lddlm}Mddlm}Nddlm}Oddlm}Pddlm }Qt j }Rd |R}Sd }Td |Rvpjd |Rv}Ut |Ld oz|Lj}Vt |Ld r|Ljst |Ldr|Ljst |Ldr|Ljrd}T|Tr.t |Lds.t |Ldr|Ljrddl}Wd}X|Us|Vstd|X|Us|Vs,|Wjddnt |Ldr:|Ljr:tdn |Tr:d|L_d|L_d|L_d|L_d}Yd}Zd}[g}\d }]|0rtt|0dkrtjt|0rd}]n|RD]}^|^dvrd}]q|r||Pjj vr|]s|O!|}_|_rtj|_r||_"#dd#ddvr||L_|_|L_|_}0d}]d|Rvs,d|RvrB|Yd7}Yd}Z|\$dd |RvsVd!|Rvrl|Yd7}Yd"}Z|\$d d#|Rvsd$|Rvr|Yd7}Yd%}Z|\$d#d&|Rvsd'|Rvr|Yd7}Yd(}Z|\$d&d)|Rvsd*|Rvr|Yd7}Yd+}Z|\$d)d,|Rvsd-|Rvr|Yd7}Yd.}Z|\$d,d/|Rvs(d0|Rvrn|]sn|O!d1}_tj|_rn|Yd7}Yd1}Zd1|L_d1|L_|_|L_|\$d/d2|Rvsd3|Rvr|]s|O!d4}_tj|_r|Yd7}Yd4}Zd4|L_d4|L_|_|L_|\$d2d5|Rvsd6|Rvr"|]s"|O!d7}_tj|_r"|Yd7}Yd7}Zd7|L_d7|L_|_|L_|\$d5d8|Rvs6d9|Rvr||]s||O!d:}_tj|_r||Yd7}Yd:}Zd:|L_d:|L_|_|L_|\$d8|Z}[d;|Rvr|Zdks|Yd7}Yd}[|\$d;d<|Rvr|Zd"ks|Yd7}Yd"}[|\$d<d=|Rvr|Zd%ks|Yd7}Yd%}[|\$d=d>|Rvr(|Zd+ks(|Yd7}Yd+}[|\$d>d?|RvrR|Zd(ksR|Yd7}Yd(}[|\$d?d@|Rvr|Zd1ks|]s|O!d1}_tj|_r|Yd7}Yd1}[d1|L_d1|L_|_|L_|\$d@dA|Rvr|Zd4ks|]s|O!d4}_tj|_r|Yd7}Yd4}[d4|L_d4|L_|_|L_|\$dAdB|Rvr`|Zd7ks`|]s`|O!d7}_tj|_r`|Yd7}Yd7}[d7|L_d7|L_|_|L_|\$dBdC|Rvr|Zd:ks|]s|O!d:}_tj|_r|Yd7}Yd:}[d:|L_d:|L_|_|L_|\$dC|YdkrdD}`|`dE|YdF |\f7}`|`dG7}`|`dH7}`|st|`|dur|[r|[}nd}n|"}|Pj%j&}a||avrBtdI||af|LjrP|Lj}|durndJ|Rvrjd}nd }|durdK|Rvrd}nd }|rd}|durdL|Rvrd}nd }|durdM}|Edur|dur|E}|durdN}d }b|dNkrd}b|durdO}|dur&dP|Rvr"d}nd }|Fdur>|dur>|F}|dur\dQ|RvrXd}nd }| durzdR|Rvrvd} nd } |!durdS|Rvrd}!nd }!|8dur|7dur|8}7|7durdT|Rvrd}7nd }7dU}c| }d|ddu rdV|Sv rdW|Sv r|S#dWd#dd}dn"dX|Sv r0|S#dXd#dd}d|d r|d'dY r\|d(dY r\|ddd}dn$|d'dZ r|d(dZ r|ddd}d|)}e|edu rd[|Sv rd}f|RD]n}^|^'d\ r|^#d\d}e qn>|^d[k rt|R|fdk r|R|fd}e|e'd] rd}e q|fd7}f q|e})|/}g|gdu rd^|Sv rd}f|RD]n}^|^'d_ rZ|^#d_d}g qn>|^d^k rt|R|fdk r|R|fd}g|g'd] rd}g q|fd7}f q4|g}/|5du r||^d`k rDt|R|fdk rD|R|fd}h|h'd] r>d}h qP|fd7}f q|h}5|5 r|5)dbdk rzdc|5}`t|`|5*ddd}5d}id}jz(t+|5#dbd}it+|5#dbd}jWn$t yde|5}`t|`Yn0|i|M_,|j|M_-|6du r|=du r|=}6|6}k|kdu rdf|Sv rd}f|RD]n}^|^'dg rF|^#dgd}k qn>|^dfk rt|R|fdk r|R|fd}k|k'd] r~d}k q|fd7}f q |k}6|6 r4|6)dbdk rdh|6}`t|`|6*ddd}6d}ld}mz(t+|6#dbd}lt+|6#dbd}mWn$t ydi|6}`t|`Yn0|l|M_.|m|M_/|l|M_0|m|M_1| du rdj|Sv rd}f|RD]n}^|^'dk rv|^#dkd}  qn>|^djk rt|R|fdk r|R|fd} | 'd] rd}  q|fd7}f qP| }nd}ot |Ldl r|Lj r|Lj}0|0durxdm|Svrxd}f|RD]n}^|^'dnr$|^#dnd}oqnn>|^dmkrbt|R|fdkrb|R|fd}o|o'd]r\d}oqn|fd7}f q|orx|o}0|0durdo|Svr|RD]&}^|^'dor|^#dod}0qq|Kr|0sdp}0n"|Ir|0sdq}0n|Jr|0sdr}0ds|Rvr|0sdp}0n*dt|Rvr|0sdq}0ndu|Rvr,|0s,dr}0|0rV|0"drkrV|dkrVd}d }d }d }p|rdd}pdv|Rvsdw|Rvsdx|Rvrd}pd}|s|?s|>s|s|@s|s|Ard}|s|?s|>rd}n|dy|Rvs*dz|Rvs*d{|Rvs*d||Rvs*d}|Rvs*d~|Rvs*d|Rvs*d|Rvs*d|RvrHd}|durL|AdurLd}nd }|sX|Ar^d}n(d|Rvs|d|Rvs|d|Rvrd}nd }|s|@rd}d}n6d||Rvsd}|Rvsd~|Rvsd|Rvrd}d}nd }|r|dvrd||f}`t|`|durd|Rvsd|Rvrd}nd }|Q2r`|s`|s`|s`|r\dtj34vs\tj3ds`d}|prx|rxd }d }d}|r|d%krd }d}n|dvrd }|durd|Rvsd|Rvsd|Rvrd}nd }|dur |dur d|Rvsd|Rvsd|Rvr d }n>|dur|dus>|dur.|r>|durD|rDd}nd }|dur|Cdurd|Rvsd|Rvsd|Rvsd|Rvrd}nd }n|s|Crd}nd }|durd|Rvrd}nd }|durd|Rvrd}nd }|durd|Rvrd}nd }|Hdur|2dur|H}2|2std|Svrtd|Rvs|^dkrt|R|fdkr|R|fd}1|1'd]rd}1q|fd7}fql|1durhd|Svrhd}f|RD]n}^|^'dr|^#dd}1qhn>|^dkr\t|R|fdkr\|R|fd}1|1'd]rVd}1qh|fd7}fq||Pjj vr|0sd}||L_|}q|Nj5|q|||b||||d| | | |n|||||||||||||||||||| |!|"|#|$|%|&|'|(|)|*|+|,|-|.|/|0|1|2|3|4|c|7|9|:|;|qd:}r|rS)a * SeleniumBase Driver as a Python Context Manager or a returnable object. * Example 1: (context manager format) ----------------------------------- .. code-block:: python from seleniumbase import DriverContext with DriverContext() as driver: driver.get("https://google.com/ncr") Example 2: (as a Python returnable) ----------------------------------- .. code-block:: python from seleniumbase import Driver driver = Driver() driver.get("https://google.com/ncr") Optional Parameters: -------------------- browser (str): Choose from "chrome", "edge", "firefox", or "safari". headless (bool): Use the default headless mode for Chromium and Firefox. headless1 (bool): Use Chromium's old headless mode. (Fast, but limited) headless2 (bool): Use Chromium's new headless mode. (Has more features) headed (bool): Run tests in headed/GUI mode on Linux, where not default. locale_code (str): Set the Language Locale Code for the web browser. protocol (str): The Selenium Grid protocol: "http" or "https". servername (str): The Selenium Grid server/IP used for tests. port (int): The Selenium Grid port used by the test server. proxy (str): Use proxy. Format: "SERVER:PORT" or "USER:PASS@SERVER:PORT". proxy_bypass_list (str): Skip proxy when using the listed domains. proxy_pac_url (str): Use PAC file. (Format: URL or USERNAME:PASSWORD@URL) multi_proxy (bool): Allow multiple proxies with auth when multi-threaded. agent (str): Modify the web browser's User-Agent string. cap_file (str): The desired capabilities to use with a Selenium Grid. cap_string (str): The desired capabilities to use with a Selenium Grid. recorder_ext (bool): Enables the SeleniumBase Recorder Chromium extension. disable_cookies (bool): Disable Cookies on websites. (Pages might break!) disable_js (bool): Disable JavaScript on websites. (Pages might break!) disable_csp (bool): Disable the Content Security Policy of websites. enable_ws (bool): Enable Web Security on Chromium-based browsers. disable_ws (bool): Reverse of "enable_ws". (None and False are different) enable_sync (bool): Enable "Chrome Sync" on websites. use_auto_ext (bool): Use Chrome's automation extension. undetectable (bool): Use undetected-chromedriver to evade bot-detection. uc_cdp_events (bool): Capture CDP events in undetected-chromedriver mode. uc_subprocess (bool): Use undetected-chromedriver as a subprocess. log_cdp_events (bool): Capture {"performance": "ALL", "browser": "ALL"} no_sandbox (bool): (DEPRECATED) - "--no-sandbox" is always used now. disable_gpu (bool): (DEPRECATED) - GPU is disabled if not "swiftshader". incognito (bool): Enable Chromium's Incognito mode. guest_mode (bool): Enable Chromium's Guest mode. dark_mode (bool): Enable Chromium's Dark mode. devtools (bool): Open Chromium's DevTools when the browser opens. remote_debug (bool): Enable Chrome's Debugger on "http://localhost:9222". enable_3d_apis (bool): Enable WebGL and 3D APIs. swiftshader (bool): Chrome: --use-gl=angle / --use-angle=swiftshader-webgl ad_block_on (bool): Block some types of display ads from loading. host_resolver_rules (str): Set host-resolver-rules, comma-separated. block_images (bool): Block images from loading during tests. do_not_track (bool): Tell websites that you don't want to be tracked. chromium_arg (str): "ARG=N,ARG2" (Set Chromium args, ","-separated.) firefox_arg (str): "ARG=N,ARG2" (Set Firefox args, comma-separated.) firefox_pref (str): SET (Set Firefox PREFERENCE:VALUE set, ","-separated) user_data_dir (str): Set the Chrome user data directory to use. extension_zip (str): Load a Chrome Extension .zip|.crx, comma-separated. extension_dir (str): Load a Chrome Extension directory, comma-separated. disable_features (str): "F1,F2" (Disable Chrome features, ","-separated.) binary_location (str): Set path of the Chromium browser binary to use. driver_version (str): Set the chromedriver or uc_driver version to use. page_load_strategy (str): Set Chrome PLS to "normal", "eager", or "none". use_wire (bool): Use selenium-wire's webdriver over selenium webdriver. external_pdf (bool): Set Chrome "plugins.always_open_pdf_externally":True window_position (x,y): Set the browser's starting window position: "X,Y" window_size (w,h): Set the browser's starting window size: "Width,Height" is_mobile (bool): Use the mobile device emulator while running tests. mobile (bool): Shortcut / Duplicate of "is_mobile". d_width (int): Set device width d_height (int): Set device height d_p_r (float): Set device pixel ratio position (x,y): Shortcut / Duplicate of "window_position". size (w,h): Shortcut / Duplicate of "window_size". uc (bool): Shortcut / Duplicate of "undetectable". undetected (bool): Shortcut / Duplicate of "undetectable". uc_cdp (bool): Shortcut / Duplicate of "uc_cdp_events". uc_sub (bool): Shortcut / Duplicate of "uc_subprocess". locale (str): Shortcut / Duplicate of "locale_code". log_cdp (bool): Shortcut / Duplicate of "log_cdp_events". ad_block (bool): Shortcut / Duplicate of "ad_block_on". server (str): Shortcut / Duplicate of "servername". guest (bool): Shortcut / Duplicate of "guest_mode". wire (bool): Shortcut / Duplicate of "use_wire". pls (str): Shortcut / Duplicate of "page_load_strategy". r)config)settings)browser_launcher) detect_b_ver) constants) shared_utils Fz--coz--collect-only all_scripts is_behave is_pytest is_nosetestT_context_of_runnerNz8Skipping `Driver()` script. (Use `python`, not `pytest`)z *** %s)Zallow_module_levelzt A Driver() script was triggered by nosetest collection! (Prevent that by using: ``if __name__ == "__main__":``))--binary-locationz--binary_locationz--bl/\z--browser=chromez--browser chromechromez--browser=edgez--browser edgeedgez--browser=firefoxz--browser firefoxZfirefoxz--browser=safariz--browser safariZsafariz --browser=iez --browser ieZiez--browser=remotez--browser remoteremotez--browser=operaz--browser operaoperaz--browser=bravez--browser bravebravez--browser=cometz--browser cometcometz--browser=atlasz--browser atlasatlasz--chromez--edgez --firefoxz--iez--safariz--operaz--bravez--cometz--atlasz( TOO MANY browser types were entered!z There were %s found: > %sz, z' ONLY ONE default browser is allowed!z( Select a single browser & try again! zABrowser: {%s} is not a valid browser option. Valid options = {%s}z --headlessz --headless1z --headless2http localhostZ4444z --incognitoz--guestz--darkz --devtoolsz--mobileZ direct_driverz--proxyz--proxy=z--proxy "'z--chromium-argz--chromium-arg=-z--disable-featuresz--disable-features=z--window-positionz--window-position=,zF window_position expects an "x,y" string! (Your input was: "%s") zL Expecting integer values for "x,y"! (window_position input was: "%s") z --window-sizez--window-size=zJ window_size expects a "width,height" string! (Your input was: "%s") zQ Expecting integer values for "width,height"! (window_size input was: "%s") z--agentz--agent= _cdp_bin_locr*z--binary-location=z--bl=Z _chromium_cftchsz--use-chromiumz--cftz--chsz --recorderz--recordz--recz--undetectablez --undetectedz--ucz--uc-cdp-eventsz--uc_cdp_eventsz--uc-cdpz--uc-subprocessz--uc_subprocessz--uc-subz--uc_cdp)r/r2r3r4r5z Undetected-Chromedriver Mode ONLY supports Chromium browsers! ("uc=True" / "undetectable=True" / "--uc") (Your browser choice was: "%s".) (Will use "%s" without UC Mode.) z--guiz--headedZDISPLAY)r/r0r2r3r4r5z --disable-cspz--no-cspz--dcspz--disable-web-securityz --disable-wsz--dwsz--log-cdp-eventsz--log_cdp_eventsz --log-cdpz --log_cdpz--use-auto-extz--disable-cookiesz --disable-jsz--pls=z --pls=nonez --pls="none"nonez --pls=eagerz --pls="eager"eagerz --pls=normalz--pls="normal"normal)rBrAr@z8page_load_strategy must be "normal", "eager", or "none"!z--block-imagesz--block_imagesz--do-not-trackz--do_not_trackz--wirez--external-pdfz--external_pdfz--remote-debugz--remote_debugz--enable-3d-apisz--enable_3d_apisz --swiftshaderz --locale="z --locale=z--locale-code="z--locale-code=z --ad-blockz --ad_blockz--host-resolver-rules="z--host_resolver_rules="z--host_resolver_rules=z--driver-versionz--driver-version=z--driver_versionz--driver_version=): browser_nameheadless locale_codeuse_gridprotocol servernameport proxy_stringproxy_bypass_list proxy_pac_url multi_proxy user_agentcap_file cap_string recorder_extdisable_cookies disable_js disable_csp enable_ws enable_sync use_auto_ext undetectable uc_cdp_events uc_subprocesslog_cdp_events no_sandbox disable_gpu headless1 headless2 incognito guest_mode dark_modedevtools remote_debugenable_3d_apis swiftshader ad_block_onhost_resolver_rules block_images do_not_track chromium_arg firefox_arg firefox_pref user_data_dir extension_zip extension_dirdisable_featuresbinary_locationdriver_versionpage_load_strategyuse_wire external_pdftest_idZmobile_emulatorZ device_widthZ device_heightZdevice_pixel_ratiobrowser)6Z seleniumbaserZseleniumbase.configrseleniumbase.corerr Zseleniumbase.fixturesr!r"rargvjoinrr$r%r&r'pytestprintskiprr(Z_browser_shortcutZ _cdp_browserr=lenstrospathexistsZ ChromiumSubsZ chromium_subsZget_binary_locationlowersplitappendZ ValidBrowsersvalid_browsers startswithendswithcountreplaceintZWINDOW_START_XZWINDOW_START_YZCHROME_START_WIDTHZCHROME_START_HEIGHTZHEADLESS_START_WIDTHZHEADLESS_START_HEIGHTZis_linuxenvironkeysZ get_driver)srxrDr^r_ZheadedrErGrHrIproxyrKrLrMZagentrOrPrQrRrSrTrUZ disable_wsrVrWrXrYrZr[r\r]r`rarbrcrdrerfrgrhrirjrkrlrmrnrorprqrrrsrtrurvZwindow_positionZ window_sizeZ is_mobileZmobileZd_widthZd_heightZd_p_rpositionsizeZucZ undetectedZuc_cdpZuc_sublocaleZlog_cdpZad_blockserverZguestZwireZplsr>r?Z use_chromiumZ sb_configrrr r!r"Zsys_argvZarg_joinZexisting_runnerZ collect_onlyr$r|msgZbrowser_changesZ browser_setZ browser_textZ browser_listZbin_loc_in_optionsargZbin_locmessagerrFrwrJZc_arZd_fZw_pZwin_xZwin_yZw_swidthheightrNZfound_blZ recorder_moderCrr r r rCs .            "                                                                                                                                   s& M