aboutsummaryrefslogtreecommitdiffstats
path: root/chapter08
diff options
context:
space:
mode:
authorXi Ruoyao <xry111@xry111.site>2023-03-31 22:22:38 +0800
committerXi Ruoyao <xry111@xry111.site>2023-03-31 22:25:35 +0800
commitaf612e9a199b621382a46377104a538e8c89b210 (patch)
tree7b3c37a8a1ad133bf0046f0e38505b9b6164a6a8 /chapter08
parent92dbe964f1e726ddf6589d5083819780f49fdf23 (diff)
Package updates
Update to linux-6.2.8 (#5230) Update to xz-5.4.2 (#5233) Update to coreutils-9.2 (#5232) Update to libcap-2.68 (#5236) Update to bc-6.5.0 (#5228) Update to openssl-3.1.0 (#5227) Update to texinfo-7.0.3 (#5235) Update to grep-3.10 (#5234) Update to tzdata-2023c (#5237) Update to wheel-0.40.0 (#5229) Add flit-core-3.8.0
Diffstat (limited to 'chapter08')
-rw-r--r--chapter08/chapter08.xml1
-rw-r--r--chapter08/flit-core.xml115
2 files changed, 116 insertions, 0 deletions
diff --git a/chapter08/chapter08.xml b/chapter08/chapter08.xml
index 902d1bf48..91827b88e 100644
--- a/chapter08/chapter08.xml
+++ b/chapter08/chapter08.xml
@@ -63,6 +63,7 @@
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="libelf.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="libffi.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="python.xml"/>
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="flit-core.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="wheel.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="ninja.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="meson.xml"/>
diff --git a/chapter08/flit-core.xml b/chapter08/flit-core.xml
new file mode 100644
index 000000000..ef62034ab
--- /dev/null
+++ b/chapter08/flit-core.xml
@@ -0,0 +1,115 @@
+<?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-flit-core" role="wrap" revision="systemd">
+ <?dbhtml filename="flit-core.html"?>
+
+ <sect1info condition="script">
+ <productname>flit-core</productname>
+ <productnumber>&flit-core-version;</productnumber>
+ <address>&flit-core-url;</address>
+ </sect1info>
+
+ <title>Flit-Core-&flit-core-version;</title>
+
+ <indexterm zone="ch-system-flit-core">
+ <primary sortas="a-flit-core">Flit-core</primary>
+ </indexterm>
+
+ <sect2 role="package">
+ <title/>
+
+ <para>Flit-core is the distribution-building parts of Flit (a packaging
+ tool for simple Python modules).</para>
+
+ <segmentedlist>
+ <segtitle>&buildtime;</segtitle>
+ <segtitle>&diskspace;</segtitle>
+ <seglistitem>
+ <seg>&flit-core-fin-sbu;</seg>
+ <seg>&flit-core-fin-du;</seg>
+ </seglistitem>
+ </segmentedlist>
+
+ </sect2>
+
+ <sect2 role="installation">
+ <title>Installation of Flit-core</title>
+
+ <para>Build the package:</para>
+
+<screen><userinput remap="install">pip3 wheel -w dist --no-build-isolation --no-deps $PWD</userinput></screen>
+
+ <para>Install the package:</para>
+
+<screen><userinput remap="install">pip3 install --no-index --no-user --find-links dist flit_core</userinput></screen>
+
+ <variablelist>
+ <title>The meaning of the pip3 configuration options and commands:</title>
+
+ <varlistentry>
+ <term><command>wheel</command></term>
+ <listitem>
+ <para>This command builds the wheel archive for this package.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><parameter>-w dist</parameter></term>
+ <listitem>
+ <para>Instructs pip to put the created wheel into the
+ <filename class='directory'>dist</filename> directory.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><command>install</command></term>
+ <listitem>
+ <para>This command installs the package.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><parameter>--no-build-isolation</parameter>,
+ <parameter>--no-deps</parameter>, and
+ <parameter>--no-index</parameter></term>
+ <listitem>
+ <para>These options prevent fetching files from the online package
+ repository (PyPI). If packages are installed in the correct order,
+ pip won't need to fetch any files in the first place; these
+ options add some safety in case of user error.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><parameter>--find-links dist</parameter></term>
+ <listitem>
+ <para>Instructs pip to search for wheel archives in the
+ <filename class='directory'>dist</filename> directory.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </sect2>
+
+ <sect2 id="contents-flit-core" role="content">
+ <title>Contents of Flit-Core</title>
+
+ <segmentedlist>
+ <segtitle>Installed directory</segtitle>
+
+ <seglistitem>
+ <seg>
+ /usr/lib/python&python-minor;/site-packages/flit_core and
+ /usr/lib/python&python-minor;/site-packages/flit_core-&flit-core-version;.dist-info
+ </seg>
+ </seglistitem>
+ </segmentedlist>
+
+ </sect2>
+
+</sect1>
+