Skip to content

Add PyManager troubleshooting steps for direct launch of script files #141530

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Nov 14, 2025
Merged

Add PyManager troubleshooting steps for direct launch of script files #141530

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 16 additions & 6 deletions Doc/using/windows.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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:

*************************
Expand Down Expand Up @@ -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

Expand Down Expand Up @@ -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:

Expand Down
Loading