U
|
\ ±d 9 ã @ sÞ d dl Z d dlZd dlZd dlZd dlZd dlmZ d dlmZ d dl m
|
Z
|
d dl m Z d dl mZ d dlmZ dd lmZ dd
|
lmZ dd lmZ dd lmZ dd lmZ ddlm Z e e ¡Z dZ dZ!G dd deZdS )é N)Úcontextmanager)ÚBytesIO)Úrmtree)ÚDesiredCapabilities)Ú DriverFinder)Ú WebDriveré )Ú FirefoxBinary)ÚFirefoxProfile)ÚOptions)ÚFirefoxRemoteConnection)ÚDEFAULT_EXECUTABLE_PATH)ÚServicezgeckodriver.logc sà e Zd ZdZdZddddededddedf dd fdd Zdd fdd Z ddd
|
d Z
|
e d d Z ddddZ edd Zd edddZddddZedddZedddZeddd Zedd d Z ZS ) r ZchromeÚcontentNT)Úreturnc sÜ |t krtjdtdd |s |
|
r0tjdtdd |rDtjdtdd d| _|r^tjdtdd d| _| tkr|tjdtdd |tkrtjd tdd |r¨tjd
|
tdd | | _|sº|
|
rº|
|
}|sÈt j
|
¡ }|sÒt }t |}| d ¡rî|d |_|r|jr|j| _|jr|j| _|r:t|tr.t|}|| _||_|r`t|trTt|}|| _||_| d ¡rt|jszd |_| jst|||d| _t | j|¡| j_| j ¡ t| jj|jd} t j | |dd d | _ dS )ac 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: (Optional) service instance for managing the starting and stopping of the driver.
|
: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 objectÚbinaryZacceptInsecureCertsF)Ú service_argsÚlog_path)Zremote_server_addrZ ignore_proxyT)Zcommand_executorÚoptionsÚ
|
keep_alive) r ÚwarningsÚwarnÚDeprecationWarningr ÚprofileÚDEFAULT_LOG_PATHÚDEFAULT_SERVICE_LOG_PATHÚservicer ZFIREFOXÚcopyr ÚdictÚgetÚ
|
isinstanceÚstrr r
|
Zaccept_insecure_certsr r Úget_pathÚpathÚstartr Z service_urlZ_ignore_local_proxyÚsuperÚ__init__Z
|
_is_remote)ÚselfÚfirefox_profileÚfirefox_binaryZ capabilitiesÚproxyZexecutable_pathr Zservice_log_pathr r Zdesired_capabilitiesr r Úexecutor©Ú __class__© ú[d:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\selenium/webdriver/firefox/webdriver.pyr( 0 s¢ A ÿý ÿý ÿý ÿ
|
|
|
|
ÿzWebDriver.__init__c s zt ¡ W n tk
|
r" Y nX | j ¡ | jrxz$t| jj | jjrVt| jj W n tk
|
rv t
|
d¡ Y nX | ¡ dS )z3Quits the driver and close every associated window.z(Unable to remove profile specific paths.N) r' ÚquitÚ Exceptionr Ústopr r r% Z
|
tempfolderÚloggerÚ exceptionÚ_close_binary_file_handle©r) r. r0 r1 r2 Í s
|
zWebDriver.quitc C sN z*t | jtr(t| jjdr(| jj ¡ W n tk
|
rH t d¡ Y nX dS )zèAttempts to close the underlying file handles for `FirefoxBinary`
|
instances if they are used and open.
|
|
To keep inline with other cleanup raising here is swallowed and
|
will not cause a runtime error.
|
Úclosez=Unable to close open file handle for firefox binary log file.N) r" r r ÚhasattrZ _log_filer9 r3 r5 r6 r8 r0 r0 r1 r7 á s z#WebDriver._close_binary_file_handlec C s | j S )N)r r8 r0 r0 r1 r* ï s zWebDriver.firefox_profilec C s | dd|i¡ d S )NZ SET_CONTEXTÚcontext©Úexecute)r) r; r0 r0 r1 Ú set_contextõ s zWebDriver.set_contextc c s6 | d¡ d¡}| |¡ z
|
dV W 5 | |¡ X dS )aà Sets 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_CONTEXTÚvalueN)r= Úpopr> )r) r; Zinitial_contextr0 r0 r1 r; ø s
|
|
|
zWebDriver.contextFc C sÖ t j |¡rt }t|d }t |dtj¡H}t |¡D ]6\}}}|D ]&} t j || ¡}
|
|
|
|
|
|
|
|d
¡ qHq:W 5 Q R X t | ¡ ¡ d¡} n*t|d} t | ¡ ¡ d¡} W 5 Q R X | |d} | d| ¡d S ) a Installs Firefox addon.
|
|
Returns identifier of installed addon. This identifier can later
|
be used to uninstall addon.
|
|
:param temporary: allows you to load browser extensions temporarily during a session
|
:param path: Absolute path to the addon that will be installed.
|
|
:Usage:
|
::
|
|
driver.install_addon('/path/to/firebug.xpi')
|
r ÚwNzUTF-8Úrb)ÚaddonÚ temporaryZ INSTALL_ADDONr? )Úosr% Úisdirr ÚlenÚzipfileÚZipFileÚ ZIP_DEFLATEDÚwalkÚjoinÚwriteÚbase64Ú b64encodeÚgetvalueÚdecodeÚopenÚreadr= )r) r% rD ÚfpZ path_rootZzippedÚbaseÚdirsÚfilesZfyleÚfilenamerC ÚfileÚpayloadr0 r0 r1 Ú install_addon s "
|
zWebDriver.install_addonc C s | dd|i¡ dS )zUninstalls Firefox addon using its identifier.
|
|
:Usage:
|
::
|
|
driver.uninstall_addon('addon@foo.com')
|
ZUNINSTALL_ADDONÚidNr< )r) Ú
|
identifierr0 r0 r1 Úuninstall_addon- s zWebDriver.uninstall_addonc C sp | ¡ d¡st dt¡ | ¡ }zDz$t|d}| |¡ W 5 Q R X W n tk
|
rb Y W ¢
|
dS X W 5 ~X dS )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` extensionÚwbFT) ÚlowerÚendswithr r Ú UserWarningÚ get_full_page_screenshot_as_pngrR rM ÚOSError)r) rX ZpngÚfr0 r0 r1 Ú get_full_page_screenshot_as_file7 s þ z*WebDriver.get_full_page_screenshot_as_filec C s
|
| |¡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')
|
)rf )r) rX r0 r0 r1 Úsave_full_page_screenshotT s z#WebDriver.save_full_page_screenshotc C s t | ¡ d¡¡S )z´Gets the full document screenshot of the current window as a binary
|
data.
|
|
:Usage:
|
::
|
|
driver.get_full_page_screenshot_as_png()
|
Úascii)rN Ú b64decodeÚ"get_full_page_screenshot_as_base64Úencoder8 r0 r0 r1 rc d s z)WebDriver.get_full_page_screenshot_as_pngc C s | d¡d S )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? r< r8 r0 r0 r1 rj o s z,WebDriver.get_full_page_screenshot_as_base64)F)Ú__name__Ú
|
__module__Ú __qualname__ZCONTEXT_CHROMEZCONTEXT_CONTENTr r r r( r2 r7 Úpropertyr* r> r r; r# r[ r^ Úboolrf rg Úbytesrc rj Ú __classcell__r0 r0 r. r1 r , s> óò
|
|
|
r )"rN ÚloggingrE r rH Ú
|
contextlibr Úior Úshutilr Z.selenium.webdriver.common.desired_capabilitiesr Z'selenium.webdriver.common.driver_finderr Z#selenium.webdriver.remote.webdriverr ZRemoteWebDriverr+ r r* r
|
r r Zremote_connectionr r r r Ú getLoggerrl r5 r r r0 r0 r0 r1 Ú<module> s(
|
|
