a .c@slddlmZmZmZddlmZddlmZddlm Z e ddddZ ee dd d d Z Gd ddZ d S))DictListUnion)WebDriverException)By) WebElement RelativeBy)tag_namereturncCs|s tdtd|iS)a| Start 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 r e/var/www/brookimports/venv/lib/python3.9/site-packages/selenium/webdriver/support/relative_locator.py with_tag_names r )byusingr cCs,|dusJd|dus Jdt||iS)aJ 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)rrr r r locate_with*s rc@seZdZdZdeeefedddZde e efddddZ de e efddd d Z de e efddd d Z de e efddd dZde e eefddddZedddZdS)ra Gives 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 NrootfilterscCs||_|p g|_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 Nr)selfrrr r r __init__Js zRelativeBy.__init__)element_or_locatorr cCs$|s td|jd|gd|S)z Add a filter to look for elements above. :Args: - element_or_locator: Element to look above :Element or locator must be given when calling above methodabovekindargsrrappendrrr r r rVszRelativeBy.abovecCs$|s td|jd|gd|S)z Add a filter to look for elements below. :Args: - element_or_locator: Element to look below rbelowrrrr r r rbszRelativeBy.belowcCs$|s td|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 rleftrrrr r r to_left_ofnszRelativeBy.to_left_ofcCs$|s td|jd|gd|S)z Add a filter to look for elements right of. :Args: - element_or_locator: Element to look right of rrightrrrr r r to_right_ofzszRelativeBy.to_right_of)element_or_locator_distancer cCs$|s td|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 zFElement or locator or distance must be given when calling above methodnearrr)rr$r r r r%szRelativeBy.near)r cCsd|j|jdiS)zh Create a dict that will be passed to the driver to start searching for the element relativerr)rr r r to_dicts zRelativeBy.to_dict)NN)N)N)N)N)N)__name__ __module__ __qualname____doc__rrstrrrrrrrr!r#intr%r'r r r r r:s      N)typingrrrZselenium.common.exceptionsrZselenium.webdriver.common.byrZ$selenium.webdriver.remote.webelementrr,r rrr r r r s