hC{ ddlZddlmZddlmZmZmZmZmZddl m Z m Z m Z m Z mZddlmZddlmZmZ edZedZeeefZd ed eegeffd Zd ed eegeffd Zd eeefd eegeffdZded eegeffdZded eegeffdZded eegeffdZded eegeffdZ d eeefd eegeedefffdZ!ded eegeedefffdZ"d8deded eedeffdZ#d eeefd eege$effdZ%d eeefd eege$effdZ&d eeefd eegee$eedfffdZ'd eeefded eegeffdZ(d eeefded eegeffd Z)d eeefd!eded eegeffd"Z*d eeeefeefd eegeffd#Z+d eeeeeffd eegeeefffd$Z,deeeeeffd eegeeefffd%Z-d&eeeeeffd eegeedefffd'Z.ded eegeffd(Z/ded eegeffd)Z0d eeefd eegeffd*Z1ded+ed eegeffd,Z2d eeefd+ed eegeffd-Z3d.e4d eegeffd/Z5d0e$ed eegeffd1Z6d eegeeedfffd2Z7d eeefd!ed eegeffd3Z8d4eegefd eegeedefffd5Z9d4eegeeedffd eegee$eedfffd6Z:d4eegefd eegeffd7Z;y)9N)Iterable)AnyCallableLiteralTypeVarUnion)NoAlertPresentExceptionNoSuchElementExceptionNoSuchFrameExceptionStaleElementReferenceExceptionWebDriverException)Alert) WebDriver WebElementDTtitlereturnc dtffd }|S)zAn expectation for checking the title of a page. Parameters: ----------- title : str The expected title, which must be an exact match. Returns: ------- boolean : True if the title matches, False otherwise. driverc"|jk(SNrrrs q/home/bbl/html/w1hd.aprs.trek/venv/lib/python3.12/site-packages/selenium/webdriver/support/expected_conditions.py _predicateztitle_is.._predicate8s||u$$rrrs` rtitle_isr +s%9% rc dtffd }|S)aAn expectation for checking that the title contains a case-sensitive substring. Parameters: ----------- title : str The fragment of title expected. Returns: ------- boolean : True when the title matches, False otherwise. rc |jvSrrrs rrz"title_contains.._predicateLs $$rrrs` rtitle_containsr#>s%9% rlocatorc dtffd }|S)azAn expectation for checking that an element is present on the DOM of a page. This does not necessarily mean that the element is visible. Parameters: ----------- locator : Tuple[str, str] Used to find the element. Returns: ------- WebElement : The WebElement once it is located. Example: -------- >>> from selenium.webdriver.common.by import By >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> element = WebDriverWait(driver, 10).until(EC.presence_of_element_located((By.NAME, "q"))) rc"|jSr) find_elementrr$s rrz/presence_of_element_located.._predicategs"v""G,,rWebDriverOrWebElementr$rs` rpresence_of_element_locatedr,Rs*-0- rurlc dtffd }|S)aAn expectation for checking that the current url contains a case- sensitive substring. Parameters: ----------- url : str The fragment of url expected. Returns: ------- boolean : True when the url matches, False otherwise. rc |jvSr current_urlrr-s rrz url_contains.._predicate{sf((((rrr-rs` r url_containsr4m)9) rpatternc dtffd }|S)aQAn expectation for checking the current url. Parameters: ----------- pattern : str The pattern to match with the current url. Returns: ------- boolean : True when the pattern matches, False otherwise. Notes: ------ More powerful than url_contains, as it allows for regular expressions. rcHtj|jduSr)researchr1)rr6s rrzurl_matches.._predicatesyy&"4"45TAArr)r6rs` r url_matchesr;s"B9B rc dtffd }|S)zAn expectation for checking the current url. Parameters: ----------- url : str The expected url, which must be an exact match. Returns: ------- boolean : True when the url matches, False otherwise. rc"|jk(Srr0r2s rrzurl_to_be.._predicatef((((rrr3s` r url_to_ber?s)9) rc dtffd }|S)aAn expectation for checking the current url is different than a given string. Parameters: ----------- url : str The expected url, which must not be an exact match. Returns: ------- boolean : True when the url does not match, False otherwise rc"|jk7Srr0r2s rrzurl_changes.._predicater>rrr3s` r url_changesrBr5rFc dtffd }|S)aAn expectation for checking that an element is present on the DOM of a page and visible. Visibility means that the element is not only displayed but also has a height and width that is greater than 0. Parameters: ----------- locator : Tuple[str, str] Used to find the element. Returns: ------- WebElement : The WebElement once it is located and visible. Example: -------- >>> from selenium.webdriver.common.by import By >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> element = WebDriverWait(driver, 10).until(EC.visibility_of_element_located((By.NAME, "q"))) rcT t|jS#t$rYywxYwNF)_element_if_visibler'r r(s rrz1visibility_of_element_located.._predicates3 &':v':':G'DE E-  s  ''r)r+s` rvisibility_of_element_locatedrGs00 relementcfd}|S)a1An expectation for checking that an element, known to be present on the DOM of a page, is visible. Parameters: ----------- element : WebElement The WebElement to check. Returns: ------- WebElement : The WebElement once it is visible. Example: -------- >>> from selenium.webdriver.common.by import By >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> element = WebDriverWait(driver, 10).until(EC.visibility_of(driver.find_element(By.NAME, "q"))) Notes: ------ Visibility means that the element is not only displayed but also has a height and width that is greater than 0. element is the WebElement returns the (same) WebElement once it is visible ctSr)rF_rHs rrz!visibility_of.._predicates"7++rrHrs` r visibility_ofrOs6, r visibilityc0|j|k(r|SdS)a|An expectation for checking that an element, known to be present on the DOM of a page, is of the expected visibility. Parameters: ----------- element : WebElement The WebElement to check. visibility : bool The expected visibility of the element. Returns: ------- WebElement : The WebElement once it is visible or not visible. F) is_displayed)rHrPs rrFrFs**, :7EErc dtffd }|S)agAn expectation for checking that there is at least one element present on a web page. Parameters: ----------- locator : Tuple[str, str] Used to find the element. Returns: ------- List[WebElement] : The list of WebElements once they are located. Example: -------- >>> from selenium.webdriver.common.by import By >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> elements = WebDriverWait(driver, 10).until(EC.presence_of_all_elements_located((By.CLASS_NAME, "foo"))) rc"|jSr) find_elementsr(s rrz4presence_of_all_elements_located.._predicate(s#v##W--rr)r+s` r presence_of_all_elements_locatedrVs*.0. rc dtffd }|S)auAn expectation for checking that there is at least one element visible on a web page. Parameters: ----------- locator : Tuple[str, str] Used to find the element. Returns: ------- List[WebElement] : The list of WebElements once they are located and visible. Example: -------- >>> from selenium.webdriver.common.by import By >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> elements = WebDriverWait(driver, 10).until(EC.visibility_of_any_elements_located((By.CLASS_NAME, "foo"))) rc`|jDcgc]}t|s|c}Scc}wr)rUrF)rrHr$s rrz6visibility_of_any_elements_located.._predicateCs-';v';';W'EfGI\]dIefffs++r)r+s` r"visibility_of_any_elements_locatedrY.s*g0g rc dtffd }|S)aAn expectation for checking that all elements are present on the DOM of a page and visible. Visibility means that the elements are not only displayed but also has a height and width that is greater than 0. Parameters: ----------- locator : Tuple[str, str] Used to find the elements. Returns: ------- List[WebElement] : The list of WebElements once they are located and visible. Example: -------- >>> from selenium.webdriver.common.by import By >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> elements = WebDriverWait(driver, 10).until(EC.visibility_of_all_elements_located((By.CLASS_NAME, "foo"))) rcr |j}|D]}t|dsy|S#t$rYywxYw)NFrP)rUrFr )relementsrHr$s rrz6visibility_of_all_elements_located.._predicateasO +v++W5H# !&w5A  !O-  s!*** 66r)r+s` r"visibility_of_all_elements_locatedr^Is00 rtext_c$dtffd }|S)aAn expectation for checking if the given text is present in the specified element. Parameters: ----------- locator : Tuple[str, str] Used to find the element. text_ : str The text to be present in the element. Returns: ------- boolean : True when the text is present, False otherwise. Example: -------- >>> from selenium.webdriver.common.by import By >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> is_text_in_element = WebDriverWait(driver, 10).until( EC.text_to_be_present_in_element((By.CLASS_NAME, "foo"), "bar") ) rc^ |jj}|vS#t$rYywxYwrE)r'textr r element_textr$r_s rrz1text_to_be_present_in_element.._predicates= .6..8==LL( (-  s  ,,r)r$r_rs`` rtext_to_be_present_in_elementrfn20 rc$dtffd }|S)aAn expectation for checking if the given text is present in the element's value. Parameters: ----------- locator : Tuple[str, str] Used to find the element. text_ : str The text to be present in the element's value. Returns: ------- boolean : True when the text is present, False otherwise. Example: -------- >>> from selenium.webdriver.common.by import By >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> is_text_in_element_value = WebDriverWait(driver, 10).until( ... EC.text_to_be_present_in_element_value((By.CLASS_NAME, "foo"), "bar") ... ) rcn |jjd}|y|vS#t$rYywxYw)NvalueFr' get_attributer rcs rrz7text_to_be_present_in_element_value.._predicatesK .6..8FFwOL#L( (-   (( 44r)res`` r#text_to_be_present_in_element_valuerns60 r attribute_c(dtffd }|S)a)An expectation for checking if the given text is present in the element's attribute. Parameters: ----------- locator : Tuple[str, str] Used to find the element. attribute_ : str The attribute to check the text in. text_ : str The text to be present in the element's attribute. Returns: ------- boolean : True when the text is present, False otherwise. Example: -------- >>> from selenium.webdriver.common.by import By >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> is_text_in_element_attribute = WebDriverWait(driver, 10).until( ... EC.text_to_be_present_in_element_attribute((By.CLASS_NAME, "foo"), "bar", "baz") ... ) rcn |jj}|y|vS#t$rYywxYwrErk)rrdror$r_s rrz;text_to_be_present_in_element_attribute.._predicatesK .6..8FFzRL#L( (-  rmr))r$ror_rs``` r'text_to_be_present_in_element_attributerrs:0 rc dtffd }|S)aAn expectation for checking whether the given frame is available to switch to. Parameters: ----------- locator : Union[Tuple[str, str], str, WebElement] Used to find the frame. Returns: ------- boolean : True when the frame is available, False otherwise. Example: -------- >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> WebDriverWait(driver, 10).until(EC.frame_to_be_available_and_switch_to_it("frame_name")) Notes: ------ If the frame is available it switches the given driver to the specified frame. rc ttr9tts)|jj |j y|jj y#t $rYywxYw)NTF) isinstancerstr switch_toframer'r r(s rrz:frame_to_be_available_and_switch_to_it.._predicatesm '8,Z5M  &&':v':':G'DE  &&w/#  sAA( A(( A43A4rr+s` r&frame_to_be_available_and_switch_to_itrys69 rc dtffd }|S)aAn Expectation for checking that an element is either invisible or not present on the DOM. Parameters: ----------- locator : Union[WebElement, Tuple[str, str]] Used to find the element. Returns: ------- boolean : True when the element is invisible or not present, False otherwise. Example: -------- >>> from selenium.webdriver.common.by import By >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> is_invisible = WebDriverWait(driver, 10).until(EC.invisibility_of_element_located((By.CLASS_NAME, "foo"))) Notes: ------ - In the case of NoSuchElement, returns true because the element is not present in DOM. The try block checks if the element is present but is invisible. - In the case of StaleElementReference, returns true because stale element reference implies that element is no longer visible. rc }t|ts|j|}t|dS#tt f$rYywxYw)NFr\T)rurr'rFr r )rtargetr$s rrz3invisibility_of_element_located.._predicate(sP Ffj1,,,f5&v%@ @&(FG    s-1AAr)r+s` rinvisibility_of_element_locatedr} s> 0  rct|S)aAn Expectation for checking that an element is either invisible or not present on the DOM. Parameters: ----------- element : Union[WebElement, Tuple[str, str]] Used to find the element. Returns: ------- boolean : True when the element is invisible or not present, False otherwise. Example: -------- >>> from selenium.webdriver.common.by import By >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> is_invisible_or_not_present = WebDriverWait(driver, 10).until( ... EC.invisibility_of_element(driver.find_element(By.CLASS_NAME, "foo")) ... ) )r})rHs rinvisibility_of_elementr9s0 +7 33rmarkc dtffd }|S)amAn Expectation for checking an element is visible and enabled such that you can click it. Parameters: ----------- mark : Union[WebElement, Tuple[str, str]] Used to find the element. Returns: ------- WebElement : The WebElement once it is located and clickable. Example: -------- >>> from selenium.webdriver.common.by import By >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> element = WebDriverWait(driver, 10).until(EC.element_to_be_clickable((By.CLASS_NAME, "foo"))) rc}t|ts|j|}t||}|r|j r|SyrE)rurr'rO is_enabled)rr|rHrs rrz+element_to_be_clickable.._predicatemsK&*-(V((&1F'-'/ w))+Nrr))rrs` relement_to_be_clickablerTs20 rcfd}|S)aQWait until an element is no longer attached to the DOM. Parameters: ----------- element : WebElement The element to wait for. Returns: ------- boolean : False if the element is still attached to the DOM, true otherwise. Example: -------- >>> from selenium.webdriver.common.by import By >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> is_element_stale = WebDriverWait(driver, 10).until(EC.staleness_of(driver.find_element(By.CLASS_NAME, "foo"))) cF jy#t$rYywxYwNFT)rr rKs rrz staleness_of.._predicates)     -  s   rMrNs` r staleness_ofrys( rcfd}|S)aZAn expectation for checking the selection is selected. Parameters: ----------- element : WebElement The WebElement to check. Returns: ------- boolean : True if the element is selected, False otherwise. Example: -------- >>> from selenium.webdriver.common.by import By >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> is_selected = WebDriverWait(driver, 10).until(EC.element_to_be_selected(driver.find_element( By.CLASS_NAME, "foo")) ) c$jSr is_selectedrKs rrz*element_to_be_selected.._predicates""$$rrMrNs` relement_to_be_selectedrs,% rc dtffd }|S)aBAn expectation for the element to be located is selected. Parameters: ----------- locator : Tuple[str, str] Used to find the element. Returns: ------- boolean : True if the element is selected, False otherwise. Example: -------- >>> from selenium.webdriver.common.by import By >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> is_selected = WebDriverWait(driver, 10).until(EC.element_located_to_be_selected((By.CLASS_NAME, "foo"))) rc>|jjSr)r'rr(s rrz2element_located_to_be_selected.._predicates"v""G,88::rr)r+s` relement_located_to_be_selectedrs(;0; rrcfd}|S)aAn expectation for checking if the given element is selected. Parameters: ----------- element : WebElement The WebElement to check. is_selected : bool Returns: ------- boolean : True if the element's selection state is the same as is_selected Example: -------- >>> from selenium.webdriver.common.by import By >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> is_selected = WebDriverWait(driver, 10).until( ... EC.element_selection_state_to_be(driver.find_element(By.CLASS_NAME, "foo"), True) ... ) c*jk(Srr)rLrHrs rrz1element_selection_state_to_be.._predicates""$ 33rrM)rHrrs`` relement_selection_state_to_bers.4 rc$dtffd }|S)aAn expectation to locate an element and check if the selection state specified is in that state. Parameters: ----------- locator : Tuple[str, str] Used to find the element. is_selected : bool Returns: ------- boolean : True if the element's selection state is the same as is_selected Example: -------- >>> from selenium.webdriver.common.by import By >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> is_selected = WebDriverWait(driver, 10).until(EC.element_located_selection_state_to_be( (By.CLASS_NAME, "foo"), True) ) rch |j}|jk(S#t$rYywxYwrE)r'rr )rrHrr$s rrz9element_located_selection_state_to_be.._predicates@ )f))73G&&(K7 7-   !% 11r))r$rrs`` r%element_located_selection_state_to_bers40 r num_windowsc dtffd }|S)aAn expectation for the number of windows to be a certain value. Parameters: ----------- num_windows : int The expected number of windows. Returns: ------- boolean : True when the number of windows matches, False otherwise. Example: -------- >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> is_number_of_windows = WebDriverWait(driver, 10).until(EC.number_of_windows_to_be(2)) rc4t|jk(Srlenwindow_handles)rrs rrz+number_of_windows_to_be.._predicate"s6(()[88rr)rrs` rnumber_of_windows_to_bers&999 rcurrent_handlesc dtffd }|S)aqAn expectation that a new window will be opened and have the number of windows handles increase. Parameters: ----------- current_handles : List[str] The current window handles. Returns: ------- boolean : True when a new window is opened, False otherwise. Example: -------- >>> from selenium.webdriver.support.ui import By >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> is_new_window_opened = WebDriverWait(driver, 10).until(EC.new_window_is_opened(driver.window_handles)) rcFt|jtkDSrr)rrs rrz(new_window_is_opened.._predicate=s6(()C,@@@rr)rrs` rnew_window_is_openedr(s*A9A rcdtfd}|S)aAn expectation for checking if an alert is currently present and switching to it. Returns: ------- Alert : The Alert once it is located. Example: -------- >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> alert = WebDriverWait(driver, 10).until(EC.alert_is_present()) Notes: ------ If the alert is present it switches the given driver to it. rcN |jjS#t$rYywxYwrE)rwalertr )rs rrz$alert_is_present.._predicateVs+ ##)) )&  s  $$r)rs ralert_is_presentrCs&9 rc$dtffd }|S)aAn expectation for checking if the given attribute is included in the specified element. Parameters: ----------- locator : Tuple[str, str] Used to find the element. attribute_ : str The attribute to check. Returns: ------- boolean : True when the attribute is included, False otherwise. Example: -------- >>> from selenium.webdriver.common.by import By >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> is_attribute_in_element = WebDriverWait(driver, 10).until( ... EC.element_attribute_to_include((By.CLASS_NAME, "foo"), "bar") ... ) rch |jj}|duS#t$rYywxYwrErk)relement_attributeror$s rrz0element_attribute_to_include.._predicatexsC  3 3 3W = K KJ W $D0 0-  rr))r$rors`` relement_attribute_to_includer_rgrexpected_conditionsc dtffd }|S)a0An expectation that any of multiple expected conditions is true. Parameters: ----------- expected_conditions : Callable[[D], T] The list of expected conditions to check. Returns: ------- T : The result of the first matching condition, or False if none do. Example: -------- >>> from selenium.webdriver.common.by import By >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> element = WebDriverWait(driver, 10).until( ... EC.any_of(EC.presence_of_element_located((By.NAME, "q"), ... EC.visibility_of_element_located((By.NAME, "q")))) Notes: ------ Equivalent to a logical 'OR'. Returns results of the first matching condition, or False if none do. rcPD]} ||}|r|cSy#t$rY wxYwrEr rexpected_conditionresultrs rany_of_conditionz any_of..any_of_conditionsH"5   +F3!M &  s  %%r)rrs` rany_ofrs6 rc dtffd }|S)aAn expectation that all of multiple expected conditions is true. Parameters: ----------- expected_conditions : Callable[[D], Union[T, Literal[False]]] The list of expected conditions to check. Returns: ------- List[T] : The results of all the matching conditions, or False if any do not. Example: -------- >>> from selenium.webdriver.common.by import By >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> elements = WebDriverWait(driver, 10).until( ... EC.all_of(EC.presence_of_element_located((By.NAME, "q"), ... EC.visibility_of_element_located((By.NAME, "q")))) Notes: ------ Equivalent to a logical 'AND'. Returns: When any ExpectedCondition is not met: False. When all ExpectedConditions are met: A List with each ExpectedCondition's return value. rcvg}D] } ||}|sy|j|"|S#t$rYywxYwrE)appendr )rresultsrrrs rall_of_conditionz all_of..all_of_conditionsT"5   +F3 v&  &  s ++ 88r)rrs` rall_ofrs<   rc dtffd }|S)aAn expectation that none of 1 or multiple expected conditions is true. Parameters: ----------- expected_conditions : Callable[[D], Any] The list of expected conditions to check. Returns: ------- boolean : True if none of the conditions are true, False otherwise. Example: -------- >>> from selenium.webdriver.common.by import By >>> from selenium.webdriver.support.ui import WebDriverWait >>> from selenium.webdriver.support import expected_conditions as EC >>> element = WebDriverWait(driver, 10).until( ... EC.none_of(EC.presence_of_element_located((By.NAME, "q"), ... EC.visibility_of_element_located((By.NAME, "q")))) Notes: ------ Equivalent to a logical 'NOT-OR'. Returns a Boolean rcLD]} ||}|ryy#t$rYwxYwrrrs rnone_of_conditionz"none_of..none_of_conditionsF"5   +F3  &  s  ##r)rrs` rnone_ofrs4! r)T)rs$ $992E  CL CLi34CHi[$%67&#(I;+<"=(sCxXG\F]_iFi=j6ch {D'89(9+t*;!<.38YK$56&SXyk4&78( 38_ $%uWU^Z-G'HHIB:(C5%PZ@Z:[3[*\BFFFwW\~_iOiIjF$eCHo(LaKbdhisdtKtBu6c3hHNcMdfjkufvMvDw6" 38_" $%uT*-=wu~-M'NNO"J 5c? 3 8UjTkmqTqKr F$ 38_$%($ $%t+,$N& 38_&*-&69& $%t+,&R% 5c?C3 4% yk4 %P- :uS#X. /- $%uZ-='>>?-`4 :uS#X. /4 $%uZ-='>>?46"  E#s(O+ ," $%uWU^Z-G'HHI"J*3%+)>>J8SE4K3H8E#s(OJ_I`bfIf@g4:DXWZV[]aVaMb:! 38_!+/! $%t+,!H9+t:K1L2$s))dAR8S6(I;eWU^6K0L#LM8 %S/ s xYnXoquXuOv F%1#q&!1%hsE'RW.Z[J[D\?\6]%P*"A3a.?(@#@A* qc5a'%.0112*Z$(A38"4$1#t)9L$r