Pythonの型ヒント(型アノテーション)のすすめ

def calculate_total(items):
    # itemsがリストかどうか分からない
    # 各要素が数値かどうかも分からない
    return sum(items)

# 実行してみると...
result = calculate_total(["100", "200", "300"])  # 文字列のリスト
print(result)  # "100200300" 文字列が結合される

def calculate_total(items: list[int]) -> int:
    # 型ヒントにより、itemsは整数のリストであることが明確に
    return sum(items)

# mypyが実行前にエラーを検出
result = calculate_total(["100", "200", "300"])  # エラー: 文字列のリストは整数のリストではない

# 型ヒントなし
def process_user(user):
    return user.get("name")  # userが辞書かどうか分からない

# 型ヒントあり
def process_user(user: dict[str, str]) -> str:
    return user["name"]  # 型が明確なので安全にアクセスできる

# 型ヒントなし
def get_user_name(user_id):
    if user_id < 0:
        return None
    return f"User{user_id}"

name = get_user_name(-1)
print(name.upper())  # Noneはupperメソッドを持たないのでエラー

# 型ヒントあり
from typing import Optional

def get_user_name(user_id: int) -> Optional[str]:   # Optional[str]はstr型かNone型のどちらかを取ることを示す
    if user_id < 0:
        return None
    return f"User{user_id}"

name = get_user_name(-1)
if name is not None:
    print(name.upper())

name: str = "Python"
age: int = 25
height: float = 175.5
is_student: bool = True
array: list[int] = [1, 2, 3]
dict_map: dict[str, int] = {"a": 1, "b": 2, "c": 3}