o N,öh1ã@s‚ddlZddlmZmZmZmZddlmZddlm Z m Z ddl m Z de ddfd d „Zd e d e ddfd d„ZGdd„dƒZdS)éN)ÚNoReturnÚOptionalÚUnionÚ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. Parameters: ----------- tag_name : str 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. Notes: ------ - 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úw/var/www/www-root/data/www/bot.pdev.uz/venv/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. Parameters: ----------- by : ByType The method to find the element. using : str 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_with6s rc@seZdZdZeeefZd2deeeefdee fdd„Z e de e efddfd d „ƒZe d3d4d d „ƒZd3de e edfddfd d „Ze de e efddfdd„ƒZe d3d4dd„ƒZd3de e edfddfdd„Ze de e efddfdd„ƒZe d3d4dd„ƒZd3de e edfddfdd„Ze de e efddfdd„ƒZe d3d4dd„ƒZd3de e edfddfdd„Ze de e efddfdd„ƒZe d3d4dd„ƒZd3de e edfddfdd„Ze de e efddfdd„ƒZe d3d4d d„ƒZd3de e edfddfd!d„Ze de e efddfd"d#„ƒZe d3d4d$d#„ƒZd3de e edfddfd%d#„Ze de e efddfd&d'„ƒZe d3d4d(d'„ƒZd3de e edfddfd)d'„Ze d5de e efd+eddfd,d-„ƒZe d6ddd+edd fd.d-„ƒZd6de e edfd+eddfd/d-„Zdefd0d1„ZdS)7r aÓGives the opportunity to find elements based on their relative location on the page from a root element. 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 NÚrootÚfilterscCs||_|pg|_dS)aÓCreates a new RelativeBy object. It is preferred if you use the `locate_with` method as this signature could change. Attributes: ----------- root : Dict[By, str] - A dict with `By` enum as the key and the search query as the value filters : List - 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__`s zRelativeBy.__init__Úelement_or_locatorr cCódS©Nr©rrrrrÚabovepózRelativeBy.abovercCrrrrrrrrsr cCó$|stdƒ‚|j d|gdœ¡|S)aAdd a filter to look for elements above. Parameters: ----------- element_or_locator : Union[WebElement, Dict, None] 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ÚappendrrrrrvócCrrrrrrrÚbelow’r zRelativeBy.belowcCrrrrrrrr)•r cCr!)aAdd a filter to look for elements below. Parameters: ----------- element_or_locator : Union[WebElement, Dict, None] 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)˜r(cCrrrrrrrÚ to_left_of´r zRelativeBy.to_left_ofcCrrrrrrrr+·r cCr!)a$Add a filter to look for elements to the left of. Parameters: ----------- element_or_locator : Union[WebElement, Dict, None] 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Ör zRelativeBy.to_right_ofcCrrrrrrrr.Ùr cCr!)aAdd a filter to look for elements right of. Parameters: ----------- element_or_locator : Union[WebElement, Dict, None] 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ør zRelativeBy.straight_abovecCrrrrrrrr1ûr cCr!)zyAdd a filter to look for elements above. :Args: - element_or_locator: Element to look above r"Ú straightAbover#r&rrrrr1þócCrrrrrrrÚstraight_below r zRelativeBy.straight_belowcCrrrrrrrr4 r cCr!)zyAdd a filter to look for elements below. :Args: - element_or_locator: Element to look below r*Ú straightBelowr#r&rrrrr4r3cCrrrrrrrÚstraight_left_ofr zRelativeBy.straight_left_ofcCrrrrrrrr6r cCr!)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&rrrrr6"r3cCrrrrrrrÚstraight_right_of.r zRelativeBy.straight_right_ofcCrrrrrrrr81r cCr!)zAdd a filter to look for elements right of. :Args: - element_or_locator: Element to look right of r/Ú straightRightr#r&rrrrr84r3é2ÚdistancecCrrr©rrr;rrrÚnear@r zRelativeBy.nearcCrrrr<rrrr=Cr cCs6|stdƒ‚|dkrtdƒ‚|j d||gdœ¡|S)ažAdd a filter to look for elements near. Parameters: ----------- element_or_locator : Union[WebElement, Dict, None] Element to look near by the element or within a distance distance : int Distance in pixel Returns: -------- RelativeBy Raises: ------- WebDriverException - If `element_or_locator` is None - 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=Fs cCsd|j|jdœiS)z[Create a dict that will be passed to the driver to start searching for the element.Úrelativerr)rrrrÚto_dicths þÿzRelativeBy.to_dict)NNr)rNr r)r:)Nr:)Ú__name__Ú __module__Ú __qualname__Ú__doc__ÚdictrÚstrÚ LocatorTyperÚlistrrrr rr)r+r.r1r4r6r8Úintr=r?rrrrr Psd $    """)r ÚtypingrrrrÚselenium.common.exceptionsrÚselenium.webdriver.common.byrrÚ$selenium.webdriver.remote.webelementr rErrr rrrrÚs