Python Type Hints
Python เป็นภาษาที่ไม่บังคับชนิดข้อมูล (dynamic typing) ตัวแปรหนึ่งเก็บ int แล้วเปลี่ยนไปเก็บ string ก็ได้ ความยืดหยุ่นนี้ดีตอนเขียนเร็ว ๆ แต่พอโปรเจกต์ใหญ่ขึ้นจะเริ่มมีบั๊กแบบ “ส่งค่าผิดชนิดเข้าฟังก์ชัน” Type hints คือการเขียนบอกว่าตัวแปร/พารามิเตอร์ควรเป็นชนิดอะไร
Type hints ไม่ได้บังคับตอนรัน
จุดสำคัญที่ต้องเข้าใจก่อน: Python ไม่ตรวจ type hints ตอนรันโปรแกรม มันเป็นแค่คำอธิบาย
def greet(name: str) -> str:
return "สวัสดี " + name
print(greet(123)) # ยังรัน! แล้ว error ตอน + เพราะ 123 ไม่ใช่ strประโยชน์มาจาก เครื่องมือ — editor (VS Code, PyCharm) เตือนตอนพิมพ์ และ type checker อย่าง mypy ตรวจทั้งโปรเจกต์ก่อนรัน
พื้นฐาน: พารามิเตอร์และค่าคืน
def add(a: int, b: int) -> int:
return a + b
def full_name(first: str, last: str) -> str:
return f"{first} {last}"
def is_adult(age: int) -> bool:
return age >= 18
def log(message: str) -> None: # None = ไม่คืนค่า
print(message)-> ตามด้วยชนิดของค่าที่ฟังก์ชันคืน
ตัวแปร
count: int = 0
name: str = "สมชาย"
price: float = 45.0
active: bool = Trueส่วนใหญ่ไม่จำเป็น เพราะ editor เดาชนิดจากค่าได้อยู่แล้ว ใส่เมื่อค่าเริ่มต้นไม่ชัดเจน
คอลเลกชัน
Python 3.9+ ใช้ชนิด built-in ได้เลย
names: list[str] = ["สมชาย", "สมหญิง"]
scores: dict[str, int] = {"สมชาย": 85}
point: tuple[int, int] = (3, 4)
tags: set[str] = {"python", "tutorial"}
def average(numbers: list[float]) -> float:
return sum(numbers) / len(numbers)
def count_words(text: str) -> dict[str, int]:
result: dict[str, int] = {}
for word in text.split():
result[word] = result.get(word, 0) + 1
return resultOptional และ None
ถ้าค่าอาจเป็น None ได้ ใช้ | None (Python 3.10+)
def find_user(user_id: int) -> str | None:
users = {1: "สมชาย", 2: "สมหญิง"}
return users.get(user_id) # อาจได้ None
result = find_user(5)
if result is not None:
print(result.upper()) # editor รู้ว่าตรงนี้เป็น str แน่พารามิเตอร์ที่มี default เป็น None
def create_post(title: str, tags: list[str] | None = None) -> dict:
if tags is None:
tags = []
return {"title": title, "tags": tags}Union: หลายชนิดที่ยอมรับได้
def to_int(value: int | str) -> int:
return int(value)
print(to_int(5)) # 5
print(to_int("10")) # 10typing: เครื่องมือเพิ่มเติม
from typing import Callable, Any
# ฟังก์ชันที่รับฟังก์ชันมาเป็นพารามิเตอร์
def apply_twice(func: Callable[[int], int], value: int) -> int:
return func(func(value))
print(apply_twice(lambda x: x + 3, 10)) # 16
# Any = ชนิดอะไรก็ได้ (ใช้เท่าที่จำเป็น มันปิดการตรวจ)
def process(data: Any) -> None:
...Type alias: ตั้งชื่อชนิดที่ซับซ้อน
Matrix = list[list[float]]
UserId = int
def transpose(m: Matrix) -> Matrix:
return [list(row) for row in zip(*m)]กับ dataclass
type hints เป็นส่วนบังคับของ dataclass อยู่แล้ว
from dataclasses import dataclass
@dataclass
class Product:
name: str
price: float
stock: int = 0ตรวจด้วย mypy
สองคำสั่งนี้พิมพ์ใน เทอร์มินัล ไม่ใช่ใน Python shell
pip install mypy
mypy myscript.pyตัวอย่างโค้ดที่ mypy จับได้
def greet(name: str) -> str:
return "สวัสดี " + name
greet(123)error: Argument 1 to "greet" has incompatible type "int"; expected "str"รันครั้งเดียวเจอบั๊กชนิดผิดทั้งโปรเจกต์ โดยไม่ต้องรันโปรแกรมจริง
ควรใส่แค่ไหน
- ใส่: พารามิเตอร์และค่าคืนของฟังก์ชันที่คนอื่นเรียกใช้, dataclass, โค้ดที่อยู่นาน
- ไม่จำเป็น: ตัวแปรท้องถิ่นที่ค่าชัดเจน, สคริปต์สั้น ๆ ใช้ครั้งเดียว
- อย่าฝืนใส่จนโค้ดรก ถ้าชนิดซับซ้อนเกินอธิบาย อาจเป็นสัญญาณว่าควรออกแบบใหม่
เช็คความเข้าใจก่อนข้ามบท
- ใส่ type hint ให้ parameter และค่าที่ return ได้
- เข้าใจว่า type hints ช่วยเครื่องมือและคนอ่าน แต่ไม่บังคับชนิดตอนรันตามปกติ
- ลองเพิ่ม type hints ให้ฟังก์ชันในโปรเจกต์ก่อนหน้า แล้วรัน mypy ถ้ามีติดตั้ง
สรุป
- Type hints เป็นคำอธิบาย ไม่บังคับตอนรัน แต่ editor และ
mypyใช้จับบั๊ก def f(x: int) -> str:ระบุชนิดพารามิเตอร์และค่าคืนlist[str],dict[str, int]สำหรับคอลเลกชัน;X | Noneสำหรับค่าที่อาจเป็น None- ใส่ที่ขอบเขต (ฟังก์ชัน public, dataclass) เป็นหลัก
บทถัดไปว่าด้วยมาตรฐานการเขียนโค้ด PEP 8