feat: add type hints to functions and methods in jdatetime module

[mojixcoder]

No description provided.

[slashmili]

Thanks @mojixcoder! Nice work

What is the minimum Python that support type hints? Currently we support Python down to version 3.9.

[mojixcoder]

Thanks @mojixcoder! Nice work

What is the minimum Python that support type hints? Currently we support Python down to version 3.9.

Python 3.5 introduced type hints via PEP 484 (typing module).

Key milestones:

3.5 — typing module, basic annotations
3.9 — built-in generics (list[int], dict[str, int] instead of typing.List, typing.Dict)
3.10 — union syntax (X | Y instead of typing.Union[X, Y])
3.10 — typing.TypeAlias
3.11 — typing.Self, typing.Never
from future import annotations (PEP 563, available since 3.7) enables forward references and also lets you use 3.10+ syntax (like X | Y) on older Python versions, since annotations are stored as strings rather than evaluated eagerly.

Practical answer for your case

Since you already support Python 3.9, you are at a very reasonable baseline:

You get modern generic syntax (list[int])
Most ecosystem typing libraries still support 3.9+
You avoid legacy typing.List-style verbosity

Recommendation
If you want maximum compatibility → 3.5+
If you want modern, clean typing without legacy patterns → 3.9+ (your current baseline is solid)
If you want best DX today → 3.10+ (mainly for | unions)

[slashmili]

Thanks! 🎉

[slashmili]

released as 5.3.0