o Ñ·6i/-ã@szddlZddlmZmZddlmZddlmZmZddl m Z de ddfd d „Z d ed e ddfd d„Z Gdd„dƒZdS)éN)ÚNoReturnÚoverload)ÚWebDriverException)ÚByÚByType)Ú WebElementÚtag_nameÚreturnÚ RelativeBycCs$t d¡|s tdƒ‚ttj|iƒS)a¤Start 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)ÚwarningsÚwarnrr rÚ CSS_SELECTOR)r©rúp/var/www/hoanhtaovolam_webdjango/env/lib/python3.10/site-packages/selenium/webdriver/support/relative_locator.pyÚ with_tag_names rÚbyÚusingcCs,|dusJdƒ‚|dusJdƒ‚t||iƒS)a³Start 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)) NzPlease pass in a by argumentzPlease pass in a using argument)r )rrrrrÚ locate_with/s rc@sÚeZdZdZeeefZd2deeefdBdedBfdd„Z e de eBddfd d „ƒZ e d3d4d d „ƒZ d3de eBdBddfd d „Z e de eBddfdd„ƒZ e d3d4dd„ƒZ d3de eBdBddfdd„Z e de eBddfdd„ƒZe d3d4dd„ƒZd3de eBdBddfdd„Ze de eBddfdd„ƒZe d3d4dd„ƒZd3de eBdBddfdd„Ze de eBddfdd„ƒZe d3d4dd„ƒZd3de eBdBddfdd„Ze de eBddfdd„ƒZe d3d4d d„ƒZd3de eBdBddfd!d„Ze de eBddfd"d#„ƒZe d3d4d$d#„ƒZd3de eBdBddfd%d#„Ze de eBddfd&d'„ƒZe d3d4d(d'„ƒZd3de eBdBddfd)d'„Ze d5de eBd+eddfd,d-„ƒZe d6ddd+edd fd.d-„ƒZd6de eBdBd+eddfd/d-„Zdefd0d1„ZdS)7r a²Find 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 NÚrootÚfilterscCs||_|pg|_dS)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 N©rr)ÚselfrrrrrÚ__init__RszRelativeBy.__init__Úelement_or_locatorr cCódS©Nr©rrrrrÚabove]ózRelativeBy.abovercCrrrrrrrr`rcCó$|stdƒ‚|j d|gdœ¡|S)aªAdd 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©ÚkindÚargs©rrÚappendrrrrrcscCrrrrrrrÚbelowzrzRelativeBy.belowcCrrrrrrrr&}rcCr)a¢Add 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$rrrrr&€ócCrrrrrrrÚ to_left_of–rzRelativeBy.to_left_ofcCrrrrrrrr)™rcCr)a¶Add 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 methodÚleftr!r$rrrrr)œr(cCrrrrrrrÚ to_right_of²rzRelativeBy.to_right_ofcCrrrrrrrr,µrcCr)a¨Add 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 methodÚrightr!r$rrrrr,¸r(cCrrrrrrrÚstraight_aboveÎrzRelativeBy.straight_abovecCrrrrrrrr/ÑrcCr)zvAdd a filter to look for elements above. Args: element_or_locator: Element to look above r Ú straightAbover!r$rrrrr/ÔócCrrrrrrrÚstraight_belowàrzRelativeBy.straight_belowcCrrrrrrrr2ãrcCr)zvAdd a filter to look for elements below. Args: element_or_locator: Element to look below r'Ú straightBelowr!r$rrrrr2ær1cCrrrrrrrÚstraight_left_ofòrzRelativeBy.straight_left_ofcCrrrrrrrr4õrcCr)zˆAdd a filter to look for elements to the left of. Args: element_or_locator: Element to look to the left of r*Ú straightLeftr!r$rrrrr4ør1cCrrrrrrrÚstraight_right_ofrzRelativeBy.straight_right_ofcCrrrrrrrr6rcCr)z|Add a filter to look for elements right of. Args: element_or_locator: Element to look right of r-Ú straightRightr!r$rrrrr6 r1é2ÚdistancecCrrr©rrr9rrrÚnearrzRelativeBy.nearcCrrrr:rrrr;rcCs6|stdƒ‚|dkrtdƒ‚|j d||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 positiver;r!r$r:rrrr;s cCsd|j|jdœiS)z?Create a dict to be passed to the driver for element searching.Úrelativerr)rrrrÚto_dict6s þÿzRelativeBy.to_dict)NNr)rNr r)r8)Nr8)Ú__name__Ú __module__Ú __qualname__Ú__doc__ÚdictrÚstrÚ LocatorTypeÚlistrrrrr&r)r,r/r2r4r6Úintr;r=rrrrr Bsd $      )r ÚtypingrrÚselenium.common.exceptionsrÚselenium.webdriver.common.byrrÚ$selenium.webdriver.remote.webelementrrCrrr rrrrÚs