o US`c#@sVddlZddlmZmZddlmZddlmZGdddedZGdd d eZ dS) N)ABCMetaabstractmethod)InvalidArgumentException)Proxyc seZdZdZd4fdd ZeddZd4dd Zedefd d Z e j d eddfd d Z edefddZ e j deddfddZ edefddZ e j deddfddZ edefddZ e j deddfddZ edefddZej deddfddZ  d5dejedejed ejeddfd!d"Zedefd#d$Zej d%eddfd&d$Zedefd'd(Zej d%eddfd)d(Zedefd*d+Zej d%eddfd,d+Zedefd-d.Zej d%eddfd/d.Zed0d1Zeed2d3ZZS)6 BaseOptionsz3 Base class for individual browser options returnNcs(t|j|_|ddd|_dS)NpageLoadStrategynormal)super__init__default_capabilities_capsset_capabilitymobile_optionsself __class__L/usr/local/lib/python3.10/dist-packages/selenium/webdriver/common/options.pyr s   zBaseOptions.__init__cC|jSNr rrrr capabilities#szBaseOptions.capabilitiescCs||j|<dS)z Sets a capability Nr)rnamevaluerrrr'szBaseOptions.set_capabilitycC |jdS)zN :returns: the version of the browser if set, otherwise None. browserVersionrrrrrbrowser_version+ zBaseOptions.browser_versionversioncC|d|dS)z Requires the major version of the browser to match provided value: https://w3c.github.io/webdriver/#dfn-browser-version :param version: The required version of the browser rNr)rr rrrr2scCr)z4 :returns: The name of the platform platformNamerrrrr platform_name<rzBaseOptions.platform_nameplatformcCr!)z Requires the platform to match the provided value: https://w3c.github.io/webdriver/#dfn-platform-name :param platform: the required name of the platform r#Nr")rr%rrrr$CscCr)zN :returns: page load strategy if set, the default is "normal" rrrrrrpage_load_strategyLrzBaseOptions.page_load_strategystrategycC |dvr |d|dStd)z Determines the point at which a navigation command is returned: https://w3c.github.io/webdriver/#dfn-table-of-page-load-strategies :param strategy: the strategy corresponding to a document readiness state )r eagernonerz>Strategy can only be one of the following: normal, eager, noneNr ValueError)rr'rrrr&ScCr)za :returns: unhandled prompt behavior if set, the default is "dismiss and notify" unhandledPromptBehaviorrrrrrunhandled_prompt_behavior`rz%BaseOptions.unhandled_prompt_behaviorbehaviorcCr()a  How the driver should respond when an alert is present and the command sent is not handling the alert: https://w3c.github.io/webdriver/#dfn-table-of-page-load-strategies :param behavior: behavior to use when an alert is encountered )Zdismissacceptzdismiss and notifyzaccept and notifyignorer.ziBehavior can only be one of the following: dismiss, accept, dismiss and notify, accept and notify, ignoreNr+)rr0rrrr/gr-cCr)zu :returns: Values for implicit timeout, pageLoad timeout and script timeout if set (in milliseconds) timeoutsrrrrrr3urzBaseOptions.timeoutsr3cs.tfdddDr|ddStd)z How long the driver should wait for actions to complete before returning an error https://w3c.github.io/webdriver/#timeouts :param timeouts: values in milliseconds for implicit wait, page load and script timeout c3s|] }|vVqdSr)keys).0xr3rr sz'BaseOptions.timeouts..)ZimplicitZpageLoadscriptr3zITimeout keys can only be one of the following: implicit, pageLoad, scriptN)allrr,)rr3rr7rr3|sandroid_packageandroid_activity device_serialcCs:|stdd|i|_|r||jd<|r||jd<dSdS)z Enables mobile browser use for browsers that support it :Args: android_activity: The name of the android package to start z!android_package must be passed inZandroidPackageZandroidActivityZandroidDeviceSerialN)AttributeErrorr)rr;r<r=rrr enable_mobiles zBaseOptions.enable_mobilecC|jddS)zM :returns: whether the session accepts insecure certificates acceptInsecureCertsFr getrrrraccept_insecure_certsz!BaseOptions.accept_insecure_certsrcC||jd<dS)z Whether untrusted and self-signed TLS certificates are implicitly trusted: https://w3c.github.io/webdriver/#dfn-insecure-tls-certificates :param value: whether to accept insecure certificates rANrrrrrrrDcCr@)zP :returns: whether session is strict about file interactability strictFileInteractabilityFrBrrrrstrict_file_interactabilityrEz'BaseOptions.strict_file_interactabilitycCrF)z Whether interactability checks will be applied to file type input elements. The default is false. :param value: whether file interactability is strict rINrrGrrrrJscCr@)z\ :returns: whether the remote end supports setting window size and position setWindowRectFrBrrrrset_window_rectrEzBaseOptions.set_window_rectcCrF)a Whether the remote end supports all of the resizing and positioning commands. The default is false. https://w3c.github.io/webdriver/#dfn-strict-file-interactability :param value: whether remote end must support setting window resizing and repositioning rKNrrGrrrrLrHcCr)z9 :Returns: Proxy if set, otherwise None. )_proxyrrrrproxyzBaseOptions.proxycCst|ts td||_dS)Nz$Only Proxy objects can be passed in.) isinstancerrrMrGrrrrNs  cCdS)z-Convert options into capabilities dictionary.Nrrrrrto_capabilitieszBaseOptions.to_capabilitiescCrQ)z6Return minimal capabilities necessary as a dictionary.Nrrrrrr rSz BaseOptions.default_capabilitiesrN)NNN)__name__ __module__ __qualname____doc__r propertyrrstrrsetterr$r&r/dictr3typingOptionalr?boolrDrJrLrrNrrRr __classcell__rrrrrsl          r) metaclasscsPeZdZdfdd ZeddZddZdd d Zd d Zed dZ Z S) ArgOptionsrNcstg|_d|_dS)NF)r r _arguments_ignore_local_proxyrrrrr s  zArgOptions.__init__cCr)zF :Returns: A list of arguments needed for the browser )rcrrrr argumentsrOzArgOptions.argumentscCs|r |j|dStd)z\ Adds an argument to the list :Args: - Sets the arguments zargument can not be nullN)rcappendr,)rargumentrrr add_argumentszArgOptions.add_argumentcCs d|_dS)zo By calling this you will ignore HTTP_PROXY and HTTPS_PROXY from being picked up and used. TN)rdrrrr(ignore_local_proxy_environment_variabless z3ArgOptions.ignore_local_proxy_environment_variablescCrrrrrrrrRszArgOptions.to_capabilitiescCsiSrrrrrrr szArgOptions.default_capabilitiesrT) rUrVrWr rYrerhrirRr r`rrrrrbs  rb) r]abcrrZselenium.common.exceptionsrZselenium.webdriver.common.proxyrrrbrrrrs  M