E g*ddlmZddlmZddlmZddlmZddlmZddlmZddl m Z de d d fd Z d ed e d d fdZ Gdd ZdS))Dict)List)Optional)Union)WebDriverException)By) WebElementtag_namereturn RelativeBycF|stdtd|iS)aWStart 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 nullz css selector)rr )r s `/var/www/sysmax/venv/lib/python3.11/site-packages/selenium/webdriver/support/relative_locator.py with_tag_namers. = !;<<< ~x0 1 11byusingcT| 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. NzPlease pass in a by argumentzPlease pass in a using argument)r )rrs r locate_withr+s; >>9>>>   ?    r5k " ""rceZdZdZddeeeeefefdee fdZ ddee efddfdZ ddee efddfd Z ddee efddfd Zddee efddfd Zdd ee eefddfd ZdefdZdS)r aGives 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&||_|pg|_dS)a Creates 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__Is }" relement_or_locatorr cd|std|jd|gd|S)z Add 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 methodabovekindargsrrappendrrs rrzRelativeBy.aboveUC " c$%abb b W7I6JKKLLL rcd|std|jd|gd|S)z Add 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 methodbelowrr"r$s rr'zRelativeBy.belowar%rcd|std|jd|gd|S)z Add 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 methodleftrr"r$s r to_left_ofzRelativeBy.to_left_ofmsC " h$%fgg g V6H5IJJKKK rcd|std|jd|gd|S)z Add 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 methodrightrr"r$s r to_right_ofzRelativeBy.to_right_ofysC " i$%ghh h W7I6JKKLLL relement_or_locator_distancecd|std|jd|gd|S)z Add a filter to look for elements near. :Args: - element_or_locator_distance: Element to look near by the element or within a distance zEElement or locator or distance must be given when calling near methodnearrr")rr.s rr0zRelativeBy.nearsC + n$%lmm m V6Q5RSSTTT rc$d|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)NN)N)__name__ __module__ __qualname____doc__rrrrstrrrr rr'r*r-intr0r3rrr r :sx   % %Xd5S>3+>&?@ %RZ[_R` % % % %  j$.>(? <      j$.>(? <      U:t3C-D P\      eJ4D.E Q]      j$6K0L Xd           rN)typingrrrrselenium.common.exceptionsrselenium.webdriver.common.byr$selenium.webdriver.remote.webelementr r8rrr r:rrr?s "999999++++++;;;;;; 2C 2L 2 2 2 2 #B #s #| # # # #_ _ _ _ _ _ _ _ _ _ r