파이썬 파일입출력 고급 활용 권한과 소유자 유지부터 tarfile 필터까지

📂 shutil.copy2로 권한까지 복사하기

파이썬에서 파일 복사를 할 때 가장 많이 쓰는 함수는 shutil.copy입니다.
하지만 이 함수는 파일의 내용과 경로만 복사하고, 원본의 권한(permission)이나 소유자(owner) 같은 메타데이터는 보존하지 않습니다.
따라서 실행 권한이 필요한 스크립트 파일을 복사할 경우 문제가 생길 수 있죠.

이럴 때 유용한 것이 shutil.copy2입니다.
이 함수는 단순한 복사 기능뿐 아니라, 파일의 권한, 생성·수정 시간, 접근 시간까지 함께 유지합니다.
즉, 원본 파일과 거의 동일한 속성을 가진 복사본을 만들 수 있는 것입니다.

import shutil

# 일반 copy - 권한과 소유자는 유지되지 않음
shutil.copy("script.sh", "backup/script.sh")

# copy2 - 권한과 시간 정보까지 보존
shutil.copy2("script.sh", "backup/script.sh")

위 코드처럼 copy2를 사용하면 원본 파일의 실행 권한이 그대로 복사본에도 남습니다.
따라서 리눅스 환경에서 .sh 스크립트를 자동 배포할 때도 바로 실행이 가능하죠.

🛡️ copystat으로 속성만 유지하기

앞서 소개한 copy2는 파일 복사와 함께 권한 및 시간 정보를 모두 보존합니다.
그런데 경우에 따라서는 파일의 내용은 이미 복사되어 있고, 단순히 권한과 타임스탬프만 맞추고 싶을 때도 있습니다.
이럴 때 사용하는 함수가 shutil.copystat입니다.

이 함수는 파일 내용을 건드리지 않고, 원본 파일의 권한(permission), 마지막 접근/수정 시간 등을 대상 파일에 그대로 복사합니다.
특히 대용량 파일을 다룰 때는 파일 전체를 다시 복사할 필요가 없으므로 효율적입니다.

import shutil

# 먼저 파일 내용을 복사
shutil.copy("data.db", "backup/data.db")

# 그 후 copystat으로 권한과 시간만 동일하게 설정
shutil.copystat("data.db", "backup/data.db")

위 예시는 데이터베이스 파일을 백업할 때 많이 쓰이는 패턴입니다.
내용 복사 후 copystat을 적용하면, 원본과 동일한 권한과 속성을 유지할 수 있습니다.

📦 tarfile 모듈로 권한 보존 압축하기

대량의 파일을 백업하거나 배포할 때는 개별 파일 복사보다는 압축을 활용하는 경우가 많습니다.
파이썬의 tarfile 모듈은 단순히 파일을 묶는 것을 넘어, 권한과 소유자 정보까지 함께 저장하고 해제할 수 있도록 지원합니다.
즉, 리눅스에서 사용하는 tar 명령어와 거의 동일한 수준의 기능을 제공합니다.

특히 소프트웨어를 배포할 때는 실행 권한이 설정된 파일이 많기 때문에, tar 아카이브를 사용하면 권한을 안전하게 보존한 채로 묶어둘 수 있습니다.
압축 해제 시에도 동일한 권한이 유지되므로, 추가 설정이 필요하지 않아 편리합니다.

import tarfile

# tar 아카이브 생성 (권한 포함)
with tarfile.open("backup.tar", "w") as tar:
    tar.add("project_folder", arcname="project_folder")

# tar 아카이브 해제 (권한 유지)
with tarfile.open("backup.tar", "r") as tar:
    tar.extractall()

위 코드 예시에서 보듯이, tar.add()를 이용하면 파일과 폴더가 포함된 전체 디렉터리를 권한 그대로 압축할 수 있습니다.
그리고 extractall()을 사용하면 권한과 소유자 정보가 복원됩니다.

🔧 tarfile filter 활용한 권한 제어

tarfile 모듈은 단순히 파일을 묶고 풀어내는 것에 그치지 않습니다.
파일을 아카이브에 추가할 때 filter 옵션을 활용하면, 압축 과정에서 권한을 직접 수정할 수도 있습니다.
즉, 원본 파일 권한을 그대로 유지하지 않고, 배포 목적에 맞게 조정한 뒤 저장하는 것이 가능합니다.

예를 들어 특정 프로젝트를 배포할 때 모든 파일에 읽기 권한은 유지하되, 실행 권한은 제거하고 싶을 수 있습니다.
이 경우 filter 함수를 정의하여 아카이브에 담기 전에 tarinfo.mode 값을 조정하면 됩니다.

import tarfile

def remove_exec(tarinfo):
    # 실행 권한 제거
    tarinfo.mode &= 0o666
    return tarinfo

with tarfile.open("filtered_backup.tar", "w") as tar:
    tar.add("project_folder", filter=remove_exec)

위 코드에서 remove_exec() 함수는 파일의 실행 권한을 제거한 뒤 아카이브에 저장합니다.
이렇게 하면 배포된 파일은 실행 권한 없이 읽기/쓰기 권한만 유지하게 되죠.

💡 실무에서 자주 쓰는 활용 예제

이제까지 살펴본 copy2, copystat, tarfile filter는 실제 개발 현장에서 다양하게 쓰입니다.
백업, 배포, 로그 관리, 자동화 스크립트 제작 등 여러 상황에서 필수 도구처럼 활용되죠.

📌 서버 환경에서의 백업

운영 서버의 로그 파일이나 설정 파일은 권한이 매우 중요합니다.
copy2를 활용하면 실행 권한을 유지한 채로 로그 백업이 가능하고, tarfile을 사용하면 전체 프로젝트 폴더를 안전하게 묶을 수 있습니다.

• 📂데이터베이스 덤프 파일은 copystat으로 권한 맞추기
• 🛠️배포 스크립트는 copy2로 실행 권한 유지
• 🔧외부 배포용 패키지는 tarfile filter로 실행 권한 제거

📌 협업 환경에서의 배포

여러 개발자가 함께 사용하는 프로젝트에서는 권한이 꼬이지 않도록 관리하는 것이 중요합니다.
예를 들어, 실행 권한이 없는 상태로 파일이 배포되면 테스트 환경에서 에러가 발생할 수 있습니다.
이럴 때 tarfile filter를 사용해 일관된 권한 정책을 적용하면 문제를 예방할 수 있습니다.

💬 실무에서는 단순히 파일을 복사하는 것보다, 권한과 소유자를 관리하는 것이 훨씬 중요합니다. 자동화 스크립트에 이 과정을 포함시키는 습관이 필요합니다.

❓ 자주 묻는 질문 (FAQ)