Stowage/cpython
2
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-12-08 06:10:17 +00:00
Code Issues Projects Releases Packages Wiki Activity

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 .. _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: .. _using-on-windows:
************************* *************************
@ -543,12 +545,9 @@ configuration option.
The behaviour of shebangs in the Python install manager is subtly different The behaviour of shebangs in the Python install manager is subtly different
from the previous ``py.exe`` launcher, and the old configuration options no from the previous ``py.exe`` launcher, and the old configuration options no
longer apply. If you are specifically reliant on the old behaviour or longer apply. If you are specifically reliant on the old behaviour or
configuration, we recommend keeping the legacy launcher. It may be configuration, we recommend installing the `legacy launcher`_. The legacy
`downloaded independently <https://www.python.org/ftp/python/3.13.1/win32/launcher.msi>`_ launcher's ``py`` command will override PyManager's one by default, and you
and installed on its own. The legacy launcher's ``py`` command will override will need to use ``pymanager`` commands for installing and uninstalling.
PyManager's one, and you will need to use ``pymanager`` commands for
installing and uninstalling.
.. _Add-AppxPackage: https://learn.microsoft.com/powershell/module/appx/add-appxpackage .. _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 These scripts are separated for each runtime, and so you may need to
add multiple paths. 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: .. _windows-embeddable: