Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Python

Anotações de referências futuras entre aspas

Uma anotação como "Node" descreve um tipo através de um nome armazenado como texto, mesmo que a classe seja definida mais tarde. O Python 3.14 adia a avaliação das anotações por predefinição, pelo que as aspas muitas vezes já não são necessárias, mas continuam a ser sintaxe válida.

Versão: Python 3.14; repository image, production runtime not attested

Sintaxe

def f(value: "LaterType") -> "LaterType": ...

As anotações de referências futuras entre aspas (quoted forward-reference annotations) usam um literal de cadeia de caracteres como indicação de tipo, por exemplo, node: "Node" ou -> "Node". Permitem referenciar uma classe definida mais tarde, incluindo uma classe que se referencia a si própria. Não significam que o valor esperado seja do tipo str.

No Python 3.14, a avaliação das anotações é adiada por predefinição, pelo que, neste tipo de referência, normalmente também basta escrever Node sem aspas. A forma explícita "Node" continua a ser válida. Isto é diferente de from __future__ import annotations, que faz com que as anotações sejam armazenadas como cadeias de caracteres. Por si só, as indicações de tipo não impõem os tipos dos argumentos durante a execução.

typing.get_type_hints() resolve as referências textuais para tipos efetivos. Chame esta função apenas quando os nomes necessários estiverem disponíveis nos espaços de nomes adequados; um nome por resolver pode causar um NameError. A função pode executar código incluído nas anotações, por isso não a utilize com anotações não fidedignas.

No exemplo, identity aparece antes da definição de Node, mas as indicações de tipo são consultadas depois. Os dois resultados True mostram a resolução esperada de ambas as anotações para a classe Node, e a última linha mostra o nome da classe do objeto devolvido.

Exemplos

from typing import get_type_hints


def identity(node: "Node") -> "Node":
    return node


class Node:
    pass


hints = get_type_hints(identity)
print(hints["node"] is Node)
print(hints["return"] is Node)
print(identity(Node()).__class__.__name__)

Resultado

True
True
Node

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes