From: Steve Dower <steve.dower@python.org>
Date: Mon, 5 May 2025 22:23:08 +0000 (+0100)
Subject: gh-133469: Adds to advanced section on installing PyManager (GH-133471)
X-Git-Tag: v3.14.0b1~26
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=f9b22bb79d8a233380bc5eb3820bf846404a7258;p=thirdparty%2FPython%2Fcpython.git

gh-133469: Adds to advanced section on installing PyManager (GH-133471)
---

diff --git a/Doc/using/windows.rst b/Doc/using/windows.rst
index 57c6062ee43a..74d6db5d7d1a 100644
--- a/Doc/using/windows.rst
+++ b/Doc/using/windows.rst
@@ -529,6 +529,25 @@ depending on whether it was installed from python.org or through the Windows
 Store. Attempting to run the executable directly from Program Files is not
 recommended.
 
+To programmatically install or uninstall the MSIX without using your
+distribution platform's native support, the `Add-AppxPackage
+<https://learn.microsoft.com/powershell/module/appx/add-appxpackage>`_ and
+`Remove-AppxPackage <https://learn.microsoft.com/powershell/module/appx/remove-appxpackage>`_
+PowerShell cmdlets are simplest to use:
+
+.. code::
+
+   $> Add-AppxPackage C:\Downloads\python-manager-25.0.msix
+   ...
+   $> Get-AppxPackage PythonSoftwareFoundation.PythonManager | Remove-AppxPackage
+
+The native APIs for package management may be found on the Windows
+`PackageManager <https://learn.microsoft.com/uwp/api/windows.management.deployment.packagemanager>`_
+class. The :func:`!AddPackageAsync` method installs for the current user, or use
+:func:`!StagePackageAsync` followed by :func:`!ProvisionPackageForAllUsersAsync`
+to install the Python install manager for all users from the MSIX package. Users
+will still need to install their own copies of Python itself, as there is no way
+to trigger those installs without being a logged in user.
 
 .. _pymanager-admin-config: