g-ddlmZddlmZddlmZddlmZddlmZddlmZddlmZddl m Z dd l m Z dd l m Z d ed d fdZde ded d fdZGdd Zy))Dict)List)NoReturn)Optional)Union)overload)WebDriverException)By)ByType) WebElementtag_namereturn RelativeBycR|s tdttj|iS)aYStart searching for relative objects using a tag name. Note: This method may be removed in future versions, please use `locate_with` instead. :Args: - tag_name: the DOM tag of element to start searching. :Returns: - RelativeBy: use this object to create filters within a `find_elements` call. ztag_name can not be null)r rr CSS_SELECTOR)r s ^/var/www/html/venv/lib/python3.12/site-packages/selenium/webdriver/support/relative_locator.py with_tag_namers'  !;<< r1 22byusingc@|Jd|Jdt||iS)a*Start searching for relative objects your search criteria with By. :Args: - by: The value from `By` passed in. - using: search term to find the element with. :Returns: - RelativeBy: use this object to create filters within a `find_elements` call. zPlease pass in a by argumentzPlease pass in a using argument)r)rrs r locate_withr/s5 >999>  ???  r5k ""rceZdZdZeeefZddeeeefdee fdZ e de e efddfdZe ddd Zdde e edfddfd Ze de e efddfd Ze ddd Zdde e edfddfdZe de e efddfdZe dddZdde e edfddfdZe de e efddfdZe dddZdde e edfddfdZe dde e efdeddfdZe ddddedd fdZdde e edfdeddfdZdefdZy)raGives the opportunity to find elements based on their relative location on the page from a root elelemt. It is recommended that you use the helper function to create it. 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)aCreates a new RelativeBy object. It is preferred if you use the `locate_with` method as this signature could change. :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__Os }" relement_or_locatorrcyNrr s rabovezRelativeBy.above[Y\rrcyr"r#r$s rr%zRelativeBy.above^DGrc^|s td|jjd|gd|S)zyAdd a filter to look for elements above. :Args: - element_or_locator: Element to look above z:Element or locator must be given when calling above methodr%kindargsr rappendr$s rr%zRelativeBy.abovea3 "$%ab b W7I6JKL rcyr"r#r$s rbelowzRelativeBy.belowmr&rcyr"r#r$s rr1zRelativeBy.belowpr(rc^|s td|jjd|gd|S)zyAdd a filter to look for elements below. :Args: - element_or_locator: Element to look below z:Element or locator must be given when calling below methodr1r*r-r$s rr1zRelativeBy.belowsr/rcyr"r#r$s r to_left_ofzRelativeBy.to_left_ofs^arcyr"r#r$s rr5zRelativeBy.to_left_ofsILrc^|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 z?Element or locator must be given when calling to_left_of methodleftr*r-r$s rr5zRelativeBy.to_left_ofs3 "$%fg g V6H5IJK rcyr"r#r$s r to_right_ofzRelativeBy.to_right_ofs_brcyr"r#r$s rr:zRelativeBy.to_right_ofsJMrc^|s td|jjd|gd|S)zAdd a filter to look for elements right of. :Args: - element_or_locator: Element to look right of z@Element or locator must be given when calling to_right_of methodrightr*r-r$s rr:zRelativeBy.to_right_ofs3 "$%gh h W7I6JKL rdistancecyr"r#rr r>s rnearzRelativeBy.nearslorcyr"r#r@s rrAzRelativeBy.nearsWZrc|s td|dkr td|jjd||gd|S)zAdd 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 z9Element or locator must be given when calling near methodrzDistance must be positiverAr*r-r@s rrAzRelativeBy.nearsH"$%`a a q=$%@A A V6H(5STU rc8d|j|jdiS)z[Create a dict that will be passed to the driver to start searching for the element.relativerr)rs rto_dictzRelativeBy.to_dicts$  <<  r)NNr")r Nrr)2)NrG)__name__ __module__ __qualname____doc__rr str LocatorTyperrrrrr r%r1r5r:intrArFr#rrrr>s vs{#K %Xd63;&78 %(SW. %\j+.E(F\<\\ GG j+t.K(L Xd \j+.E(F\<\\ GG j$.D(E Q] aU:{3J-KaP\aa LL U:tT3I-J Vb beJ 4K.LbQ]bb MM eJd4J.K Wc ouZ-D'EoQTo^joo ZtZcZ:ZZ uZd-J'K ^a kw   rN)typingrrrrrrselenium.common.exceptionsr selenium.webdriver.common.byr r $selenium.webdriver.remote.webelementr rLrrrr#rrrSs^"9+/;3C3L3" #F #3 #< #B B r