Prefer py.exe whereever possible on Windows

use tab layout so users can shift between windows/*nix

Signed-off-by: Naveen M K <naveen@syrusdark.website>

Author: naveen521kk

source/guides/distributing-packages-using-setuptools.rst

@@ -23,15 +23,23 @@ conflicts, prefer the advice in the Python Packaging User Guide.
 
 Requirements for packaging and distributing
 ===========================================
-
+ 
 1. First, make sure you have already fulfilled the :ref:`requirements for
    installing packages <installing_requirements>`.
 
-2. Install "twine" [1]_:
+2.  Install "twine" [1]_:
+
+    .. tab:: Unix/macOS
+
+        .. code-block:: bash
 
-   ::
+            python3 -m pip install twine
 
-    python -m pip install twine
+    .. tab:: Windows
+
+        .. code-block:: bash
+
+            py -m pip install twine
 
    You'll need this to upload your project :term:`distributions <Distribution
    Package>` to :term:`PyPI <Python Package Index (PyPI)>` (see :ref:`below
@@ -751,10 +759,17 @@ called a :ref:`*Platform Wheel* (see section below) <Platform Wheels>`.
 Before you can build wheels for your project, you'll need to install the
 ``wheel`` package:
 
-.. code-block:: text
+.. tab:: Unix/macOS
 
-  python -m pip install wheel
+    .. code-block:: bash
 
+        python3 -m pip install wheel
+
+.. tab:: Windows
+
+    .. code-block:: bash
+
+        py -m pip install wheel
 
 .. _`Universal Wheels`:
 
@@ -767,9 +782,17 @@ anywhere by :ref:`pip`.
 
 To build the wheel:
 
-.. code-block:: text
+.. tab:: Unix/macOS
+
+    .. code-block:: bash
+
+        python3 setup.py bdist_wheel --universal
 
-  python setup.py bdist_wheel --universal
+.. tab:: Windows
+
+    .. code-block:: bash
+
+        py setup.py bdist_wheel --universal
 
 You can also permanently set the ``--universal`` flag in :file:`setup.cfg`:
 
@@ -803,10 +826,17 @@ and 3.
 
 To build the wheel:
 
-::
+.. tab:: Unix/macOS
+
+    .. code-block:: bash
+
+        python3 setup.py bdist_wheel
+
+.. tab:: Windows
 
- python setup.py bdist_wheel
+    .. code-block:: bash
 
+        py setup.py bdist_wheel
 
 ``bdist_wheel`` will detect that the code is pure Python, and build a wheel
 that's named such that it's usable on any Python installation with the same
@@ -830,9 +860,17 @@ macOS, or Windows, usually due to containing compiled extensions.
 
 To build the wheel:
 
-::
+.. tab:: Unix/macOS
+
+    .. code-block:: bash
+
+        python3 setup.py bdist_wheel
+
+.. tab:: Windows
+
+    .. code-block:: bash
 
- python setup.py bdist_wheel
+        py setup.py bdist_wheel
 
 
 :command:`bdist_wheel` will detect that the code is not pure Python, and build

source/guides/dropping-older-python-versions.rst

@@ -57,9 +57,19 @@ Defining the Python version required
 
 Ensure that before you generate source distributions or binary distributions, you update Setuptools and install twine.
 
-Steps::
+Steps
 
-   python -m pip install --upgrade setuptools twine
+.. tab:: Unix/macOS
+
+    .. code-block:: bash
+
+        python3 -m pip install --upgrade setuptools twine
+
+.. tab:: Windows
+
+    .. code-block:: bash
+
+        py -m pip install --upgrade setuptools twine
 
 `setuptools` version should be above 24.0.0.
 

source/guides/hosting-your-own-index.rst

@@ -12,9 +12,19 @@ generate an autoindex.
 
 In either case, since you'll be hosting a repository that is likely not in
 your user's default repositories, you should instruct them in your project's
-description to configure their installer appropriately. For example with pip::
+description to configure their installer appropriately. For example with pip
 
-    python -m pip install --extra-index-url https://python.example.com/ foobar
+.. tab:: Unix/macOS
+
+    .. code-block:: bash
+
+        python3 -m pip install --extra-index-url https://python.example.com/ foobar
+
+.. tab:: Windows
+
+    .. code-block:: bash
+
+        py -m pip install --extra-index-url https://python.example.com/ foobar
 
 In addition, it is **highly** recommended that you serve your repository with
 valid HTTPS. At this time, the security of your user's installations depends on