ความแตกต่างระหว่างการกำหนดการพิมพ์ 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 สามารถพิมพ์ได้

^* : หมายเหตุ: หากคุณใช้ Python 3.7 หรือใหม่กว่าคุณสามารถใช้dictเป็นประเภททั่วไปได้หากคุณเริ่มต้นโมดูลด้วยfrom __future__ import annotationsPython 3.9 dict(รวมถึงคอนเทนเนอร์มาตรฐานอื่น ๆ ) รองรับการใช้เป็นประเภททั่วไปแม้ว่าจะไม่มีก็ตาม คำสั่ง

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]