o US`c4@sddlZddlmZddlZddlmZddlZddlmZddl Z ddl m Z ddl m ZddlmZdd lmZdd lmZdd lmZdd lmZmZdZd ZGdddeZ dS)N)BytesIO)rmtree)contextmanager)DesiredCapabilities) WebDriver) FirefoxBinary)FirefoxProfile)Options)FirefoxRemoteConnection)DEFAULT_EXECUTABLE_PATHServicezgeckodriver.logc seZdZdZdZddddededddedf fdd Zdfdd Z e d d Z dd d Z e ddZddefddZdddZdefddZdefddZdefddZdefddZZS)rZchromecontentNTc s|tkr tjdtdd|s| rtjdtdd|r"tjdtddd|_|r/tjdtddd|_| tkr>tjdtdd|tkrJtjd tdd|rTtjd tdd| |_|s]| r]| }|sdt j }|sit }t |}|d rw|d |_|r|jr|j|_|jr|j|_|rt|trt|}||_||_|rt|trt|}||_||_|d r|jsd |_|jst|||d|_|jt|jj|jd} tj| |ddd |_dS)a Starts a new local session of Firefox. Based on the combination and specificity of the various keyword arguments, a capabilities dictionary will be constructed that is passed to the remote end. The keyword arguments given to this constructor are helpers to more easily allow Firefox WebDriver sessions to be customised with different options. They are mapped on to a capabilities dictionary that is passed on to the remote end. As some of the options, such as `firefox_profile` and `options.profile` are mutually exclusive, precedence is given from how specific the setting is. `capabilities` is the least specific keyword argument, followed by `options`, followed by `firefox_binary` and `firefox_profile`. In practice this means that if `firefox_profile` and `options.profile` are both set, the selected profile instance will always come from the most specific variable. In this case that would be `firefox_profile`. This will result in `options.profile` to be ignored because it is considered a less specific setting than the top-level `firefox_profile` keyword argument. Similarly, if you had specified a `capabilities["moz:firefoxOptions"]["profile"]` Base64 string, this would rank below `options.profile`. :param firefox_profile: Deprecated: Instance of ``FirefoxProfile`` object or a string. If undefined, a fresh profile will be created in a temporary location on the system. :param firefox_binary: Deprecated: Instance of ``FirefoxBinary`` or full path to the Firefox binary. If undefined, the system default Firefox installation will be used. :param capabilities: Deprecated: Dictionary of desired capabilities. :param proxy: Deprecated: The proxy settings to use when communicating with Firefox via the extension connection. :param executable_path: Deprecated: Full path to override which geckodriver binary to use for Firefox 47.0.1 and greater, which defaults to picking up the binary from the system path. :param options: Instance of ``options.Options``. :param service_log_path: Deprecated: Where to log information from the driver. :param service_args: Deprecated: List of args to pass to the driver service :param desired_capabilities: Deprecated: alias of capabilities. In future versions of this library, this will replace 'capabilities'. This will make the signature consistent with RemoteWebDriver. :param keep_alive: Whether to configure remote_connection.RemoteConnection to use HTTP keep-alive. zDexecutable_path has been deprecated, please pass in a Service object) stacklevelz[capabilities and desired_capabilities have been deprecated, please pass in a Service objectzCfirefox_binary has been deprecated, please pass in a Service objectNzEfirefox_profile has been deprecated, please pass in an Options objectz=log_path has been deprecated, please pass in a Service objectzEservice_log_path has been deprecated, please pass in a Service objectzAservice_args has been deprecated, please pass in a Service objectbinaryZacceptInsecureCertsF) service_argslog_path)Zremote_server_addrZ ignore_proxyT)Zcommand_executoroptions keep_alive)r warningswarnDeprecationWarningrprofileDEFAULT_LOG_PATHDEFAULT_SERVICE_LOG_PATHservicerZFIREFOXcopyr dictget isinstancestrrr Zaccept_insecure_certsr startr Z service_urlZ_ignore_local_proxysuper__init__Z _is_remote)selffirefox_profilefirefox_binaryZ capabilitiesproxyZexecutable_pathrZservice_log_pathrrZdesired_capabilitiesrrexecutor __class__O/usr/local/lib/python3.10/dist-packages/selenium/webdriver/firefox/webdriver.pyr$-s7       zWebDriver.__init__returnc sztWn tyYnw|j|jrIzt|jj|jjr-t|jjWdSWdStyH}z t t |WYd}~dSd}~wwdS)z3Quits the driver and close every associated window.N) r#quit ExceptionrstoprrpathZ tempfolderprintr!)r%er*r,r-r/s"   zWebDriver.quitcCs|jS)N)rr%r,r,r-r&szWebDriver.firefox_profilecCs|dd|idS)NZ SET_CONTEXTcontextexecute)r%r6r,r,r- set_contextszWebDriver.set_contextc cs@|dd}||z dVW||dS||w)aSets the context that Selenium commands are running in using a `with` statement. The state of the context on the server is saved before entering the block, and restored upon exiting it. :param context: Context, may be one of the class properties `CONTEXT_CHROME` or `CONTEXT_CONTENT`. Usage example:: with selenium.context(selenium.CONTEXT_CHROME): # chrome scope ... do stuff ... Z GET_CONTEXTvalueN)r8popr9)r%r6Zinitial_contextr,r,r-r6s  zWebDriver.contextFc Cstj|rSt}t|d}t|dtj)}t|D]\}}}|D]} tj || } | | | |dq$qWdn1sCwYt | d} nt|d} t | d} Wdn1smwY| |d} |d| dS) a> Installs Firefox addon. Returns identifier of installed addon. This identifier can later be used to uninstall addon. :param path: Absolute path to the addon that will be installed. :Usage: :: driver.install_addon('/path/to/firebug.xpi') rwNzUTF-8rb)addon temporaryZ INSTALL_ADDONr:)osr2isdirrlenzipfileZipFile ZIP_DEFLATEDwalkjoinwritebase64 b64encodegetvaluedecodeopenreadr8)r%r2r?fpZ path_rootZzippedbasedirsfilesZfylefilenamer>filepayloadr,r,r- install_addons"    zWebDriver.install_addoncCs|dd|idS)z Uninstalls Firefox addon using its identifier. :Usage: :: driver.uninstall_addon('addon@foo.com') ZUNINSTALL_ADDONidNr7)r% identifierr,r,r-uninstall_addon zWebDriver.uninstall_addoncCs|ds tdt|}z1z$t|d }||Wdn 1s(wYWW~dSWW~dStyBYW~dSw~w)a Saves a full document screenshot of the current window to a PNG image file. Returns False if there is any IOError, else returns True. Use full paths in your filename. :Args: - filename: The full path you wish to save your screenshot to. This should end with a `.png` extension. :Usage: :: driver.get_full_page_screenshot_as_file('/Screenshots/foo.png') z.pngz^name used for saved screenshot does not match file type. It should end with a `.png` extensionwbNFT) lowerendswithrr UserWarningget_full_page_screenshot_as_pngrMrHOSError)r%rSZpngfr,r,r- get_full_page_screenshot_as_files&    z*WebDriver.get_full_page_screenshot_as_filecCs ||S)a Saves a full document screenshot of the current window to a PNG image file. Returns False if there is any IOError, else returns True. Use full paths in your filename. :Args: - filename: The full path you wish to save your screenshot to. This should end with a `.png` extension. :Usage: :: driver.save_full_page_screenshot('/Screenshots/foo.png') )rb)r%rSr,r,r-save_full_page_screenshot/s z#WebDriver.save_full_page_screenshotcCst|dS)z Gets the full document screenshot of the current window as a binary data. :Usage: :: driver.get_full_page_screenshot_as_png() ascii)rI b64decode"get_full_page_screenshot_as_base64encoder5r,r,r-r_@rZz)WebDriver.get_full_page_screenshot_as_pngcCs|ddS)z Gets the full document screenshot of the current window as a base64 encoded string which is useful in embedded images in HTML. :Usage: :: driver.get_full_page_screenshot_as_base64() ZFULL_PAGE_SCREENSHOTr:r7r5r,r,r-rfKs z,WebDriver.get_full_page_screenshot_as_base64)r.N)F)__name__ __module__ __qualname__ZCONTEXT_CHROMEZCONTEXT_CONTENTr rrr$r/propertyr&r9rr6r!rVrYboolrbrcr_rf __classcell__r,r,r*r-r(s.       r)rIiorr@shutilrr contextlibrrCZ.selenium.webdriver.common.desired_capabilitiesrZ#selenium.webdriver.remote.webdriverrZRemoteWebDriverr'rr&r rr Zremote_connectionr rr r rrr,r,r,r-s"