Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Python

Il letterale `...` (`Ellipsis`) nei metodi di un protocollo

In Python 3.12, `...` è un letterale che rappresenta l’oggetto `Ellipsis`. Nel corpo di un metodo di protocollo segnala l’assenza di un’implementazione, ma non restituisce quell’oggetto.

Versione: Python 3.12

Sintassi

...

from typing import Protocol

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

I tre punti consecutivi ... sono un elemento della sintassi di Python, non un segno editoriale che indica codice omesso. Il letterale produce l’unica istanza di types.EllipsisType, accessibile anche tramite il nome predefinito Ellipsis. L’operatore is permette di verificare che si tratti dello stesso oggetto.

Se ... è l’unica istruzione nel corpo di una normale funzione, è un’espressione usata come istruzione: il suo valore non viene restituito. Quando si raggiunge la fine del corpo, la funzione restituisce None, come con il solo pass. Tuttavia, pass è un’istruzione, non un’espressione. Invece, return ... restituisce esplicitamente Ellipsis.

In una classe basata su typing.Protocol, un corpo costituito da ... indica che il metodo specifica un requisito dell’interfaccia anziché fornire un’implementazione predefinita utilizzabile. Un verificatore statico dei tipi può accettare una classe con una firma del metodo compatibile anche se non eredita dal protocollo. Il letterale di per sé non applica @abstractmethod né avvia controlli sulle firme durante l’esecuzione.

Esempi

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()))

Risultato

True
True
7

Il primo `True` conferma l’identità con `Ellipsis`; il secondo mostra che `placeholder()` restituisce `None`. Il `7` proviene da `FixedReader.read()`, non dal corpo del metodo di protocollo.

Lezioni correlate

  • Python · Lezione 22 · Avanzato · Versione: 5

Fonti