코드 묶음에 이름 붙이기

코드 줄의 묶음에 이름을 붙이고 필요할 때 실행하기

형식

기본 50분 / 확장 60분 · + 10 MIN EXTENSION

핵심

def, 함수 이름, 괄호, 콜론, 들여쓰기

연결

여러 줄의 절차 → 이름이 있는 작업 단위

• 0-6 min5주차 코드 회상

  생성 포스터 코드에서 한 번의 작업으로 묶을 범위를 찾습니다.

• 6-15 min이미 사용한 함수

  함수 이름, 괄호 안 입력, 실행 결과를 익숙한 코드에서 다시 읽습니다.

• 15-27 min함수 정의 문법

  def, 이름, 괄호, 콜론, 들여쓴 본문을 한 줄씩 해석합니다.

• 27-37 min정의와 호출

  위에서 아래로 실행 순서를 추적하고 본문이 실행되는 시점을 확인합니다.

• 37-45 minPillow 함수

  고정된 도형 묶음을 함수로 만들고 여러 번 호출해 한계를 찾습니다.

• 45-50 min오류 진단

  대표 오류를 수정하고 2교시의 매개변수가 필요한 이유를 정리합니다.

0-6분 · 5주차 코드는 한 장을 만들지만 아직 다시 쓰기 어렵다

5주차에는 반복문 안에서 크기, 위치, 색상을 선택하고 조건에 따라 세 가지 도형을 그렸습니다. 시드와 설정값을 바꾸면 새로운 결과를 만들 수 있었지만, 이미지를 만드는 전체 과정에는 아직 하나의 이름이 없었습니다.

from PIL import Image, ImageDraw
from IPython.display import display
import random

canvas_width = 600
canvas_height = 600
seed_number = 73
shape_count = 56
min_size = 20
max_size = 80
margin = 40
medium_threshold = 42
large_threshold = 64
background_color = (235, 241, 250)
primary_color = (48, 112, 166)
secondary_color = (92, 150, 118)
accent_color = (230, 83, 72)
outline_color = (35, 42, 55)
palette = [primary_color, secondary_color, accent_color]

image = Image.new(
    "RGB",
    (canvas_width, canvas_height),
    background_color,
)
draw = ImageDraw.Draw(image)
random.seed(seed_number)

for shape_number in range(shape_count):
    size = random.randint(min_size, max_size)
    x = random.randint(margin, canvas_width - margin - size)
    y = random.randint(margin, canvas_height - margin - size)
    base_color = random.choice(palette)

    if size >= large_threshold:
        draw.rectangle(
            (x, y, x + size, y + size),
            fill=accent_color,
            outline=outline_color,
            width=3,
        )
    elif size >= medium_threshold:
        draw.ellipse(
            (x, y, x + size, y + size),
            fill=base_color,
        )
    else:
        draw.ellipse(
            (x, y, x + size, y + size),
            fill=background_color,
            outline=base_color,
            width=4,
        )

display(image)

이 코드는 잘못된 코드가 아닙니다. 다만 새로운 포스터를 세 장 만들려면 설정값을 바꾸고 같은 셀을 여러 번 실행해야 하며, 다른 노트북에서 사용하려면 관련 코드를 다시 찾아 옮겨야 합니다. 6주차의 함수는 이미 작동하는 코드를 버리는 문법이 아니라, 작동하는 코드의 시작과 끝을 정하고 그 작업에 이름을 붙이는 구조입니다.

6-15분 · 우리는 이미 여러 함수를 사용했다

함수라는 이름이 새로울 뿐, 함수 호출은 2주차부터 계속 사용했습니다. print("안녕하세요")에서 print는 함수의 이름이고, 괄호 안의 문자열은 함수가 사용할 입력이며, 화면에 글자를 표시하는 것이 함수의 동작입니다.

random.randint()와 image.save()처럼 이름 앞에 점이 붙는 구조도 있습니다. 전자는 random 모듈 안의 함수이고 후자는 이미지 객체가 가진 메서드입니다. 이번 시간에는 이 분류를 외우지 않습니다. 이름 뒤의 괄호를 만나면 정해진 작업을 호출한다는 공통 구조만 정확히 읽습니다.

15-27분 · def는 새로운 작업의 정의를 시작한다

Python에서 자신만의 함수를 만들 때에는 def로 정의를 시작합니다. 다음 함수는 생성 규칙 한 문장을 출력하는 작은 작업입니다.

def announce_rule():
    message = "크기는 무작위로 선택하고 큰 값은 사각형으로 표현한다."
    print(message)

announce_rule()

함수의 본문에는 한 줄만 들어갈 수도 있고 여러 줄이 들어갈 수도 있습니다. 중요한 것은 줄 수가 아니라 한 이름으로 부를 만한 하나의 책임을 갖는지입니다. 배경 만들기, 도형 하나 그리기, 포스터 한 장 만들기처럼 결과를 행동으로 설명할 수 있으면 함수 이름도 자연스럽게 정할 수 있습니다.

함수 이름은 수행할 행동을 먼저 말한다

• 영문 소문자로 시작하고 여러 단어는 밑줄로 연결합니다.
• 함수가 하는 일을 나타내는 동사를 앞에 둡니다: draw, create, save, show.
• Python 키워드인 if, for, def, return은 이름으로 사용하지 않습니다.
• print, list, range처럼 이미 사용하는 이름을 새 함수 이름으로 덮어쓰지 않습니다.

들여쓰기는 함수에 포함되는 코드의 경계다

def show_start_message():
    print("이미지 생성을 시작합니다.")
    print("설정값을 확인했습니다.")

print("함수 정의가 끝났습니다.")
show_start_message()

앞의 두 print()는 네 칸 들여썼으므로 함수 본문입니다. 세 번째 print()는 왼쪽 끝으로 돌아왔으므로 함수 밖의 코드입니다. 빈 줄은 읽기 쉽게 나눈 것이며 함수의 경계를 결정하지 않습니다. 경계는 들여쓰기 깊이로 결정됩니다.

27-37분 · 정의는 준비이고 호출은 실행이다

def 문장을 실행하면 Python은 함수 이름과 본문을 기억합니다. 그러나 본문 안의 출력이나 도형 그리기를 바로 실행하지는 않습니다. 프로그램이 함수 호출을 만날 때에만 본문으로 이동합니다.

print("1. 프로그램 시작")

def show_generation_step():
    print("3. 함수 본문 실행")

print("2. 함수 정의 완료")
show_generation_step()
print("4. 프로그램 종료")

코드에서 함수 본문이 “2. 함수 정의 완료”보다 위에 적혀 있어도 출력 순서는 3번입니다. Python은 정의 줄에서 본문을 기억한 뒤 건너뛰고, 아래의 호출을 만났을 때 본문으로 돌아갑니다. 본문이 끝나면 호출 다음 줄로 복귀합니다.

def show_color():
    print("coral")

print("start")
show_color()
show_color()
print("end")

Colab에서는 정의 셀을 먼저 실행해야 한다

Colab은 화면의 셀 위치가 아니라 실제 실행한 순서를 기억합니다. 함수 호출 셀을 먼저 실행하면 Python은 아직 그 함수 이름을 알지 못해 NameError를 표시합니다. 위쪽 정의 셀을 먼저 실행한 뒤 아래쪽 호출 셀을 실행해야 합니다.

37-45분 · 고정된 도형 묶음을 함수로 만들기

이제 Pillow 도형 세 개를 하나의 고정 모티프로 묶습니다. 다음 코드는 그대로 실행할 수 있는 완전한 예제입니다.

from PIL import Image, ImageDraw
from IPython.display import display

image = Image.new("RGB", (600, 400), (245, 240, 228))
draw = ImageDraw.Draw(image)

def draw_fixed_motif():
    draw.rectangle(
        (80, 90, 260, 270),
        fill=(230, 83, 72),
        outline=(35, 42, 55),
        width=4,
    )
    draw.ellipse(
        (210, 120, 390, 300),
        fill=(48, 112, 166),
    )
    draw.line(
        (70, 330, 530, 330),
        fill=(35, 42, 55),
        width=8,
    )

draw_fixed_motif()
display(image)

함수의 이름만 보아도 “고정된 모티프를 그리는 작업”임을 알 수 있습니다. 호출문에서는 사각형, 타원, 선의 좌표와 색을 다시 적지 않습니다. 함수 내부의 구체적인 절차를 하나의 이름 뒤에 숨겼기 때문입니다.

draw_fixed_motif()를 두 번 호출해도 두 번째 모티프는 첫 번째와 정확히 같은 위치에 그려집니다. 두 모티프가 포개지므로 화면에서는 하나처럼 보입니다. 함수는 재사용을 가능하게 했지만, 아직 호출할 때 위치·크기·색을 바꾸는 방법은 없습니다. 이 한계가 2교시에서 매개변수가 필요한 이유입니다.

45-50분 · 대표 오류를 마지막 줄부터 읽기

수업 후 개별 복습

• 당일 3분: 노트를 보지 않고 def, 함수 이름, 괄호, 콜론, 들여쓴 본문, 호출 순서를 적습니다.
• 다음 날 5분: 출력 함수 하나를 정의하고 두 번 호출한 뒤 실행 전 예상 출력과 비교합니다.
• 2교시 직전 2분: draw_fixed_motif()의 위치와 색을 호출할 때 바꾸려면 어떤 입력 자리가 필요한지 세 가지 적습니다.

50-60분 · 5주차 코드의 작업 이름 설계하기

확장 시간에는 새로운 문법을 추가하지 않습니다. 5주차 포스터 제작 과정을 세 작업으로 나누고, 각 작업에 이름을 붙인 뒤 호출 순서만 작성합니다.

def prepare_canvas():
    print("1. 캔버스를 준비합니다.")

def create_poster():
    print("2. 도형을 생성합니다.")

def save_poster():
    print("3. 포스터를 저장합니다.")

prepare_canvas()
create_poster()
save_poster()

위 세 줄은 전체 구현이 아니라 작업 순서를 읽기 위한 호출 계획입니다. 다음 시간에는 호출 괄호 안에 시드, 도형 수, 위치, 크기, 색상처럼 바꾸고 싶은 값을 전달해 같은 함수에서 서로 다른 결과를 만듭니다.

참고 자료

• Python 공식 튜토리얼: Defining Functionsdef, 함수 이름, 매개변수 괄호, 들여쓴 본문, 호출과 return의 공식 설명
• Python 언어 참조: Function definitions함수 정의문의 형식과 함수 본문 실행에 관한 공식 언어 참조
• PEP 8: Function and Variable Names소문자와 밑줄을 사용하는 Python 함수 이름 표기 지침
• Pillow 공식 문서: ImageDraw함수 본문에서 묶어 사용하는 사각형, 타원, 선 그리기 메서드의 공식 설명