Skip to content
Browse files

bpo-37481: Deprecate distutils bdist_wininst command (GH-14553)

The distutils bdist_wininst command is now deprecated, use
bdist_wheel (wheel packages) instead.
(cherry picked from commit 1da4462)

Co-authored-by: Victor Stinner <>
  • Loading branch information...
miss-islington and vstinner committed Jul 5, 2019
1 parent c3ef1a5 commit b4cd6ba1a028c2624ac7bc93439b9d45f51cfeba
@@ -1863,6 +1863,9 @@ Subclasses of :class:`Command` must define the following methods.
.. module:: distutils.command.bdist_wininst
:synopsis: Build a Windows installer

.. deprecated:: 3.8
Use bdist_wheel (wheel packages) instead.

.. % todo
@@ -146,6 +146,9 @@ generated by each, are:
| :command:`bdist_msi` | msi |

.. note::
bdist_wininst is deprecated since Python 3.8.

The following sections give details on the individual :command:`bdist_\*`

@@ -298,6 +301,9 @@ file winds up deep in the "build tree," in a temporary directory created by
Creating Windows Installers

.. warning::
bdist_wininst is deprecated since Python 3.8.

Executable installers are the natural format for binary distributions on
Windows. They display a nice graphical user interface, display some information
about the module distribution to be installed taken from the metadata in the
@@ -459,3 +465,6 @@ Starting with Python 2.6, bdist_wininst supports a :option:`!--user-access-contr
option. The default is 'none' (meaning no UAC handling is done), and other
valid values are 'auto' (meaning prompt for UAC elevation if Python was
installed for all users) and 'force' (meaning always prompt for elevation).

.. note::
bdist_wininst is deprecated since Python 3.8.
@@ -1065,6 +1065,10 @@ Build and C API Changes

* The distutils ``bdist_wininst`` command is now deprecated, use
``bdist_wheel`` (wheel packages) instead.
(Contributed by Victor Stinner in :issue:`37481`.)

* Deprecated methods ``getchildren()`` and ``getiterator()`` in
the :mod:`~xml.etree.ElementTree` module emit now a
:exc:`DeprecationWarning` instead of :exc:`PendingDeprecationWarning`.
@@ -3,7 +3,9 @@
Implements the Distutils 'bdist_wininst' command: create a windows installer

import sys, os
import os
import sys
import warnings
from distutils.core import Command
from distutils.util import get_platform
from distutils.dir_util import create_tree, remove_tree
@@ -58,6 +60,12 @@ class bdist_wininst(Command):
# bpo-10945: bdist_wininst requires mbcs encoding only available on Windows
_unsupported = (sys.platform != "win32")

def __init__(self, *args, **kw):
super().__init__(*args, **kw)
warnings.warn("bdist_wininst command is deprecated since Python 3.8, "
"use bdist_wheel (wheel packages) instead",
DeprecationWarning, 2)

def initialize_options(self):
self.bdist_dir = None
self.plat_name = None
@@ -2,7 +2,7 @@
import sys
import platform
import unittest
from import run_unittest
from import run_unittest, check_warnings

from distutils.command.bdist_wininst import bdist_wininst
from distutils.tests import support
@@ -21,7 +21,8 @@ def test_get_exe_bytes(self):
# this test makes sure it works now for every platform
# let's create a command
pkg_pth, dist = self.create_dist()
cmd = bdist_wininst(dist)
with check_warnings(("", DeprecationWarning)):
cmd = bdist_wininst(dist)

# let's run the code that finds the right wininst*.exe file
@@ -0,0 +1,2 @@
The distutils ``bdist_wininst`` command is deprecated in Python 3.8, use
``bdist_wheel`` (wheel packages) instead.

0 comments on commit b4cd6ba

Please sign in to comment.
You can’t perform that action at this time.