[issue31582] Add _pth breadcrumb to sys.path documentation

Steve Dower added the comment: New changeset c62b944dfc98911a5050389fa6ac753e283fee1f by Russel Webber in branch 'main': bpo-31582: Created a new documentation section describing sys.path initialization (GH-31082)

[issue31582] Add _pth breadcrumb to sys.path documentation

Change by Russel Webber : -- keywords: +patch pull_requests: +29265 stage: needs patch -> patch review pull_request: https://github.com/python/cpython/pull/31082 ___ Python tracker

[issue31582] Add _pth breadcrumb to sys.path documentation

Russel Webber added the comment: I agree wholeheartedly, an explantation of sys.path initialisation would be very helpful. I've seen too many hacks in end user Python code due to misunderstandings around sys.path initialisation and the available ways to customise sys.path. I'll work on

[issue31582] Add _pth breadcrumb to sys.path documentation

Steve Dower added the comment: I think we need somewhere in the documentation to explain how the initial import path is calculated, in terms useful for an end user (rather than what's in getpath.py, which is for developers). Right now, I'm not sure there's a good place for it. There's a

[issue31582] Add _pth breadcrumb to sys.path documentation

Russel Webber added the comment: I am happy to take a look at improving the documentation. I see the new getpath.py has very extensive commenting. Should I simply mention ._pth files as in the original issue from 5 years ago, or are you looking for documentation of how sys.path is

[issue31582] Add _pth breadcrumb to sys.path documentation

Steve Dower added the comment: Need to make this happen, and it probably needs to be me (though I'm happy to review a contribution). We now handle ._pth files on all platforms as part of the Modules/getpath.py changes (which I hinted to in my previous comment from 5 years ago ;) ).

[issue31582] Add _pth breadcrumb to sys.path documentation

Steve Dower added the comment: Sounds like a good idea. I hope that sys.path initialization is documented as well for POSIX as it is for Windows, as that will make this a simple "for X, click here; for Y, click here" patch. Otherwise, someone will need to figure out

[issue31582] Add _pth breadcrumb to sys.path documentation

Change by Éric Araujo : -- components: +Windows nosy: +paul.moore, steve.dower, tim.golden, zach.ware ___ Python tracker ___

[issue31582] Add _pth breadcrumb to sys.path documentation

New submission from Traveler Hauptman: Python on windows (winpython) was not adding PYTHONPATH to sys.path as documented and I could not understand why. It took a lot of time, web searches, and finally a tour through the code to find out about _pth; which is well documented but difficult to