실습 5 — 수업 자료 묶음 만들기

import os
import shutil
from pathlib import Path

kit = Path("out_ch20_class_kit")
# 다시 돌려도 지난번 파일이 남지 않게 통째로 지우고 새로 만든다. rmtree = remove tree
shutil.rmtree(kit, ignore_errors=True)
for sub in ["data", "code", "answers"]:
    (kit / sub).mkdir(parents=True)

src = Path("out_ch20_exercise")
if not src.exists():
    raise SystemExit("out_ch20_exercise 가 없습니다. 실습 2를 먼저 실행하세요")
# 문제 그림은 data/ 에, 정답 마스크와 정답표는 answers/ 에 나눠 담는다
for p in sorted(src.iterdir()):
    dest = "answers" if ("mask" in p.name or p.suffix == ".csv") else "data"
    shutil.copy(p, kit / dest / p.name)       # copy: 파일 하나를 복사한다
for sub in ["data", "answers"]:
    print(sub, sorted(x.name for x in (kit / sub).iterdir()))

from importlib.metadata import version

# 수강생이 채울 시작 코드. 빈칸은 ____ 로 둔다
starter = '''import cv2

img = cv2.imread("../data/medium.png", cv2.IMREAD_GRAYSCALE)
if img is None:
    raise SystemExit("그림을 읽지 못했습니다. code 폴더에서 실행했는지 보세요")

# 1단계: 노이즈를 줄인다(6차시)
blur = ____
# 2단계: Otsu 로 이진화한다(8차시)
_, binary = ____
cv2.imwrite("my_answer.png", binary)
'''
(kit / "code" / "step1_threshold.py").write_text(starter, encoding="utf-8")

readme = """# 동전 세기 이진화 실습

## 학습목표
- 노이즈 낀 그림을 흐리게 한 뒤 Otsu 로 이진화해 정답 마스크와의 IoU 0.9 이상을 얻을 수 있다.

## 준비
- Python 3.12 이상, `python -m pip install -r requirements.txt`

## 실행 순서
1. `code` 폴더로 옮긴 뒤 `step1_threshold.py` 의 빈칸(____)을 채워 실행한다.
2. 만든 `my_answer.png` 를 강사에게 내면 채점 결과와 피드백을 받는다.

## 자료와 라이선스
- `data/` 의 그림은 OpenCV 로 그린 가상의 그림이다(씨앗 2001). 실제 사진이 아니다.
- OpenCV 는 Apache 2.0 라이선스를 따른다.
"""
(kit / "README.md").write_text(readme, encoding="utf-8")

pkgs = ["opencv-python", "numpy"]                    # 이 실습이 쓰는 패키지만 적는다
(kit / "requirements.txt").write_text("".join(f"{p}=={version(p)}\n" for p in pkgs), encoding="utf-8")
print((kit / "requirements.txt").read_text(encoding="utf-8"))

import pandas as pd

rows = []
# rglob("*"): 하위 폴더까지 모든 파일과 폴더를 찾는다(recursive glob)
for p in sorted(kit.rglob("*")):
    if p.is_file():
        rows.append({"파일": p.relative_to(kit).as_posix(), "KB": round(p.stat().st_size / 1024, 1)})
files = pd.DataFrame(rows)
print(files.to_string(index=False))
print("파일", len(files), "개, 모두", round(float(files["KB"].sum()), 1), "KB")

checks = {
    "README 가 있다": (kit / "README.md").exists(),
    "requirements.txt 에 버전이 적혀 있다": "==" in (kit / "requirements.txt").read_text(encoding="utf-8"),
    "문제 그림 세 장이 data 에 있다": len(list((kit / "data").glob("*.png"))) == 3,
    "정답 마스크가 data 에 섞이지 않았다": not any("mask" in p.name for p in (kit / "data").iterdir()),
    "README 에 라이선스가 적혀 있다": "라이선스" in readme,
    "README 에 가상 그림이라고 밝혔다": "가상" in readme,
}
for name, ok in checks.items():
    print(f"[{'통과' if ok else '확인'}] {name}")

# make_archive(만들 이름, 형식, 묶을 폴더): 폴더를 ZIP 한 파일로 묶는다. 이름 뒤에 .zip 이 붙는다
zip_path = shutil.make_archive("out_ch20_class_kit", "zip", "out_ch20_class_kit")
print("묶은 파일:", os.path.basename(zip_path), os.path.getsize(zip_path) // 1024, "KB")