Fastapi개발시 사용한 중급 기능들 yield, @contextmanager 등

 

어지간한건 AI가 알려주지만 특정 기능들은 잘 알고 쓰는게 필요할것 같아서 정리 해봅니다.

 

yield

제네레이터(generator)만드는 기능 입니다. 제네레이터는 상태를 유지하면서 **"한 번에 하나씩 값을 반환하고, 상태를 유지하면서 실행을 멈췄다 이어간다"**는 점입니다.

 

일반 함수 vs Generator 함수

일반 함수

 

python

def normal_function():
    print("시작")
    return "값"
    print("끝")  # 실행되지 않음

result = normal_function()
# 함수 호출 → 스택에 올라감 → return → 스택에서 제거 → 끝

Generator 함수 (yield 사용)

 

python

def generator_function():
    print("시작")
    yield "값"      # 여기서 멈춤, 하지만 스택에서 제거되지 않음!
    print("끝")     # 나중에 실행됨

gen = generator_function()  # Generator 객체 생성, 아직 실행 안됨
result = next(gen)          # 여기서 yield까지 실행
next(gen)                   # 여기서 yield 다음부터 실행

 

핵심 차이점

일반 함수:

호출 → 스택에 올라감 → return → 스택에서 완전히 제거 → 끝

 

Generator 함수:

호출 → Generator 객체 생성 → next() → 스택에 올라감 → yield → 일시중단 
→ 스택에서 제거되지 않고 "얼어있는" 상태 → next() → 재개 → 끝

 

 

@contextmanager

@contextmanager는 Python의 표준 라이브러리인 contextlib에 있는 데코레이터로,
with 문에서 사용할 수 있는 커스텀 컨텍스트 매니저를 간단하게 만들어줍니다.

 

• **__enter__()**와 __exit__() 메서드를 가진 객체입니다.
• with 문과 함께 사용되며, 자원 열고 닫는 패턴을 안전하게 처리합니다.

 

@dataclass

@dataclass는 Python 3.7부터 도입된 데코레이터로, 클래스를 간편하게 정의할 수 있게 해줍니다.

기본 사용법

 

python

from dataclasses import dataclass

@dataclass
class Person:
    name: str
    age: int
    email: str

 

 

@classmethod

@classmethod는 Python에서 클래스 메서드를 정의할 때 사용하는 데코레이터입니다. 이 메서드는 인스턴스가 아닌 클래스 자체를 첫 번째 인자로 받습니다. 보통 첫 번째 인자의 이름으로는 cls를 사용합니다 (self는 인스턴스 메서드에서 사용).

class Person:
    def __init__(self, name, age):
        self.name = name
        self.age = age

    @classmethod
    def from_birth_year(cls, name, birth_year):
        from datetime import datetime
        current_year = datetime.now().year
        return cls(name, current_year - birth_year)

# 인스턴스 생성
p1 = Person.from_birth_year("Alice", 2000)
print(p1.name, p1.age)  # Alice 25 (2025년 기준)

 

🔍 @staticmethod와 비교

항목@classmethod@staticmethod

첫 인자	cls (클래스)	없음
클래스 상태 접근	가능	불가능
인스턴스 상태 접근	불가능	불가능
사용 용도	클래스 정보 기반 로직	유틸리티 함수