본문으로 건너뛰기

__init_subclass__

하위 클래스를 정의하는 순간 자동으로 등록하는 방법입니다.

개념​

기본 클래스에 __init_subclass__를 정의하면, 그 클래스를 상속한 하위 클래스가 정의될 때마다 자동으로 불립니다.

사용 방법​

  • super().__init_subclass__(**kwargs)를 먼저 부릅니다.
  • 등록 조건(예: name이 있음)을 둬서 이름 없는 중간 클래스는 등록되지 않게 합니다.
  • 이름이 겹치면 정의하는 순간 거부합니다.

예시​

레포 코드에 없는 이름 중복 검사를 더한 형태입니다.

# 예시: 정의만 하면 등록되고, 이름이 겹치면 정의하는 순간 실패합니다
_AGENTS: dict[str, type] = {}


class Agent:
name = ""

def __init_subclass__(cls, **kwargs: object) -> None:
super().__init_subclass__(**kwargs)
# 이름이 없는 중간 클래스는 등록하지 않습니다
if not cls.name:
return
if cls.name in _AGENTS:
raise ValueError(f"agent {cls.name!r} is already defined by {_AGENTS[cls.name].__name__}")
_AGENTS[cls.name] = cls


class GptAgent(Agent):
name = "gpt"


try:
class AnotherGpt(Agent):
name = "gpt"
except ValueError as error:
print(error) # agent 'gpt' is already defined by GptAgent
print(sorted(_AGENTS)) # ['gpt']

Self-Index에서의 사용​

adapters/browsecomp/agent/backbones.py:45

def __init_subclass__(cls, **kwargs):
super().__init_subclass__(**kwargs)
if cls.name:
_REGISTRY[cls.name] = cls

주의할 점​

레포 코드는 이름 중복을 검사하지 않아서, 같은 name을 쓴 두 번째 클래스가 첫 번째를 조용히 덮어씁니다. 위 예시처럼 중복을 거부하거나 Registry.register(B3)를 거치게 합니다.