Phaze v1.1.4

[PT] Biblioteca para automação silenciosa, robusta e "headless" do Microsoft Power BI Desktop. [EN] Library for silent, robust, and "headless" automation of Microsoft Power BI Desktop.

Principais Recursos / Key Features

Português

• Limbo Mode: Move a janela do Power BI para coordenadas negativas (-30000), permitindo que você continue usando o computador enquanto o robô trabalha.
• Kernel Force Save: Ignora falhas de clique visual. Utiliza injeção direta de mensagens no Kernel do Windows (PostMessage com Scan Codes reais) para forçar o salvamento (Ctrl+S) mesmo com a janela oculta.
• Crash Recovery: Detecta e trata automaticamente o erro "Há um problema com o WebView2" que ocorre ao renderizar gráficos fora da tela.
• Smart Refresh: Monitora a estabilidade visual do popup de atualização e detecta janelas que fecham sozinhas (Auto-Close).

English

• Limbo Mode: Moves the Power BI window to negative coordinates (-30000), allowing you to use the computer while the bot works.
• Kernel Force Save: Bypasses visual click failures. Uses direct Kernel message injection (PostMessage with real Scan Codes) to force save (Ctrl+S) even when the window is hidden.
• Crash Recovery: Automatically detects and handles the "There is a problem with WebView2" error that occurs when rendering charts off-screen.
• Smart Refresh: Monitors the visual stability of the refresh popup and detects windows that close automatically (Auto-Close).

Instalação / Installation

pip install phaze.

Como Usar / How to Use

A Phaze v1.1.4 funciona como um "Toolkit Modular". Você decide a ordem das ações.Phaze v1.1.4 operates as a "Modular Toolkit". You decide the order of actions.

Exemplo Completo

import time
from phaze.local_ops import Phaze

# Configuração
NOME_JANELA = "Nome do Seu Arquivo PBI"

def main():
    # 1. Inicializa
    driver = Phaze()

    # 2. Conecta
    print("Conectando...")
    if not driver.connect(window_name=NOME_JANELA):
        print("Janela não encontrada.")
        return

    # 3. Atualiza (Refresh)
    print("Atualizando dados...")
    # Agora chamamos o método a partir de 'driver'
    if driver.refresh():
        print("Atualização concluída com sucesso.")
    else:
        print("Falha na atualização.")
        driver.bring_back()
        return

    # 4. Salva (Save)
    print("Salvando...")
    if driver.save():
        print("Comando de salvar enviado.")
    else:
        print("Erro ao salvar.")

    # 5. Finaliza
    driver.bring_back() 
    print("Processo finalizado.")

if __name__ == "__main__":
    main()

Índice de Drivers

A classe Phaze expõe os seguintes métodos para controle total:

Contribuição / Contributing

• Faça um Fork do projeto.
• Crie uma branch para sua modificação: git checkout -b feature/melhoria-direta.
• Envie um Pull Request detalhando o que foi feito.