`1h{ ddlZddlmZddlmZmZmZmZmZm Z m Z ddl m Z m Z mZmZmZddlmZddlmZmZ e dZe dZe eefZd ed eegeffd Zd ed eegeffd Zd eeefd eegeffdZded eegeffdZded eegeffdZded eegeffdZ ded eegeffdZ!d eeefd eege edefffdZ"ded eege edefffdZ#d8deded e edeffdZ$d eeefd eegeeffdZ%d eeefd eegeeffdZ&d eeefd eege eeedfffdZ'd eeefded eegeffdZ(d eeefded eegeffd Z)d eeefd!eded eegeffd"Z*d e eeefeefd eegeffd#Z+d e eeeeffd eege eefffd$Z,de eeeeffd eege eefffd%Z-d&e eeeeffd eege edefffd'Z.ded eegeffd(Z/ded eegeffd)Z0d eeefd eegeffd*Z1ded+ed eegeffd,Z2d eeefd+ed eegeffd-Z3d.e4d eegeffd/Z5d0eed eegeffd1Z6d eege eedfffd2Z7d eeefd!ed eegeffd3Z8d4eegefd eege edefffd5Z9d4eege eedffd eege eeedfffd6Z:d4eegefd eegeffd7Z;y)9N)Iterable)AnyCallableListLiteralTupleTypeVarUnion)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 l/var/www/skyplay_api_hub/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 $$rr r!s` 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((((rr r/rs` r url_containsr6m)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)researchr3)rr8s rrzurl_matches.._predicatesyy&"4"45TAArr )r8rs` 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(Srr2r4s rrzurl_to_be.._predicatef((((rr r5s` r url_to_berAs)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"|jk7Srr2r4s rrzurl_changes.._predicater@rr r5s` r url_changesrDr7rFc 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)rr*s rrz1visibility_of_element_located.._predicates3 &':v':':G'DE E-  s  ''r+r-s` rvisibility_of_element_locatedrIs00 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)rH_rJs rrz!visibility_of.._predicates"7++rrJrs` r visibility_ofrQs6, 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)rJrRs rrHrHs**, :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_locatedrXs*.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)rWrH)rrJr&s rrz6visibility_of_any_elements_located.._predicateCs-';v';';W'EfGI\]dIefffs++r+r-s` r"visibility_of_any_elements_locatedr[.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)NFrR)rWrHr)relementsrJr&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$rYywxYwrG)r)textrr element_textr&ras rrz1text_to_be_present_in_element.._predicates= .6..8==LL( (-  s  ,,r+r&rars`` rtext_to_be_present_in_elementrhn20 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") ... ) rch |jjd}|vS#t$rYywxYw)NvalueFr) get_attributerres rrz7text_to_be_present_in_element_value.._predicatesB .6..8FFwOLL( (-   !% 11r+rgs`` r#text_to_be_present_in_element_valuerps60 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$rYywxYwrGrm)rrfrqr&ras rrz;text_to_be_present_in_element_attribute.._predicatesK .6..8FFzRL#L( (-  s (( 44r+)r&rqrars``` r'text_to_be_present_in_element_attributerts: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(( A43A4r r-s` r&frame_to_be_available_and_switch_to_itr{s69 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)rwrr)rHr r)rtargetr&s rrz3invisibility_of_element_located.._predicate&sP Ffj1,,,f5&v%@ @&(FG    s-1AAr+r-s` rinvisibility_of_element_locatedrs> 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)rJs rinvisibility_of_elementr7s0 +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|SyrG)rwrr)rQ is_enabled)rr~rJrs rrz+element_to_be_clickable.._predicateksK&*-(V((&1F'-'/ w))+Nrr+)rrs` relement_to_be_clickablerRs20 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)rrrMs rrz staleness_of.._predicates)     -  s   rOrPs` r staleness_ofrws( 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_selectedrMs rrz*element_to_be_selected.._predicates""$$rrOrPs` 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)rNrJrs rrz1element_selection_state_to_be.._predicates""$ 33rrO)rJrrs`` 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$rYywxYwrG)r)rr)rrJrr&s rrz9element_located_selection_state_to_be.._predicates@ )f))73G&&(K7 7-  ror+)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_ber s&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$rYywxYwrG)ryalertr )rs rrz$alert_is_present.._predicateTs+ ##)) )&  s  $$r )rs ralert_is_presentrAs&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$rYywxYwrGrm)relement_attributerqr&s rrz0element_attribute_to_include.._predicatevsC  3 3 3W = K KJ W $D0 0-  ror+)r&rqrs`` relement_attribute_to_includer]rirexpected_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 wxYwrGrrexpected_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$rYywxYwrG)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$ $FFF2E  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+,"J& 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