어지러운 폴더를 규칙대로 종류, 날짜, 이름별 하위 폴더로 정리하는 Python 스크립트

실행 방법

python merge_sales.py --month 2026-10

2026-11-02 09:14:03 INFO  폴더: sales/2026-10, 파일 9개 발견
2026-11-02 09:14:03 INFO  shop-01.csv: 1,284행
2026-11-02 09:14:04 INFO  shop-02.xlsx: 967행
2026-11-02 09:14:04 WARN  shop-07.csv: 가격 없는 3행 건너뜀 (88, 412, 913번 줄)
2026-11-02 09:14:05 INFO  완료: 10,412행 -> report-2026-10.xlsx ("매출", "합계" 시트)

코드가 아닌 설정으로

매장별 열 이름은 settings.ini에 있어서, 매장이 새로 생기거나 열 이름이 바뀌면 그곳에 한 줄만 고치면 됩니다.

[columns]
date = 날짜, 판매일, 일자
product = 상품, 품목, 상품명
quantity = 수량, 개수, 판매 수량
price = 가격, 단가

코드 일부

def read_shop_file(path: Path, columns: dict[str, list[str]]) -> pd.DataFrame:
    """매장 파일 하나를 읽고 열 이름을 보고서 기준으로 바꿉니다."""
    table = pd.read_excel(path) if path.suffix == ".xlsx" else pd.read_csv(path, encoding="utf-8-sig")
    renamed = {}
    for name, variants in columns.items():
        found = next((c for c in table.columns if c.strip() in variants), None)
        if found is None:
            raise ReportError(f"{path.name}: '{name}'에 해당하는 열이 없습니다 (찾은 이름: {', '.join(variants)})")
        renamed[found] = name
    table = table.rename(columns=renamed)[list(columns)]
    table["shop"] = path.stem
    return table

파일: merge_sales.py(310줄), settings.ini, requirements.txt, 그리고 Python 설치, 스크립트 실행, 로그 메시지별 의미를 설명한 README가 들어 있는 ZIP 압축 파일. 고객이 자신의 컴퓨터에서 직접 실행합니다.