База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Python

Типови анотации и протоколи

Анотация може да опише интерфейса за статична проверка без изискване за общ базов клас.

Версия: Python 3.14; repository image, production runtime not attested

Синтаксис

class Reader(Protocol):
    def read(self) -> str: ...

Анотация може да опише интерфейса за статична проверка без изискване за общ базов клас.

Protocol описва структурно методите и сигнатурите им. Извикването не налага анотациите. runtime_checkable позволява на isinstance да провери наличието на членове без проверка на параметри или тип на резултата.

Message дава READY. NeedsKey има read и преминава проверката, въпреки че извикване без аргумент предизвиква TypeError.

from typing import Protocol,runtime_checkable,get_type_hints
@runtime_checkable
class Reader(Protocol):
    def read(self)->str: ...
class Bad:
    def read(self, extra): return extra
def display(source:Reader): return source.read()
assert get_type_hints(display)['source'] is Reader
assert isinstance(Bad(),Reader)
try: display(Bad())
except TypeError: pass
else: raise AssertionError

Примери

from typing import Protocol, runtime_checkable

@runtime_checkable
class Reader(Protocol):
    def read(self) -> str: ...

class Message:
    def read(self) -> str:
        return "ready"

class NeedsKey:
    def read(self, key):
        return key

def display(source: Reader):
    return source.read().upper()

print(display(Message()), isinstance(NeedsKey(), Reader))

Резултат

READY True

Message дава READY. NeedsKey има read и преминава проверката, въпреки че извикване без аргумент предизвиква TypeError.

Източници