glfs/general/prog/python-modules.xml

<?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="python-modules" xreflabel="Python Modules">
  <?dbhtml filename="python-modules.html" ?>


  <title>Python Modules</title>

  <indexterm zone="python-modules">
    <primary sortas="a-Python-Modules">Python Modules</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to Python Modules</title>

    <para>
      The <application>Python</application> module packages add useful objects
      to the <application>Python</application> language. Modules utilized by
      packages throughout BLFS are listed here, along with their dependencies.
    </para>

    <important>
      <para>
        In BLFS, we normally build and install Python 3 modules with
        <command>pip3</command>.  Please take care that the
        <command>pip3 install</command> commands in the book should be
        run as &root; unless it's for a Python virtual environment.  Running
        <command>pip3 install</command> as a non-&root; user may seem to
        work fine, but it will cause the installed module to be inaccessible by
        other users.
      </para>
      <para>
        <command>pip3 install</command> will not reinstall an already
        installed module by default.  For using the
        <command>pip3 install</command> command to upgrade a module (for
        example, from meson-0.61.3 to meson-0.62.0), insert
        <parameter>--upgrade</parameter> into the command line.  If it's really
        necessary to downgrade a module or reinstall the same version for
        some reason, insert <parameter>--force-reinstall</parameter> into
        the command line.
      </para>
    </important>

    <itemizedlist spacing="compact">
      <listitem>
        <para>
          <xref linkend="asciidoc"/>
        </para>
      </listitem>
      <listitem>
        <para>
          <xref linkend="cython"/>
        </para>
      </listitem>
      <listitem>
        <para>
          <xref linkend="dbus-python"/>
        </para>
      </listitem>
<!--      <listitem>
        <para>
          <xref linkend="decorator"/>
        </para>
      </listitem>
-->
      <listitem>
        <para>
          <xref linkend="docutils"/>
        </para>
      </listitem>
      <listitem>
        <para>
          <xref linkend="py3c"/>
        </para>
      </listitem>
      <listitem>
        <para>
          <xref linkend="pyatspi2"/>
        </para>
      </listitem>
      <listitem>
        <para>
          <xref linkend="pycairo"/>
        </para>
      </listitem>
      <listitem>
        <para>
          <xref linkend="pycairo2"/>
        </para>
      </listitem>
      <listitem>
        <para>
          <xref linkend="pycryptodome"/>
        </para>
      </listitem>
      <listitem>
        <para>
          <xref linkend="python-dbusmock"/>
        </para>
      </listitem>
      <listitem>
        <para>
          <xref linkend="pygments"/>
        </para>
      </listitem>
      <listitem>
        <para>
          <xref linkend="pygobject2"/>
        </para>
      </listitem>
      <listitem>
        <para>
          <xref linkend="pygobject3"/>
        </para>
      </listitem>
      <listitem>
        <para>
          <xref linkend="pygtk"/>
        </para>
      </listitem>
      <listitem>
        <para>
          <xref linkend="pyxdg"/>
        </para>
      </listitem>
<!--      <listitem>
        <para>
          <xref linkend="funcsigs"/>
        </para>
      </listitem>
-->
<!--      <listitem>
        <para>
          <xref linkend="Beaker"/>
        </para>
      </listitem>
-->
      <listitem>
        <para>
          <xref linkend="libxml2py2"/>
        </para>
      </listitem>
      <listitem>
        <para>
          <xref linkend="lxml"/>
        </para>
      </listitem>
      <listitem revision="sysv">
        <para>
          <xref linkend="MarkupSafe"/>
        </para>
      </listitem>
      <listitem revision="sysv">
        <para>
          <xref linkend="Jinja2"/>
        </para>
      </listitem>
      <listitem>
        <para>
          <xref linkend="Mako"/>
        </para>
      </listitem>
<!--      <listitem>
        <para>
          <xref linkend="python-slip"/>
        </para>
      </listitem>
-->
      <listitem>
        <para>
          <xref linkend="scour"/>
        </para>
      </listitem>
      <listitem>
        <para>
          <xref linkend="six"/>
        </para>
      </listitem>
      <listitem>
        <para>
          <xref linkend="PyYAML"/>
        </para>
      </listitem>
    </itemizedlist>
  </sect2>

  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="asciidoc.xml"/>

  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="cython.xml"/>

  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="dbus-python.xml"/>

<!--  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="decorator.xml"/>
-->
  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="docutils.xml"/>

  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="py3c.xml"/>

  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="pyatspi2.xml"/>
<!--
  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="py2cairo.xml"/>
-->
  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="pycairo.xml"/>

  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="pycairo2.xml"/>

  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="pycryptodome.xml"/>

  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="python-dbusmock.xml"/>

  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="pygments.xml"/>

  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="pygobject2.xml"/>

  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="pygobject3.xml"/>

  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="pygtk.xml"/>

  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="pyxdg.xml"/>

<!--
  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="setuptools.xml"/>
-->

<!--  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="funcsigs.xml"/> -->

<!--  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="beaker.xml"/>-->

  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="libxml2py2.xml"/>

  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="lxml.xml"/>

  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="markupsafe.xml"/>

  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="jinja2.xml"/>

  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="mako.xml"/>

<!--  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="python-slip.xml"/>-->

  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="pyyaml.xml"/>

  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="scour.xml"/>

  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="six.xml"/>

</sect1>