[issue45991] Improve ambiguous docstrings in pkgutil

2022-02-28 Thread Kevin Hock
Kevin Hock added the comment: > Maybe instead a note could be put in the Pathlib doc noting functions that > accept path arguments might not accept Path objects? My concern with that is that someone using `pkgutil` wouldn't see it. However, I can see the argument that fixing the '

[issue45991] Improve ambiguous docstrings in pkgutil

2022-02-24 Thread Kevin Hock
Kevin Hock added the comment: At best it is ambiguous, with the class being confused with Str being called Path. Looking up "AttributeError: 'PosixPath' object has no attribute 'startswith'" gives a lot of results for similar issues, so I think the wording could b

[issue45991] Improve ambiguous docstrings in pkgutil

2021-12-05 Thread Kevin Hock
New submission from Kevin Hock : # Issue If you search for "list of paths" in https://github.com/KevinHock/cpython/blob/main/Lib/pkgutil.py A lot of people mistake this as `PosixPath`. You can see an example here: https://github.com/duo-labs/parliament/pull/207 that references