pywinauto

pywinauto

pywinauto é um conjunto de módulos python para automatizar a GUI do Microsoft Windows. Na sua forma mais simples, permite enviar ações do mouse e do teclado para caixas de diálogo e controles do Windows, mas tem suporte para ações mais complexas, como obter dados de texto.

Tecnologias internas suportadas: API Win32 ( backend="win32" ; usada por padrão), MS UI Automation ( backend="uia" ). Os módulos de emulação de entrada do usuário, mouse e keyboard funcionam no Windows e no Linux.

Está gostando disso?

Basta marcar o repositório com uma estrela ou fazer uma doação.

Sua ajuda é valiosa, pois este é um projeto de hobby para todos nós: desenvolvemos novos recursos fora do horário comercial.

• Em geral, a biblioteca tende a ser multiplataforma num futuro próximo (Linux em 2018, macOS em 2019).
• O gerador confiável de "reprodução de gravação" baseado em texto também é um recurso de alta prioridade em desenvolvimento.
• Mais solicitações de recursos e discussões são bem-vindas nas edições.

Configurar

• execute pip install -U pywinauto (as dependências serão instaladas automaticamente)

Documentação/Ajuda

• Breve introdução no ReadTheDocs
• Guia de primeiros passos (conceito central, ferramentas de espionagem/inspeção, etc.)
• Tag StackOverflow para perguntas
• Lista de discussão

Exemplo simples

É simples e os scripts resultantes são muito legíveis. Quão simples?

About Notepad") app.AboutNotepad.OK.click() app.UntitledNotepad.Edit.type_keys("pywinauto Works!", with_spaces = True)">

 from pywinauto . application import Application
app = Application (). start ( "notepad.exe" )

app . UntitledNotepad . menu_select ( "Help->About Notepad" )
app . AboutNotepad . OK . click ()
app . UntitledNotepad . Edit . type_keys ( "pywinauto Works!" , with_spaces = True )

Exemplo de automação de UI MS

Exemplo mais detalhado para explorer.exe :

 from pywinauto import Desktop , Application

Application (). start ( 'explorer.exe "C: \ Program Files"' )

# connect to another process spawned by explorer.exe
# Note: make sure the script is running as Administrator!
app = Application ( backend = "uia" ). connect ( path = "explorer.exe" , title = "Program Files" )

app . ProgramFiles . set_focus ()
common_files = app . ProgramFiles . ItemsView . get_item ( 'Common Files' )
common_files . right_click_input ()
app . ContextMenu . Properties . invoke ()

# this dialog is open in another process (Desktop object doesn't rely on any process id)
Properties = Desktop ( backend = 'uia' ). Common_Files_Properties
Properties . print_control_identifiers ()
Properties . Cancel . click ()
Properties . wait_not ( 'visible' ) # make sure the dialog is closed

Dependências (se instalar manualmente)

• Windows:
  • pyWin32
  • comtypes
  • seis
• Linux:
  • python-xlib
  • seis
• Pacotes opcionais:
  • Instale Pillow (por pip install -U Pillow ) para poder chamar o método capture_as_image() para fazer um snapshot de um controle.

Pacotes necessários para executar testes unitários

• Travesseiro
• cobertura

Execute todos os testes: python ./pywinauto/unittests/testall.py

Contribuição

Solicitações pull são muito bem-vindas. Leia o Guia de Contribuição para obter mais detalhes sobre testes unitários, convenções de codificação, etc.

Direitos autorais

Pywinauto para GUI nativa do Windows foi inicialmente escrito por Mark Mc Mahon . Mark trouxe muitas ideias excelentes para a vida usando o poder do Python. Outros colaboradores se inspiram na bela API para que o desenvolvimento continue.

A partir da versão 0.6.0, o pywinauto é distribuído sob a licença BSD de 3 cláusulas. Pywinauto 0.5.4 e anteriores foram distribuídos sob a LGPL v2.1 ou posterior.

• (c) A comunidade de código aberto, 2015-2018 (desenvolvimento 0.6.0+)
• (c) Intel Corporation, 2015 (manutenção 0.5.x)
• (c)Michael Herrmann, 2012-2013 (0.4.2)
• (c) Mark Mc Mahon, 2006-2010 (0.4.0 e antes)