수업 자료 묶기와 공유

이사할 때 상자마다 "주방 - 그릇", "욕실 - 수건"처럼 적어 두면 새집에서 바로 찾습니다. 상자 맨 위에 "깨지기 쉬움, 이쪽이 위"라는 안내문을 붙이면 옮기는 사람도 실수하지 않습니다. 수강생에게 나눠 줄 자료도 칸을 나눠 담고, 맨 위에 안내 파일을 둡니다.

그림의 네 상자가 수업 자료 묶음의 칸입니다. 여기서 이삿짐 상자가 폴더이고, 상자 위의 안내문이 README.md 입니다. 아래 띠의 requirements.txt 는 "이 짐을 풀려면 드라이버와 망치가 필요합니다"라는 쪽지와 같습니다. 비유와 다른 점도 있습니다. 이삿짐은 한 번 옮기면 끝이지만, 수업 자료는 수강생 서른 명이 저마다의 PC 에서 같은 결과를 얻어야 합니다. 그래서 버전과 씨앗을 함께 적습니다.

묶음의 짜임

라이선스와 출처 표기

결과를 공유하는 법

짧은 예시

지금 PC 에 깔린 패키지 버전을 읽어 requirements.txt 에 들어갈 줄을 만듭니다. 파일로 쓰는 것은 실습 5에서 합니다.

from importlib.metadata import version   # metadata: 설치된 패키지의 이름·버전 정보

for pkg in ["opencv-python", "numpy", "matplotlib", "pandas"]:
    # == 은 "꼭 이 버전"이라는 뜻이다. >= 로 쓰면 "이 버전 이상"이다
    print(f"{pkg}=={version(pkg)}")

나눠 주기 전 확인 목록

• 새 가상환경에서 requirements.txt 로 설치한 뒤 실습 코드가 처음부터 끝까지 돌아간다
• 연습 그림을 만드는 코드의 씨앗이 고정돼 있다
• 정답 파일은 수강생 묶음에서 뺐거나 따로 나눌 때를 정했다
• README 에 실행 순서와 작업 폴더가 적혀 있다
• 쓴 라이브러리와 데이터의 라이선스, 출처를 적었다
• 사람 얼굴, 차량 번호, 실제 상호가 찍힌 그림이 없다

주의할 점

• 가상환경 폴더(.venv)는 묶음에 넣지 않습니다. 수강생 PC 에서 requirements.txt 로 새로 만듭니다(1장).
• 버전을 적지 않으면 몇 달 뒤 새 판이 나와 함수 이름이 바뀌었을 때 실습이 깨집니다. 수업에서 확인한 버전을 적어 둡니다.