pywinauto

pywinauto

pywinauto adalah sekumpulan modul python untuk mengotomatisasi GUI Microsoft Windows. Sederhananya, ini memungkinkan Anda mengirim tindakan mouse dan keyboard ke dialog dan kontrol Windows, namun memiliki dukungan untuk tindakan yang lebih kompleks seperti mendapatkan data teks.

Teknologi yang didukung: Win32 API ( backend="win32" ; digunakan secara default), MS UI Automation ( backend="uia" ). Modul emulasi input pengguna mouse dan keyboard berfungsi di Windows dan Linux.

Menikmati ini?

Cukup bintangi repo atau berikan donasi.

Bantuan Anda sangat berharga karena ini adalah proyek hobi bagi kita semua: kami melakukan pengembangan fitur baru selama jam-jam di luar kantor.

• Secara umum perpustakaan cenderung bersifat lintas platform dalam waktu dekat (Linux pada tahun 2018, macOS pada tahun 2019).
• Generator "record-replay" berbasis teks yang andal juga merupakan fitur prioritas tinggi yang sedang dikembangkan.
• Permintaan dan diskusi fitur lainnya diterima dalam edisi ini.

Pengaturan

• jalankan pip install -U pywinauto (dependensi akan diinstal secara otomatis)

Dokumentasi / Bantuan

• Pengantar Singkat tentang ReadTheDocs
• Panduan Memulai (konsep inti, alat Spy/Inspeksi, dll.)
• Tag StackOverflow untuk pertanyaan
• milis

Contoh Sederhana

Sederhana dan skrip yang dihasilkan sangat mudah dibaca. Seberapa sederhana?

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 )

Contoh Otomasi MS UI

Contoh lebih detail untuk 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

Dependensi (jika diinstal secara manual)

• jendela:
  • pyWin32
  • comtypes
  • enam
• Linux:
  • python-xlib
  • enam
• Paket opsional:
  • Instal Pillow (dengan pip install -U Pillow ) agar dapat memanggil metode capture_as_image() untuk membuat snapshot kontrol.

Paket diperlukan untuk menjalankan pengujian unit

• Bantal
• cakupan

Jalankan semua tes: python ./pywinauto/unittests/testall.py

Kontribusi

Permintaan tarik sangat diterima. Baca Panduan Kontribusi untuk detail selengkapnya tentang pengujian unit, konvensi pengkodean, dll.

Hak Cipta

Pywinauto untuk GUI Windows asli awalnya ditulis oleh Mark Mc Mahon . Mark mewujudkan banyak ide hebat dengan menggunakan kekuatan Python. Kontributor selanjutnya terinspirasi dari API yang bagus sehingga pengembangan terus berlanjut.

Mulai dari 0.6.0 pywinauto didistribusikan di bawah lisensi 3-klausul BSD. Pywinauto 0.5.4 dan sebelumnya didistribusikan di bawah LGPL v2.1 atau lebih baru.

• (c) Komunitas Open Source, 2015-2018 (pengembangan 0.6.0+)
• (c) Intel Corporation, 2015 (pemeliharaan 0,5.x)
• (c) Michael Herrmann, 2012-2013 (0.4.2)
• (c) Mark Mc Mahon, 2006-2010 (0.4.0 dan sebelumnya)