Python 디자인 패턴

Python의 Builder 디자인 패턴

이 레슨에서는 Builder 패턴으로 복잡한 객체를 명확한 여러 단계에 걸쳐 만듭니다.

  • 고급
  • 3분 분량
  • 실행 가능한 예제 1개

소개

어떤 문제를 해결하나요

어떤 객체에는 선택적인 부분이 많습니다. 보고서에는 제목, 차트, 표, 바닥글이 있거나 그 조합이 있을 수 있습니다. 선택적 인수가 열 개인 생성자는 읽기 어렵고 잘못 호출하기 쉽습니다. 빌더는 부분을 한 단계씩 분명하게 더합니다.

일상 속 비유

빌더(builder)는 카운터에서 샌드위치를 주문하는 것과 같습니다. "빵, 그다음 치즈, 그다음 토마토" 라고 말하면 지시할 때마다 샌드위치가 커집니다. "됐어요" 라고 하면 완성된 샌드위치를 받습니다.

샌드위치 카운터에서 코드로
ReportBuilder()🍞 빈 주문 시작
.add_title()🧀 재료 하나 더하기
.add_chart()🍅 하나 더, 순서가 중요
.build()🥪 완성된 샌드위치 건네기
필요한 부분을 더한 뒤 결과를 만듭니다.
한 문장으로

빌더 패턴은 별도의 메서드로 복잡한 객체를 한 단계씩 만들고, 마지막 build 호출에서 완성된 객체를 돌려줍니다.

핵심 포인트

  1. self.parts 는 지금까지 더한 부분을 모읍니다.
  2. add_title 과 add_chart 는 각각 부분 하나를 더하고 return self 하므로 호출을 이을 수 있습니다.
  3. ReportBuilder().add_title().add_chart().build() 는 지시 목록처럼 읽힙니다.
  4. build() 는 모은 부분을 완성된 보고서 텍스트로 바꿉니다.

언제 사용하나요?

  • 선택적 부분이 많은 객체: 보고서, HTTP 요청, SQL 쿼리, 문서.
  • 메서드 체이닝으로 단계별 생성을 읽기 쉽게 하기.
  • 같은 생성 단계로 다른 변형 만들기.

필요 없는 경우

  • 필수 필드가 두세 개인 객체: 평범한 생성자나 데이터클래스가 더 간단합니다.
  • 기본값이 있는 키워드 인수로 이미 호출이 분명한 Python 코드.

예제 코드

코드 실행 →
main.py
class ReportBuilder:
    # Builder: assemble a complex value one optional part at a time.
    def __init__(self):
        self.parts = []

    def add_title(self):
        self.parts.append("title")
        return self

    def add_chart(self):
        self.parts.append("chart")
        return self

    def build(self):
        # Hide the final assembly behind one operation.
        return "Report: " + ", ".join(self.parts)


report = ReportBuilder().add_title().add_chart().build()
print(report)
이 예제의 실행 버튼 만들기

실행 결과

Report: title, chart

코드 설명

add_title() 같은 각 메서드는 보고서에 부분을 하나 추가한 뒤 builder 객체 자신을 돌려줍니다(return self). 그래서 호출을 한 줄로 이어서 쓸 수 있습니다. 마지막으로 build() 메서드가 부분들을 모아 완성된 보고서 Report: title, chart를 돌려줍니다.

값을 변경하고 Python 설치 없이 CodeUtility 온라인 Python 컴파일러에서 실행하세요.

연습 문제

아래 제안을 따라 코드를 바꿔 보세요. 코드를 직접 고치고 결과를 확인하면 읽기만 할 때보다 레슨을 훨씬 잘 이해할 수 있습니다.

  1. 패턴 구조를 유지하면서 예제 도메인을 바꿔 보세요.
  2. 패턴을 더 단순한 구현과 비교하고 장단점을 설명하세요.
  3. 다른 구현을 추가하기 전에 각 참여 요소에 대한 테스트를 작성하세요.
Python 컴파일러에서 실행 →

자주 하는 실수

return self 를 잊기

return self 가 없으면 메서드가 None 을 돌려줘 체이닝이 실패합니다.

문제
def add_title(self):
    self.parts.append("title")
수정
def add_title(self):
    self.parts.append("title")
    return self

이 레슨을 마쳤나요?

학습 완료로 표시하면 진행 상황을 기록할 수 있습니다.

챌린지로 연습하기

이 레슨에서 배운 내용으로 실제 문제를 풀어 보세요. 모든 챌린지는 브라우저에서 실행되며 즉시 테스트와 AI 리뷰를 받을 수 있습니다.

모든 챌린지