source: general/prog/python-modules.xml@ a2bf8b17

<?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;

  <!ENTITY notify-python-download-http
           "http://www.galago-project.org/files/releases/source/notify-python/notify-python-&notify-python-version;.tar.bz2">
  <!ENTITY notify-python-download-ftp  " ">
  <!ENTITY notify-python-md5sum        "d247cf79b46cef7495deb0a76334f81d">
  <!ENTITY notify-python-size          "212 KB">
  <!ENTITY notify-python-buildsize     "2.3 MB">
  <!ENTITY notify-python-time          "less than 0.1 SBU">

  <!ENTITY py2cairo-download-http
           "http://cairographics.org/releases/py2cairo-&py2cairo-version;.tar.bz2">
  <!ENTITY py2cairo-download-ftp  " ">
  <!ENTITY py2cairo-md5sum        "20337132c4ab06c1146ad384d55372c5">
  <!ENTITY py2cairo-size          "400 KB">
  <!ENTITY py2cairo-buildsize     "3.6 MB">
  <!ENTITY py2cairo-time          "less than 0.1 SBU">

  <!ENTITY pygobject2-download-http
           "&gnome-download-http;/pygobject/2.28/pygobject-&pygobject2-version;.tar.xz">
  <!ENTITY pygobject2-download-ftp
           "&gnome-download-ftp;/pygobject/2.28/pygobject-&pygobject2-version;.tar.xz">
  <!ENTITY pygobject2-md5sum        "9415cb7f2b3a847f2310ccea258b101e">
  <!ENTITY pygobject2-size          "730 KB">
  <!ENTITY pygobject2-buildsize     "25 MB">
  <!ENTITY pygobject2-time          "0.2 SBU">

  <!ENTITY pygobject3-download-http
           "&gnome-download-http;/pygobject/3.4/pygobject-&pygobject3-version;.tar.xz">
  <!ENTITY pygobject3-download-ftp
           "&gnome-download-ftp;/pygobject/3.4/pygobject-&pygobject3-version;.tar.xz">
  <!ENTITY pygobject3-md5sum        "a17b3897507f179d643e02f5abf111ac">
  <!ENTITY pygobject3-size          "604 KB">
  <!ENTITY pygobject3-buildsize     "16 MB">
  <!ENTITY pygobject3-time          "0.1 SBU">

  <!ENTITY pygtk-download-http
           "&gnome-download-http;/pygtk/2.24/pygtk-&pygtk-version;.tar.bz2">
  <!ENTITY pygtk-download-ftp
           "&gnome-download-ftp;/pygtk/2.24/pygtk-&pygtk-version;.tar.bz2">
  <!ENTITY pygtk-md5sum        "a1051d5794fd7696d3c1af6422d17a49">
  <!ENTITY pygtk-size          "2.2 MB">
  <!ENTITY pygtk-buildsize     "83 MB">
  <!ENTITY pygtk-time          "0.7 SBU">

  <!ENTITY pyatspi2-download-http
           "&gnome-download-http;/pyatspi/2.6/pyatspi-&pyatspi2-version;.tar.xz">
  <!ENTITY pyatspi2-download-ftp
           "&gnome-download-ftp;/pyatspi/2.6/pyatspi-&pyatspi2-version;.tar.xz">
  <!ENTITY pyatspi2-md5sum        "95c48cae83d1f6d6cd13615df14124e5">
  <!ENTITY pyatspi2-size          "284 KB">
  <!ENTITY pyatspi2-buildsize     "3.5 MB">
  <!ENTITY pyatspi2-time          "less than 0.1 SBU">

  <!ENTITY pyrex-download-http
           "http://www.cosc.canterbury.ac.nz/~greg/python/Pyrex/Pyrex-&pyrex-version;.tar.gz">
  <!ENTITY pyrex-download-ftp  " ">
  <!ENTITY pyrex-md5sum        "515dee67d15d4393841e2d60e8341947">
  <!ENTITY pyrex-size          "252 KB">
  <!ENTITY pyrex-buildsize     "4.0 MB">
  <!ENTITY pyrex-time          "less than 0.1 SBU">
]>

<sect1 id="python-modules" xreflabel="Python modules">
  <?dbhtml filename="python-modules.html" ?>

  <sect1info>
    <othername>$LastChangedBy$</othername>
    <date>$Date$</date>
  </sect1info>

  <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.
      Installation of the modules shown on this page is meant to follow from top
      to bottom to handle optional dependencies in each module.
    </para>

    <itemizedlist spacing="compact">
      <listitem>
        <para>
          <xref linkend="notify-python"/>
        </para>
      </listitem>
      <listitem>
        <para>
          <xref linkend="py2cairo"/>
        </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="pyatspi2"/>
        </para>
      </listitem>
      <listitem>
        <para>
          <xref linkend="pyrex"/>
        </para>
      </listitem>
    </itemizedlist>
  </sect2>

  <!-- Begin Notify Python -->
  <sect2 id="notify-python" xreflabel="Notify Python-&notify-python-version;">

    <title>Notify Python-&notify-python-version;</title>

    <indexterm zone="notify-python">
      <primary sortas="a-notify-python">notify-python</primary>
    </indexterm>

    <sect3 role="package">
      <title>Introduction to Notify Python Module</title>

      <para>
        Notify Python provides <application>Python 2</application>
        bindings to the <application>libnotify</application>.
      </para>

      &lfs72_checked;

      <bridgehead renderas="sect4">Package Information</bridgehead>
      <itemizedlist spacing="compact">
        <listitem>
          <para>
            Download (HTTP): <ulink url="&notify-python-download-http;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download (FTP): <ulink url="&notify-python-download-ftp;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download MD5 sum: &notify-python-md5sum;
          </para>
        </listitem>
        <listitem>
          <para>
            Download size: &notify-python-size;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated disk space required: &notify-python-buildsize;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated build time: &notify-python-time;
          </para>
        </listitem>
      </itemizedlist>

    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>
          Required patch:
          <ulink url="&patch-root;/notify-python-&notify-python-version;-libnotify-0.7-1.patch"/>
        </para>
      </listitem>
    </itemizedlist>

      <bridgehead renderas="sect4">Notify Python Dependencies</bridgehead>

      <bridgehead renderas="sect5">Required</bridgehead>
      <para role="required">
        <xref linkend="libnotify"/> and
        <xref linkend="pygtk"/> (with <xref linkend="gtk2"/> support).
      </para>

      <para condition="html" role="usernotes">
        User Notes: <ulink url="&blfs-wiki;/notify-python"/>
      </para>
    </sect3>

    <sect3 role="installation">
      <title>Installation of Notify Python</title>

      <para>
        Install <application>Notify Python</application> by running the following
        commands:
      </para>

<screen><userinput>patch -Np1 -i ../notify-python-&notify-python-version;-libnotify-0.7-1.patch &amp;&amp;
./configure --prefix=/usr &amp;&amp;
make</userinput></screen>

      <para>
        This package does not come with a testsuite.
      </para>

      <para>
        Now, as the <systemitem class="username">root</systemitem> user:
      </para>

<screen role="root"><userinput>make install</userinput></screen>
    </sect3>

    <sect3 role="content">
      <title>Contents</title>

      <segmentedlist>
        <segtitle>Installed Directory</segtitle>

        <seglistitem>
          <seg>
            /usr/lib/python&python2-majorver;/site-packages/gtk-2.0/pynotify
          </seg>
        </seglistitem>
      </segmentedlist>
    </sect3>
  </sect2>
  <!-- End Notify Python -->

  <!-- Begin Py2cairo -->
  <sect2 id="py2cairo" xreflabel="Py2cairo-&py2cairo-version;">

    <title>Py2cairo-&py2cairo-version;</title>

    <indexterm zone="py2cairo">
      <primary sortas="a-Py2cairo">Py2cairo</primary>
    </indexterm>

    <sect3 role="package">
      <title>Introduction to Py2cairo Module</title>

      <para>
        Py2cairo provides <application>Python 2</application> bindings to
        <application>Cairo</application>.
      </para>

      &lfs72_checked;

      <bridgehead renderas="sect4">Package Information</bridgehead>
      <itemizedlist spacing="compact">
        <listitem>
          <para>
            Download (HTTP): <ulink url="&py2cairo-download-http;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download (FTP): <ulink url="&py2cairo-download-ftp;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download MD5 sum: &py2cairo-md5sum;
          </para>
        </listitem>
        <listitem>
          <para>
            Download size: &py2cairo-size;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated disk space required: &py2cairo-buildsize;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated build time: &py2cairo-time;
          </para>
        </listitem>
      </itemizedlist>

      <bridgehead renderas="sect4">Py2cairo Dependencies</bridgehead>

      <bridgehead renderas="sect5">Required</bridgehead>
      <para role="required">
        <xref linkend="python2"/> and
        <xref linkend="cairo"/>
      </para>

      <bridgehead renderas="sect5">Optional</bridgehead>
      <para role="optional">
        <ulink url="http://pytest.org">pytest</ulink>
      </para>

      <para condition="html" role="usernotes">
        User Notes: <ulink url="&blfs-wiki;/py2cairo"/>
      </para>
    </sect3>

    <sect3 role="installation">
      <title>Installation of Py2cairo</title>

      <para>
        Install <application>Py2cairo</application> by running the following
        commands:
      </para>

<screen><userinput>./waf configure --prefix=/usr &amp;&amp;
./waf build</userinput></screen>

      <para>
        The test suite requires the optional <application>pytest</application>
        package.  If installed, it is run by changing to the 
        <filename class='directory'>test</filename> directory and running 
        <userinput>py.test</userinput>.
      </para>

      <para>
        Now, as the <systemitem class="username">root</systemitem> user:
      </para>

<screen role="root"><userinput>./waf install</userinput></screen>
    </sect3>

    <sect3 role="content">
      <title>Contents</title>

      <segmentedlist>
        <segtitle>Installed Libraries</segtitle>
        <segtitle>Installed Directory</segtitle>

        <seglistitem>
          <seg>_cairo.so</seg>
          <seg>
            /usr/include/pycairo and
            /usr/lib/python&python2-majorver;/site-packages/cairo
          </seg>
        </seglistitem>
      </segmentedlist>
    </sect3>
  </sect2>
  <!-- End Py2cairo -->

  <!-- Begin PyGObject2 -->
  <sect2 id="pygobject2" xreflabel="PyGObject-&pygobject2-version;">

    <title>PyGObject-&pygobject2-version;</title>

    <indexterm zone="pygobject2">
      <primary sortas="a-PyGObject">PyGObject</primary>
    </indexterm>

    <sect3 role="package">
      <title>Introduction to PyGObject Module</title>

      <para>
        PyGObject-&pygobject2-version; provides
        <application>Python 2</application> bindings to the GObject class from
        <application>GLib</application>.
      </para>

      &lfs72_checked;

      <bridgehead renderas="sect4">Package Information</bridgehead>
      <itemizedlist spacing="compact">
        <listitem>
          <para>
            Download (HTTP): <ulink url="&pygobject2-download-http;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download (FTP): <ulink url="&pygobject2-download-ftp;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download MD5 sum: &pygobject2-md5sum;
          </para>
        </listitem>
        <listitem>
          <para>
            Download size: &pygobject2-size;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated disk space required: &pygobject2-buildsize;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated build time: &pygobject2-time;
          </para>
        </listitem>
      </itemizedlist>

    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>
          Required patch (if you have installed
          <xref linkend="gobject-introspection"/>):
          <ulink url="&patch-root;/pygobject-&pygobject2-version;-introspection-1.patch"/>
        </para>
      </listitem>
    </itemizedlist>

      <bridgehead renderas="sect4">PyGObject Dependencies</bridgehead>

      <bridgehead renderas="sect5">Required</bridgehead>
      <para role="required">
        <xref linkend="glib2"/> and
        <xref linkend="py2cairo"/>
      </para>

      <bridgehead renderas="sect5">Optional</bridgehead>
      <para role="optional">
        <xref linkend="libxslt"/> (to Build Documentation)
      </para>

      <para condition="html" role="usernotes">
        User Notes: <ulink url="&blfs-wiki;/pygobject2"/>
      </para>
    </sect3>

    <sect3 role="installation">
      <title>Installation of PyGObject</title>

      <para>
        Install <application>PyGObject</application> by running the following
        commands:
      </para>

<screen><userinput>patch -p1 &lt; ../pygobject-&pygobject2-version;-introspection-1.patch &amp;&amp;
./configure --prefix=/usr &amp;&amp;
make</userinput></screen>

      <para>
        This package does not have a working testsuite.
      </para>

      <para>
        Now, as the <systemitem class="username">root</systemitem> user:
      </para>

<screen role="root"><userinput>make install</userinput></screen>
    </sect3>

    <sect3 role="commands">
      <title>Command Explanations</title>

      <para>
        <option>--disable-docs</option>: This option disables the rebuilding of
        the html documentation if <xref linkend="libxslt"/> is installed.
      </para>

    </sect3>

    <sect3 role="content">
      <title>Contents</title>

      <segmentedlist>
        <segtitle>Installed Programs</segtitle>
        <segtitle>Installed Libraries</segtitle>
        <segtitle>Installed Directories</segtitle>

        <seglistitem>
          <seg>pygobject-codegen-2.0</seg>
          <seg>
            libpyglib-2.0-python.so,
            _gio.so,
            unix.so,
            _glib.so and
            _gobject.so.
          </seg>
          <seg>
            /usr/include/pygtk-2.0,
            /usr/lib/python&python2-majorver;/site-packages/gtk-2.0/{gio,glib,gobject},
            /usr/share/gtk-doc/html/pygobject and
            /usr/share/pygobject/2.0
          </seg>
        </seglistitem>
      </segmentedlist>
    </sect3>
  </sect2>
  <!-- End PyGObject2 -->

  <!-- Begin PyGObject3 -->
  <sect2 id="pygobject3" xreflabel="PyGObject-&pygobject3-version;">

    <title>PyGObject-&pygobject3-version;</title>

    <indexterm zone="pygobject3">
      <primary sortas="a-PyGObject">PyGObject</primary>
    </indexterm>

    <sect3 role="package">
      <title>Introduction to PyGObject Module</title>

      <para>
        PyGObject-&pygobject3-version; provides
        <application>Python 2</application> bindings to the GObject
        class from <application>GLib</application>.
      </para>

      &lfs72_checked;

      <bridgehead renderas="sect4">Package Information</bridgehead>
      <itemizedlist spacing="compact">
        <listitem>
          <para>
            Download (HTTP): <ulink url="&pygobject3-download-http;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download (FTP): <ulink url="&pygobject3-download-ftp;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download MD5 sum: &pygobject3-md5sum;
          </para>
        </listitem>
        <listitem>
          <para>
            Download size: &pygobject3-size;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated disk space required: &pygobject3-buildsize;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated build time: &pygobject3-time;
          </para>
        </listitem>
      </itemizedlist>

      <bridgehead renderas="sect4">PyGObject Dependencies</bridgehead>

      <bridgehead renderas="sect5">Required</bridgehead>
      <para role="required">
        <xref linkend="gobject-introspection"/> and
        <xref linkend="py2cairo"/>
      </para>

      <bridgehead renderas="sect5">Optional</bridgehead>
      <para role="optional">
        <xref linkend="libxslt"/> (to Build Documentation)
      </para>

      <para condition="html" role="usernotes">
        User Notes: <ulink url="&blfs-wiki;/pygobject3"/>
      </para>
    </sect3>

    <sect3 role="installation">
      <title>Installation of PyGObject</title>

      <para>
        Install <application>PyGObject</application> by running the following
        commands:
      </para>

<screen><userinput>./configure --prefix=/usr &amp;&amp;
make</userinput></screen>

      <para>
        To test the results, issue: <command>make check</command>.
      </para>

      <para>
        Now, as the <systemitem class="username">root</systemitem> user:
      </para>

<screen role="root"><userinput>make install</userinput></screen>

    </sect3>

    <sect3 role="commands">
      <title>Command Explanations</title>

      <para>
        <parameter>--disable-docs</parameter>: This option disables the
        rebuilding of the html documentation if <xref linkend="libxslt"/> is
        installed.
      </para>

    </sect3>

    <sect3 role="content">
      <title>Contents</title>

      <segmentedlist>
        <segtitle>Installed Library</segtitle>
        <segtitle>Installed Directories</segtitle>

        <seglistitem>
          <seg>
            libpyglib-gi-2.0-python.so
           </seg>
          <seg>
            /usr/include/pygobject-3.0 and
            /usr/lib/python&python2-majorver;/site-packages/gi
          </seg>
        </seglistitem>
      </segmentedlist>

    </sect3>

  </sect2>
  <!-- End PyGObject -->

  <!-- Begin PyGTK -->
  <sect2 id="pygtk" xreflabel="PyGTK-&pygtk-version;">

    <title>PyGTK-&pygtk-version;</title>

    <indexterm zone="pygtk">
      <primary sortas="a-PyGTK">PyGTK</primary>
    </indexterm>

    <sect3 role="package">
      <title>Introduction to PyGTK Module</title>

      <para>
        PyGTK lets you to easily create programs with a graphical user interface
        using the <application>Python</application> programming language.
      </para>

      &lfs72_checked;

      <bridgehead renderas="sect4">Package Information</bridgehead>
      <itemizedlist spacing="compact">
        <listitem>
          <para>
            Download (HTTP): <ulink url="&pygtk-download-http;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download (FTP): <ulink url="&pygtk-download-ftp;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download MD5 sum: &pygtk-md5sum;
          </para>
        </listitem>
        <listitem>
          <para>
            Download size: &pygtk-size;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated disk space required: &pygtk-buildsize;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated build time: &pygtk-time;
          </para>
        </listitem>
      </itemizedlist>

      <bridgehead renderas="sect4">PyGTK Dependencies</bridgehead>

      <bridgehead renderas="sect5">Required</bridgehead>
      <para role="required">
        <xref linkend="pygobject2"/>
      </para>

      <bridgehead renderas="sect5">Required (atk module)</bridgehead>
      <para role="required">
        <xref linkend="atk"/>
      </para>

      <bridgehead renderas="sect5">Required (pango module)</bridgehead>
      <para role="required">
        <xref linkend="pango"/>
      </para>

      <bridgehead renderas="sect5">Required (pangocairo module)</bridgehead>
      <para role="required">
        <xref linkend="py2cairo"/> and
        <xref linkend="pango"/>
      </para>

      <bridgehead renderas="sect5">Required (gtk and gtk.unixprint modules)</bridgehead>
      <para role="required">
        <xref linkend="py2cairo"/> and
        <xref linkend="gtk2"/>.
      </para>

      <bridgehead renderas="sect5">Required (gtk.libglade module)</bridgehead>
      <para role="required">
        <xref linkend="py2cairo"/> and
        <xref linkend="libglade"/>.
      </para>

      <bridgehead renderas="sect5">Optional</bridgehead>
      <para role="optional">
        <ulink url="http://numpy.scipy.org/">NumPy</ulink>
      </para>

      <bridgehead renderas="sect5">Optional (to Build Documentation)</bridgehead>
      <para role="optional">
        <xref linkend="libxslt"/>
      </para>

      <para condition="html" role="usernotes">
        User Notes: <ulink url="&blfs-wiki;/pygtk"/>
      </para>
    </sect3>

    <sect3 role="installation">
      <title>Installation of PyGTK</title>

      <para>
        Install <application>PyGTK</application> by running the following
        commands:
      </para>

<screen><userinput>./configure --prefix=/usr &amp;&amp;
make</userinput></screen>

      <para>
        The tests must be run from an active X display. If this is so, issue:
        <command>make check</command>.
      </para>

      <para>
        Now, as the <systemitem class="username">root</systemitem> user:
      </para>

<screen role="root"><userinput>make install</userinput></screen>
    </sect3>

    <sect3 role="commands">
      <title>Command Explanations</title>

      <para>
        <parameter>--enable-docs</parameter>: This option enables rebuilding the
        html documentation if <xref linkend="libxslt"/> is installed.
      </para>
    </sect3>

    <sect3 role="content">
      <title>Contents</title>

      <segmentedlist>
        <segtitle>Installed Programs</segtitle>
        <segtitle>Installed Libraries</segtitle>
        <segtitle>Installed Directories</segtitle>

        <seglistitem>
          <seg>pygtk-codegen-2.0 and pygtk-demo.</seg>
          <seg>
            atk.so,
            _gtk.so,
            glade.so,
            gtkunixprint.so,
            pango.so and
            pangocairo.so.
          </seg>
          <seg>
            /usr/include/pygtk-2.0,
            /usr/lib/pygtk,
            /usr/lib/python&python2-majorver;/site-packages/gtk-2.0,
            /usr/share/gtk-doc/html/pygtk and
            /usr/share/pygtk.
          </seg>
        </seglistitem>
      </segmentedlist>

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

        <varlistentry id="pygtk-codegen-2.0">
          <term><command>pygtk-codegen-2.0</command></term>
          <listitem>
            <para>
              is a wrapper script to run the <application>PyGTK</application>
              codegen module.
            </para>
            <indexterm zone="pygtk pygtk-codegen-2.0">
              <primary sortas="b-pygtk-codegen-2.0">pygtk-codegen-2.0</primary>
            </indexterm>
          </listitem>
        </varlistentry>

        <varlistentry id="pygtk-demo">
          <term><command>pygtk-demo</command></term>
          <listitem>
            <para>
              is a Python wrapper to run the <application>PyGTK</application>
              demo program.
            </para>
            <indexterm zone="pygtk pygtk-demo">
              <primary sortas="b-pygtk-demo">pygtk-demo</primary>
            </indexterm>
          </listitem>
        </varlistentry>
      </variablelist>
    </sect3>
  </sect2>
  <!-- End PyGTK -->

  <!-- Begin pyatspi2 -->
  <sect2 id="pyatspi2" xreflabel="pyatspi2-&pyatspi2-version;">

    <title>pyatspi2-&pyatspi2-version;</title>

    <indexterm zone="pyatspi2">
      <primary sortas="a-pyatspi2">pyatspi2</primary>
    </indexterm>

    <sect3 role="package">
      <title>Introduction to pyatspi2</title>

      <para>
        The <application>pyatspi2</application> package contains Python2
        bindings for the core components of GNOME Accessibility.
      </para>

      &lfs72_checked;

      <bridgehead renderas="sect4">Package Information</bridgehead>
      <itemizedlist spacing="compact">
        <listitem>
          <para>
            Download (HTTP): <ulink url="&pyatspi2-download-http;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download (FTP): <ulink url="&pyatspi2-download-ftp;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download MD5 sum: &pyatspi2-md5sum;
          </para>
        </listitem>
        <listitem>
          <para>
            Download size: &pyatspi2-size;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated disk space required: &pyatspi2-buildsize;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated build time: &pyatspi2-time;
          </para>
        </listitem>
      </itemizedlist>

      <bridgehead renderas="sect4">pyatspi2 Dependencies</bridgehead>

      <bridgehead renderas="sect5">Required</bridgehead>
      <para role="required">
        <xref linkend="pygobject3"/>
      </para>

      <bridgehead renderas="sect5">Recommended</bridgehead>
      <para role="recommended">
        <xref linkend="at-spi2-core"/>
      </para>

      <para condition="html" role="usernotes">
        User Notes: <ulink url="&blfs-wiki;/pyatspi2"/>
      </para>

    </sect3>

    <sect3 role="installation">
      <title>Installation of pyatspi2</title>

      <para>
        Install <application>pyatspi2</application> by running the following
        commands:
      </para>

<screen><userinput>./configure --prefix=/usr &amp;&amp;
make</userinput></screen>

    <para>
      This package does not come with a testsuite.
    </para>

    <para>
      Now, as the <systemitem class="username">root</systemitem> user:
    </para>

<screen role="root"><userinput>make install</userinput></screen>

    </sect3>

    <sect3 role="content">
      <title>Contents</title>

      <segmentedlist>
        <segtitle>Installed Directory</segtitle>

        <seglistitem>
          <seg>
            /usr/lib/python&python2-majorver;/site-packages/pyatspi
          </seg>
        </seglistitem>
      </segmentedlist>

    </sect3>

  </sect2>
  <!-- End pyatspi2 -->

  <!-- Begin Pyrex -->
  <sect2 id="pyrex" xreflabel="Pyrex-&pyrex-version;">

    <title>Pyrex-&pyrex-version;</title>

    <indexterm zone="pyrex">
      <primary sortas="a-Pyrex">pyrex</primary>
    </indexterm>

    <sect3 role="package">
      <title>Introduction to Pyrex Module</title>

      <para>
        <application>Pyrex</application> is language used for writing
        <application>Python</application> extension modules.
      </para>

      &lfs72_checked;

      <bridgehead renderas="sect4">Package Information</bridgehead>
      <itemizedlist spacing="compact">
        <listitem>
          <para>
          Download (HTTP): <ulink url="&pyrex-download-http;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download (FTP): <ulink url="&pyrex-download-ftp;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download MD5 sum: &pyrex-md5sum;
          </para>
        </listitem>
        <listitem>
          <para>
            Download size: &pyrex-size;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated disk space required: &pyrex-buildsize;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated build time: &pyrex-time;
          </para>
        </listitem>
      </itemizedlist>

      <bridgehead renderas="sect4">Pyrex Dependencies</bridgehead>

      <bridgehead renderas="sect5">Required</bridgehead>
      <para role="required">
        <xref linkend="python2"/>
      </para>

      <para condition="html" role="usernotes">
        User Notes: <ulink url="&blfs-wiki;/pyrex"/>
      </para>
    </sect3>

    <sect3 role="installation">
      <title>Installation of Pyrex</title>

      <para>
        Install <application>pyrex</application> by running the following
        commands as the <systemitem class="username">root</systemitem> user:
      </para>

<screen role="root"><userinput>python setup.py install</userinput></screen>
    </sect3>

    <sect3 role="commands">
      <title>Command Explanations</title>

      <para>
        <command>python setup.py install</command>: This command installs
        the package. There are other options available, see
        <command>python setup.py --help-commands</command> for details.
      </para>

    </sect3>

    <sect3 role="content">
      <title>Contents</title>

      <segmentedlist>
        <segtitle>Installed Programs</segtitle>
        <segtitle>Installed Directories</segtitle>

        <seglistitem>
          <seg>
            pyrexc
          </seg>
          <seg>
            /usr/lib/python&python2-majorver;/site-packages/Pyrex
          </seg>
        </seglistitem>
      </segmentedlist>

    </sect3>

  </sect2>
  <!-- End Pyrex -->

</sect1>