[BUG]: Wrong type annotation when using std::filesystem::path as a return type, causes stubgen to choke

[HolyBlackCat]

Required prerequisites

• Make sure you've read the documentation. Your issue may be addressed there.
• Search the issue tracker and Discussions to verify that this hasn't already been reported. +1 or comment there if it has.
• Consider asking first in the Gitter chat room or in a Discussion.

What version (or hash if on master) of pybind11 are you using?

741d86f

Problem description

When a function returns std::filesystem::path and I use <pybind11/stl/filesystem.h>, the type annotation says Path, which is a non-existent type, which makes pybind11_stubgen choke on such functions.

Previous versions of Pybind used to return os.PathLike, but this was broken in #5450.

Reproducible example code

No response

Is this a regression? Put the last known working version here if it is.

2.10.1

[timohl]

Thanks for reporting.
Could you provide the error message and version of pybind11-stubgen?

I thought I tested this and pybind11-stubgen imports it automatically, but maybe we have to go with pathlib.Path.

[HolyBlackCat]

Stubgen says pybind11_stubgen - [ ERROR] In my_module.my_function : Can't find/import 'Path' for every function that returns std::filesystem::path.

pip show pybind11-stubgen says the version is 2.5.1.

I don't know its inner workings too well, but how would it guess that Path means pathlib.Path?

[timohl]

I added a fix for this in my latest PR reworking the arg/return type hint system.
If this PR takes too long or gets rejected, I can create a small PR only containing the fix.