@@ -0,0 +1,66 @@
|
||||
Here is an inevitably incomplete list of MUCH-APPRECIATED CONTRIBUTORS --
|
||||
people who have submitted patches, reported bugs, added translations, helped
|
||||
answer newbie questions, and generally made PyAutoGUI that much better:
|
||||
|
||||
Abhijeet Singh https://github.com/cseas
|
||||
Al Sweigart https://github.com/asweigart/
|
||||
Alexandr Orlov https://github.com/hey-sancho
|
||||
alphaCTzo7G https://github.com/alphaCTzo7G
|
||||
Andrew Selzer https://github.com/afs2015
|
||||
Andy Dam https://github.com/andydam
|
||||
Anwar A. Ruff https://github.com/aaruff
|
||||
Ari Lacenski https://github.com/tensory
|
||||
Ashok Fernandez https://github.com/ashokfernandez/
|
||||
Brian Redmond https://github.com/bredmond
|
||||
Christopher Valles https://github.com/christophervalles
|
||||
clach04 https://github.com/clach04
|
||||
Clayton A. Alves https://github.com/claytonaalves
|
||||
cryzed https://github.com/cryzed
|
||||
Daniel D. Beck https://github.com/ddbeck
|
||||
danielboone https://github.com/danielboone
|
||||
Davee Nguyen https://github.com/daveenguyen
|
||||
David Siah https://github.com/dsiah
|
||||
Denilson Figueiredo de Sá https://github.com/denilsonsa
|
||||
Dominik Schmelz https://github.com/DIDoS
|
||||
dragon778 https://github.com/dragon788
|
||||
Duxxi https://github.com/sjhhh3
|
||||
Eric https://github.com/bleuetnoir
|
||||
ErtugrulSener https://github.com/ErtugrulSener
|
||||
Fornost461 https://github.com/Fornost461
|
||||
Harrison https://github.com/Sentdex
|
||||
Hugo Salvador https://github.com/hugoesb
|
||||
i-need-to-tell-you-something https://github.com/i-need-to-tell-you-something
|
||||
jakibaki https://github.com/
|
||||
Jeff Triplett https://github.com/jefftriplett
|
||||
Jeremy R. Gray https://github.com/jeremygray
|
||||
Jeromie Kirchoff https://github.com/JayRizzo
|
||||
Joel Gomes da Silva https://github.com/joelgomes1994
|
||||
johnborgmann https://github.com/johnborgmann
|
||||
Jon Winsley https://github.com/glitchassassin
|
||||
jorg-j https://github.com/jorg-j
|
||||
Jose Riha https://github.com/jose1711
|
||||
Julien Schueller https://github.com/jschueller
|
||||
Korons https://github.com/Korons
|
||||
lb1a https://github.com/lb1a
|
||||
Lesmana Zimmer https://github.com/lesmana
|
||||
liberme https://github.com/liberme
|
||||
Matt Olsen https://github.com/digwanderlust
|
||||
mvbentes https://github.com/mvbentes
|
||||
nexcvon https://github.com/nexcvon
|
||||
Oleg Höfling https://github.com/hoefling
|
||||
optroot https://github.com/optroot
|
||||
pgkos https://github.com/pgkos
|
||||
qiujieqiong https://github.com/qiujieqiong
|
||||
Ricardo Amendoeira https://github.com/ric2b
|
||||
Scott Noyes https://github.com/snoyes
|
||||
Sergio Encarnación https://github.com/Sergioenc28
|
||||
sneakypete81 https://github.com/sneakypete81
|
||||
Stefan Hoelzl https://github.com/stefanhoelzl
|
||||
Stephen Ellis https://github.com/saellis
|
||||
Steven Shave https://github.com/stevenshave
|
||||
Tim Gates https://github.com/timgates42
|
||||
Timothy Crory https://github.com/tcrory
|
||||
undefx https://github.com/undefx
|
||||
Vélmer Oliveira https://github.com/velmer
|
||||
Yoshiaki Ono https://github.com/fx-kirin
|
||||
Stefan Hoelzl https://github.com/stefanhoelzl
|
@@ -0,0 +1 @@
|
||||
pip
|
@@ -0,0 +1,27 @@
|
||||
Copyright (c) 2014, Al Sweigart
|
||||
All rights reserved.
|
||||
|
||||
Redistribution and use in source and binary forms, with or without
|
||||
modification, are permitted provided that the following conditions are met:
|
||||
|
||||
* Redistributions of source code must retain the above copyright notice, this
|
||||
list of conditions and the following disclaimer.
|
||||
|
||||
* Redistributions in binary form must reproduce the above copyright notice,
|
||||
this list of conditions and the following disclaimer in the documentation
|
||||
and/or other materials provided with the distribution.
|
||||
|
||||
* Neither the name of the PyAutoGUI nor the names of its
|
||||
contributors may be used to endorse or promote products derived from
|
||||
this software without specific prior written permission.
|
||||
|
||||
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
||||
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||||
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
||||
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
|
||||
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
||||
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
||||
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
|
||||
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
|
||||
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
||||
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
@@ -0,0 +1,169 @@
|
||||
Metadata-Version: 2.1
|
||||
Name: PyAutoGUI
|
||||
Version: 0.9.53
|
||||
Summary: PyAutoGUI lets Python control the mouse and keyboard, and other GUI automation tasks. For Windows, macOS, and Linux, on Python 3 and 2.
|
||||
Home-page: https://github.com/asweigart/pyautogui
|
||||
Author: Al Sweigart
|
||||
Author-email: al@inventwithpython.com
|
||||
License: BSD
|
||||
Keywords: gui automation test testing keyboard mouse cursor click press keystroke control
|
||||
Platform: UNKNOWN
|
||||
Classifier: Development Status :: 4 - Beta
|
||||
Classifier: Environment :: Win32 (MS Windows)
|
||||
Classifier: Environment :: X11 Applications
|
||||
Classifier: Environment :: MacOS X
|
||||
Classifier: Intended Audience :: Developers
|
||||
Classifier: License :: OSI Approved :: BSD License
|
||||
Classifier: Operating System :: OS Independent
|
||||
Classifier: Programming Language :: Python
|
||||
Classifier: Programming Language :: Python :: 2
|
||||
Classifier: Programming Language :: Python :: 2.7
|
||||
Classifier: Programming Language :: Python :: 3
|
||||
Classifier: Programming Language :: Python :: 3.1
|
||||
Classifier: Programming Language :: Python :: 3.2
|
||||
Classifier: Programming Language :: Python :: 3.3
|
||||
Classifier: Programming Language :: Python :: 3.4
|
||||
Classifier: Programming Language :: Python :: 3.5
|
||||
Classifier: Programming Language :: Python :: 3.6
|
||||
Classifier: Programming Language :: Python :: 3.7
|
||||
Classifier: Programming Language :: Python :: 3.8
|
||||
Description-Content-Type: text/markdown
|
||||
License-File: LICENSE.txt
|
||||
License-File: AUTHORS.txt
|
||||
Requires-Dist: pymsgbox
|
||||
Requires-Dist: PyTweening (>=1.0.1)
|
||||
Requires-Dist: pyscreeze (>=0.1.21)
|
||||
Requires-Dist: pygetwindow (>=0.0.5)
|
||||
Requires-Dist: mouseinfo
|
||||
Requires-Dist: pyobjc-core ; platform_system == "Darwin"
|
||||
Requires-Dist: pyobjc ; platform_system == "Darwin"
|
||||
Requires-Dist: python-xlib ; platform_system == "Linux" and python_version < "3.0"
|
||||
Requires-Dist: python3-Xlib ; platform_system == "Linux" and python_version >= "3.0"
|
||||
|
||||
PyAutoGUI
|
||||
=========
|
||||
|
||||
PyAutoGUI is a cross-platform GUI automation Python module for human beings. Used to programmatically control the mouse & keyboard.
|
||||
|
||||
`pip install pyautogui`
|
||||
|
||||
Full documentation available at https://pyautogui.readthedocs.org
|
||||
|
||||
Simplified Chinese documentation available at https://muxuezi.github.io/posts/doc-pyautogui.html
|
||||
|
||||
Source code available at https://github.com/asweigart/pyautogui
|
||||
|
||||
If you need help installing Python, visit https://installpython3.com/
|
||||
|
||||
Dependencies
|
||||
============
|
||||
|
||||
PyAutoGUI supports Python 2 and 3. If you are installing PyAutoGUI from PyPI using pip:
|
||||
|
||||
Windows has no dependencies. The Win32 extensions do not need to be installed.
|
||||
|
||||
macOS needs the rubicon-objc module installed (in that order).
|
||||
|
||||
Linux needs the python3-xlib (or python-xlib for Python 2) module installed.
|
||||
|
||||
Pillow needs to be installed, and on Linux you may need to install additional libraries to make sure Pillow's PNG/JPEG works correctly. See:
|
||||
|
||||
https://stackoverflow.com/questions/7648200/pip-install-pil-e-tickets-1-no-jpeg-png-support
|
||||
|
||||
http://ubuntuforums.org/showthread.php?t=1751455
|
||||
|
||||
If you want to do development and contribute to PyAutoGUI, you will need to install these modules from PyPI:
|
||||
|
||||
* pyscreeze
|
||||
* pymsgbox
|
||||
* pytweening
|
||||
|
||||
Example Usage
|
||||
=============
|
||||
|
||||
Keyboard and Mouse Control
|
||||
--------------------------
|
||||
|
||||
The x, y coordinates used by PyAutoGUI has the 0, 0 origin coordinates in the top left corner of the screen. The x coordinates increase going to the right (just as in mathematics) but the y coordinates increase going down (the opposite of mathematics). On a screen that is 1920 x 1080 pixels in size, coordinates 0, 0 are for the top left while 1919, 1079 is for the bottom right.
|
||||
|
||||
Currently, PyAutoGUI only works on the primary monitor. PyAutoGUI isn't reliable for the screen of a second monitor (the mouse functions may or may not work on multi-monitor setups depending on your operating system and version).
|
||||
|
||||
All keyboard presses done by PyAutoGUI are sent to the window that currently has focus, as if you had pressed the physical keyboard key.
|
||||
|
||||
```python
|
||||
>>> import pyautogui
|
||||
>>> screenWidth, screenHeight = pyautogui.size() # Returns two integers, the width and height of the screen. (The primary monitor, in multi-monitor setups.)
|
||||
>>> currentMouseX, currentMouseY = pyautogui.position() # Returns two integers, the x and y of the mouse cursor's current position.
|
||||
>>> pyautogui.moveTo(100, 150) # Move the mouse to the x, y coordinates 100, 150.
|
||||
>>> pyautogui.click() # Click the mouse at its current location.
|
||||
>>> pyautogui.click(200, 220) # Click the mouse at the x, y coordinates 200, 220.
|
||||
>>> pyautogui.move(None, 10) # Move mouse 10 pixels down, that is, move the mouse relative to its current position.
|
||||
>>> pyautogui.doubleClick() # Double click the mouse at the
|
||||
>>> pyautogui.moveTo(500, 500, duration=2, tween=pyautogui.easeInOutQuad) # Use tweening/easing function to move mouse over 2 seconds.
|
||||
>>> pyautogui.write('Hello world!', interval=0.25) # Type with quarter-second pause in between each key.
|
||||
>>> pyautogui.press('esc') # Simulate pressing the Escape key.
|
||||
>>> pyautogui.keyDown('shift')
|
||||
>>> pyautogui.write(['left', 'left', 'left', 'left', 'left', 'left'])
|
||||
>>> pyautogui.keyUp('shift')
|
||||
>>> pyautogui.hotkey('ctrl', 'c')
|
||||
```
|
||||
|
||||
Display Message Boxes
|
||||
---------------------
|
||||
```python
|
||||
>>> import pyautogui
|
||||
>>> pyautogui.alert('This is an alert box.')
|
||||
'OK'
|
||||
>>> pyautogui.confirm('Shall I proceed?')
|
||||
'Cancel'
|
||||
>>> pyautogui.confirm('Enter option.', buttons=['A', 'B', 'C'])
|
||||
'B'
|
||||
>>> pyautogui.prompt('What is your name?')
|
||||
'Al'
|
||||
>>> pyautogui.password('Enter password (text will be hidden)')
|
||||
'swordfish'
|
||||
```
|
||||
|
||||
Screenshot Functions
|
||||
--------------------
|
||||
|
||||
(PyAutoGUI uses Pillow for image-related features.)
|
||||
```python
|
||||
>>> import pyautogui
|
||||
>>> im1 = pyautogui.screenshot()
|
||||
>>> im1.save('my_screenshot.png')
|
||||
>>> im2 = pyautogui.screenshot('my_screenshot2.png')
|
||||
```
|
||||
You can also locate where an image is on the screen:
|
||||
```python
|
||||
>>> import pyautogui
|
||||
>>> button7location = pyautogui.locateOnScreen('button.png') # returns (left, top, width, height) of matching region
|
||||
>>> button7location
|
||||
(1416, 562, 50, 41)
|
||||
>>> buttonx, buttony = pyautogui.center(button7location)
|
||||
>>> buttonx, buttony
|
||||
(1441, 582)
|
||||
>>> pyautogui.click(buttonx, buttony) # clicks the center of where the button was found
|
||||
```
|
||||
The locateCenterOnScreen() function returns the center of this match region:
|
||||
```python
|
||||
>>> import pyautogui
|
||||
>>> buttonx, buttony = pyautogui.locateCenterOnScreen('button.png') # returns (x, y) of matching region
|
||||
>>> buttonx, buttony
|
||||
(1441, 582)
|
||||
>>> pyautogui.click(buttonx, buttony) # clicks the center of where the button was found
|
||||
```
|
||||
|
||||
How Does PyAutoGUI Work?
|
||||
========================
|
||||
|
||||
The three major operating systems (Windows, macOS, and Linux) each have different ways to programmatically control the mouse and keyboard. This can often involve confusing, obscure, and deeply technical details. The job of PyAutoGUI is to hide all of this complexity behind a simple API.
|
||||
|
||||
* On Windows, PyAutoGUI accesses the Windows API (also called the WinAPI or win32 API) through the built-in `ctypes` module. The `nicewin` module at https://github.com/asweigart/nicewin provides a demonstration for how Windows API calls can be made through Python.
|
||||
|
||||
* On macOS, PyAutoGUI uses the `rubicon-objc` module to access the Cocoa API.
|
||||
|
||||
* On Linux, PyAutoGUI uses the `Xlib` module to access the X11 or X Window System.
|
||||
|
||||
|
||||
|
@@ -0,0 +1,20 @@
|
||||
PyAutoGUI-0.9.53.dist-info/AUTHORS.txt,sha256=NtIbFfLKewUtSUbkf1BJPFeSgEyKhMursyuh1w7dhZk,2879
|
||||
PyAutoGUI-0.9.53.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
|
||||
PyAutoGUI-0.9.53.dist-info/LICENSE.txt,sha256=rNMjpKuy_R62UDcXVGvAbRWA3qmJw7EzjRdrp8N8Zl0,1509
|
||||
PyAutoGUI-0.9.53.dist-info/METADATA,sha256=NSzxvHdozixTIr5Zyrqkpse03Yy8ENpyRmiw-QJINVw,7476
|
||||
PyAutoGUI-0.9.53.dist-info/RECORD,,
|
||||
PyAutoGUI-0.9.53.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
||||
PyAutoGUI-0.9.53.dist-info/WHEEL,sha256=ewwEueio1C2XeHTvT17n8dZUJgOvyCWCt0WVNLClP9o,92
|
||||
PyAutoGUI-0.9.53.dist-info/top_level.txt,sha256=YztmWux-iPoF3Dv9x530vZvae0kMBsGbPAoKgWRGAvk,10
|
||||
pyautogui/__init__.py,sha256=wQhwpxKHX1HIcpyqjt4BfwJpzWXUxcLfyT5O86EiePs,80963
|
||||
pyautogui/__main__.py,sha256=P8Ny3OScHrutsXUz-UsqKamaFihW-Yuq0YzKHkRGADI,58
|
||||
pyautogui/__pycache__/__init__.cpython-39.pyc,,
|
||||
pyautogui/__pycache__/__main__.cpython-39.pyc,,
|
||||
pyautogui/__pycache__/_pyautogui_java.cpython-39.pyc,,
|
||||
pyautogui/__pycache__/_pyautogui_osx.cpython-39.pyc,,
|
||||
pyautogui/__pycache__/_pyautogui_win.cpython-39.pyc,,
|
||||
pyautogui/__pycache__/_pyautogui_x11.cpython-39.pyc,,
|
||||
pyautogui/_pyautogui_java.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
||||
pyautogui/_pyautogui_osx.py,sha256=1qRh0eBh9GXPJSKxkpm2-yhoWMFblP4QXi2pjJ-KaTg,15261
|
||||
pyautogui/_pyautogui_win.py,sha256=DGhxh8vAWxcYh2AHN83K2LFJarGSCAx5B_JYeSFUaao,20633
|
||||
pyautogui/_pyautogui_x11.py,sha256=DSyKFpSV5BgWR-8jRAXLXRQwlcv2z3s3Fd9uBmt5yyc,15759
|
@@ -0,0 +1,5 @@
|
||||
Wheel-Version: 1.0
|
||||
Generator: bdist_wheel (0.37.0)
|
||||
Root-Is-Purelib: true
|
||||
Tag: py3-none-any
|
||||
|
@@ -0,0 +1 @@
|
||||
pyautogui
|
Reference in New Issue
Block a user