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

[3.14] Further improves Advanced installation docs for PyManager (GH-134541) (GH-134576)

Browse source 
Further improves Advanced installation docs for PyManager (GH-134541)
(cherry picked from commit 99a9ab1c64)

Co-authored-by: Steve Dower <steve.dower@python.org>
This commit is contained in:
Miss Islington (bot) 2025-05-23 12:23:06 +02:00 • committed by GitHub
parent 81675941fb
commit adb0794692
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 34 additions and 13 deletions
Download patch file Download diff file Expand all files Collapse all files

47
Doc/using/windows.rst
View file

@ -504,6 +504,14 @@ configuration option.
installing and uninstalling. installing and uninstalling.
.. _Add-AppxPackage: https://learn.microsoft.com/powershell/module/appx/add-appxpackage
.. _Remove-AppxPackage: https://learn.microsoft.com/powershell/module/appx/remove-appxpackage
.. _Add-AppxProvisionedPackage: https://learn.microsoft.com/powershell/module/dism/add-appxprovisionedpackage
.. _PackageManager: https://learn.microsoft.com/uwp/api/windows.management.deployment.packagemanager
.. _pymanager-advancedinstall: .. _pymanager-advancedinstall:
Advanced Installation Advanced Installation
@ -559,12 +567,10 @@ downloaded MSIX can be installed by launching or using the commands below.
.. code-block:: powershell .. code-block:: powershell
$> winget download 9NQ7512CXL7T -e --skip-license --accept-package-agreements --disable-interactivity $> winget download 9NQ7512CXL7T -e --skip-license --accept-package-agreements --accept-source-agreements
To programmatically install or uninstall an MSIX using only PowerShell, the To programmatically install or uninstall an MSIX using only PowerShell, the
`Add-AppxPackage <https://learn.microsoft.com/powershell/module/appx/add-appxpackage>`_ `Add-AppxPackage`_ and `Remove-AppxPackage`_ PowerShell cmdlets are recommended:
and `Remove-AppxPackage <https://learn.microsoft.com/powershell/module/appx/remove-appxpackage>`_
PowerShell cmdlets are recommended:
.. code-block:: powershell .. code-block:: powershell
@ -572,18 +578,33 @@ PowerShell cmdlets are recommended:
... ...
$> Get-AppxPackage PythonSoftwareFoundation.PythonManager | Remove-AppxPackage $> Get-AppxPackage PythonSoftwareFoundation.PythonManager | Remove-AppxPackage
The native APIs for package management may be found on the Windows The latest release can be downloaded and installed by Windows by passing the
`PackageManager <https://learn.microsoft.com/uwp/api/windows.management.deployment.packagemanager>`_ AppInstaller file to the Add-AppxPackage command. This installs using the MSIX
class. The :func:`!AddPackageAsync` method installs for the current user, or use on python.org, and is only recommended for cases where installing via the Store
:func:`!StagePackageAsync` followed by :func:`!ProvisionPackageForAllUsersAsync` (interactively or using WinGet) is not possible.
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 .. code-block:: powershell
to trigger those installs without being a logged in user.
$> Add-AppxPackage -AppInstallerFile https://www.python.org/ftp/python/pymanager/pymanager.appinstaller
Other tools and APIs may also be used to provision an MSIX package for all users
on a machine, but Python does not consider this a supported scenario. We suggest
looking into the PowerShell `Add-AppxProvisionedPackage`_ cmdlet, the native
Windows `PackageManager`_ class, or the documentation and support for your
deployment tool.
Regardless of the install method, 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. When using the MSIX, the latest version of Python will
be available for all users to install without network access.
Note that the MSIX downloadable from the Store and from the Python website are Note that the MSIX downloadable from the Store and from the Python website are
subtly different and cannot be installed at the same time. Wherever possible, subtly different and cannot be installed at the same time. Wherever possible,
we suggest using the above commands to download the package from the Store to we suggest using the above WinGet commands to download the package from the
reduce the risk of setting up conflicting installs. Store to reduce the risk of setting up conflicting installs. There are no
licensing restrictions on the Python install manager that would prevent using
the Store package in this way.
.. _pymanager-admin-config: .. _pymanager-admin-config: