This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author bittner
Recipients bittner, brett.cannon, docs@python, methane, miss-islington, stonecharioteer
Date 2020-01-07.23:18:31
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1578439112.17.0.507764709122.issue38623@roundup.psfhosted.org>
In-reply-to
Content
Python learners deserve to know about "site-packages" and (optionally) "dist-packages". This is a "random note", it's an explanation that is missing in the tutorial.

- Site-packages "is the target directory of manually built Python packages", does someone explain.[4]

- It is the "expected convention for locally installed packages", explains Greg Ward in "Installing Python Modules".[5]

- Their location is only a subset of `sys.path`, as visible from the Python code in the `site` module.[6]

The tutorial currently mentions its special role only briefly [7], saying:

> * The installation-dependent default.

We should explain that part. I'll give it a shot replacing my earlier proposal.


[4] https://stackoverflow.com/questions/31384639/what-is-pythons-site-packages-directory
[5] https://docs.python.org/3.8/install/#modifying-python-s-search-path
[6] https://github.com/python/cpython/blob/master/Lib/site.py#L319-L344
[7] https://docs.python.org/3.8/tutorial/modules.html?highlight=installation-dependent%20default#the-module-search-path
History
Date User Action Args
2020-01-07 23:18:32bittnersetrecipients: + bittner, brett.cannon, methane, docs@python, miss-islington, stonecharioteer
2020-01-07 23:18:32bittnersetmessageid: <1578439112.17.0.507764709122.issue38623@roundup.psfhosted.org>
2020-01-07 23:18:32bittnerlinkissue38623 messages
2020-01-07 23:18:31bittnercreate