14주차 2교시: 코드 구조와 검증 기준 세우기

코드가 작동한다는 말을 검사 가능한 증거로 바꾸기

• 0-7분공통 경로

  서로 다른 프로젝트에 공통인 데이터 흐름을 비교합니다.

• 7-17분여덟 STEP

  한 셀이 한 질문에 답하도록 구조를 나눕니다.

• 17-27분검증 문장

  수치·관계·파일 검사를 초보자의 언어로 읽습니다.

• 27-35분출처와 권한

  입력의 이용 조건과 개인정보 위험을 확인합니다.

• 35-41분진단·신청자 면담

  실패 사례를 읽고 자기 자료·재사용 신청자부터 면담합니다.

• 41-50분경로 확정

  신청자는 판정을, 나머지 학생은 제공 경로 선택을 기록합니다.

• 50-60분선택 확장

  프로젝트 전용 검사 한 개를 추가 설계합니다.

0-7분 · 서로 다른 프로젝트에서 같은 제작 경로 찾기

데이터 프로젝트는 CSV를 읽고, 텍스트 프로젝트는 TXT를 읽고, 사운드 프로젝트는 WAV를 읽으며, 규칙 기반 이미지는 위치·크기·색 매개변수나 이전 생성 코드를 읽습니다. 지도 프로젝트는 이번 주에 category와 value 표를 데이터 경로로 집계해 정적인 수량 증거를 먼저 저장합니다. 위도·경도와 Folium 지도 연결은 이 경로가 안정된 뒤 15주차에 다시 연결합니다. 복합 프로젝트는 질문을 결정하는 주 입력 하나에서 시작합니다. 사용하는 함수는 다르지만 프로젝트의 중심 질문은 같습니다. 무엇을 입력했고, 원본을 어떻게 보존했으며, 어떤 규칙으로 값을 만들고, 그 값을 어떻게 보여 주고, 무엇으로 저장했는가?

원본 크기로 보기 ↗

7-17분 · 노트북을 STEP 0부터 STEP 7까지 나누기

초보자가 긴 노트북에서 가장 자주 겪는 문제는 어느 셀을 수정해야 하는지 알 수 없다는 점입니다. 3교시 노트북은 아래 여덟 STEP으로 나뉩니다. 각 STEP은 하나의 질문에만 답하고, 정상이라면 다음 STEP이 사용할 변수나 판단 문장을 남깁니다.

# 한 셀은 한 질문에 답합니다.
raw_data = pd.read_csv(source_path)       # 입력이 열리는가?
work_data = raw_data.copy(deep=True)      # 원본을 보존했는가?
processed = work_data.groupby("category")["value"].sum()
assert len(processed) > 0                 # 처리 결과가 존재하는가?

셀을 나누는 목적은 코드를 길게 꾸미는 것이 아니라 오류 위치를 좁히는 것입니다. STEP 2가 실패하면 그래프 색상을 고치지 않고 입력 파일과 열 이름을 봅니다. STEP 6이 실패하면 처리 규칙을 다시 쓰기 전에 파일명과 저장 경로를 봅니다.

새 기능을 배우기보다 이미 작동한 경로를 재사용하기

14주차는 새로운 라이브러리를 많이 배우는 주차가 아닙니다. 자신의 경로와 가장 가까운 이전 결과에서 작은 코드 묶음을 가져옵니다. 복사한 뒤에는 변수 이름과 입력 구조가 현재 프로젝트와 일치하는지 한 줄씩 확인합니다.

17-27분 · “정상 작동”을 검증 문장으로 바꾸기

assert는 뒤의 조건이 참인지 확인합니다. 참이면 조용히 다음 줄로 진행하고, 거짓이면 오류 메시지와 함께 멈춥니다. 초보자에게 중요한 것은 문법을 외우는 일이 아니라 무엇이 참이어야 다음 단계로 넘어갈 수 있는가를 말로 먼저 쓰는 일입니다.

assert len(raw_data) > 0, "입력 행이 없습니다."
assert {"category", "value"}.issubset(raw_data.columns), (
    "CSV에는 category와 value 열이 필요합니다."
)
assert np.isfinite(processed_values).all(), (
    "처리 결과에 숫자가 아닌 값이 있습니다."
)
assert output_path.is_file(), "결과 파일을 찾을 수 없습니다."

좋은 오류 메시지는 “실패”라고만 말하지 않습니다. 무엇을 기대했고 어디를 확인해야 하는지 알려 줍니다. “CSV에는 category와 value 열이 필요합니다”라는 문장은 학생이 파일의 헤더를 보도록 안내합니다.

경로별로 남겨야 할 최소 증거

27-35분 · 출처, 이용 권한, 개인정보를 코드보다 먼저 확인하기

파일을 기술적으로 열 수 있다는 사실은 사용할 권한이 있다는 뜻이 아닙니다. 입력 셀 가까이에 자료의 제목, 작성자 또는 제공자, 원본 주소, 이용 조건, 수집 또는 제작 시점, 개인정보 제거 여부를 기록합니다. 제출 파일에는 노트북을 다시 실행하는 데 필요한 입력만 포함합니다.

35-41분 · 열리지만 틀린 프로토타입 세 가지 진단하며 면담 시작하기

프로토타입의 오류는 빨간 오류 메시지로만 나타나지 않습니다. 화면이 보이고 파일이 열려도 이전 데이터, 잘못된 실행 순서, 빠진 설명 때문에 증거가 성립하지 않을 수 있습니다.

35-50분 · 자기 자료·코드 재사용 신청자만 60-90초 면담하기

모든 학생이 두 번 줄을 서지 않도록 1차 면담은 자기 자료를 쓰거나 이전 코드를 바꿔 넣으려는 신청자에게만 진행합니다. 프로젝트 카드와 실제 입력을 보여 주며 아래 다섯 문장만 순서대로 설명합니다. 교수는 입력에 대해 approval_status와 approval_note, 코드에 대해 reuse_status와 reuse_note를 따로 정합니다. 제공 입력을 그대로 쓰면 provided, 공통 코드를 유지하면 guided를 기록하며, 둘 중 하나만 승인받는 조합도 가능합니다.

1. 질문: “나는 ___이 어떻게 다른지/변하는지 묻습니다.”
2. 입력과 권한: “___ 자료를 사용하며, 이용 근거는 ___입니다.”
3. 처리: “입력에서 ___을 계산하거나 변환합니다.”
4. 표현과 출력: “그 값을 ___에 연결해 ___ 파일로 저장합니다.”
5. 제외와 위험: “이번 주에는 ___을 하지 않으며, 막히면 ___로 전환합니다.”

2교시 15분 안에 확인할 수 있는 신청자는 최대 10-15명입니다. 신청자가 더 많으면 남은 학생은 기다리지 않습니다. 승인받지 못한 자기 입력은 provided로, 승인받지 못한 재사용 코드는 guided로 각각 전환하고, 보류된 연결은 15주차 첫 행동으로 기록합니다. 3교시에는 전원이 자동 증거를 준비한 뒤 30-45초 최종 확인 한 번만 받습니다. 30명이어도 최종 확인은 최대 22.5분이므로, 완성한 학생이 두 번째 긴 면담 대기열 때문에 귀가하지 못하는 상황을 피할 수 있습니다.

50-60분 · 선택 확장: 프로젝트 전용 검사 한 개 설계하기

공통 검사에 더해 자신의 질문에만 필요한 검사를 하나 설계합니다. 먼저 자연어로 조건을 쓰고, 그다음 assert 문장으로 바꿉니다. 아직 구현하지 못해도 검사할 변수와 기대 관계가 분명하면 됩니다.

수업 후 개별 복습

1. 프로젝트 노트북의 여덟 STEP과 각 STEP이 답하는 질문을 적습니다.
2. 입력 검증, 처리 검증, 표현 검증, 출력 검증의 예를 하나씩 씁니다.
3. 자동 검사와 교수 확인이 각각 담당하는 일을 두 가지씩 적습니다.
4. 이전 주차 코드를 복사한 뒤 반드시 바꿔야 하는 네 항목을 적습니다.
5. 자료의 출처 기록과 이용 허가가 서로 다른 이유를 설명합니다.
6. 자신의 면담 판정과 3교시 첫 행동을 한 문장으로 씁니다.

공식 문서

• Python 공식 문서 : assert 문조건이 참인지 확인하고 거짓일 때 AssertionError를 발생시키는 문법의 공식 설명
• pandas 공식 문서 : DataFrame.copy원본과 작업용 DataFrame을 구분할 때 사용하는 복사 메서드
• Matplotlib 공식 문서 : savefigFigure를 파일로 저장할 때 파일명, 형식, DPI를 지정하는 방법
• Python 공식 문서 : Path.is_file출력 경로가 실제 일반 파일인지 확인하는 표준 라이브러리 메서드