CKTIS / Python
typing.TypeGuard
Anota um predicado booleano cujo sucesso restringe o tipo estático do primeiro argumento posicional mesmo para listas invariantes.
Versão: Python 3.14; repository image, production runtime not attested
Sintaxe
def is_names(value: list[object]) -> TypeGuard[list[str]]: ...Anota um predicado booleano cujo sucesso restringe o tipo estático do primeiro argumento posicional mesmo para listas invariantes.
Um resultado falso não determina um tipo complementar e o Python não valida a promessa.
A verificação de todos os elementos também aceita a lista vazia.
Exemplos
from typing import TypeGuard
def is_names(value: list[object]) -> TypeGuard[list[str]]:
return all(isinstance(x, str) for x in value)
def join(values: list[object]) -> str:
return ",".join(values) if is_names(values) else "mixed"
print(repr(join([])), join(["x", "y"]), join(["x", 2]))
Resultado
'' x,y mixed
A verificação de todos os elementos também aceita a lista vazia.