CKTIS / Python
O literal `...` (`Ellipsis`) nos métodos de protocolo
Em Python 3.12, `...` é um literal que representa o objeto `Ellipsis`. No corpo de um método de protocolo, indica que não há implementação, mas não devolve esse objeto.
Versão: Python 3.12
Sintaxe
...
from typing import Protocol
class Reader(Protocol):
def read(self) -> int:
...Os três pontos consecutivos ... formam um elemento da sintaxe de Python, não uma marca editorial de código omitido. O literal é avaliado como a única instância de types.EllipsisType, também acessível através do nome incorporado Ellipsis. O operador is permite verificar que se trata do mesmo objeto.
Quando ... é a única instrução no corpo de uma função normal, é uma expressão usada como instrução: o seu valor não é devolvido. Ao chegar ao fim do corpo, a função devolve None, tal como faria apenas com pass. Contudo, pass é uma instrução, não uma expressão. Já return ... devolve explicitamente Ellipsis.
Numa classe baseada em typing.Protocol, um corpo que contém apenas ... indica que o método define um requisito da interface, em vez de fornecer uma implementação por omissão que possa ser usada. Um verificador estático de tipos pode aceitar uma classe com uma assinatura de método compatível, mesmo que não herde do protocolo. O literal, por si só, não aplica @abstractmethod nem desencadeia verificações de assinaturas em tempo de execução.
Exemplos
from typing import Protocol
class Reader(Protocol):
def read(self) -> int:
...
class FixedReader:
def read(self) -> int:
return 7
def read_value(reader: Reader) -> int:
return reader.read()
def placeholder() -> None:
...
print((...) is Ellipsis)
print(placeholder() is None)
print(read_value(FixedReader()))
Resultado
True True 7
O primeiro `True` confirma a identidade com `Ellipsis`; o segundo mostra que `placeholder()` devolve `None`. O `7` vem de `FixedReader.read()`, não do corpo do método do protocolo.
Lições relacionadas
- Python · Lição 22 · Avançado · Versão: 5