[issue28901] Embedded Release interactive mode documentation
New submission from Matthias v/d Meent: The Windows Embedded release (at least the x86_64 version) does not include the usual helper functions (exit, help, ...) when run interactively (~ python.exe). This is not documented at the docs of Windows Embedded release, which might mean that this is a bug. Documentation on Embedded release here (https://docs.python.org/3/using/windows.html#embedded-distribution) missing in interactive mode of embedded release: (output of diff): ['copyright', 'credits', 'exit', 'help', 'license', 'quit'] Notice that 'help', a builtin function according to the docs [0], is missing in the Embedded release. Even when embedded, a builtin should be available IMO. [0] https://docs.python.org/3.6/library/functions.html This comparison was only between running the python executable in the [zip] and python installed from this [installer]. It is very well possible this is a long-standing issue since 3.5 (the first Embedded release), and this may occur on other architectures as well. [zip] https://www.python.org/ftp/python/3.6.0/python-3.6.0rc1-embed-amd64.zip [installer] https://www.python.org/ftp/python/3.6.0/python-3.6.0rc1-amd64.exe ---------- assignee: docs@python components: Documentation, Windows messages: 282693 nosy: Matthias v/d Meent, docs@python, paul.moore, steve.dower, tim.golden, zach.ware priority: normal severity: normal status: open title: Embedded Release interactive mode documentation type: enhancement versions: Python 3.6 _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue28901> _______________________________________
Zachary Ware added the comment: Each of those items is added to builtins by site.py, which I believe is not imported by default by the embeddable distribution. I didn't immediately find that fact mentioned in the docs, though. Also note that the embeddable distribution isn't really meant for regular usage, it's meant for embedding :). While this is definitely worth some clarification in the docs, it's not a high-priority issue. +Ethan Smith from #28903. ---------- nosy: +Ethan Smith stage: -> needs patch title: Embedded Release interactive mode documentation -> Windows: document that site is not imported by default by embeddable distribution _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue28901> _______________________________________
Steve Dower added the comment: If you go to the 3.6 version of that doc page and also read the section on finding modules, you'll see that the presence of a "python._pth" file causes -S (skip importing site) to be implied unless the ._pth file includes "import site": https://docs.python.org/3.6/using/windows.html#finding-modules You'll then notice that the embeddable distro includes a ._pth file by default (though you don't have to distribute that with your app, just as you may want to omit the exe files). That could certainly be called out more clearly in the section on the embeddable distro, though so far it hasn't come up with anyone who's using it for its proper purpose (that I'm aware of). ---------- _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue28901> _______________________________________
Change by Steve Dower <steve.dower@python.org>: ---------- resolution: -> not a bug stage: needs patch -> resolved status: open -> closed _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue28901> _______________________________________
participants (3)
-
Matthias v/d Meent
-
Steve Dower
-
Zachary Ware