PEP 3155 – 클래스와 함수의 정규화된 이름

Author:: Antoine Pitrou <solipsis at pitrou.net>
Status:: Final
Type:: Standards Track
Created:: 29-Oct-2011
Python-Version:: 3.3
Post-History:
Resolution:: Python-Dev message

Table of Contents

근거
제안
- 중첩 클래스 예제
- 중첩 함수 예제
제한 사항
논의
- 모듈 이름 제외
- 바인딩되지 않은 메서드의 부활
이름 지정 선택
참고 문헌
Copyright

번역·라이선스 안내

이 비공식 한국어 번역은 원문 Copyright 절의 Public Domain 조건에 따라 제공합니다. 원저자와 공식 원문은 그대로 표시합니다. 수정되지 않은 기준 원문 · 공식 최신판

근거

Python의 인트로스펙션 기능은 오랫동안 중첩 클래스에 대한 지원이 부족했습니다. 클래스 객체가 주어졌을 때, 해당 객체가 다른 클래스 내부에 정의되었는지 모듈 최상위 수준에 정의되었는지 알 수 없으며, 전자의 경우에는 어느 클래스에 정의되었는지도 알 수 없습니다. 중첩 클래스의 사용은 흔히 좋지 않은 스타일로 간주되지만, 중첩 클래스에 2류 인트로스펙션 지원만 제공해야 할 유일한 이유는 형편없는 말장난 때문입니다.

Python 3은 이전에 바인딩되지 않은 메서드라고 불리던 것을 제거하여 엎친 데 덮친 격으로 만들었습니다. Python 2에서는 다음 정의가 주어졌을 때:

class C:
    def f():
        pass

C.f 객체에서 해당 객체를 정의한 클래스로 거슬러 올라갈 수 있습니다.:

>>> C.f.im_class
<class '__main__.C'>

Python 3에서는 이러한 가능성이 사라졌습니다.:

>>> C.f.im_class
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
AttributeError: 'function' object has no attribute 'im_class'
>>> dir(C.f)
['__annotations__', '__call__', '__class__', '__closure__', '__code__',
'__defaults__', '__delattr__', '__dict__', '__dir__', '__doc__',
'__eq__', '__format__', '__ge__', '__get__', '__getattribute__',
'__globals__', '__gt__', '__hash__', '__init__', '__kwdefaults__',
'__le__', '__lt__', '__module__', '__name__', '__ne__', '__new__',
'__reduce__', '__reduce_ex__', '__repr__', '__setattr__', '__sizeof__',
'__str__', '__subclasshook__']

이로 인해 사용자가 이용할 수 있는 인트로스펙션 기능이 다시 제한됩니다. 소프트웨어를 Python 3으로 포팅할 때 실제 문제가 발생할 수 있으며, 예를 들어 메서드 객체의 인트로스펙션 문제가 여러 차례 제기된 Twisted Core가 있습니다. 피클링 지원도 제한됩니다 [1].

제안

이 PEP에서는 함수와 클래스에 __qualname__속성을 추가할 것을 제안합니다. 최상위 함수와 클래스의 경우 __qualname__속성은 __name__속성과 같습니다. 중첩 클래스, 메서드 및 중첩 함수의 경우 __qualname__속성은 모듈 최상위 수준에서 해당 객체로 이어지는 점으로 구분된 경로를 포함합니다. 함수의 로컬 네임스페이스는 해당 점으로 구분된 경로에서 <locals>라는 이름의 구성 요소로 표현됩니다.

함수와 클래스의 repr() 및 str()은 __name__대신 __qualname__을 사용하도록 수정됩니다.

중첩 클래스 예제

>>> class C:
...   def f(): pass
...   class D:
...     def g(): pass
...
>>> C.__qualname__
'C'
>>> C.f.__qualname__
'C.f'
>>> C.D.__qualname__
'C.D'
>>> C.D.g.__qualname__
'C.D.g'

중첩 함수 예제

>>> def f():
...   def g(): pass
...   return g
...
>>> f.__qualname__
'f'
>>> f().__qualname__
'f.<locals>.g'