Cara menentukan jenis pengembalian "nullable" dengan petunjuk jenis

Misalkan saya memiliki fungsi:

def get_some_date(some_argument: int=None) -> %datetime_or_None%:
    if some_argument is not None and some_argument == 1:
        return datetime.utcnow()
    else:
        return None

Bagaimana cara menentukan tipe pengembalian untuk sesuatu yang bisa None?

Anda sedang mencari Optional.

Karena jenis pengembalian Anda dapat datetime(dikembalikan dari datetime.utcnow()) atau NoneAnda harus menggunakan Optional[datetime]:

from typing import Optional

def get_some_date(some_argument: int=None) -> Optional[datetime]:
    # as defined

Dari dokumentasi tentang pengetikan, Optionaladalah singkatan untuk:

Optional[X]setara dengan Union[X, None].

di mana Union[X, Y]berarti nilai tipe Xatau Y.

Jika Anda ingin menjadi eksplisit karena kekhawatiran bahwa orang lain mungkin tersandung Optionaldan tidak menyadari artinya, Anda selalu dapat menggunakan Union:

from typing import Union

def get_some_date(some_argument: int=None) -> Union[datetime, None]:

Tapi saya ragu ini adalah ide yang bagus, Optionaladalah nama indikatif dan tidak menghemat beberapa penekanan tombol.

_{Seperti yang ditunjukkan dalam komentar oleh @ Michael0x2a Union[T, None]diubah Union[T, type(None)]jadi tidak perlu digunakan di typesini.}

Secara visual ini mungkin berbeda tetapi secara programatik, dalam kedua kasus, hasilnya persis sama ; Union[datetime.datetime, NoneType]akan menjadi tipe yang disimpan di get_some_date.__annotations__^* :

>>> from typing import get_type_hints
>>> print(get_type_hints(get_some_date))
{'return': typing.Union[datetime.datetime, NoneType],
 'some_argument': typing.Union[int, NoneType]}

^* Gunakan typing.get_type_hintsuntuk mengambil __annotations__atribut objek alih-alih mengaksesnya secara langsung.