PyAutoGUI: 파이썬으로 데스크탑 자동화 마스터하기

# PyAutoGUI 설치 방법
pip install pyautogui

import pyautogui

# 현재 화면의 해상도 확인
screen_size = pyautogui.size()
print(screen_size)  # 예: Size(width=1920, height=1080)

# 절대 좌표로 마우스 이동 (x=700, y=200 위치로)
pyautogui.moveTo(700, 200)

# 시간 지정하여 천천히 이동 (1.5초 동안)
pyautogui.moveTo(100, 500, duration=1.5)

# 상대 좌표로 마우스 이동 (현재 위치에서 x+100, y+100)
pyautogui.move(100, 100, duration=0.5)

# 마우스 클릭하기
pyautogui.click()  # 현재 위치에서 클릭
pyautogui.click(x=100, y=200)  # 특정 위치 클릭
pyautogui.click(clicks=2)  # 더블 클릭 (또는 doubleClick() 사용)

# 마우스 우클릭과 휠클릭
pyautogui.rightClick()
pyautogui.middleClick()

# 드래그 기능 - 파일이나 객체 이동에 활용
pyautogui.dragTo(300, 400, duration=0.5)  # 절대 좌표로 드래그
pyautogui.drag(100, 0, duration=0.25)  # 현재 위치에서 상대적으로 드래그

# 스크롤 기능
pyautogui.scroll(500)  # 위로 스크롤
pyautogui.scroll(-300)  # 아래로 스크롤

# 현재 화면 스크린샷 저장
screenshot = pyautogui.screenshot()
screenshot.save('./my_screenshot.png')

# 특정 위치의 픽셀 색상 확인
pixel_color = pyautogui.pixel(100, 200)
print(pixel_color)  # RGB 값 출력, 예: (255, 255, 255)

# 특정 위치가 예상 색상과 일치하는지 확인
is_white = pyautogui.pixelMatchesColor(100, 200, (255, 255, 255))
print(is_white)  # True 또는 False

# 화면에서 특정 이미지 찾기
button_location = pyautogui.locateOnScreen('./save_button.png')
print(button_location)  # 좌표와 크기 출력: Box(left=x, top=y, width=w, height=h)

# 찾은 이미지 위치 클릭
pyautogui.click(button_location)

# 여러 개의 동일한 이미지 모두 찾기 (예: 체크박스)
checkboxes = list(pyautogui.locateAllOnScreen('./checkbox.png'))
for checkbox in checkboxes:
    pyautogui.click(checkbox)

pyautogui.locateOnScreen('./button.png', grayscale=True)

pyautogui.locateOnScreen('./button.png', region=(x, y, width, height))

# opencv-python 모듈 필요: pip install opencv-python
pyautogui.locateOnScreen('./button.png', confidence=0.8)  # 80% 일치해도 인식

# 텍스트 입력하기 (영문, 숫자만 가능)
pyautogui.write('Hello World!')
pyautogui.write('User123', interval=0.25)  # 입력 속도 조절 (타이핑 간격 0.25초)

# 특수 키 사용하기
pyautogui.press('enter')  # 엔터 키 누르기
pyautogui.press(['left', 'left', 'right'])  # 여러 키 순차적으로 누르기

# 키 조합 사용하기 (단축키)
pyautogui.hotkey('ctrl', 'c')  # Ctrl+C (복사)
pyautogui.hotkey('ctrl', 'v')  # Ctrl+V (붙여넣기)
pyautogui.hotkey('alt', 'tab')  # Alt+Tab (창 전환)

import pyperclip

# 클립보드를 활용한 한글 입력 함수
def type_korean(text):
    pyperclip.copy(text)  # 텍스트를 클립보드에 복사
    pyautogui.hotkey('ctrl', 'v')  # 붙여넣기

# 함수 사용 예시
type_korean("안녕하세요! 파이썬 자동화입니다.")

# 제목으로 윈도우 찾기
notepad_windows = pyautogui.getWindowsWithTitle('메모장')
if notepad_windows:
    notepad = notepad_windows[0]
    
    # 창 활성화
    notepad.activate()
    
    # 창 크기 조절
    notepad.maximize()  # 최대화
    pyautogui.sleep(1)
    notepad.minimize()  # 최소화
    pyautogui.sleep(1)
    notepad.restore()   # 원래 크기로 복원

import time

# 이미지가 나타날 때까지 대기하는 함수
def wait_for_image(image_path, timeout=30):
    start_time = time.time()
    target = None
    
    while target is None:
        target = pyautogui.locateOnScreen(image_path)
        if time.time() - start_time > timeout:
            print(f"타임아웃: {timeout}초 동안 {image_path} 이미지를 찾지 못했습니다.")
            break
        time.sleep(0.5)  # CPU 부하 감소를 위한 짧은 대기
    
    return target

# 함수 사용 예시
login_button = wait_for_image('./login_button.png', timeout=10)
if login_button:
    pyautogui.click(login_button)

import logging
from datetime import datetime

# 로그 설정
log_filename = datetime.now().strftime('automation_%Y-%m-%d_%H%M%S.log')
logging.basicConfig(
    level=logging.INFO,
    format='%(asctime)s [%(levelname)s] %(message)s',
    handlers=[
        logging.FileHandler(log_filename, encoding='utf-8'),
        logging.StreamHandler()  # 콘솔에도 출력
    ]
)

# 로그 사용 예시
logging.info("자동화 스크립트 시작")
try:
    button = pyautogui.locateOnScreen('./submit_button.png')
    if button:
        logging.info("제출 버튼을 찾았습니다. 클릭합니다.")
        pyautogui.click(button)
    else:
        logging.warning("제출 버튼을 찾지 못했습니다.")
except Exception as e:
    logging.error(f"오류 발생: {str(e)}")

logging.info("자동화 스크립트 종료")

pyautogui.FAILSAFE = True  # 기본값은 True

pyautogui.PAUSE = 0.5  # 모든 PyAutoGUI 함수 사이에 0.5초 대기