EEi/-|ddlZddlmZmZddlmZddlmZmZddl m Z de ddfd Z d ed e ddfd Z Gd dZy)N)NoReturnoverload)WebDriverException)ByByType) WebElementtag_namereturn RelativeByc|tjd|s tdttj |iS)aStart searching for relative objects using a tag name. Args: tag_name: The DOM tag of element to start searching. Returns: RelativeBy: Use this object to create filters within a `find_elements` call. Raises: WebDriverException: If `tag_name` is None. Note: This method is deprecated and may be removed in future versions. Please use `locate_with` instead. zbThis method is deprecated and may be removed in future versions. Please use `locate_with` instead.ztag_name can not be null)warningswarnrr r CSS_SELECTOR)r s w/home/sietch6/trending-topics-pipeline/venv/lib/python3.12/site-packages/selenium/webdriver/support/relative_locator.py with_tag_namers4  MMvw  !;<< r1 22byusingc@|Jd|Jdt||iS)aStart searching for relative objects your search criteria with By. Args: by: The method to find the element. using: The value from `By` passed in. Returns: RelativeBy: Use this object to create filters within a `find_elements` call. Example: >>> lowest = driver.find_element(By.ID, "below") >>> elements = driver.find_elements(locate_with(By.CSS_SELECTOR, "p").above(lowest)) zPlease pass in a by argumentzPlease pass in a using argument)r )rrs r locate_withr/s5 >999>  ???  r5k ""rcJeZdZdZeeefZd&deeefdzdedzfdZ e de ezddfdZ e d'd(d Z d'de ezdzddfd Z e de ezddfd Z e d'd(d Z d'de ezdzddfdZ e de ezddfdZe d'd(dZd'de ezdzddfdZe de ezddfdZe d'd(dZd'de ezdzddfdZe de ezddfdZe d'd(dZd'de ezdzddfdZe de ezddfdZe d'd(dZd'de ezdzddfdZe de ezddfdZe d'd(dZd'de ezdzddfdZe de ezddfdZe d'd(dZd'de ezdzddfd Ze d)de ezd!eddfd"Ze d*ddd!edd fd#Zd*de ezdzd!eddfd$Zdefd%Zy)+r aFind elements based on their relative location from a root element. It is recommended that you use the helper function to create instances. Example: -------- >>> lowest = driver.find_element(By.ID, "below") >>> elements = driver.find_elements(locate_with(By.CSS_SELECTOR, "p").above(lowest)) >>> ids = [el.get_attribute("id") for el in elements] >>> assert "above" in ids >>> assert "mid" in ids Nrootfiltersc(||_|xsg|_y)aSCreate a RelativeBy object (prefer using `locate_with` instead). Args: root: A dict with `By` enum as the key and the search query as the value filters: A list of the filters that will be searched. If none are passed in please use the fluent API on the object to create the filters Nrr)selfrrs r__init__zRelativeBy.__init__Rs }" relement_or_locatorr cyNrrs rabovezRelativeBy.above]SVrrcyr r!r"s rr#zRelativeBy.above`DGrc^|s td|jjd|gd|S)aAdd a filter to look for elements above. Args: element_or_locator: Element to look above Returns: RelativeBy Raises: WebDriverException: If `element_or_locator` is None. Example: -------- >>> lowest = driver.find_element(By.ID, "below") >>> elements = driver.find_elements(locate_with(By.CSS_SELECTOR, "p").above(lowest)) :Element or locator must be given when calling above methodr#kindargsrrappendr"s rr#zRelativeBy.abovecs3""$%ab b W7I6JKL rcyr r!r"s rbelowzRelativeBy.belowzr$rcyr r!r"s rr/zRelativeBy.below}r&rc^|s td|jjd|gd|S)aAdd a filter to look for elements below. Args: element_or_locator: Element to look below Returns: RelativeBy Raises: WebDriverException: If `element_or_locator` is None. Example: >>> highest = driver.find_element(By.ID, "high") >>> elements = driver.find_elements(locate_with(By.CSS_SELECTOR, "p").below(highest)) :Element or locator must be given when calling below methodr/r)r,r"s rr/zRelativeBy.belows3 "$%ab b W7I6JKL rcyr r!r"s r to_left_ofzRelativeBy.to_left_ofsX[rcyr r!r"s rr4zRelativeBy.to_left_ofsILrc^|s td|jjd|gd|S)aAdd a filter to look for elements to the left of. Args: element_or_locator: Element to look to the left of Returns: RelativeBy Raises: WebDriverException: If `element_or_locator` is None. Example: >>> right = driver.find_element(By.ID, "right") >>> elements = driver.find_elements(locate_with(By.CSS_SELECTOR, "p").to_left_of(right)) ?Element or locator must be given when calling to_left_of methodleftr)r,r"s rr4zRelativeBy.to_left_ofs3 "$%fg g V6H5IJK rcyr r!r"s r to_right_ofzRelativeBy.to_right_ofsY\rcyr r!r"s rr:zRelativeBy.to_right_ofsJMrc^|s td|jjd|gd|S)aAdd a filter to look for elements right of. Args: element_or_locator: Element to look right of Returns: RelativeBy Raises: WebDriverException: If `element_or_locator` is None. Example: >>> left = driver.find_element(By.ID, "left") >>> elements = driver.find_elements(locate_with(By.CSS_SELECTOR, "p").to_right_of(left)) @Element or locator must be given when calling to_right_of methodrightr)r,r"s rr:zRelativeBy.to_right_ofs3 "$%gh h W7I6JKL rcyr r!r"s rstraight_abovezRelativeBy.straight_above\_rcyr r!r"s rr@zRelativeBy.straight_aboveMPrc^|s td|jjd|gd|S)zvAdd a filter to look for elements above. Args: element_or_locator: Element to look above r( straightAbover)r,r"s rr@zRelativeBy.straight_above3 "$%ab b _?Q>RST rcyr r!r"s rstraight_belowzRelativeBy.straight_belowrArcyr r!r"s rrHzRelativeBy.straight_belowrCrc^|s td|jjd|gd|S)zvAdd a filter to look for elements below. Args: element_or_locator: Element to look below r2 straightBelowr)r,r"s rrHzRelativeBy.straight_belowrFrcyr r!r"s rstraight_left_ofzRelativeBy.straight_left_ofs^arcyr r!r"s rrMzRelativeBy.straight_left_ofsORrc^|s td|jjd|gd|S)zAdd a filter to look for elements to the left of. Args: element_or_locator: Element to look to the left of r7 straightLeftr)r,r"s rrMzRelativeBy.straight_left_ofs3 "$%fg g ^>P=QRS rcyr r!r"s rstraight_right_ofzRelativeBy.straight_right_ofs_brcyr r!r"s rrRzRelativeBy.straight_right_ofsPSrc^|s td|jjd|gd|S)z|Add a filter to look for elements right of. Args: element_or_locator: Element to look right of r= straightRightr)r,r"s rrRzRelativeBy.straight_right_of s3 "$%gh h _?Q>RST rdistancecyr r!rrrVs rnearzRelativeBy.nearsfircyr r!rXs rrYzRelativeBy.nearsWZrc|s td|dkr td|jjd||gd|S)a2Add a filter to look for elements near. Args: element_or_locator: Element to look near by the element or within a distance distance: Distance in pixel Returns: RelativeBy Raises: WebDriverException: If `element_or_locator` is None WebDriverException: If `distance` is less than or equal to 0. Example: >>> near = driver.find_element(By.ID, "near") >>> elements = driver.find_elements(locate_with(By.CSS_SELECTOR, "p").near(near, 50)) z9Element or locator must be given when calling near methodrzDistance must be positiverYr)r,rXs rrYzRelativeBy.nearsH$"$%`a a q=$%@A A V6H(5STU rc8d|j|jdiS)z?Create a dict to be passed to the driver for element searching.relativerr)rs rto_dictzRelativeBy.to_dict6s$  <<  r)NNr )rNr r)2)Nr_)__name__ __module__ __qualname____doc__dictrstr LocatorTypelistrrrr#r/r4r:r@rHrMrRintrYr^r!rrr r Bs  vs{#K %T&#+.5 %td{ %V [(@V\VV GG [(@4(GS_.V [(@V\VV GG T(9D(@L,[Z+-E[,[[ LLZ$->-EQ],\j;.F\<\\ MMj4.?$.FR^,_k1I_l__ PP k1ID1P \h _k1I_l__ PP d1BT1I Ua a: 3KaP\aa RR :3Dt3K Wc bJ4LbQ]bb SS J4E4L Xd izK'?i3iXdii ZtZcZ:ZZzK'?$'FY\fr4  r)r typingrrselenium.common.exceptionsrselenium.webdriver.common.byrr$selenium.webdriver.remote.webelementrrerrr r!rrrmsO"%93;3C3L3,#F#3#<#&{ { r