Разница между определением typing.Dict и dict?

Я практикуюсь в использовании подсказок типов в Python 3.5. Один из моих коллег использует typing.Dict:

import typing


def change_bandwidths(new_bandwidths: typing.Dict,
                      user_id: int,
                      user_name: str) -> bool:
    print(new_bandwidths, user_id, user_name)
    return False


def my_change_bandwidths(new_bandwidths: dict,
                         user_id: int,
                         user_name: str) ->bool:
    print(new_bandwidths, user_id, user_name)
    return True


def main():
    my_id, my_name = 23, "Tiras"
    simple_dict = {"Hello": "Moon"}
    change_bandwidths(simple_dict, my_id, my_name)
    new_dict = {"new": "energy source"}
    my_change_bandwidths(new_dict, my_id, my_name)

if __name__ == "__main__":
    main()

Оба они работают нормально, разницы нет.

Я прочитал typingдокументацию к модулю .

Между typing.Dictили dictкакой из них использовать в программе?

Нет никакой реальной разницы между использованием простого typing.Dictи dict, нет.

Тем не менее, typing.Dictэто тип Generic , который позволяет указать тип ключей и значений тоже , что делает его более гибким:

def change_bandwidths(new_bandwidths: typing.Dict[str, str],
                      user_id: int,
                      user_name: str) -> bool:

Таким образом, вполне может быть, что в какой-то момент жизненного цикла вашего проекта вы захотите более точно определить аргумент словаря, и в этот момент расширение typing.Dictдо typing.Dict[key_type, value_type]будет «меньшим» изменением, чем замена dict.

Вы можете сделать это еще более универсальным, используя здесь типы Mappingили MutableMapping; поскольку вашей функции не нужно изменять отображение, я бы придерживался Mapping. A dict- это одно отображение, но вы можете создать другие объекты, которые также удовлетворяют интерфейсу сопоставления, и ваша функция вполне может работать с ними:

def change_bandwidths(new_bandwidths: typing.Mapping[str, str],
                      user_id: int,
                      user_name: str) -> bool:

Теперь вы четко рассказать другим пользователям этой функции , что ваш код не будет фактически изменяющие на new_bandwidthsотображение передается в.

Ваша фактическая реализация просто ожидает объект, который можно распечатать. Это может быть тестовая реализация, но в ее нынешнем виде ваш код продолжал бы работать, если бы вы использовали его new_bandwidths: typing.Any, потому что любой объект в Python можно распечатать.

typing.Dictэто общая версия dict:

class typing.Dict(dict, MutableMapping[KT, VT])

Общая версия dict. Использование этого типа следующее:

def get_position_in_index(word_list: Dict[str, int], word: str) -> int:
     return word_list[word]

Здесь вы можете указать тип ключа и значений в dict: Dict[str, int]