Python 파일 복사 완벽 가이드｜shutil 모듈 사용법과 예외 처리

1. 들어가며

2. Python에서 파일을 복사하기 위한 준비

shutil 모듈 임포트

import shutil

shutil 모듈의 장점

3. shutil 모듈의 기본적인 사용 방법

shutil.copy()의 사용법

import shutil

# 파일 복사
shutil.copy('original.txt', 'copy.txt')

shutil.copy2()의 사용법

import shutil

# 파일 내용과 메타데이터를 복사
shutil.copy2('original.txt', 'copy_with_metadata.txt')

4. 디렉터리 전체를 복사하는 방법

shutil.copytree()의 사용 방법

import shutil

# 디렉터리 복사
shutil.copytree('source_directory', 'destination_directory')

복사 시 무시할 파일이나 디렉터리 지정

import shutil

# .log 파일을 무시하고 복사
shutil.copytree('source_directory', 'destination_directory', ignore=shutil.ignore_patterns('*.log'))

5. 덮어쓰기를 방지하는 방법

os.path.exists()를 사용하기

import shutil
import os

# 덮어쓰기를 방지하기 위한 파일 존재 확인
if not os.path.exists('copy.txt'):
    shutil.copy('original.txt', 'copy.txt')
else:
    print('파일은 이미 존재합니다. 복사를 건너뜁니다.')

pathlib.Path.exists()를 사용하기

from pathlib import Path

# Path 객체로 존재 여부 확인
dst = Path('copy.txt')

if not dst.exists():
    shutil.copy('original.txt', dst)
else:
    print('파일은 이미 존재합니다. 복사를 건너뜁니다.')

6. Python에서 파일을 이동하는 방법

shutil.move()의 사용법

import shutil

# 파일 이동
shutil.move('original.txt', 'new_folder/original.txt')

import shutil
import os

# 디렉터리 존재 확인 및 생성
if not os.path.exists('new_folder'):
    os.makedirs('new_folder')

# 파일 이동
shutil.move('original.txt', 'new_folder/original.txt')

7. Python에서 파일 복사 예제 코드

파일을 복사하는 예제

import shutil

# 파일 복사
shutil.copy('data.txt', 'backup/data_backup.txt')

디렉터리 전체를 복사하는 예제

import shutil

# 디렉터리 복사
shutil.copytree('project_files', 'project_backup')

덮어쓰기를 방지하기 위한 예제

import shutil
import os

# 덮어쓰지 않도록 복사
if not os.path.exists('backup/report.txt'):
    shutil.copy('report.txt', 'backup/report.txt')
else:
    print('파일이 이미 존재합니다. 복사를 중지합니다.')

8. 응용편: 특정 파일 형식만 복사하는 방법

import shutil
import glob

# .txt 파일을 모두 복사
for file in glob.glob('data/*.txt'):
    shutil.copy(file, 'backup/')

9. 오류 처리와 예외 처리

기본적인 예외 처리 추가

import shutil

try:
    shutil.copy('non_existent_file.txt', 'backup/')
except FileNotFoundError as e:
    print(f'파일을 찾을 수 없습니다: {e}')
except PermissionError as e:
    print(f'권한 오류가 발생했습니다: {e}')
except Exception as e:
    print(f'예기치 않은 오류가 발생했습니다: {e}')

10. 정리