types
— 동적 형 생성과 내장형 이름¶
소스 코드: Lib/types.py
이 모듈은 새로운 형의 동적 생성을 지원하는 유틸리티 함수를 정의합니다.
표준 파이썬 인터프리터가 사용하지만, int
나 str
처럼 내장으로 노출되지 않는 일부 객체 형의 이름도 정의합니다.
마지막으로, 내장되기에 충분히 기본적이지 않은 몇 가지 추가 형 관련 유틸리티 클래스와 함수를 제공합니다.
동적 형 생성¶
-
types.
new_class
(name, bases=(), kwds=None, exec_body=None)¶ 적절한 메타 클래스를 사용하여 동적으로 클래스 객체를 만듭니다.
처음 세 개의 인자는 클래스 정의 헤더를 구성하는 요소들입니다: 클래스 이름, 베이스 클래스 (순서대로), 키워드 인자 (가령
metaclass
).exec_body 인자는 새로 만들어진 클래스 이름 공간을 채우는 데 사용되는 콜백입니다. 클래스 이름 공간을 유일한 인자로 받아들이고 클래스 내용으로 이름 공간을 직접 갱신해야 합니다. 콜백이 제공되지 않으면,
lambda ns: ns
를 전달하는 것과 같은 효과가 있습니다.버전 3.3에 추가.
-
types.
prepare_class
(name, bases=(), kwds=None)¶ 적절한 메타 클래스를 계산하고 클래스 이름 공간을 만듭니다.
인자는 클래스 정의 헤더를 구성하는 요소들입니다: 클래스 이름, 베이스 클래스 (순서대로) 및 키워드 인자 (가령
metaclass
).반환 값은 3-튜플입니다:
metaclass, namespace, kwds
metaclass는 적절한 메타 클래스이고, namespace는 준비된 클래스 이름 공간이며 kwds는
'metaclass'
항목이 제거된 전달된 kwds 인자의 갱신된 사본입니다. kwds 인자가 전달되지 않으면, 빈 딕셔너리가 됩니다.버전 3.3에 추가.
버전 3.6에서 변경: 반환된 튜플의
namespace
요소의 기본값이 변경되었습니다. 이제 메타 클래스에__prepare__
메서드가 없으면 삽입 순서 보존 맵핑이 사용됩니다.
-
types.
resolve_bases
(bases)¶ PEP 560의 명세에 따라 MRO 항목을 동적으로 결정합니다.
이 함수는
type
의 인스턴스가 아닌 항목들을 bases에서 찾고,__mro_entries__
메서드가 있는 각 객체가 이 메서드 호출의 언패킹 된 결과로 대체된 튜플을 반환합니다. bases 항목이type
의 인스턴스이거나,__mro_entries__
메서드가 없으면, 반환 튜플에 변경되지 않은 상태로 포함됩니다.버전 3.7에 추가.
더 보기
PEP 560 - typing 모듈과 제네릭 형에 대한 코어 지원
표준 인터프리터 형¶
이 모듈은 파이썬 인터프리터를 구현하는 데 필요한 많은 형의 이름을 제공합니다. listiterator
형과 같이 처리 중에 우연히 발생하는 일부 형은 의도적으로 포함하지 않았습니다.
이러한 이름의 일반적인 용도는 isinstance()
나 issubclass()
검사입니다.
다음과 같은 형들에 대해 표준 이름이 정의됩니다:
-
types.
MethodType
¶ 사용자 정의 클래스 인스턴스의 메서드 형.
-
types.
BuiltinFunctionType
¶ -
types.
BuiltinMethodType
¶ len()
이나sys.exit()
와 같은 내장 함수와 내장 클래스의 메서드의 형. (여기서, “내장”이라는 용어는 “C로 작성된”을 의미합니다.)
-
types.
WrapperDescriptorType
¶ object.__init__()
나object.__lt__()
와 같은, 일부 내장 데이터형과 베이스 클래스의 메서드의 형.버전 3.7에 추가.
-
types.
MethodWrapperType
¶ 일부 내장 데이터형과 베이스 클래스의 연결된(bound) 메서드의 형. 예를 들어
object().__str__
의 형입니다.버전 3.7에 추가.
-
types.
MethodDescriptorType
¶ str.join()
과 같은 일부 내장 데이터형의 메서드의 형.버전 3.7에 추가.
-
types.
ClassMethodDescriptorType
¶ dict.__dict__['fromkeys']
와 같은 일부 내장 데이터형의 연결되지 않은(unbound) 클래스 메서드의 형.버전 3.7에 추가.
-
class
types.
ModuleType
(name, doc=None)¶ 모듈의 형. 생성자는 만들 모듈의 이름과 선택적으로 독스트링을 취합니다.
참고
다양한 임포트 제어 어트리뷰트를 설정하려면
importlib.util.module_from_spec()
을 사용하여 새 모듈을 만드십시오.-
__name__
¶ 모듈의 이름
-
-
class
types.
TracebackType
(tb_next, tb_frame, tb_lasti, tb_lineno)¶ sys.exc_info()[2]
에서 발견되는 것과 같은 트레이스백 객체의 형.사용 가능한 어트리뷰트와 연산에 대한 세부 사항 및 동적으로 트레이스백을 만드는 것에 대한 지침은 언어 레퍼런스를 참조하십시오.
-
types.
FrameType
¶ tb
가 트레이스백 객체일 때tb.tb_frame
에서 발견되는 것과 같은 프레임 객체의 형.사용 가능한 어트리뷰트와 연산에 대한 자세한 내용은 언어 레퍼런스를 참조하십시오.
-
types.
GetSetDescriptorType
¶ FrameType.f_locals
나array.array.typecode
와 같은,PyGetSetDef
가 있는 확장 모듈에서 정의된 객체의 형. 이 형은 객체 어트리뷰트에 대한 디스크립터로 사용됩니다.property
형과 같은 목적을 갖지만, 확장 모듈에 정의된 클래스에 사용됩니다.
-
types.
MemberDescriptorType
¶ datetime.timedelta.days
와 같은,PyMemberDef
가 있는 확장 모듈에서 정의된 객체의 형. 이 형은 표준 변환 함수를 사용하는 간단한 C 데이터 멤버의 디스크립터로 사용됩니다;property
형과 같은 목적을 갖지만, 확장 모듈에 정의된 클래스를 위한 것입니다.CPython implementation detail: 파이썬의 다른 구현에서, 이 형은
GetSetDescriptorType
과 같을 수 있습니다.
-
class
types.
MappingProxyType
(mapping)¶ 매핑의 읽기 전용 프락시. 매핑 항목에 대한 동적 뷰를 제공하는데, 매핑이 변경될 때 뷰가 이러한 변경 사항을 반영함을 의미합니다.
버전 3.3에 추가.
-
key in proxy
하부 매핑에 키 key가 있으면
True
를, 그렇지 않으면False
를 반환합니다.
-
proxy[key]
키 key를 사용하여 하부 매핑의 항목을 반환합니다. key가 하부 매핑에 없으면
KeyError
를 발생시킵니다.
-
iter(proxy)
하부 매핑의 키에 대한 이터레이터를 반환합니다. 이것은
iter(proxy.keys())
의 줄임 표현입니다.
-
len(proxy)
하부 매핑의 항목 수를 반환합니다.
-
copy
()¶ 하부 매핑의 얕은 사본을 반환합니다.
-
get
(key[, default])¶ key가 하부 매핑에 있으면 key의 값을, 그렇지 않으면 default를 반환합니다. default를 지정하지 않으면, 기본적으로
None
으로 설정되므로, 이 메서드는 절대KeyError
를 발생시키지 않습니다.
-
items
()¶ 하부 매핑의 항목(items)(
(key, value)
쌍)의 새 뷰를 반환합니다.
-
keys
()¶ 하부 매핑의 키(keys)의 새로운 뷰를 반환합니다.
-
values
()¶ 하부 매핑의 값(values)의 새 뷰를 반환합니다.
-
추가 유틸리티 클래스와 함수¶
-
class
types.
SimpleNamespace
¶ 이름 공간에 대한 어트리뷰트 액세스와 의미 있는 repr을 제공하는 간단한
object
서브 클래스.object
와 달리,SimpleNamespace
를 사용하면 어트리뷰트를 추가하고 제거할 수 있습니다.SimpleNamespace
객체가 키워드 인자로 초기화되면, 하부 이름 공간에 직접 추가됩니다.형은 다음 코드와 대략 동등합니다:
class SimpleNamespace: def __init__(self, **kwargs): self.__dict__.update(kwargs) def __repr__(self): keys = sorted(self.__dict__) items = ("{}={!r}".format(k, self.__dict__[k]) for k in keys) return "{}({})".format(type(self).__name__, ", ".join(items)) def __eq__(self, other): return self.__dict__ == other.__dict__
SimpleNamespace
는class NS: pass
의 대체품으로 유용할 수 있습니다. 하지만, 구조화된 레코드형에는namedtuple()
을 대신 사용하십시오.버전 3.3에 추가.
-
types.
DynamicClassAttribute
(fget=None, fset=None, fdel=None, doc=None)¶ 클래스의 어트리뷰트 액세스를 __getattr__ 로 보냅니다.
디스크립터이며, 인스턴스와 클래스를 통해 액세스할 때 다르게 작동하는 어트리뷰트를 정의하는 데 사용됩니다. 인스턴스 액세스는 정상적으로 유지되지만, 클래스를 통한 어트리뷰트 액세스는 클래스의 __getattr__ 메서드로 보냅니다; 이는 AttributeError를 발생 시켜 수행됩니다.
이를 통해 인스턴스에서 활성화된 프로퍼티를 가짐과 동시에, 클래스에서 같은 이름을 가진 가상 어트리뷰트를 가질 수 있습니다 (예제는 Enum을 참조하십시오).
버전 3.4에 추가.
코루틴 유틸리티 함수¶
-
types.
coroutine
(gen_func)¶ 이 함수는 제너레이터 함수를 제너레이터 기반 코루틴을 반환하는 코루틴 함수로 변환합니다. 제너레이터 기반 코루틴은 여전히 제너레이터 이터레이터이지만, 코루틴 객체로도 간주하며 어웨이터블입니다. 그러나, 반드시
__await__()
메서드를 구현할 필요는 없습니다.gen_func가 제너레이터 함수면 제자리(in-place)에서 수정됩니다.
gen_func가 제너레이터 함수가 아니면, 래핑 됩니다.
collections.abc.Generator
의 인스턴스를 반환하면, 인스턴스는 어웨이터블 프락시 객체로 래핑 됩니다. 다른 모든 형의 객체는 그대로 반환됩니다.버전 3.5에 추가.