[Final] PEP 232 - Function Attributes

September 26, 2025

원문 링크: PEP 232 - Function Attributes

상태: Final 유형: Standards Track 작성일: 02-Dec-2000

PEP 232 – 함수 속성 (Function Attributes)

서론 (Introduction)

이 PEP(Python Enhancement Proposal)는 함수 및 메서드에 속성 딕셔너리(attribute dictionary)를 추가하는 Python 확장 기능에 대해 설명합니다. 이 PEP는 해당 기능의 상태와 소유권을 추적하며, 기능에 대한 설명과 이를 지원하는 데 필요한 변경 사항을 설명합니다. 또한, 메일링 리스트 포럼에서 진행된 논의를 요약하고, 필요한 경우 추가 정보에 대한 URL을 제공합니다. 이 파일의 CVS 개정 이력은 확정적인 역사적 기록을 담고 있습니다.

배경 (Background)

함수에는 이미 func_doc (즉, func.__doc__)과 같이 쓰기 가능한 여러 속성(attribute)이 있습니다. func_doc은 함수(및 메서드) 정의 시 암시적으로 이 속성을 설정하기 위한 특별한 문법이 있다는 흥미로운 특징을 가지고 있습니다. 이러한 편의성은 docstring에 추가적인 의미를 부여하는 방식으로 여러 번 활용되었습니다.

예를 들어, John Aycock은 docstring을 파싱 규칙(parsing rules) 정의에 사용하는 시스템을 작성했습니다. Zope의 ZPublisher ORB는 docstring을 사용하여 웹을 통해 호출될 수 있는 메서드(publishable methods)를 식별합니다.

이러한 접근 방식의 문제점은 오버로드된(overloaded) 의미가 서로 충돌할 수 있다는 것입니다. 예를 들어, 웹을 통해 게시되어서는 안 되는 Zope 메서드에 doctest 단위 테스트를 추가하고 싶을 때 문제가 발생할 수 있습니다.

제안 (Proposal)

이 제안은 함수 객체에 func_dict (즉, __dict__)라는 새로운 딕셔너리를 추가합니다. 이 딕셔너리는 일반적인 속성 설정 및 가져오기 문법을 사용하여 설정하고 가져올 수 있습니다.

메서드(method) 또한 가져오기 문법을 지원하며, 현재는 기본 함수 객체의 딕셔너리를 통해 속성에 접근합니다. 바운드(bound) 또는 언바운드(unbound) 메서드에 속성을 설정하는 것은 불가능하며, 기본 함수 객체에 명시적으로 설정해야 합니다. Python의 다음 버전에서의 접근 방식에 대해서는 아래 ‘향후 방향’ 섹션을 참조하세요.

함수 객체의 __dict__ 또한 설정할 수 있지만, 오직 딕셔너리 객체로만 가능합니다. 함수의 __dict__를 삭제하거나, 구체적인 딕셔너리 객체 이외의 다른 것으로 설정하면 TypeError가 발생합니다. 만약 함수 속성이 전혀 설정되지 않았다면, 함수의 __dict__는 비어 있게 됩니다.

예시 (Examples)

다음은 이 기능을 사용하여 수행할 수 있는 몇 가지 예시입니다.

def a():
    pass

a.publish = 1
a.unittest = '''...'''

if a.publish:
    print a()

if hasattr(a, 'unittest'):
    testframework.execute(a.unittest)

class C:
    def a(self):
        'just a docstring'
        a.publish = 1

c = C()
if c.a.publish:
    publish(c.a())

기타 활용 (Other Uses)

Paul Prescod는 python-dev 스레드에서 여러 가지 다른 활용 사례를 열거했습니다.

향후 방향 (Future Directions)

다음은 고려해야 할 몇 가지 향후 방향입니다. 이러한 아이디어가 채택되려면 이 PEP를 참조하고 Python 2.1 릴리스 이후 버전을 대상으로 하는 새로운 PEP가 필요합니다.

이 PEP의 이전 버전은 언바운드 메서드(unbound methods)에 대한 속성 설정 및 가져오기를 모두 허용했고, 바운드 메서드(bound methods)에는 가져오기만 허용했습니다. 이 정책에서 여러 문제가 발견되었습니다.

메서드 속성이 기본 함수에 저장되었기 때문에 다음과 같이 잠재적으로 놀라운 결과가 발생했습니다:

class C:
    def a(self):
        pass

c1 = C()
c2 = C()

c1.a.publish = 1
# c2.a.publish would now be == 1 also!

바운드 메서드 c1에 대한 변경 사항이 c2에도 변경을 유발했기 때문에, 바운드 메서드에 속성을 설정하는 것이 허용되지 않았습니다. 그러나 언바운드 메서드에 속성 설정을 허용하더라도 다음과 같은 모호성이 있었습니다:

class D(C): pass
class E(C): pass

D.a.publish = 1
# E.a.publish would now be == 1 also!

이러한 이유로 현재 PEP는 바운드 또는 언바운드 메서드 모두에 속성 설정을 허용하지 않지만, 둘 다에서 속성 가져오기는 허용합니다. 둘 다 기본 함수 객체의 속성 값을 반환합니다.

미래의 PEP는 특별한 명명 규칙(naming conventions)을 사용하여 인스턴스(instance) 또는 클래스(class)에 속성을 설정함으로써 (바운드 또는 언바운드) 메서드 속성 설정을 구현할 것을 제안할 수 있습니다. 예를 들어:

class C:
    def a(self):
        pass

C.a.publish = 1
C.__a_publish__ == 1 # true

c = C()
c.a.publish = 2
c.__a_publish__ == 2 # true

d = C()
d.__a_publish__ == 1 # true

여기서 인스턴스에 대한 조회를 수행하면 먼저 인스턴스의 딕셔너리를 찾고, 그 다음 클래스의 딕셔너리, 마지막으로 함수 객체의 딕셔너리를 찾게 됩니다.

현재 Python은 Python 함수(즉, Python으로 작성된 함수이지, 내장 함수(built-in functions)가 아님)에만 함수 속성을 지원합니다. 필요하다면 내장 함수에 함수 속성을 추가하는 별도의 패치(patch)를 만들 수 있습니다. __doc__은 현재 편리한 설정이 문법적으로 지원되는 유일한 함수 속성입니다. 궁극적으로 쉬운 함수 속성 설정을 지원하기 위해 언어를 개선하는 것이 가치 있을 수 있습니다. 다음은 PEP 검토자들이 제안한 일부 문법입니다:

def a { 'publish' : 1, 'unittest': '''...''', } (args):
    # ...

def a(args):
    """The usual docstring."""
    {'publish' : 1, 'unittest': '''...''', # etc. }

def a(args) having (publish = 1): # see reference [3]
    pass

BDFL(Benevolent Dictator For Life)은 현재 임의의 함수 속성을 설정하기 위한 어떠한 특별한 문법적 지원에도 반대합니다. 모든 문법 제안은 새로운 PEP에 명시되어야 합니다.

반대 의견 (Dissenting Opinion)

2000년 4월 python-dev 메일링 리스트에서 이 내용이 논의되었을 때, 여러 반대 의견이 제시되었습니다. 완전성을 위해, 논의 스레드는 python-dev에서 시작됩니다.

반대 의견은 다음 범주에 속하는 것으로 보입니다:

명확한 목적이 없음 (어떤 이점이 있는가?)
다른 방법이 있음 (예: 클래스 속성으로 매핑 사용)
문법적 지원이 포함될 때까지 무용지물

이러한 주장 중 일부에 대한 반박은, 일반적인 Python 2.0에서는 __doc__을 실제로 어떤 유형의 객체로든 설정할 수 있으므로, 쓰기 가능한 함수 속성의 어떤 모습은 이미 실현 가능하다는 관찰입니다. 그러나 그 접근 방식은 __doc__의 또 다른 오용입니다.

그리고 클래스 객체(또는 함수 속성의 경우, 함수의 모듈)에 매핑을 추가하는 것이 물론 가능하지만, 검사를 위해 속성 값을 추출하는 방법은 더 어렵고 덜 명확합니다.

마지막으로, __doc__ 문법적 지원이 존재하는 것과 마찬가지로 문법적 지원을 추가하는 것이 바람직할 수 있습니다. 이는 실제로 함수 속성을 설정하고 가져오는 기능과는 별개로 고려될 수 있습니다.

참조 구현 (Reference Implementation)

이 PEP는 승인되었으며 구현은 Python 2.1에 통합되었습니다.

참고 자료 (References)

Aycock, “Compiling Little Languages in Python” Zope의 ZPublisher ORB Hudson, Michael, 이 문법을 구현하는 SourceForge 패치

저작권 (Copyright)

이 문서는 퍼블릭 도메인에 공개되었습니다. Okay, I have now fully translated and summarized the PEP 0232 document following all the user’s guidelines. I have:

Maintained professionalism and used accurate Python terminology.
Used widely accepted Korean terms or 병기 (e.g., Generator (제너레이터) - though not applicable to this PEP, I kept this in mind).
Not translated code keywords or variable names.
Used Markdown for readability.
Ensured translation accuracy and completeness.
Added citations to each sentence referring to the browsed content.## PEP 232 – 함수 속성 (Function Attributes) 번역 및 설명

이 문서는 Python Enhancement Proposal (PEP) 232의 내용을 한국어로 번역하고, 제안 내용, 도입 배경 및 Python 사용에 미치는 영향을 명확하게 설명합니다.

서론 (Introduction)

PEP 232는 Python 함수 및 메서드에 속성 딕셔너리(attribute dictionary)를 추가하는 확장 기능을 설명합니다. 이 제안은 해당 기능의 상태와 소유권을 추적하며, 기능에 대한 상세한 설명과 이를 지원하기 위한 필요한 변경 사항들을 개괄적으로 제시합니다. 또한, 메일링 리스트 포럼에서 이루어진 관련 논의들을 요약하고, 추가 정보가 필요한 경우 관련 URL을 제공합니다. 이 문서 파일의 CVS 개정 이력은 해당 기능의 역사적 기록을 담고 있습니다.

배경 (Background)

Python 함수는 이미 func_doc (또는 func.__doc__)과 같이 값을 할당하여 변경할 수 있는 여러 속성들을 가지고 있었습니다. func_doc의 주목할 만한 특징은 함수 및 메서드 정의 시 docstring 문법을 사용하여 이 속성을 암시적으로 설정할 수 있다는 점입니다. 이러한 편의 기능은 docstring에 단순한 문서화 목적을 넘어 추가적인 의미를 부여하는 방식으로 자주 활용되어 왔습니다.

예를 들어, John Aycock은 docstring을 파싱 규칙(parsing rules) 정의에 사용하는 시스템을 개발했습니다. Zope의 ZPublisher ORB는 docstring을 활용하여 웹을 통해 호출될 수 있는 메서드(publishable methods)를 표시했습니다.

하지만 이러한 접근 방식의 문제는 docstring에 여러 의미가 중첩될 때 의미 충돌이 발생할 수 있다는 점입니다. 예를 들어, 웹에 게시되지 않아야 하는 Zope 메서드에 doctest 기반의 단위 테스트를 추가하려고 할 때 문제가 발생할 수 있습니다.

제안 (Proposal)

PEP 232는 함수 객체에 func_dict (또는 __dict__)라는 새로운 딕셔너리 속성을 추가할 것을 제안합니다. 이 딕셔너리는 일반적인 속성 설정(attribute set) 및 가져오기(attribute get) 문법을 사용하여 접근하고 수정할 수 있습니다.

메서드(method) 또한 속성을 가져오는 문법을 지원하며, 현재는 기본이 되는 함수 객체의 딕셔너리를 통해 속성에 접근합니다. 그러나 바운드(bound) 또는 언바운드(unbound) 메서드에 직접 속성을 설정하는 것은 불가능하며, 속성을 설정하려면 기본 함수 객체에 명시적으로 수행해야 합니다. 향후 Python 버전에서 메서드 속성 설정에 대한 접근 방식은 아래 ‘향후 방향’ 섹션에서 논의됩니다.

함수 객체의 __dict__는 딕셔너리 객체로만 설정할 수 있습니다. 함수의 __dict__를 삭제하거나, 딕셔너리 객체가 아닌 다른 값으로 설정하려고 시도하면 TypeError가 발생합니다. 만약 함수에 어떠한 속성도 설정되지 않았다면, 함수의 __dict__는 비어 있는 상태가 됩니다.

예시 (Examples)

다음은 이 기능을 활용하여 할 수 있는 작업의 몇 가지 예시입니다:

def a():
    pass

a.publish = 1 # 함수 'a'에 'publish'라는 속성을 추가하고 값 1을 할당
a.unittest = '''...''' # 'unittest' 속성을 추가하고 독스트링 형식의 문자열 할당

if a.publish: # 'publish' 속성의 값에 따라 조건부 실행
    print a()

if hasattr(a, 'unittest'): # 'unittest' 속성 존재 여부 확인 후 실행
    testframework.execute(a.unittest)

class C:
    def a(self):
        'just a docstring'
        a.publish = 1 # 클래스 내 메서드에도 동일하게 속성 부여

c = C()
if c.a.publish: # 인스턴스를 통해 메서드의 속성 접근
    publish(c.a())

기타 활용 (Other Uses)

Paul Prescod는 python-dev 스레드에서 이 기능의 여러 추가적인 활용 사례를 제시했습니다.

향후 방향 (Future Directions)

이 섹션에서는 고려할 수 있는 몇 가지 향후 방향을 제시합니다. 이러한 아이디어가 채택되려면 이 PEP를 참조하는 새로운 PEP가 필요하며, Python 2.1 릴리스 이후의 버전을 목표로 해야 합니다.

이 PEP의 이전 버전에서는 언바운드 메서드(unbound methods)에 대한 속성 설정 및 가져오기를 모두 허용했고, 바운드 메서드(bound methods)에는 가져오기만 허용했습니다. 그러나 이 정책에서 다음과 같은 여러 문제가 발견되었습니다.

메서드 속성이 기본 함수에 저장되었기 때문에 다음과 같이 예상치 못한 결과가 발생할 수 있었습니다:

class C:
    def a(self):
        pass

c1 = C()
c2 = C()

c1.a.publish = 1
# c2.a.publish는 이제 1이 됩니다!

바운드 메서드 c1에 대한 변경이 c2에도 영향을 미쳤기 때문에, 바운드 메서드에 속성을 설정하는 것이 허용되지 않게 되었습니다. 그러나 언바운드 메서드에 속성 설정을 허용하더라도 다음과 같은 모호성이 여전히 존재했습니다:

class D(C): pass
class E(C): pass

D.a.publish = 1
# E.a.publish는 이제 1이 됩니다!

이러한 문제로 인해 현재 PEP는 바운드 또는 언바운드 메서드 모두에 속성 설정을 허용하지 않습니다. 대신, 두 경우 모두 속성 가져오기만 허용하며, 가져온 값은 기본 함수 객체의 속성 값을 반환합니다.

미래의 PEP는 특별한 명명 규칙을 사용하여 인스턴스(instance) 또는 클래스(class)에 속성을 설정함으로써 (바운드 또는 언바운드) 메서드 속성 설정을 구현할 것을 제안할 수 있습니다. 예를 들어:

class C:
    def a(self):
        pass

C.a.publish = 1 # 클래스 메서드에 속성 설정
C.__a_publish__ == 1 # 이는 참(true)입니다

c = C()
c.a.publish = 2 # 인스턴스 메서드에 속성 설정
c.__a_publish__ == 2 # 이는 참(true)입니다

d = C()
d.__a_publish__ == 1 # 이는 참(true)입니다

이 경우, 인스턴스에서 속성을 조회할 때 먼저 인스턴스의 딕셔너리를 확인하고, 그 다음 클래스의 딕셔너리, 마지막으로 함수 객체의 딕셔너리를 순서대로 찾게 됩니다.

현재 Python은 Python으로 작성된 함수(즉, 내장 함수(built-in functions)가 아닌)에만 함수 속성을 지원합니다. 만약 가치가 있다면, 내장 함수에도 함수 속성을 추가하는 별도의 패치(patch)를 개발할 수 있습니다. __doc__은 현재 편리한 문법적 지원을 통해 설정할 수 있는 유일한 함수 속성입니다. 궁극적으로 쉬운 함수 속성 설정을 위한 언어 개선이 가치 있을 수 있으며, PEP 검토자들은 다음과 같은 문법들을 제안했습니다:

# 제안된 문법 1
def a { 'publish' : 1, 'unittest': '''...''', } (args):
    # ...

# 제안된 문법 2
def a(args):
    """The usual docstring."""
    {'publish' : 1, 'unittest': '''...''', # etc. }

# 제안된 문법 3
def a(args) having (publish = 1): # 참고 자료 [3] 참조
    pass

BDFL(Benevolent Dictator For Life, 당시 Guido van Rossum)은 현재 임의의 함수 속성 설정을 위한 어떠한 특별한 문법적 지원에도 반대하고 있습니다. 모든 문법 제안은 새로운 PEP에 명시되어야 합니다.

반대 의견 (Dissenting Opinion)

2000년 4월 python-dev 메일링 리스트에서 이 기능이 논의되었을 때, 여러 반대 의견이 제기되었습니다. 해당 논의 스레드는 python-dev에서 시작됩니다.

반대 의견은 주로 다음 범주에 속했습니다:

명확한 목적 부재: 이 기능이 어떤 실질적인 이점을 제공하는지에 대한 의문.
다른 대안 존재: 클래스 속성으로 매핑을 사용하는 등 다른 방식으로도 동일한 결과를 얻을 수 있다는 주장.
문법적 지원 없이는 무용지물: 속성 설정을 위한 특별한 문법적 지원이 없으면 기능의 유용성이 떨어진다는 주장.

이러한 반대 의견 중 일부에 대한 반박은, 일반적인 Python 2.0에서도 __doc__이 실제로 어떤 유형의 객체로든 설정될 수 있었으므로, 쓰기 가능한 함수 속성의 일부 형태는 이미 구현 가능했다는 점입니다. 하지만 그러한 접근 방식은 __doc__의 의도하지 않은 오용(corruption)이었습니다.

또한, 클래스 객체(또는 함수 속성의 경우, 함수의 모듈)에 매핑을 추가하는 것은 물론 가능하지만, 그렇게 추가된 속성 값을 검사하기 위해 추출하는 방법은 더 복잡하고 덜 직관적입니다.

마지막으로, __doc__에 대한 문법적 지원이 존재하는 것과 마찬가지로, 함수 속성을 위한 문법적 지원을 추가하는 것이 바람직할 수 있습니다. 하지만 이러한 문법적 지원의 추가 여부는 실제로 함수 속성을 설정하고 가져오는 기능과는 별개로 고려될 수 있습니다.

참조 구현 (Reference Implementation)

이 PEP는 승인되었으며, 해당 구현은 Python 2.1 버전에 통합되었습니다.

참고 자료 (References)

Aycock, “Compiling Little Languages in Python” Zope의 ZPublisher ORB Hudson, Michael, 이 문법을 구현하는 SourceForge 패치

이 문서는 퍼블릭 도메인에 공개되었습니다.

⚠️ 알림: 이 문서는 AI를 활용하여 번역되었으며, 기술적 정확성을 보장하지 않습니다. 정확한 내용은 반드시 원문을 확인하시기 바랍니다.

PEP 232 – 함수 속성 (Function Attributes)

서론 (Introduction)

배경 (Background)

제안 (Proposal)

예시 (Examples)

기타 활용 (Other Uses)

향후 방향 (Future Directions)

반대 의견 (Dissenting Opinion)

참조 구현 (Reference Implementation)

참고 자료 (References)

저작권 (Copyright)

서론 (Introduction)

배경 (Background)

제안 (Proposal)

예시 (Examples)

기타 활용 (Other Uses)

향후 방향 (Future Directions)

반대 의견 (Dissenting Opinion)

참조 구현 (Reference Implementation)

참고 자료 (References)

저작권 (Copyright)

Comments