Skip to content

Commit b101e9d

Browse files
authored
Add PyManager troubleshooting steps for direct launch of script files (pythonGH-141530)
1 parent eab7385 commit b101e9d

File tree

1 file changed

+16
-6
lines changed

1 file changed

+16
-6
lines changed

Doc/using/windows.rst

Lines changed: 16 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,8 @@
44

55
.. _Microsoft Store app: https://apps.microsoft.com/detail/9NQ7512CXL7T
66

7+
.. _legacy launcher: https://www.python.org/ftp/python/3.14.0/win32/launcher.msi
8+
79
.. _using-on-windows:
810

911
*************************
@@ -543,12 +545,9 @@ configuration option.
543545
The behaviour of shebangs in the Python install manager is subtly different
544546
from the previous ``py.exe`` launcher, and the old configuration options no
545547
longer apply. If you are specifically reliant on the old behaviour or
546-
configuration, we recommend keeping the legacy launcher. It may be
547-
`downloaded independently <https://www.python.org/ftp/python/3.13.1/win32/launcher.msi>`_
548-
and installed on its own. The legacy launcher's ``py`` command will override
549-
PyManager's one, and you will need to use ``pymanager`` commands for
550-
installing and uninstalling.
551-
548+
configuration, we recommend installing the `legacy launcher`_. The legacy
549+
launcher's ``py`` command will override PyManager's one by default, and you
550+
will need to use ``pymanager`` commands for installing and uninstalling.
552551

553552
.. _Add-AppxPackage: https://learn.microsoft.com/powershell/module/appx/add-appxpackage
554553

@@ -859,6 +858,17 @@ default).
859858
These scripts are separated for each runtime, and so you may need to
860859
add multiple paths.
861860

861+
* - Typing ``script-name.py`` in the terminal opens in a new window.
862+
- This is a known limitation of the operating system. Either specify ``py``
863+
before the script name, create a batch file containing ``@py "%~dpn0.py" %*``
864+
with the same name as the script, or install the `legacy launcher`_
865+
and select it as the association for scripts.
866+
867+
* - Drag-dropping files onto a script doesn't work
868+
- This is a known limitation of the operating system. It is supported with
869+
the `legacy launcher`_, or with the Python install manager when installed
870+
from the MSI.
871+
862872

863873
.. _windows-embeddable:
864874

0 commit comments

Comments
 (0)