Python pyperclip 모듈로 클립보드 복사·붙여넣기 완벽 가이드

소개

pyperclip은 파이썬에서 클립보드에 내용을 복사하고 붙여넣을 수 있게 해주는 모듈입니다. 크로스 플랫폼을 지원하며, Python 2와 Python 3 모두에서 사용할 수 있습니다.

클립보드를 활용한 복사와 붙여넣기는 데이터 처리 결과를 다른 파일이나 프로그램으로 옮겨야 할 때 매우 유용합니다. 예를 들어, 스프레드시트나 문서 편집기로 결과값을 손쉽게 전달할 수 있습니다.

설치 방법

pyperclip은 파이썬에 기본 포함되어 있지 않으므로, 먼저 설치해야 합니다. PIP 패키지 관리자를 이용하면 간단하게 설치할 수 있습니다.

터미널(또는 명령 프롬프트)을 열고 아래 명령어를 입력하세요.

pip install pyperclip

설치가 완료되면 파이썬 스크립트에서 해당 모듈을 임포트하여 사용할 수 있습니다.

import pyperclip

클립보드에 텍스트 복사하기

클립보드에 텍스트를 복사하려면 pyperclip.copy() 함수를 사용합니다.

import pyperclip
pyperclip.copy("Hello world!")

위 코드를 실행하면 "Hello world!"라는 문자열이 클립보드에 저장되어, 어디서든 바로 붙여넣기 할 수 있는 상태가 됩니다.

클립보드에서 텍스트 붙여넣기

클립보드에 저장된 최신 내용을 가져오려면 pyperclip.paste() 함수를 사용합니다.

예제

import pyperclip
text = pyperclip.paste()
print(text)

출력 결과

Hello world!

새로운 내용이 복사될 때까지 대기하기

프로젝트 작업 중에는 새로운 메시지를 복사한 후 그 내용을 붙여넣어야 하는 경우가 종종 있습니다. 이럴 때는 pyperclip.waitForNewPaste() 함수를 활용하면 됩니다. 이 함수는 클립보드의 내용이 변경될 때까지 프로그램 실행을 대기시킵니다.

예제

import pyperclip
pyperclip.copy("Hello world!")
text = pyperclip.paste()
print(text)
pyperclip.copy('Hello world!')
text = pyperclip.waitForNewPaste()
print(text)

출력 결과

Hello world! Random message copied

참고: 위 예제에서 프로그램은 새로 복사된 텍스트를 출력한 후 종료됩니다. 단, 새로 복사하는 내용은 기존의 "Hello world!"와 달라야 합니다.

만약 클립보드의 내용이 기존과 동일하더라도 무조건 붙여넣기를 진행하고 싶다면, pyperclip.waitForPaste() 함수를 사용하세요. 이 함수는 클립보드에 어떤 내용이든 존재하기만 하면 즉시 반환됩니다.

또 한 가지 알아두어야 할 점은, 클립보드에 저장되거나 붙여넣어지는 데이터는 항상 문자열(String) 자료형이라는 것입니다. 숫자나 리스트 등 다른 자료형을 다루려면 str() 함수로 변환한 후 사용해야 합니다.

마무리

이제 pyperclip 모듈을 사용하여 텍스트를 클립보드에 복사하고 붙여넣는 방법을 익혔습니다. 이를 활용하면 데이터를 반복적으로 복사·붙여넣어야 하는 표 작성 등의 업무를 자동화하는 간단한 도구를 만들 수 있습니다.

크로스 플랫폼을 지원하기 때문에 Linux, macOS, Windows 환경 어디에서나 동일하게 사용할 수 있다는 점도 큰 장점입니다. 여러분의 자동화 프로젝트에 pyperclip을 적극 활용해 보세요.