mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-11-24 12:20:42 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 9

Add PyManager troubleshooting steps for direct launch of script files (GH-141530)

Browse source
This commit is contained in:
Steve Dower 2025-11-14 15:23:01 +00:00 • committed by GitHub
parent eab7385858
commit b101e9d36b
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 16 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

22
Doc/using/windows.rst
View file

@ -4,6 +4,8 @@
.. _Microsoft Store app: https://apps.microsoft.com/detail/9NQ7512CXL7T
.. _legacy launcher: https://www.python.org/ftp/python/3.14.0/win32/launcher.msi
.. _using-on-windows:
*************************
@ -543,12 +545,9 @@ configuration option.
The behaviour of shebangs in the Python install manager is subtly different
from the previous ``py.exe`` launcher, and the old configuration options no
longer apply. If you are specifically reliant on the old behaviour or
configuration, we recommend keeping the legacy launcher. It may be
`downloaded independently <https://www.python.org/ftp/python/3.13.1/win32/launcher.msi>`_
and installed on its own. The legacy launcher's ``py`` command will override
PyManager's one, and you will need to use ``pymanager`` commands for
installing and uninstalling.
configuration, we recommend installing the `legacy launcher`_. The legacy
launcher's ``py`` command will override PyManager's one by default, and you
will need to use ``pymanager`` commands for installing and uninstalling.
.. _Add-AppxPackage: https://learn.microsoft.com/powershell/module/appx/add-appxpackage
@ -859,6 +858,17 @@ default).
These scripts are separated for each runtime, and so you may need to
add multiple paths.
* - Typing ``script-name.py`` in the terminal opens in a new window.
- This is a known limitation of the operating system. Either specify ``py``
before the script name, create a batch file containing ``@py "%~dpn0.py" %*``
with the same name as the script, or install the `legacy launcher`_
and select it as the association for scripts.
* - Drag-dropping files onto a script doesn't work
- This is a known limitation of the operating system. It is supported with
the `legacy launcher`_, or with the Python install manager when installed
from the MSI.
.. _windows-embeddable: