source: chapter08/wheel.xml@ 8a687fa

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../general.ent">
  %general-entities;
]>

<sect1 id="ch-system-wheel" role="wrap">
  <?dbhtml filename="wheel.html"?>

  <sect1info condition="script">
    <productname>wheel</productname>
    <productnumber>&wheel-version;</productnumber>
    <address>&wheel-url;</address>
  </sect1info>

  <title>Wheel-&wheel-version;</title>

  <indexterm zone="ch-system-wheel">
    <primary sortas="a-wheel">wheel</primary>
  </indexterm>

  <sect2 role="package">
    <title/>

    <para>Wheel is a Python library that is the reference
    implementation of the Python wheel packaging standard.</para>

    <segmentedlist>
      <segtitle>&buildtime;</segtitle>
      <segtitle>&diskspace;</segtitle>
      <seglistitem>
        <seg>&wheel-fin-sbu;</seg>
        <seg>&wheel-fin-du;</seg>
      </seglistitem>
    </segmentedlist>

  </sect2>

  <sect2 role="installation">
    <title>Installation of Wheel</title>

    <para>Install wheel with the following command:</para>

<screen><userinput remap="install">pip3 install --no-index $PWD</userinput></screen>

    <variablelist>
      <title>The meaning of the pip3 options:</title>

      <varlistentry>
        <term><command>install</command></term>
        <listitem>
           <para>Install the package.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><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>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><parameter>$PWD</parameter></term>
        <listitem>
           <para>Look for files to install in the current working directory.</para>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

  <sect2 id="contents-wheel" role="content">
    <title>Contents of Wheel</title>

    <segmentedlist>
      <segtitle>Installed program</segtitle>
      <segtitle>Installed directory</segtitle>

      <seglistitem>
        <seg>wheel</seg>
        <seg>/usr/lib/python&python-minor;/site-packages/wheel</seg>
      </seglistitem>
    </segmentedlist>

    <variablelist>
      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
      <?dbfo list-presentation="list"?>
      <?dbhtml list-presentation="table"?>

      <varlistentry id="wheel-wheel">
        <term><command>wheel</command></term>
        <listitem>
          <para>
            is an utility to unpack, pack, or convert wheel packages
          </para>
          <indexterm zone="ch-system-wheel">
            <primary sortas="b-wheel">wheel</primary>
          </indexterm>
        </listitem>
      </varlistentry>
    </variablelist>

  </sect2>

</sect1>