"Nullable" dönüş türünü tür ipuçlarıyla belirleme

Bir fonksiyonum olduğunu varsayalım:

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

Olabilecek bir şey için dönüş türünü nasıl belirleyebilirim None?

Arıyorsunuz Optional.

İade türünüz olabileceğinden datetime(iade edildiği gibi datetime.utcnow()) veya Noneşunları kullanmanız gerekir Optional[datetime]:

from typing import Optional

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

Yazma ile ilgili belgelere göre Optionalkısayol:

Optional[X]eşittir Union[X, None].

burada Union[X, Y]türde bir değer anlamına gelir Xya da Y.

Başkalarının tökezleyebileceği Optionalve bunun anlamının farkında olamayacağı endişeleri nedeniyle açık olmak istiyorsanız, her zaman şunları kullanabilirsiniz Union:

from typing import Union

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

Ama bunun iyi bir fikir olduğunu, Optionalgösterge edici bir isim olduğunu ve birkaç tuş vuruşunu kurtardığını sanıyorum .

_{@ Michael0x2a tarafından yapılan yorumlarda belirtildiği gibi burada kullanılmaya gerek olmadığı Union[T, None]için transforme edilmiştir .Union[T, type(None)]type}

Görsel olarak bunlar farklı olabilir, ancak programlı olarak, her iki durumda da sonuç tamamen aynıdır ; ^*Union[datetime.datetime, NoneType] içinde saklanan tip olacaktır :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]}

^* Kullanım typing.get_type_hintsnesnelerin kapmak için __annotations__doğrudan erişmek yerine niteliğini.