한 descriptor를 클래스 속성으로 등록할 때 __set_name__은 어떤 정보를 언제 받나요?

__set_name__은 클래스가 생성될 때 클래스 namespace에 이미 들어 있던 descriptor에게 소유 클래스와 공개 속성 이름을 알려 주는 hook입니다. 호출 형태는 descriptor.__set_name__(owner, name)입니다. 이를 이용하면 descriptor 생성자가 필드 이름을 중복해서 받지 않고, name을 실제 저장 키인 _name으로 바꿀 수 있습니다.

class Field:
    def __set_name__(self, owner, name):
        self.storage = '_' + name
    def __get__(self, obj, owner=None):
        return self if obj is None else getattr(obj, self.storage, None)
    def __set__(self, obj, value): setattr(obj, self.storage, value)

class User:
    name = Field()
u = User(); u.name = 'Lee'
print(User.name.storage, u.name)  # _name Lee

T0에 User namespace의 name 값은 Field 객체입니다. T1에 type이 User를 완성하면서 Field에 (User, 'name')을 전달하고 storage를 _name으로 설정합니다. T2에 u.name = 'Lee'가 들어오면 descriptor는 u._name에 저장합니다. 중요한 경계는 클래스가 완성된 뒤 User.age = Field()라고 일반 대입하는 경우입니다. 이 assignment가 자동으로 __set_name__을 호출한다고 기대하면 안 되며, 동적 등록 API가 field.__set_name__(User, 'age')를 직접 실행해야 합니다. 같은 Field 객체를 여러 클래스에 재사용하면 마지막 등록의 owner/name을 덮을 수 있으므로 보통 클래스마다 새 객체를 만들거나 owner별 저장소를 둡니다.