mirror of
https://github.com/User0332/rewards-farmer.git
synced 2026-09-16 01:31:36 +00:00
mardausdennis
9842d608c8
The daily set opener lives in the streaks section, not in a section of its own, so scoping the lookup to a dedicated section disabled the task on every layout. Match on 'daily set streak' instead, since 'daily set' also hits the level up entry. Visual search keeps a positional fallback inside streaks because its label is not confirmed on layouts that ship it. Claim now prefers an exact label match so the 'Ready to claim' heading cannot win.
342 lines
12 KiB
Python
342 lines
12 KiB
Python
import re
|
|
|
|
from selenium.webdriver.common.by import By
|
|
from selenium.webdriver.remote.webelement import WebElement
|
|
from selenium.common.exceptions import NoSuchElementException, StaleElementReferenceException
|
|
from selenium import webdriver
|
|
|
|
|
|
class ElementSelectionUtils:
|
|
"""Selectors for the Rewards UI.
|
|
|
|
These are deliberately semantic rather than positional. The Rewards page is
|
|
server-rendered React whose markup differs between markets and changes
|
|
between deploys, so absolute XPaths like
|
|
`/html/body/div[2]/div[2]/div/main/section[1]/...` resolve to nothing
|
|
outside the exact variant they were written against.
|
|
|
|
Two concrete cases this has to survive:
|
|
|
|
1. Outside en-US the page can render an extra `exploreonbing` section, which
|
|
shifts every positional section index by one.
|
|
2. Some sections are emitted twice for responsive layout. The first match in
|
|
document order can be the hidden, empty one, so container lookups must
|
|
pick the copy that is visible and actually has content.
|
|
|
|
Anything the current variant does not ship raises NoSuchElementException so
|
|
the caller can skip that task instead of aborting the whole run.
|
|
"""
|
|
|
|
def __init__(self, driver: webdriver.Edge):
|
|
self.driver = driver
|
|
|
|
# ------------------------------------------------------------------
|
|
# helpers
|
|
# ------------------------------------------------------------------
|
|
|
|
def resolve(self, xpath: str):
|
|
return self.driver.find_element(By.XPATH, xpath)
|
|
|
|
def _container_by_id(self, element_id: str) -> WebElement:
|
|
"""Return the usable copy of an id that may be present more than once.
|
|
|
|
Only a copy that is both visible and has content is usable. A hidden copy
|
|
still exposes its links to find_elements, but they cannot be clicked and
|
|
their `.text` is empty, so returning one produces silent no-ops further
|
|
up. Raising instead lets the caller's WebDriverWait retry while the page
|
|
finishes hydrating.
|
|
"""
|
|
matches = self.driver.find_elements(By.ID, element_id)
|
|
|
|
if not matches:
|
|
raise NoSuchElementException(f"no element with id {element_id!r}")
|
|
|
|
for match in matches:
|
|
try:
|
|
if match.is_displayed() and match.find_elements(By.TAG_NAME, "a"):
|
|
return match
|
|
except StaleElementReferenceException:
|
|
continue
|
|
|
|
raise NoSuchElementException(
|
|
f"{element_id!r} is present but no visible copy has content yet"
|
|
)
|
|
|
|
def _button_containing(self, needle: str, root: WebElement = None) -> WebElement:
|
|
"""First button whose visible text contains `needle` (case-insensitive)."""
|
|
scope = self.driver if root is None else root
|
|
needle = needle.lower()
|
|
|
|
for button in scope.find_elements(By.TAG_NAME, "button"):
|
|
try:
|
|
if needle in (button.text or "").lower():
|
|
return button
|
|
except StaleElementReferenceException:
|
|
continue
|
|
|
|
raise NoSuchElementException(f"no button containing {needle!r}")
|
|
|
|
def _link_containing(self, needle: str, root: WebElement = None) -> WebElement:
|
|
scope = self.driver if root is None else root
|
|
needle = needle.lower()
|
|
|
|
for link in scope.find_elements(By.TAG_NAME, "a"):
|
|
try:
|
|
if needle in (link.text or "").lower():
|
|
return link
|
|
except StaleElementReferenceException:
|
|
continue
|
|
|
|
raise NoSuchElementException(f"no link containing {needle!r}")
|
|
|
|
# ------------------------------------------------------------------
|
|
# navigation
|
|
# ------------------------------------------------------------------
|
|
|
|
def get_earn_tab(self):
|
|
# The react-aria prefix is generated per build, so match on the suffix.
|
|
return self.driver.find_element(By.CSS_SELECTOR, '[id$="-tab-/earn"]')
|
|
|
|
def get_dashboard_tab(self):
|
|
return self.driver.find_element(By.CSS_SELECTOR, '[id$="-tab-/dashboard"]')
|
|
|
|
def get_sidebar_section(self):
|
|
for section in self.driver.find_elements(By.TAG_NAME, "section"):
|
|
try:
|
|
# get_dom_attribute returns None for sections without an id,
|
|
# so normalise before comparing.
|
|
if (section.get_dom_attribute("id") or "").startswith("react-aria"):
|
|
return section
|
|
except StaleElementReferenceException:
|
|
continue
|
|
|
|
raise NoSuchElementException("sidebar section not found")
|
|
|
|
# ------------------------------------------------------------------
|
|
# daily set
|
|
# ------------------------------------------------------------------
|
|
|
|
def _streaks_button(self, index: int) -> WebElement:
|
|
"""Positional fallback inside the streaks section.
|
|
|
|
Same node the original absolute XPath pointed at, but anchored on the
|
|
section id so an extra section earlier in the page cannot shift it.
|
|
"""
|
|
streaks = self.driver.find_element(By.ID, "streaks")
|
|
|
|
return streaks.find_element(By.XPATH, f"./div/div[2]/div/div/button[{index}]")
|
|
|
|
def get_open_daily_set_button(self):
|
|
# Lives in the streaks section, not in a section of its own. Match on
|
|
# "daily set streak" rather than "daily set", because the level up
|
|
# section also has "Complete the Daily Set for 7 days in a row".
|
|
try:
|
|
return self._button_containing("daily set streak")
|
|
except NoSuchElementException:
|
|
return self._streaks_button(3)
|
|
|
|
def get_daily_set_elements(self):
|
|
# The first link in the opened panel is the progress row, not an activity.
|
|
return self.get_sidebar_section().find_elements(By.TAG_NAME, "a")[1:]
|
|
|
|
# ------------------------------------------------------------------
|
|
# explore on bing (absent in en-US, present in some other markets)
|
|
# ------------------------------------------------------------------
|
|
|
|
def get_explore_on_bing_elements(self):
|
|
try:
|
|
container = self._container_by_id("exploreonbing")
|
|
except NoSuchElementException:
|
|
return []
|
|
|
|
return container.find_elements(By.TAG_NAME, "a")
|
|
|
|
# ------------------------------------------------------------------
|
|
# visual search
|
|
# ------------------------------------------------------------------
|
|
|
|
def get_open_visual_search_sidebar(self):
|
|
for needle in ("visual search", "image search"):
|
|
try:
|
|
return self._button_containing(needle)
|
|
except NoSuchElementException:
|
|
continue
|
|
|
|
# Not every layout ships this entry point, and where it does the label is
|
|
# not confirmed, so fall back to the original position in streaks.
|
|
return self._streaks_button(5)
|
|
|
|
def get_search_now_link_from_visual_search_sidebar(self):
|
|
sidebar = self.get_sidebar_section()
|
|
|
|
try:
|
|
return self._link_containing("search now", sidebar)
|
|
except NoSuchElementException:
|
|
# Fall back to the original positional behaviour.
|
|
links = sidebar.find_elements(By.TAG_NAME, "a")
|
|
|
|
if len(links) < 2:
|
|
raise NoSuchElementException("visual search sidebar has no usable link")
|
|
|
|
return links[1]
|
|
|
|
def get_visual_search_button(self):
|
|
return self.driver.find_element(By.CSS_SELECTOR, "#sb_form > div.camera.icon")
|
|
|
|
def get_visual_search_file_input(self):
|
|
return self.driver.find_element(By.CSS_SELECTOR, "#sb_fileinput")
|
|
|
|
# ------------------------------------------------------------------
|
|
# cards
|
|
# ------------------------------------------------------------------
|
|
|
|
def get_all_misc_cards(self):
|
|
return self._container_by_id("moreactivities").find_elements(By.TAG_NAME, "a")
|
|
|
|
def extract_card_descriptions(self, card: WebElement):
|
|
try:
|
|
return card.find_element(By.CSS_SELECTOR, "p:nth-child(2)").text
|
|
except NoSuchElementException:
|
|
paragraphs = card.find_elements(By.TAG_NAME, "p")
|
|
|
|
return paragraphs[1].text if len(paragraphs) > 1 else (card.text or "")
|
|
|
|
def _card_status_element(self, card: WebElement):
|
|
return card.find_element(By.CSS_SELECTOR, "div.flex.w-full.items-center.gap-2")
|
|
|
|
def card_is_complete(self, card: WebElement):
|
|
try:
|
|
status = self._card_status_element(card).text
|
|
except NoSuchElementException:
|
|
return False
|
|
|
|
return "completed" in (status or "").lower()
|
|
|
|
def get_card_point_value(self, card: WebElement):
|
|
try:
|
|
elem = self._card_status_element(card).find_element(By.TAG_NAME, "p")
|
|
except NoSuchElementException:
|
|
return 0
|
|
|
|
# Rendered as "+10", and other variants add a unit, so pull the digits out
|
|
# rather than relying on int() accepting the exact string.
|
|
digits = re.search(r"\d+", elem.text or "")
|
|
|
|
return int(digits.group()) if digits else 0
|
|
|
|
def element_is_fully_in_viewport(self, elem: WebElement) -> bool:
|
|
js_viewport_check = """
|
|
var elem = arguments[0];
|
|
var box = elem.getBoundingClientRect();
|
|
|
|
return (
|
|
box.top >= 0 &&
|
|
box.left >= 0 &&
|
|
box.bottom <= (window.innerHeight || document.documentElement.clientHeight) &&
|
|
box.right <= (window.innerWidth || document.documentElement.clientWidth)
|
|
);
|
|
"""
|
|
|
|
return self.driver.execute_script(js_viewport_check, elem)
|
|
|
|
# ------------------------------------------------------------------
|
|
# points breakdown
|
|
# ------------------------------------------------------------------
|
|
|
|
def get_points_breakdown_button(self):
|
|
return self._button_containing("points breakdown")
|
|
|
|
def get_close_button_on_points_breakdown(self):
|
|
return self.get_generic_sidebar_close_button()
|
|
|
|
def get_points_earned_from_searches_on_points_breakdown(self):
|
|
"""Return (earned, max) for the Bing search row of the breakdown panel.
|
|
|
|
The value renders as two spans, "3" and "/15", so an XPath on text()
|
|
matches only the second half. Read the panel's rendered text instead and
|
|
anchor on the row label, because several rows share the same value class
|
|
and a reordering would otherwise silently return the wrong number.
|
|
"""
|
|
sidebar = self.get_sidebar_section()
|
|
text = sidebar.text or ""
|
|
lines = [line.strip() for line in text.splitlines()]
|
|
|
|
def parse(candidate: str):
|
|
match = re.fullmatch(r"([\d,]+)\s*/\s*([\d,]+)", candidate)
|
|
|
|
if not match:
|
|
return None
|
|
|
|
return int(match.group(1).replace(",", "")), int(match.group(2).replace(",", ""))
|
|
|
|
for index, line in enumerate(lines):
|
|
if "bing search" in line.lower():
|
|
for candidate in lines[index + 1:index + 3]:
|
|
parsed = parse(candidate)
|
|
|
|
if parsed:
|
|
return parsed
|
|
|
|
# Fall back to the first fraction anywhere in the panel.
|
|
match = re.search(r"([\d,]+)\s*/\s*([\d,]+)", text)
|
|
|
|
if match:
|
|
return int(match.group(1).replace(",", "")), int(match.group(2).replace(",", ""))
|
|
|
|
raise NoSuchElementException("no points fraction found in the breakdown sidebar")
|
|
|
|
# ------------------------------------------------------------------
|
|
# bonus
|
|
# ------------------------------------------------------------------
|
|
|
|
def get_bonus_button_on_dashboard(self):
|
|
return self._button_containing("ready to claim")
|
|
|
|
def get_claim_bonus_points_button(self):
|
|
sidebar = self.get_sidebar_section()
|
|
buttons = sidebar.find_elements(By.TAG_NAME, "button")
|
|
|
|
# Prefer the button whose whole label is the action. A substring match
|
|
# would hit the "Ready to claim" heading before the actual Claim button.
|
|
for button in buttons:
|
|
try:
|
|
if (button.text or "").strip().lower() == "claim":
|
|
return button
|
|
except StaleElementReferenceException:
|
|
continue
|
|
|
|
for button in buttons:
|
|
try:
|
|
if "claim" in (button.text or "").lower():
|
|
return button
|
|
except StaleElementReferenceException:
|
|
continue
|
|
|
|
if len(buttons) < 3:
|
|
raise NoSuchElementException("bonus sidebar has no claim button")
|
|
|
|
return buttons[2]
|
|
|
|
def get_generic_sidebar_close_button(self):
|
|
sidebar = self.get_sidebar_section()
|
|
|
|
try:
|
|
return sidebar.find_element(By.CSS_SELECTOR, "button[aria-label*='lose']")
|
|
except NoSuchElementException:
|
|
buttons = sidebar.find_elements(By.TAG_NAME, "button")
|
|
|
|
if not buttons:
|
|
raise NoSuchElementException("sidebar has no buttons")
|
|
|
|
return buttons[0]
|
|
|
|
# ------------------------------------------------------------------
|
|
# bing search page
|
|
# ------------------------------------------------------------------
|
|
|
|
def get_bing_search_bar(self):
|
|
return self.driver.find_element(By.TAG_NAME, "textarea")
|
|
|
|
def get_clear_bing_search_query_button(self):
|
|
return self.driver.find_element(By.ID, "sw_clx")
|