Change by Peter Bittner : ---------- keywords: +patch pull_requests: +16500 stage: -> patch review pull_request: https://github.com/python/cpython/pull/16974 _______________________________________ Python tracker https://bugs.python.org/issue38623 _______________________________________

Vinay Keerthi added the comment: Just chiming in my opinion, the site-packages directory is also dependent on venv, correct? So would explaining where it is at a global install level be much use? Or do you mean explaining where site-packages is even for a venv? I could take this up, if some agrees that jr needs doing. ---------- nosy: +stonecharioteer _______________________________________ Python tracker https://bugs.python.org/issue38623 _______________________________________

Change by Inada Naoki : ---------- pull_requests: +17278 pull_request: https://github.com/python/cpython/pull/17858 _______________________________________ Python tracker https://bugs.python.org/issue38623 _______________________________________

Inada Naoki added the comment:

There is a specific question this change attempts to answer: "Where is the module I imported located in the file system?"

So `print(the_module.__file__)` is better answer. (or `pip list -v` if the module is third party package installed via pip). `python -m site` doesn't tell you where the imported module came from.

[3] https://docs.python.org/3/library/site.html#site.getusersitepackages

After merging PR 17858, you can use :ref:`site-commandline` for cross reference. ---------- _______________________________________ Python tracker https://bugs.python.org/issue38623 _______________________________________

Inada Naoki added the comment: New changeset ca94677a6216e2d41b04574986ce49d31a0b329c by Inada Naoki in branch 'master': bpo-38623: Doc: Add section for site module CLI. (GH-17858) https://github.com/python/cpython/commit/ca94677a6216e2d41b04574986ce49d31a0... ---------- _______________________________________ Python tracker https://bugs.python.org/issue38623 _______________________________________

Change by miss-islington : ---------- pull_requests: +17301 pull_request: https://github.com/python/cpython/pull/17891 _______________________________________ Python tracker https://bugs.python.org/issue38623 _______________________________________

miss-islington added the comment: New changeset a6b37589a05c63abec122d3a00785641a3bcd85a by Miss Islington (bot) in branch '3.8': bpo-38623: Doc: Add section for site module CLI. (GH-17858) https://github.com/python/cpython/commit/a6b37589a05c63abec122d3a00785641a3b... ---------- _______________________________________ Python tracker https://bugs.python.org/issue38623 _______________________________________

Peter Bittner added the comment: 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-d... [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-dep... ---------- _______________________________________ Python tracker https://bugs.python.org/issue38623 _______________________________________

Brett Cannon added the comment: I think "Python learners deserve to know about "site-packages" and (optionally) "dist-packages" " is a bit strong of a statement. I don't think the tutorial covers how to install third-party package which is what goes into site-packages, so I don't know what benefit they will garner from having that covered in the tutorial to teach the basics of Python. In an intermediate tutorial I can totally understand the explanation along with using e.g. pip, but for a tutorial like this I still think it's unnecessary. ---------- _______________________________________ Python tracker https://bugs.python.org/issue38623 _______________________________________