`types` — 동적 형 생성과 내장형 이름¶

소스 코드: Lib/types.py

이 모듈은 새로운 형의 동적 생성을 지원하는 유틸리티 함수를 정의합니다.

표준 파이썬 인터프리터가 사용하지만, int나 str처럼 내장으로 노출되지 않는 일부 객체 형의 이름도 정의합니다.

마지막으로, 내장되기에 충분히 기본적이지 않은 몇 가지 추가 형 관련 유틸리티 클래스와 함수를 제공합니다.

동적 형 생성¶

types.new_class(name, bases=(), kwds=None, exec_body=None)¶

적절한 메타 클래스를 사용하여 동적으로 클래스 객체를 만듭니다.

처음 세 개의 인자는 클래스 정의 헤더를 구성하는 요소들입니다: 클래스 이름, 베이스 클래스 (순서대로), 키워드 인자 (가령 metaclass).

exec_body 인자는 새로 만들어진 클래스 이름 공간을 채우는 데 사용되는 콜백입니다. 클래스 이름 공간을 유일한 인자로 받아들이고 클래스 내용으로 이름 공간을 직접 갱신해야 합니다. 콜백이 제공되지 않으면, lambda ns: None를 전달하는 것과 같은 효과가 있습니다.

Added in version 3.3.

types.prepare_class(name, bases=(), kwds=None)¶

적절한 메타 클래스를 계산하고 클래스 이름 공간을 만듭니다.

인자는 클래스 정의 헤더를 구성하는 요소들입니다: 클래스 이름, 베이스 클래스 (순서대로) 및 키워드 인자 (가령 metaclass).

반환 값은 3-튜플입니다: metaclass, namespace, kwds

metaclass는 적절한 메타 클래스이고, namespace는 준비된 클래스 이름 공간이며 kwds는 'metaclass' 항목이 제거된 전달된 kwds 인자의 갱신된 사본입니다. kwds 인자가 전달되지 않으면, 빈 딕셔너리가 됩니다.

Added in version 3.3.

버전 3.6에서 변경: 반환된 튜플의 namespace 요소의 기본값이 변경되었습니다. 이제 메타 클래스에 __prepare__ 메서드가 없으면 삽입 순서 보존 맵핑이 사용됩니다.

메타 클래스: 이 함수들이 지원하는 클래스 생성 절차에 대한 자세한 내용
PEP 3115 - 파이썬 3000의 메타 클래스: __prepare__ 이름 공간 훅을 도입했습니다

types.resolve_bases(bases)¶

PEP 560의 명세에 따라 MRO 항목을 동적으로 결정합니다.

이 함수는 type의 인스턴스가 아닌 항목들을 bases에서 찾고, __mro_entries__() 메서드가 있는 각 객체가 이 메서드 호출의 언 패킹 된 결과로 대체된 튜플을 반환합니다. bases 항목이 type의 인스턴스이거나, __mro_entries__() 메서드가 없으면, 반환 튜플에 변경되지 않은 상태로 포함됩니다.

Added in version 3.7.

types.get_original_bases(cls, /)¶

PEP 560 에 설명된 메커니즘을 따라, cls 의 __mro_entries__() 메서드가 호출되기 전에 원래 베이스로 주어진 객체들의 튜플을 반환합니다. 이는 Generics 을 인트로스펙션하는 데 유용합니다.

__orig_bases__ 속성이 있는 클래스의 경우, 이 함수는 cls.__orig_bases__``의 값을 반환합니다. ``__orig_bases__ 속성이 없는 클래스의 경우, :attr:`cls.__bases__ <type.__bases__>`를 반환합니다.

예제:

from typing import TypeVar, Generic, NamedTuple, TypedDict

T = TypeVar("T")
class Foo(Generic[T]): ...
class Bar(Foo[int], float): ...
class Baz(list[str]): ...
Eggs = NamedTuple("Eggs", [("a", int), ("b", str)])
Spam = TypedDict("Spam", {"a": int, "b": str})

assert Bar.__bases__ == (Foo, float)
assert get_original_bases(Bar) == (Foo[int], float)

assert Baz.__bases__ == (list,)
assert get_original_bases(Baz) == (list[str],)

assert Eggs.__bases__ == (tuple,)
assert get_original_bases(Eggs) == (NamedTuple,)

assert Spam.__bases__ == (dict,)
assert get_original_bases(Spam) == (TypedDict,)

assert int.__bases__ == (object,)
assert get_original_bases(int) == (object,)

Added in version 3.12.

PEP 560 - typing 모듈과 제네릭 형에 대한 코어 지원

표준 인터프리터 형¶

이 모듈은 파이썬 인터프리터를 구현하는 데 필요한 많은 형의 이름을 제공합니다. listiterator 형과 같이 처리 중에 우연히 발생하는 일부 형은 의도적으로 포함하지 않았습니다.

이러한 이름의 일반적인 용도는 isinstance()나 issubclass() 검사입니다.

이러한 형을 인스턴스 화할 때는 서명이 파이썬 버전마다 다를 수 있음에 유의해야 합니다.

다음과 같은 형들에 대해 표준 이름이 정의됩니다:

class types.NoneType¶: :data:`None`의 타입입니다.

Added in version 3.10.

class types.FunctionType¶

class types.LambdaType¶

사용자 정의 함수와 lambda 표현식이 만든 함수의 형.

인자 code로 감사 이벤트 function.__new__를 발생시킵니다.

감사 이벤트는 함수 객체의 직접 인스턴스 화에서만 발생하며, 일반 컴파일에서는 발생하지 않습니다.

class types.GeneratorType¶: 제너레이터 함수가 만든, 제너레이터-이터레이터 객체의 형.

class types.CoroutineType¶: async def 함수가 만든 코루틴 객체의 형.

Added in version 3.5.

class types.AsyncGeneratorType¶: 비동기 제너레이터 함수가 만든, 비동기 제너레이터-이터레이터 객체의 형.

Added in version 3.6.

class types.CodeType(**kwargs)¶

compile()이 반환하는 것과 같은 코드 객체의 형.

인자 code, filename, name, argcount, posonlyargcount, kwonlyargcount, nlocals, stacksize, flags로 감사 이벤트 code.__new__를 발생시킵니다.

감사된 인자는 초기화자가 요구하는 이름이나 위치와 일치하지 않을 수 있음에 유의하십시오. 감사 이벤트는 코드 객체의 직접 인스턴스 화에서만 발생하며, 일반 컴파일에서는 발생하지 않습니다.

class types.CellType¶: 셀 객체의 형: 이러한 객체는 함수의 클로저 변수에 대한 컨테이너로 사용됩니다.

Added in version 3.8.

class types.MethodType¶: 사용자 정의 클래스 인스턴스의 메서드 형.

class types.BuiltinFunctionType¶
class types.BuiltinMethodType¶: len()이나 sys.exit() 와 같은 내장 함수와 내장 클래스의 메서드의 형. (여기서, “내장”이라는 용어는 “C로 작성된”을 의미합니다.)

class types.WrapperDescriptorType¶: object.__init__()나 object.__lt__()와 같은, 일부 내장 데이터형과 베이스 클래스의 메서드의 형.

Added in version 3.7.

class types.MethodWrapperType¶: 일부 내장 데이터형과 베이스 클래스의 연결된(bound) 메서드의 형. 예를 들어 object().__str__의 형입니다.

Added in version 3.7.

class types.NotImplementedType¶: :data:`NotImplemented`의 타입입니다.

Added in version 3.10.

class types.MethodDescriptorType¶: str.join()과 같은 일부 내장 데이터형의 메서드의 형.

Added in version 3.7.

class types.ClassMethodDescriptorType¶: dict.__dict__['fromkeys']와 같은 일부 내장 데이터형의 연결되지 않은(unbound) 클래스 메서드의 형.

Added in version 3.7.

class types.ModuleType(name, doc=None)¶

모듈의 형. 생성자는 만들 모듈의 이름과 선택적으로 독스트링을 취합니다.

:ref:`module objects <module-objects>`에 대한 문서를 참조하십시오.: ModuleType 인스턴스에서 찾을 수 있는 특수 속성에 대한 세부 정보를 제공합니다.
importlib.util.module_from_spec(): ModuleType 생성자를 사용하여 만든 모듈은 많은 특수 속성이 설정되지 않았거나 기본값으로 설정됩니다. module_from_spec`은 다양한 속성이 적절하게 설정되도록 보장하는, `:class:()!ModuleType` 인스턴스를 생성하는 보다 견고한 방법을 제공합니다.

class types.EllipsisType¶: :data:`Ellipsis`의 타입입니다.

Added in version 3.10.

class types.GenericAlias(t_origin, t_args)¶

list[int]와 같은 매개 변수화된 제네릭의 형입니다.

t_origin은 list, tuple 또는 dict와 같이 매개 변수화되지 않은 제네릭 클래스여야 합니다. t_args는 t_origin을 매개 변수화하는 형의 tuple(길이 1일 수 있습니다)이어야 합니다:

>>> from types import GenericAlias

>>> list[int] == GenericAlias(list, (int,))
True
>>> dict[str, int] == GenericAlias(dict, (str, int))
True

Added in version 3.9.

버전 3.9.2에서 변경: 이 형은 이제 서브 클래싱 할 수 있습니다.

Generic Alias Types: types.GenericAlias 인스턴스에 대한 상세 문서를 참조하십시오.
PEP 585 - 표준 컬렉션의 형 힌트 제네릭: types.GenericAlias 클래스 소개

class types.UnionType¶: :ref:`union type expressions <types-union>`의 타입입니다.

Added in version 3.10.

버전 3.14에서 변경: 이것은 이제 :class:`typing.Union`의 별칭입니다.

class types.TracebackType(tb_next, tb_frame, tb_lasti, tb_lineno)¶

sys.exception().__traceback__에서 발견되는 것과 같은 트레이스백 객체의 형.

사용 가능한 어트리뷰트와 연산에 대한 세부 사항 및 동적으로 트레이스백을 만드는 것에 대한 지침은 언어 레퍼런스를 참조하십시오.

class types.FrameType¶: tb가 트레이스백 객체일 때 tb.tb_frame에서 발견되는 것과 같은 프레임 객체의 형.

class types.FrameLocalsProxyType¶: frame.f_locals 속성에서 발견되는 프레임 로컬 프록시 객체의 타입입니다.

Added in version 3.15.

더 보기

PEP 667

class types.LazyImportType¶: 지연 로딩 프록시 객체의 타입입니다. 이 객체들은 모듈이 지연하여 임포트될 때 생성되며, 모듈에 실제로 접근할 때까지 자리 표시자 역할을 합니다. 이 타입은 지연 임포트를 프로그래밍 방식으로 감지하는 데 사용될 수 있습니다.

Added in version 3.15.

더 보기

PEP 810

class types.GetSetDescriptorType¶: FrameType.f_locals나 array.array.typecode와 같은, PyGetSetDef가 있는 확장 모듈에서 정의된 객체의 형. 이 형은 객체 어트리뷰트에 대한 디스크립터로 사용됩니다. property 형과 같은 목적을 갖지만, 확장 모듈에 정의된 클래스에 사용됩니다.

class types.MemberDescriptorType¶

datetime.timedelta.days와 같은, PyMemberDef가 있는 확장 모듈에서 정의된 객체의 형. 이 형은 표준 변환 함수를 사용하는 간단한 C 데이터 멤버의 디스크립터로 사용됩니다; property 형과 같은 목적을 갖지만, 확장 모듈에 정의된 클래스를 위한 것입니다.

또한, 클래스가 __slots__ 속성과 함께 정의되면, 각 슬롯에 대해 :class:!MemberDescriptorType` 인스턴스가 클래스의 속성으로 추가됩니다. 이렇게 하여 슬롯이 클래스의 :attr:`~type.__dict__`에 표시되도록 합니다.

파이썬의 다른 구현에서, 이 형은 GetSetDescriptorType과 같을 수 있습니다.

class types.MappingProxyType(mapping)¶

매핑의 읽기 전용 프락시. 매핑 항목에 대한 동적 뷰를 제공하는데, 매핑이 변경될 때 뷰가 이러한 변경 사항을 반영함을 의미합니다.

MappingProxyType\s는 두 가지 타입을 다루는 :ref:`generic <generics>`이며, 이는 (각각) 하부 매핑의 키와 값의 타입을 나타냅니다.

Added in version 3.3.

버전 3.9에서 변경: PEP 584의 새 병합 (|) 연산자를 지원하도록 갱신되었습니다. 단순히 하부 매핑에 위임합니다.

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)의 새 뷰를 반환합니다.

reversed(proxy): 하부 매핑의 키(keys)에 대한 역 이터레이터를 반환합니다.

Added in version 3.9.

hash(proxy): 하부 매핑의 해시를 반환합니다.

Added in version 3.12.

class types.CapsuleType¶: :ref:`capsule objects <capsules>`의 타입입니다.

Added in version 3.13.

추가 유틸리티 클래스와 함수¶

class types.SimpleNamespace¶

이름 공간에 대한 어트리뷰트 액세스와 의미 있는 repr을 제공하는 간단한 object 서브 클래스.

object`와 달리, :class:!SimpleNamespace`를 사용하면 속성을 추가하고 제거할 수 있습니다.

SimpleNamespace 객체는 dict`와 동일한 방식으로 초기화될 수 있습니다. 키워드 인자로, 단일 위치 인자로, 또는 둘 모두로 초기화할 수 있습니다. 키워드 인자로 초기화된 속성들은 하부 네임스페이스에 직접 추가됩니다. 또는 위치 인자로 초기화된 경우, 하부 네임스페이스는 해당 인자(매핑 객체 또는 키/값 쌍을 생성하는 :term:`iterable 객체)의 키-값 쌍으로 업데이트됩니다. 모든 키는 문자열이어야 합니다.

형은 다음 코드와 대략 동등합니다:

class SimpleNamespace:
    def __init__(self, mapping_or_iterable=(), /, **kwargs):
        self.__dict__.update(mapping_or_iterable)
        self.__dict__.update(kwargs)

    def __repr__(self):
        items = (f"{k}={v!r}" for k, v in self.__dict__.items())
        return "{}({})".format(type(self).__name__, ", ".join(items))

    def __eq__(self, other):
        if isinstance(self, SimpleNamespace) and isinstance(other, SimpleNamespace):
           return self.__dict__ == other.__dict__
        return NotImplemented

SimpleNamespace는 class NS: pass의 대체품으로 유용할 수 있습니다. 하지만, 구조화된 레코드형에는 namedtuple()을 대신 사용하십시오.

SimpleNamespace 객체는 :func:`copy.replace`에 의해 지원됩니다.

Added in version 3.3.

버전 3.9에서 변경: repr의 어트리뷰트 순서가 알파벳순에서 삽입 순으로 변경되었습니다 (dict처럼).

버전 3.13에서 변경: 선택적 위치 인자에 대한 지원이 추가되었습니다.

types.DynamicClassAttribute(fget=None, fset=None, fdel=None, doc=None)¶

클래스의 어트리뷰트 액세스를 __getattr__ 로 보냅니다.

디스크립터이며, 인스턴스와 클래스를 통해 액세스할 때 다르게 작동하는 어트리뷰트를 정의하는 데 사용됩니다. 인스턴스 액세스는 정상적으로 유지되지만, 클래스를 통한 어트리뷰트 액세스는 클래스의 __getattr__ 메서드로 보냅니다; 이는 AttributeError를 발생 시켜 수행됩니다.

이를 통해 인스턴스에서 활성화된 프로퍼티를 가짐과 동시에, 클래스에서 같은 이름을 가진 가상 어트리뷰트를 가질 수 있습니다 (예제는 enum.Enum을 참조하십시오).

Added in version 3.4.

코루틴 유틸리티 함수¶

types.coroutine(gen_func)¶

이 함수는 제너레이터 함수를 제너레이터 기반 코루틴을 반환하는 코루틴 함수로 변환합니다. 제너레이터 기반 코루틴은 여전히 제너레이터 이터레이터이지만, 코루틴 객체로도 간주하며 어웨이터블입니다. 그러나, 반드시 __await__() 메서드를 구현할 필요는 없습니다.

gen_func가 제너레이터 함수면 제자리(in-place)에서 수정됩니다.

gen_func가 제너레이터 함수가 아니면, 래핑 됩니다. collections.abc.Generator의 인스턴스를 반환하면, 인스턴스는 어웨이터블 프락시 객체로 래핑 됩니다. 다른 모든 형의 객체는 그대로 반환됩니다.

Added in version 3.5.

types — 동적 형 생성과 내장형 이름¶

동적 형 생성¶

표준 인터프리터 형¶

추가 유틸리티 클래스와 함수¶

코루틴 유틸리티 함수¶

분실물 보관소

`types` — 동적 형 생성과 내장형 이름¶