# Instalação (execute no terminal)
pip install selenium
pip install webdriver-manager  # Gerencia o driver automaticamente

# Imports obrigatórios para WebDriverWait
from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
from selenium.common.exceptions import TimeoutException

# Configuração básica com Chrome gerenciado automaticamente
from selenium.webdriver.chrome.service import Service
from webdriver_manager.chrome import ChromeDriverManager

driver = webdriver.Chrome(service=Service(ChromeDriverManager().install()))
driver.get("https://www.exemplo.com")

# WebDriverWait: aguarda até 10 segundos
wait = WebDriverWait(driver, 10)

# presence_of_element_located — elemento existe no DOM (pode estar oculto)
element = wait.until(
    EC.presence_of_element_located((By.ID, "element_id"))
)

# Também funciona com XPath
element = wait.until(
    EC.presence_of_element_located((By.XPATH, "//div[@class='conteudo']"))
)

# Com CSS Selector (geralmente mais rápido que XPath)
element = wait.until(
    EC.presence_of_element_located((By.CSS_SELECTOR, ".classe-do-elemento"))
)

# element_to_be_clickable — visível, habilitado e pronto para clique
# Recomendado como padrão para botões, links e inputs
botao = wait.until(
    EC.element_to_be_clickable((By.ID, "botao_enviar"))
)
botao.click()

# visibility_of_element_located — visível mas não necessariamente clicável
campo = wait.until(
    EC.visibility_of_element_located((By.NAME, "usuario"))
)
campo.send_keys("meu_login")

# Aguarda a URL exata ser carregada
wait.until(EC.url_to_be("https://www.youtube.com/@canalqb"))

# Aguarda a URL conter uma substring (útil para URLs dinâmicas)
wait.until(EC.url_contains("/dashboard"))

# Aguarda o título da página
wait.until(EC.title_contains("Bem-vindo"))

# Aguarda o título exato
wait.until(EC.title_is("Painel Principal - MeuSite"))

from selenium.webdriver.support import expected_conditions as EC

# Aguarda qualquer um de dois elementos aparecer (OR lógico)
element = wait.until(
    lambda d: d.find_element(By.ID, "sucesso") or d.find_element(By.ID, "erro")
)

# Aguarda lista de elementos (tabelas, cards dinâmicos)
elementos = wait.until(
    EC.presence_of_all_elements_located((By.CSS_SELECTOR, ".item-lista"))
)
print(f"Encontrados: {len(elementos)} itens")

# Aguarda elemento desaparecer (útil após submit de formulário)
wait.until(EC.invisibility_of_element_located((By.ID, "spinner-loading")))

from selenium.common.exceptions import TimeoutException, NoSuchElementException

def aguardar_elemento(wait, locator, descricao="elemento"):
    """
    Função reutilizável para esperar elemento com log de erro claro.
    Retorna o elemento ou None em caso de timeout.
    """
    try:
        element = wait.until(EC.element_to_be_clickable(locator))
        print(f"[OK] {descricao} encontrado e clicável.")
        return element
    except TimeoutException:
        print(f"[TIMEOUT] '{descricao}' não ficou clicável em {wait._timeout}s.")
        return None
    except NoSuchElementException:
        print(f"[ERRO] '{descricao}' não existe no DOM com o seletor informado.")
        return None

# Uso da função
wait = WebDriverWait(driver, 15)

botao_login = aguardar_elemento(
    wait,
    (By.ID, "btn-login"),
    "Botão de Login"
)

if botao_login:
    botao_login.click()
else:
    print("Fluxo alternativo: elemento não disponível.")
    driver.save_screenshot("debug_timeout.png")  # Captura tela para diagnóstico

from selenium.webdriver.support.wait import WebDriverWait
from selenium.common.exceptions import NoSuchElementException, StaleElementReferenceException
import datetime

# Fluent Wait: polling a cada 1s, ignora NoSuchElement e StaleElement
fluent_wait = WebDriverWait(
    driver,
    timeout=20,                # Timeout total em segundos
    poll_frequency=1,          # Verifica a cada 1 segundo (padrão é 0.5s)
    ignored_exceptions=[
        NoSuchElementException,
        StaleElementReferenceException  # Elemento mudou de referência no DOM
    ]
)

# Uso prático: aguardar card de produto que carrega via lazy load
card_produto = fluent_wait.until(
    EC.presence_of_element_located((By.CSS_SELECTOR, ".card-produto"))
)
print(f"Card encontrado: {card_produto.text[:50]}")