Type hints for `pathlib.types`

Feature or enhancement

The pathlib.types module is new in 3.14, and contains a single public class: pathlib.types.PathInfo.

This module also contains a few private classes: _PathParser, _JoinablePath, _ReadablePath and _WritablePath.

As the pathlib.types module is not imported by pathlib, I think we're free to add proper type annotations to the entire module, including the private classes. I think this will help clarify the interface.

I'd like these hints to be compatible with the oldest version of Python still receiving security updates (3.9 at time of writing) because I'm hoping to provide a PyPI package from this module.

Linked PRs

• gh-131639

まず pathlib.types モジュールとリンクされた PR gh-131639 を確認し、作業の現在の状態を把握します。アノテーションを Python 3.9 と互換性のある状態に保つ方法を確認し、issue で名前が挙げられている公開クラスと非公開クラスを検討します。モジュールに完全で互換性のある型ヒントが含まれ、意図されたインターフェースを変更していなければ完了です。