From e3187f489593fe719800b980c94634ecff9dfe96 Mon Sep 17 00:00:00 2001
From: Xi Ruoyao <xry111@xry111.site>
Date: Tue, 22 Nov 2022 16:56:41 +0800
Subject: wheel: build the wheel archive of wheel itself

This avoids running "python3 setup.py install" (indirectly), which may
not work correctly in the future with Python 3.12.
---
 chapter08/wheel.xml | 48 ++++++++++++++++++++++++++++++++++++++----------
 1 file changed, 38 insertions(+), 10 deletions(-)

(limited to 'chapter08')

diff --git a/chapter08/wheel.xml b/chapter08/wheel.xml
index 0f6ba7cb6..5b09fc65b 100644
--- a/chapter08/wheel.xml
+++ b/chapter08/wheel.xml
@@ -40,12 +40,39 @@
   <sect2 role="installation">
     <title>Installation of Wheel</title>
 
+    <para>Compile wheel with the following command:</para>
+
+<screen><userinput remap="make">PYTHONPATH=src pip3 wheel -w dist --no-build-isolation --no-deps $PWD</userinput></screen>
+
     <para>Install wheel with the following command:</para>
 
-<screen><userinput remap="install">pip3 install --no-index $PWD</userinput></screen>
+<screen><userinput remap="install">pip3 install --no-index --find-links=dist wheel</userinput></screen>
 
     <variablelist>
-      <title>The meaning of the pip3 options:</title>
+      <title>The meaning of the pip3 commands:</title>
+
+      <varlistentry>
+        <term><envar>PYTHONPATH=src</envar></term>
+        <listitem>
+           <para>Allow using this package (not installed yet) to build a
+           wheel archive for itself, to avoid a chicken-or-egg problem.</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><command>wheel</command></term>
+        <listitem>
+           <para>Build wheel archive for this package.</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><parameter>-w dist</parameter></term>
+        <listitem>
+           <para>Put the created wheels into the
+           <filename class='directory'>dist</filename> directory.</para>
+        </listitem>
+      </varlistentry>
 
       <varlistentry>
         <term><command>install</command></term>
@@ -55,24 +82,25 @@
       </varlistentry>
 
       <varlistentry>
-        <term><parameter>--no-index</parameter></term>
+        <term><parameter>--no-build-isolation</parameter>,
+              <parameter>--no-deps</parameter>, and
+              <parameter>--no-index</parameter></term>
         <listitem>
           <para>Prevent pip from fetching files from the online package
           repository (PyPI). If packages are installed in the correct order,
-          then it won't need to fetch any files in the first place, but this
-          option adds some safety in case of user error.</para>
+          then it won't need to fetch any files in the first place, but these
+          options add some safety in case of user error.</para>
         </listitem>
       </varlistentry>
 
       <varlistentry>
-        <term><parameter>$PWD</parameter></term>
+        <term><parameter>--find-links dist</parameter></term>
         <listitem>
-           <para>Look for files to install in the current working directory.</para>
+           <para>Search wheel archives from the
+           <filename class='directory'>dist</filename> directory.</para>
         </listitem>
       </varlistentry>
-
     </variablelist>
-
   </sect2>
 
   <sect2 id="contents-wheel" role="content">
@@ -86,7 +114,7 @@
         <seg>wheel</seg>
         <seg>
            /usr/lib/python&python-minor;/site-packages/wheel and
-           /usr/lib/python&python-minor;/site-packages/wheel-0.37.1-py3.10.egg-info
+           /usr/lib/python&python-minor;/site-packages/wheel-&wheel-version;.dist-info
         </seg>
       </seglistitem>
     </segmentedlist>
-- 
cgit v1.2.3-54-g00ecf