Python os 모듈: 파일 및 디렉토리 작업 가이드

import os
 
# 현재 작업 디렉토리 가져오기
cwd = os.getcwd()
print(cwd)  # e.g., /home/user/projects/myapp
 
# 작업 디렉토리 변경
os.chdir('/tmp')
print(os.getcwd())  # /tmp
 
# 원래 디렉토리로 돌아가기
os.chdir(cwd)

import os
 
# 단일 디렉토리 생성
os.mkdir('output')
 
# 존재하지 않는 경우에만 생성
if not os.path.exists('output'):
    os.mkdir('output')

import os
 
# 중첩된 디렉토리를 한 번의 호출로 생성
os.makedirs('data/raw/2026/january', exist_ok=True)
 
# exist_ok 없이는 'data'가 이미 존재하면 FileExistsError 발생
# os.makedirs('data/raw/2026/january')  # 오류 발생 가능

import os
 
# 현재 디렉토리의 모든 항목 나열
entries = os.listdir('.')
print(entries)  # ['main.py', 'data', 'output', 'README.md']
 
# 특정 디렉토리의 내용 나열
data_files = os.listdir('/var/log')
print(data_files)

import os
 
with os.scandir('.') as entries:
    for entry in entries:
        info = entry.stat()
        print(f"{entry.name:30s}  {'DIR' if entry.is_dir() else 'FILE':4s}  {info.st_size} bytes")

import os
import shutil
 
# 빈 디렉토리 삭제
os.rmdir('output')
 
# 디렉토리와 모든 내용 삭제 (주의해서 사용)
shutil.rmtree('data/raw/2026')

import os
 
# 파일 삭제
os.remove('temp_output.csv')
 
# 존재 확인 후 안전한 삭제
filepath = 'temp_output.csv'
if os.path.exists(filepath):
    os.remove(filepath)
    print(f"{filepath} 삭제됨")
else:
    print(f"{filepath}을(를) 찾을 수 없음")

import os
 
# 파일 이름 변경
os.rename('old_report.csv', 'new_report.csv')
 
# 파일을 다른 디렉토리로 이동
os.rename('report.csv', 'archive/report_2026.csv')
 
# 원자적 교체 (모든 플랫폼에서 대상을 덮어씀)
os.replace('new_data.csv', 'data.csv')

import os
from datetime import datetime
 
info = os.stat('data.csv')
print(f"크기: {info.st_size} bytes")
print(f"수정일: {datetime.fromtimestamp(info.st_mtime)}")
print(f"생성일: {datetime.fromtimestamp(info.st_ctime)}")
print(f"권한: {oct(info.st_mode)}")

import os
 
# 올바른 방법: os.path.join이 구분자를 처리
path = os.path.join('data', 'raw', 'sales.csv')
print(path)  # Unix에서 'data/raw/sales.csv', Windows에서 'data\\raw\\sales.csv'
 
# 잘못된 방법: 문자열 연결은 실패할 수 있음
bad_path = 'data' + '/' + 'raw' + '/' + 'sales.csv'  # Windows에서 실패

import os
 
# 경로가 존재하는지 확인 (파일 또는 디렉토리)
print(os.path.exists('/etc/hosts'))      # True (Linux/macOS에서)
 
# 파일인지 구체적으로 확인
print(os.path.isfile('main.py'))         # True
print(os.path.isfile('data'))            # False (디렉토리입니다)
 
# 디렉토리인지 구체적으로 확인
print(os.path.isdir('data'))             # True
print(os.path.isdir('main.py'))          # False

import os
 
filepath = '/home/user/projects/report_final.csv'
 
# 파일 이름 가져오기
print(os.path.basename(filepath))    # 'report_final.csv'
 
# 디렉토리 가져오기
print(os.path.dirname(filepath))     # '/home/user/projects'
 
# 디렉토리와 파일 이름으로 분할
directory, filename = os.path.split(filepath)
print(directory)   # '/home/user/projects'
print(filename)    # 'report_final.csv'
 
# 파일 이름과 확장자 분할
name, ext = os.path.splitext(filepath)
print(name)  # '/home/user/projects/report_final'
print(ext)   # '.csv'
 
# 상대 경로에서 절대 경로 가져오기
print(os.path.abspath('data.csv'))   # '/home/user/projects/data.csv'
 
# 사용자 홈 디렉토리 확인
print(os.path.expanduser('~/Documents'))  # '/home/user/Documents'

import os
 
# 환경 변수 읽기 (설정되지 않으면 None 반환)
db_host = os.getenv('DATABASE_HOST')
print(db_host)
 
# 기본값으로 읽기
db_port = os.getenv('DATABASE_PORT', '5432')
print(db_port)  # DATABASE_PORT가 설정되지 않으면 '5432'
 
# os.environ 딕셔너리로 접근 (없으면 KeyError 발생)
try:
    secret = os.environ['API_SECRET']
except KeyError:
    print("API_SECRET이 설정되지 않음")
 
# 환경 변수 설정 (자식 프로세스용)
os.environ['APP_MODE'] = 'production'
 
# 모든 환경 변수 나열
for key, value in os.environ.items():
    print(f"{key}={value}")

import os
 
# 프로젝트 디렉토리 순회
for dirpath, dirnames, filenames in os.walk('/home/user/project'):
    # 숨겨진 디렉토리 건너뛰기
    dirnames[:] = [d for d in dirnames if not d.startswith('.')]
 
    print(f"\n디렉토리: {dirpath}")
    print(f"  하위 디렉토리: {dirnames}")
    print(f"  파일: {filenames}")

import os
 
def get_directory_size(path):
    total = 0
    for dirpath, dirnames, filenames in os.walk(path):
        for filename in filenames:
            filepath = os.path.join(dirpath, filename)
            # 심볼릭 링크 건너뛰기
            if not os.path.islink(filepath):
                total += os.path.getsize(filepath)
    return total
 
size_bytes = get_directory_size('/home/user/project')
size_mb = size_bytes / (1024 * 1024)
print(f"전체 크기: {size_mb:.2f} MB")

import os
 
def find_files(directory, extension):
    """주어진 확장자를 가진 모든 파일을 재귀적으로 찾기."""
    matches = []
    for dirpath, dirnames, filenames in os.walk(directory):
        for filename in filenames:
            if filename.endswith(extension):
                matches.append(os.path.join(dirpath, filename))
    return matches
 
# 모든 Python 파일 찾기
python_files = find_files('/home/user/project', '.py')
for f in python_files:
    print(f)
 
# 모든 CSV 데이터 파일 찾기
csv_files = find_files('data', '.csv')
print(f"CSV 파일 {len(csv_files)}개 발견")

import os
 
def setup_project_dirs(base_path):
    """표준 프로젝트 디렉토리 구조 생성."""
    dirs = [
        'data/raw',
        'data/processed',
        'data/output',
        'logs',
        'config',
        'reports/figures',
    ]
    for d in dirs:
        full_path = os.path.join(base_path, d)
        os.makedirs(full_path, exist_ok=True)
        print(f"생성됨: {full_path}")
 
setup_project_dirs('my_project')

import os
import tempfile
 
# 자동 삭제되는 임시 파일 생성
with tempfile.NamedTemporaryFile(mode='w', suffix='.csv', delete=False) as tmp:
    tmp.write('col1,col2\n1,2\n3,4\n')
    tmp_path = tmp.name
 
print(f"임시 파일: {tmp_path}")
print(f"존재: {os.path.exists(tmp_path)}")
 
# 정리
os.remove(tmp_path)

# os.path 방식
import os
config_path = os.path.join(os.path.expanduser('~'), '.config', 'myapp', 'settings.json')
if os.path.isfile(config_path):
    with open(config_path) as f:
        data = f.read()
 
# pathlib 방식
from pathlib import Path
config_path = Path.home() / '.config' / 'myapp' / 'settings.json'
if config_path.is_file():
    data = config_path.read_text()

import os
 
# os.sep은 플랫폼 경로 구분자
print(os.sep)       # Unix에서 '/', Windows에서 '\\'
 
# os.linesep은 플랫폼 줄 끝 문자
print(repr(os.linesep))  # Unix에서 '\n', Windows에서 '\r\n'
 
# os.name은 OS 계열을 식별
print(os.name)      # Linux/macOS에서 'posix', Windows에서 'nt'
 
# os.path.join은 구분자를 자동으로 처리
path = os.path.join('data', 'output', 'results.csv')
# Unix에서 'data/output/results.csv'
# Windows에서 'data\\output\\results.csv'