Python 디자인 패턴

Python의 Singleton 디자인 패턴

이 레슨에서는 클래스의 객체가 공유되는 하나뿐이도록 보장하는 Singleton 패턴을 구현합니다.

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

소개

어떤 문제를 해결하나요

어떤 것은 프로그램에 하나만 있어야 합니다. 앱 설정, 연결 풀, 한 파일에 쓰는 로거. 코드의 모든 부분이 각자 사본을 만들면 설정이 서로 어긋나고 자원이 낭비됩니다.

일상 속 비유

싱글턴(singleton)은 건물에 하나뿐인 학교 종과 같습니다. 모든 교실이 같은 종을 울리고, 아무도 자기만의 종을 달지 않습니다. 어디서든 "그 종" 을 찾으면 언제나 그 하나의 종이 나옵니다.

학교 종에서 코드로
_instance = None🔔 아직 종이 달리지 않음
if cls._instance is None:🔧 처음 누군가 찾을 때 달기
return cls._instance🔁 그 뒤로는 모두 같은 종을 받음
first is second✅ 요청 두 번, 객체 하나: True
모든 호출이 같은 객체를 돌려줍니다.
한 문장으로

싱글턴 패턴은 클래스를 만들 때마다 같은 인스턴스 하나를 돌려주게 하여, 프로그램에 공유 객체 하나를 줍니다.

핵심 포인트

  1. _instance 는 공유 객체 하나를 저장하는 클래스 속성입니다.
  2. __new__ 는 Python 이 객체를 만들 때 부르는 메서드로, _instance 가 아직 None 일 때만 객체를 만듭니다.
  3. cls._instance.theme = "dark" 는 공유 객체를 한 번 설정합니다.
  4. first is second 는 True 입니다. 두 이름이 정확히 같은 객체를 가리킵니다.

언제 사용하나요?

  • 모든 모듈이 읽는 애플리케이션 전체 설정.
  • 캐시, 로거, 연결 풀 같은 공유 자원 하나.
  • __new__ 가 객체 생성을 어떻게 조절하는지 배우기.

필요 없는 경우

  • 대부분의 Python 코드: 모듈 수준 객체(모듈은 한 번만 만들어짐)가 더 간단하고 같은 일을 합니다.
  • 쉽게 테스트하고 싶은 코드: 숨은 전역 상태는 테스트를 서로 얽히게 하니, 대신 객체를 넘깁니다.

예제 코드

코드 실행 →
main.py
class AppConfig:
    # Singleton: every caller receives one shared configuration object.
    _instance = None

    def __new__(cls):
        # Create the shared instance only on the first call.
        if cls._instance is None:
            cls._instance = super().__new__(cls)
            cls._instance.theme = "dark"
        return cls._instance


first = AppConfig()
second = AppConfig()
print(first is second)
이 예제의 실행 버튼 만들기

실행 결과

True

코드 설명

__new__ 메서드는 객체가 만들어질 때마다 __init__보다 먼저 호출됩니다. 처음 호출될 때는 _instance가 아직 None이므로 객체를 만들고 기억해 둡니다. 그 뒤의 호출에서 __new__는 기억해 둔 객체를 그대로 돌려주기 때문에, 두 객체를 is로 비교하면 True가 나옵니다.

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

연습 문제

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

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

자주 하는 실수

__init__ 에서 상태 설정하기

__init__ 은 호출할 때마다 실행되므로 매번 공유 객체를 초기화합니다.

문제
def __init__(self):
    self.theme = "dark"  # runs again for every AppConfig()
수정
if cls._instance is None:
    cls._instance = super().__new__(cls)
    cls._instance.theme = "dark"

이 레슨을 마쳤나요?

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

챌린지로 연습하기

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

모든 챌린지