movva-tech-library 0.1.3

Core library for movva tech aplications.

movva-tech-library

Uma biblioteca de automação desktop focada em Windows, encapsulando e simplificando as funcionalidades do pywinauto e pyautogui.

Como inicializar

Para utilizar a biblioteca, basta importar e instanciar a classe DesktopRobot:

from movva_tech_library import DesktopRobot
from pathlib import Path

# Instanciando o robô
robot = DesktopRobot()

## Referência de Métodos

### Gerenciamento de Aplicações e Janelas

- **Iniciar uma aplicação:**
  ```python
  robot.start_application(path=r"C:\Caminho\Para\App.exe", backend="uia")

• Conectar a uma aplicação em execução:

  robot.connect_application(title="Meu App", backend="uia")
  

• Esperar por uma janela específica:

  robot.wait_for_window(title="Janela Principal", timeout=10)
  

• Definir janela ativa: (Útil para buscar locators apenas dentro dessa janela)

  robot.set_active_window(title="Janela Principal")
  

• Encerrar aplicação:

  robot.kill()
  

Interação com Elementos da Interface (Locators pywinauto)

Os métodos abaixo aceitam qualquer critério do pywinauto (ex: title, auto_id, control_type).

• Clicar por locator:

  robot.click_by_locator(title="Botão Confirmar")
  

• Duplo clique por locator:

  robot.double_click_by_locator(auto_id="btnDetalhes")
  

• Obter texto de um elemento:

  texto = robot.get_text(auto_id="labelStatus")
  print(texto)
  

Interação por Imagens na Tela (pyautogui)

Recomenda-se o uso de caminhos absolutos para as imagens.

• Clicar em uma imagem:

  # Opcional: usar offset_x e offset_y para clicar deslocado do centro da imagem
  image_path = str(BASE_DIR / "assets" / "botao.png")
  robot.click_by_image(image_path, confidence=0.9, timeout=10)
  

• Esperar por uma imagem aparecer na tela:

  coordenadas = robot.wait_for_image(image_path, confidence=0.9, timeout=10)
  

Teclado e Digitação

• Digitar texto: Pode focar em um elemento específico antes de digitar caso forneça um locator.

  # Digita livremente onde o cursor estiver
  robot.type_text("Olá Mundo", interval=0.05)
  
  # Foca no input primeiro e depois digita
  robot.type_text("Meu texto direto no campo", locator={"auto_id": "inputTexto"})
  

• Pressionar teclas isoladas:

  robot.press_key("enter")
  robot.press_key("tab", presses=2)
  

• Pressionar atalhos (hotkeys):

  robot.hotkey("ctrl", "c")
  robot.hotkey("alt", "f4")
  

Esperas (Timeouts e Pausas)

• Pausa estática (não recomendado, use waits dinâmicos quando possível):

  robot.wait(2.5) # Aguarda 2.5 segundos