Bagaimana type hint berfungsi dan apakah manfaatnya?

Question

Accepted Answer

**Type hint** (PEP 484+) membolehkan anda menganotasikan jenis yang dijangka bagi pemboleh ubah, parameter fungsi, dan nilai pulangan. Ia bersifat **pilihan** dan **tidak dikuatkuasakan semasa runtime** — Python mengabaikannya semasa larian — tetapi ia membolehkan analisis statik, peralatan yang lebih baik, serta kod yang lebih jelas.

## Sintaks asas

```python
def greet(name: str, times: int = 1) -> str:
    return name * times

age: int = 30
names: list[str] = ["Ann", "Bob"]
scores: dict[str, int] = {"math": 90}
```

`: type` menganotasikan parameter/pemboleh ubah dan `-> type` pula nilai pulangan. Ini mendokumentasikan niat dan disemak oleh peralatan, tetapi Python **tidak** menguatkuasakannya semasa runtime (menghantar jenis yang salah tidak akan menimbulkan ralat dengan sendirinya).

## Konstruk typing yang biasa

```python
from typing import Optional, Union, Callable, Any

def find(id: int) -> Optional[str]:    # str OR None (= str | None in 3.10+)
    ...

x: int | str                           # Union (3.10+ syntax)
handler: Callable[[int], bool]         # a function taking int, returning bool
items: list[dict[str, int]]            # nested generics
```

## Penyemakan jenis statik menangkap pepijat sebelum runtime

```python
def add(a: int, b: int) -> int:
    return a + b

add("hello", 3)   # ✅ Python runs it (and crashes); ❌ mypy/pyright flags it BEFORE running
```

Penyemak jenis seperti **mypy** atau **pyright** menganalisis hint tersebut dan melaporkan ralat jenis *sebelum* anda menjalankan kod — menangkap satu kelas pepijat yang besar (jenis argumen yang salah, salah guna None) lebih awal, seperti yang dilakukan oleh pengkompil.

## Manfaatnya

```text
✓ Catch type bugs early via static checkers (mypy, pyright) — before runtime
✓ IDE support — better autocomplete, refactoring, inline error detection
✓ Self-documenting code — signatures show exactly what's expected/returned
✓ Powers frameworks — FastAPI/Pydantic USE hints for validation & docs
✓ Easier maintenance of large codebases (catch breaking changes)
```

## Ia bersifat pilihan dan beransur

```text
You can add hints incrementally — a few functions, or strictly everywhere.
Unannotated code still works. "Gradual typing" suits adopting them over time.
```

## Rangka kerja memanfaatkannya semasa runtime

```python
from pydantic import BaseModel
class User(BaseModel):
    name: str
    age: int            # Pydantic USES the hint to VALIDATE data at runtime
User(name="Ann", age="x")   # raises a validation error
```

Sesetengah pustaka (Pydantic, FastAPI) membaca type hint untuk mengesahkan data dan menjana dokumentasi — menjadikannya bermakna secara fungsi semasa runtime.

## Mengapa ia penting

Type hint membawa banyak manfaat penaipan statik kepada Python tanpa mengorbankan kefleksibelan dinamiknya: ia menangkap pepijat berkaitan jenis lebih awal (melalui mypy/pyright), meningkatkan peralatan IDE dan refactoring secara mendadak, berfungsi sebagai dokumentasi yang hidup, serta menggerakkan rangka kerja moden (FastAPI, Pydantic) yang menggunakannya untuk pengesahihan dan dokumentasi yang dijana secara automatik.

Walaupun bersifat pilihan dan tidak dikuatkuasakan semasa runtime oleh Python sendiri, ia telah menjadi piawai dalam pangkalan kod Python yang profesional dan berskala besar kerana ia menjadikan kod lebih boleh dipercayai, mudah diselenggara, dan mendokumentasikan dirinya sendiri — semakin menjadi amalan yang dijangka, terutamanya apabila projek membesar.