__prepare__ 메서드는 PEP 3115를 통해 Python 3.0에서 도입되어 클래스 생성 프로토콜의 근본적인 한계를 해결했습니다. 이 변화 이전에는 클래스 본문 실행 중에 사용되는 네임스페이스가 항상 표준 사전으로, 속성 선언 순서를 보존하거나 발생하는 대로 할당을 가로챌 방법이 없었습니다. 이는 개발자들이 프래질한 소스 코드 파싱에 의존하지 않고 필드 선언의 순서를 추적해야 하는 ORM 및 직렬화 라이브러리를 구축할 때 특히 문제가 되었습니다.
Python이 클래스 본문을 실행할 때, 결국 클래스 __dict__가 될 네임스페이스 매핑을 채웁니다. 기본적으로 dict 타입은 이전 Python 버전에서는 삽입 순서를 보장하지 않으며 이름이 정의되는 순간에 유효성 검사나 변환을 위한 후크가 부족합니다. 특정 명명 패턴 금지 또는 이진 프로토콜을 위한 필드 순서 추적과 같이 선언 시간 제약이 필요한 개발자들은 클래스 객체가 최종화되기 전에 클래스 생성의 이 특정 단계에 후킹할 수 있는 깔끔한 메커니즘이 없었습니다.
메타클래스에서 __prepare__를 정적 메서드로 구현함으로써, 네임스페이스로 사용할 사용자 정의 가능한 가변 매핑(예: collections.OrderedDict 또는 맞춤형 유효성 검사 사전)을 반환할 수 있습니다. 이 매핑은 본문 실행 중 모든 클래스 수준 할당을 캡처하여 메타클래스 __new__ 메서드가 클래스를 최종화하기 전에 전처리를 수행할 수 있게 합니다. 그런 다음 사용자 정의 네임스페이스가 __new__로 전달되어 표준 dict로 변환되거나 정렬된 접근을 위해 보존될 수 있습니다.
from collections import OrderedDict class OrderPreservingMeta(type): @staticmethod def __prepare__(name, bases, **kwargs): return OrderedDict() def __new__(mcs, name, bases, namespace, **kwargs): ordered_attrs = list(namespace.keys()) cls = super().__new__(mcs, name, bases, dict(namespace)) cls._declaration_order = ordered_attrs return cls class Schema(metaclass=OrderPreservingMeta): id = 1 name = "test" value = 3.14 print(Schema._declaration_order) # ['id', 'name', 'value']
금융 거래 플랫폼은 프로토콜 헤더의 필드 순서가 Python 메시지 클래스 정의의 선언 순서와严格히 일치하는 이진 메시지 형식을 생성해야 했습니다. 필드의 순서를 바꾸면 거래 거부 또는 시스템 충돌을 초래하는 레거시 C++ 파서와의 호환성이 깨질 수 있습니다.
해결책 A: 수동 색인화. 개발자들은 각 필드를 field_order = 1과 같은 순서 번호로 주석 처리합니다. 이 방법은 초보자에게 명시적이고 이해하기 쉽습니다. 그러나 이는 DRY 원칙을 위반하고 리팩토링 중 유지 관리 부담이 되며, 중간에 필드를 삽입할 경우 모든 후속 필드의 번호를 다시 매겨야 합니다.
해결책 B: 소스 코드 파싱. 프레임워크는 AST 모듈을 사용하여 클래스 정의 소스를 파싱하고 할당 순서를 추출할 수 있습니다. 이는 메타클래스 복잡성 없이 작동합니다. 불행히도, 실행 시간에 소스 파일이 없을 때는 완전히 실패하며, 이는 동결된 이진 배포 또는 소스 코드가 제거된 최적화된 CPython 배포에서 발생합니다.
해결책 C: __prepare__가 있는 메타클래스. __prepare__에서 OrderedDict를 반환함으로써 메타클래스는 자연스러운 선언 순서를 자동으로 캡처합니다. 이는 모든 배포 시나리오에서 견고하며 최종 사용자에게 투명합니다. 유일한 단점은 Python의 메타클래스 프로토콜을 이해해야 한다는 추가 복잡성이며, 이는 고급 수준의 지식을 요구합니다.
선택된 해결책: 팀은 정의 시간 보장을 제공하면서 메시지 인스턴스당 런타임 오버헤드가 없는 해결책 C를 선택했습니다. 이는 소스 코드가 없는 환경에서도 신뢰할 수 있게 작동하며, 개발자들이 예상하는 자연스러운 클래스 구문을 유지하면서 가능한 가장 이른 단계에서 제약을 시행합니다.
결과: 메시지 라이브러리는 자동으로 전선 형식 호환성을 유지했습니다. 개발자들은 자연스러운 클래스 정의를 작성했고 시스템은 올바른 이진 레이아웃을 생성했습니다. 상속 계층은 자식 필드 이전에 부모 필드 순서를 올바르게 보존하여 수동 개입 없이 거래 프로토콜 사양의 복잡한 문제를 해결했습니다.
질문 1: __prepare__를 정적 메서드(또는 클래스 메서드)로 정의해야 하는 이유는 무엇이며, 이 데코레이터를 생략하면 어떤 오류가 발생합니까?
답변: __prepare__는 메타클래스 인스턴스가 생성되기 전에 호출되므로 아직 바인딩될 cls나 self가 없습니다. Python은 __prepare__를 호출하여 __new__에 전달될 네임스페이스를 생성합니다. 만약 일반 인스턴스 메서드로 정의되고 self를 예상하더라도, Python은 인수가 주어지지 않았다고 하여 TypeError를 발생시킵니다. 이는 메서드가 첫 번째 인자 바인딩 없이 호출될 수 있도록 정적 메서드여야 하며, 메타클래스를 직접 접근해야 하는 경우 클래스 메서드도 가능합니다.
질문 2: __prepare__가 dict의 서브클래스가 아닌 매핑을 반환할 수 있으며, 클래스 본문 실행 중에 올바르게 작동하기 위해 반드시 충족해야 하는 특정 프로토콜은 무엇입니까?
답변: 예, MutableMapping 추상 기본 클래스 프로토콜을 구현하는 가변 매핑을 반환할 수 있습니다. 특히 __setitem__, __getitem__, __contains__ 및 이상적으로는 변환을 위해 __iter__ 또는 keys()를 요구합니다. 그러나 매핑은 dict에서 상속받을 필요는 없습니다. 중요한 요구 사항은 문자열 키와 임의의 값을 수용해야 하며 클래스 본문에서 속성 할당 중에 사전처럼 동작해야 한다는 것입니다. 클래스 실행 후, 메타클래스 __new__는 이 매핑을 수신합니다. 만약 그것이 dict 서브클래스가 아니라면, super().__new__를 호출하기 전에 명시적으로 변환해야 합니다(예: dict(namespace)) 왜냐하면 결과 클래스 객체의 __dict__는 사전이어야 하기 때문입니다.
질문 3: __prepare__는 클래스 정의 헤더에서 전달된 키워드 인자(e.g., class MyClass(metaclass=Meta, strict=True))를 어떻게 처리하며, 만약 이러한 인자들이 제대로 전달되지 않는다면 어떻게 됩니까?
답변: 클래스 헤더의 키워드 인자는 **kwds로 __prepare__에 전달됩니다. 만약 __prepare__가 **kwargs(또는 특정 이름이 붙은 인자)를 받아들이지 않으면, Python은 __prepare__가 예기치 않은 키워드 인자를 받았다고 하는 TypeError를 발생시킵니다. 이는 메타클래스에 구성 옵션을 추가할 때 흔히 발생하는 함정입니다. 메서드 시그니처는 하위 호환성을 위해 __prepare__(name, bases, **kwargs)이어야 합니다. 이러한 키워드도 이후 __new__ 및 __init__에 전달되어, 메타클래스가 네임스페이스 동작(예: 엄격한 유효성 검사 모드와 관대 한 유효성 검사 모드 선택)을 사용자 정의하기 위해 준비 시간에 구성을 받을 수 있게 합니다.