[ce892ab3] | 1 | <?xml version="1.0" encoding="ISO-8859-1"?>
|
---|
| 2 | <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
---|
| 3 | "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
|
---|
| 4 | <!ENTITY % general-entities SYSTEM "../../general.ent">
|
---|
| 5 | %general-entities;
|
---|
| 6 | ]>
|
---|
| 7 |
|
---|
[d2b1e2e] | 8 | <sect1 id="python-modules" xreflabel="Python Modules">
|
---|
[ce892ab3] | 9 | <?dbhtml filename="python-modules.html" ?>
|
---|
| 10 |
|
---|
| 11 |
|
---|
| 12 | <title>Python Modules</title>
|
---|
| 13 |
|
---|
| 14 | <indexterm zone="python-modules">
|
---|
[d2b1e2e] | 15 | <primary sortas="a-Python-Modules">Python Modules</primary>
|
---|
[ce892ab3] | 16 | </indexterm>
|
---|
| 17 |
|
---|
| 18 | <sect2 role="package">
|
---|
| 19 | <title>Introduction to Python Modules</title>
|
---|
| 20 |
|
---|
[66b546a] | 21 | <para>
|
---|
| 22 | The <application>Python</application> module packages add useful objects
|
---|
| 23 | to the <application>Python</application> language. Modules utilized by
|
---|
| 24 | packages throughout BLFS are listed here, along with their dependencies.
|
---|
| 25 | </para>
|
---|
[ce892ab3] | 26 |
|
---|
[bce49fc] | 27 | <note>
|
---|
| 28 | <para>
|
---|
| 29 | If you want to run tests, several of the following modules depend on
|
---|
| 30 | the <option>sqlite3</option> core python module that has not been
|
---|
| 31 | built in LFS. It is therefore recommended to rebuild Python after
|
---|
| 32 | installing the recommended dependency listed in
|
---|
| 33 | <xref linkend="python3"/>.
|
---|
| 34 | </para>
|
---|
| 35 | </note>
|
---|
| 36 |
|
---|
[8c2cfcf] | 37 | <important>
|
---|
| 38 | <para>
|
---|
| 39 | In BLFS, we normally build and install Python 3 modules with
|
---|
| 40 | <command>pip3</command>. Please take care that the
|
---|
| 41 | <command>pip3 install</command> commands in the book should be
|
---|
| 42 | run as &root; unless it's for a Python virtual environment. Running
|
---|
[7777643] | 43 | <command>pip3 install</command> as a non-&root; user may seem to
|
---|
[1bd1f767] | 44 | work fine, but it will cause the installed module to be inaccessible by
|
---|
[8c2cfcf] | 45 | other users.
|
---|
| 46 | </para>
|
---|
| 47 | <para>
|
---|
| 48 | <command>pip3 install</command> will not reinstall an already
|
---|
| 49 | installed module by default. For using the
|
---|
| 50 | <command>pip3 install</command> command to upgrade a module (for
|
---|
[7777643] | 51 | example, from meson-0.61.3 to meson-0.62.0), insert
|
---|
| 52 | <parameter>--upgrade</parameter> into the command line. If it's really
|
---|
[8c2cfcf] | 53 | necessary to downgrade a module or reinstall the same version for
|
---|
[7777643] | 54 | some reason, insert <parameter>--force-reinstall</parameter> into
|
---|
[8c2cfcf] | 55 | the command line.
|
---|
| 56 | </para>
|
---|
| 57 | </important>
|
---|
| 58 |
|
---|
[ce892ab3] | 59 | <itemizedlist spacing="compact">
|
---|
[3ef383c] | 60 | <!--
|
---|
| 61 | <listitem>
|
---|
| 62 | <para>
|
---|
| 63 | <xref linkend="pythonhosted"/>
|
---|
| 64 | </para>
|
---|
| 65 | </listitem>
|
---|
| 66 | -->
|
---|
[141ee0a5] | 67 | <listitem>
|
---|
| 68 | <para>
|
---|
| 69 | <xref linkend="asciidoc"/>
|
---|
| 70 | </para>
|
---|
| 71 | </listitem>
|
---|
[381cfd18] | 72 | <listitem>
|
---|
| 73 | <para>
|
---|
| 74 | <xref linkend="cachecontrol"/>
|
---|
| 75 | </para>
|
---|
| 76 | </listitem>
|
---|
[5a434ec] | 77 | <listitem>
|
---|
| 78 | <para>
|
---|
| 79 | <xref linkend="cssselect"/>
|
---|
| 80 | </para>
|
---|
| 81 | </listitem>
|
---|
[7b459c22] | 82 | <listitem>
|
---|
| 83 | <para>
|
---|
| 84 | <xref linkend="cython"/>
|
---|
| 85 | </para>
|
---|
| 86 | </listitem>
|
---|
[ae96c4b] | 87 | <listitem>
|
---|
| 88 | <para>
|
---|
[53d92c8] | 89 | <xref linkend="python-dbusmock"/>
|
---|
[ae96c4b] | 90 | </para>
|
---|
| 91 | </listitem>
|
---|
[53d92c8] | 92 | <listitem>
|
---|
[14c0be2f] | 93 | <para>
|
---|
[53d92c8] | 94 | <xref linkend="dbus-python"/>
|
---|
[14c0be2f] | 95 | </para>
|
---|
| 96 | </listitem>
|
---|
[93883ec] | 97 | <listitem>
|
---|
[22f9c48] | 98 | <para>
|
---|
[d3ea9e8] | 99 | <xref linkend="docutils"/>
|
---|
[8558044] | 100 | </para>
|
---|
[22f9c48] | 101 | </listitem>
|
---|
[622cc86e] | 102 | <listitem>
|
---|
| 103 | <para>
|
---|
| 104 | <xref linkend="doxypypy"/>
|
---|
| 105 | </para>
|
---|
| 106 | </listitem>
|
---|
| 107 | <listitem>
|
---|
| 108 | <para>
|
---|
| 109 | <xref linkend="doxyqml"/>
|
---|
| 110 | </para>
|
---|
| 111 | </listitem>
|
---|
[8828c760] | 112 | <listitem>
|
---|
| 113 | <para>
|
---|
| 114 | <xref linkend="gi-docgen"/>
|
---|
| 115 | </para>
|
---|
| 116 | </listitem>
|
---|
[ce892ab3] | 117 | <listitem>
|
---|
[66b546a] | 118 | <para>
|
---|
[53d92c8] | 119 | <xref linkend="lxml"/>
|
---|
[d3ea9e8] | 120 | </para>
|
---|
[ce892ab3] | 121 | </listitem>
|
---|
[a73f7b02] | 122 | <listitem>
|
---|
| 123 | <para>
|
---|
[53d92c8] | 124 | <xref linkend="Mako"/>
|
---|
[a73f7b02] | 125 | </para>
|
---|
| 126 | </listitem>
|
---|
[7b3ac32] | 127 | <listitem>
|
---|
| 128 | <para>
|
---|
| 129 | <xref linkend="numpy"/>
|
---|
| 130 | </para>
|
---|
| 131 | </listitem>
|
---|
[82eddd4] | 132 | <listitem>
|
---|
| 133 | <para>
|
---|
[53d92c8] | 134 | <xref linkend="packaging"/>
|
---|
[82eddd4] | 135 | </para>
|
---|
| 136 | </listitem>
|
---|
[10092cde] | 137 | <listitem>
|
---|
| 138 | <para>
|
---|
[53d92c8] | 139 | <xref linkend="py3c"/>
|
---|
[10092cde] | 140 | </para>
|
---|
| 141 | </listitem>
|
---|
[07f61e4] | 142 | <listitem>
|
---|
| 143 | <para>
|
---|
[53d92c8] | 144 | <xref linkend="pyatspi2"/>
|
---|
[07f61e4] | 145 | </para>
|
---|
| 146 | </listitem>
|
---|
[f4472d1] | 147 | <listitem>
|
---|
[66b546a] | 148 | <para>
|
---|
[53d92c8] | 149 | <xref linkend="pycairo2"/>
|
---|
[66b546a] | 150 | </para>
|
---|
[ce892ab3] | 151 | </listitem>
|
---|
| 152 | <listitem>
|
---|
[66b546a] | 153 | <para>
|
---|
[53d92c8] | 154 | <xref linkend="pycairo"/>
|
---|
[66b546a] | 155 | </para>
|
---|
[ce892ab3] | 156 | </listitem>
|
---|
[60f566d9] | 157 | <!-- <listitem>
|
---|
[66b546a] | 158 | <para>
|
---|
[53d92c8] | 159 | <xref linkend="pycryptodome"/>
|
---|
[66b546a] | 160 | </para>
|
---|
[60f566d9] | 161 | </listitem> -->
|
---|
[d938ca94] | 162 | <listitem>
|
---|
| 163 | <para>
|
---|
[53d92c8] | 164 | <xref linkend="pygments"/>
|
---|
[22f9c48] | 165 | </para>
|
---|
[08093b3] | 166 | </listitem>
|
---|
[cd964c8] | 167 | <listitem>
|
---|
| 168 | <para>
|
---|
[53d92c8] | 169 | <xref linkend="pygobject2"/>
|
---|
[cd964c8] | 170 | </para>
|
---|
| 171 | </listitem>
|
---|
[7d35ee59] | 172 | <listitem>
|
---|
[23e36d1] | 173 | <para>
|
---|
[53d92c8] | 174 | <xref linkend="pygobject3"/>
|
---|
[23e36d1] | 175 | </para>
|
---|
| 176 | </listitem>
|
---|
[53d92c8] | 177 | <listitem>
|
---|
[22f9c48] | 178 | <para>
|
---|
[53d92c8] | 179 | <xref linkend="pygtk"/>
|
---|
[22f9c48] | 180 | </para>
|
---|
| 181 | </listitem>
|
---|
[53d92c8] | 182 | <listitem>
|
---|
[22f9c48] | 183 | <para>
|
---|
[53d92c8] | 184 | <xref linkend="pyparsing"/>
|
---|
[22f9c48] | 185 | </para>
|
---|
| 186 | </listitem>
|
---|
[cbc9210] | 187 | <listitem>
|
---|
| 188 | <para>
|
---|
| 189 | <xref linkend="pyserial"/>
|
---|
| 190 | </para>
|
---|
| 191 | </listitem>
|
---|
[0499056] | 192 | <listitem>
|
---|
[22f9c48] | 193 | <para>
|
---|
[53d92c8] | 194 | <xref linkend="pytest"/>
|
---|
[22f9c48] | 195 | </para>
|
---|
| 196 | </listitem>
|
---|
[6e98a080] | 197 | <listitem>
|
---|
| 198 | <para>
|
---|
[53d92c8] | 199 | <xref linkend="pyxdg"/>
|
---|
[6e98a080] | 200 | </para>
|
---|
| 201 | </listitem>
|
---|
[0cf85fa] | 202 | <listitem>
|
---|
[14c0be2f] | 203 | <para>
|
---|
[53d92c8] | 204 | <xref linkend="PyYAML"/>
|
---|
[14c0be2f] | 205 | </para>
|
---|
| 206 | </listitem>
|
---|
[a8b202a] | 207 | <listitem>
|
---|
| 208 | <para>
|
---|
| 209 | <xref linkend="recommonmark"/>
|
---|
| 210 | </para>
|
---|
| 211 | </listitem>
|
---|
[2dfb0a58] | 212 | <listitem>
|
---|
| 213 | <para>
|
---|
| 214 | <xref linkend="requests"/>
|
---|
| 215 | </para>
|
---|
| 216 | </listitem>
|
---|
[7d35ee59] | 217 | <listitem>
|
---|
| 218 | <para>
|
---|
| 219 | <xref linkend="scour"/>
|
---|
| 220 | </para>
|
---|
| 221 | </listitem>
|
---|
[505c46cc] | 222 | <listitem>
|
---|
| 223 | <para>
|
---|
| 224 | <xref linkend="six"/>
|
---|
| 225 | </para>
|
---|
| 226 | </listitem>
|
---|
[0cf85fa] | 227 | <listitem>
|
---|
| 228 | <para>
|
---|
| 229 | <xref linkend="sphinx"/>
|
---|
| 230 | </para>
|
---|
| 231 | </listitem>
|
---|
[6e86a83] | 232 | <listitem>
|
---|
| 233 | <para>
|
---|
| 234 | <xref linkend="sphinx_rtd_theme"/>
|
---|
| 235 | </para>
|
---|
| 236 | </listitem>
|
---|
[ce892ab3] | 237 | </itemizedlist>
|
---|
| 238 | </sect2>
|
---|
| 239 |
|
---|
[3ef383c] | 240 | <!--
|
---|
| 241 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
| 242 | href="python-dependencies/pythonhosted.xml"/>
|
---|
| 243 | -->
|
---|
[141ee0a5] | 244 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
[5fe69261] | 245 | href="python-modules/asciidoc.xml"/>
|
---|
[141ee0a5] | 246 |
|
---|
[5a434ec] | 247 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
| 248 | href="python-modules/cssselect.xml"/>
|
---|
| 249 |
|
---|
[381cfd18] | 250 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
| 251 | href="python-modules/cachecontrol.xml"/>
|
---|
| 252 |
|
---|
[7b459c22] | 253 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
[5fe69261] | 254 | href="python-modules/cython.xml"/>
|
---|
[7b459c22] | 255 |
|
---|
[53d92c8] | 256 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
| 257 | href="python-modules/python-dbusmock.xml"/>
|
---|
| 258 |
|
---|
[d2b1e2e] | 259 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
[5fe69261] | 260 | href="python-modules/dbus-python.xml"/>
|
---|
[a73f7b02] | 261 |
|
---|
[d3ea9e8] | 262 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
[5fe69261] | 263 | href="python-modules/docutils.xml"/>
|
---|
[d3ea9e8] | 264 |
|
---|
[622cc86e] | 265 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
| 266 | href="python-modules/doxypypy.xml"/>
|
---|
| 267 |
|
---|
| 268 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
| 269 | href="python-modules/doxyqml.xml"/>
|
---|
| 270 |
|
---|
[8828c760] | 271 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
| 272 | href="python-modules/gi-docgen.xml"/>
|
---|
| 273 |
|
---|
[0c2e5325] | 274 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
[53d92c8] | 275 | href="python-modules/lxml.xml"/>
|
---|
[0c2e5325] | 276 |
|
---|
[82eddd4] | 277 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
[53d92c8] | 278 | href="python-modules/mako.xml"/>
|
---|
[a73f7b02] | 279 |
|
---|
[7b3ac32] | 280 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
| 281 | href="python-modules/numpy.xml"/>
|
---|
| 282 |
|
---|
[07f61e4] | 283 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
[53d92c8] | 284 | href="python-modules/packaging.xml"/>
|
---|
[07f61e4] | 285 |
|
---|
[d2b1e2e] | 286 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
[53d92c8] | 287 | href="python-modules/py3c.xml"/>
|
---|
[a73f7b02] | 288 |
|
---|
[d2b1e2e] | 289 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
[53d92c8] | 290 | href="python-modules/pyatspi2.xml"/>
|
---|
[a73f7b02] | 291 |
|
---|
[d2b1e2e] | 292 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
[53d92c8] | 293 | href="python-modules/pycairo2.xml"/>
|
---|
[f4472d1] | 294 |
|
---|
[d2b1e2e] | 295 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
[53d92c8] | 296 | href="python-modules/pycairo.xml"/>
|
---|
[d938ca94] | 297 |
|
---|
[60f566d9] | 298 | <!-- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
| 299 | href="python-modules/pycryptodome.xml"/> -->
|
---|
[a8b202a] | 300 |
|
---|
[22f9c48] | 301 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
[53d92c8] | 302 | href="python-modules/pygments.xml"/>
|
---|
[22f9c48] | 303 |
|
---|
[cd964c8] | 304 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
[53d92c8] | 305 | href="python-modules/pygobject2.xml"/>
|
---|
[cd964c8] | 306 |
|
---|
[23e36d1] | 307 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
[53d92c8] | 308 | href="python-modules/pygobject3.xml"/>
|
---|
[23e36d1] | 309 |
|
---|
[22f9c48] | 310 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
[53d92c8] | 311 | href="python-modules/pygtk.xml"/>
|
---|
[22f9c48] | 312 |
|
---|
| 313 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
[53d92c8] | 314 | href="python-modules/pyparsing.xml"/>
|
---|
[22f9c48] | 315 |
|
---|
[cbc9210] | 316 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
| 317 | href="python-modules/pyserial.xml"/>
|
---|
| 318 |
|
---|
[22f9c48] | 319 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
[53d92c8] | 320 | href="python-modules/pytest.xml"/>
|
---|
[22f9c48] | 321 |
|
---|
[6e98a080] | 322 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
[53d92c8] | 323 | href="python-modules/pyxdg.xml"/>
|
---|
[6e98a080] | 324 |
|
---|
[0cf85fa] | 325 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
[53d92c8] | 326 | href="python-modules/pyyaml.xml"/>
|
---|
[14c0be2f] | 327 |
|
---|
[22f9c48] | 328 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
[53d92c8] | 329 | href="python-modules/recommonmark.xml"/>
|
---|
[22f9c48] | 330 |
|
---|
[2dfb0a58] | 331 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
| 332 | href="python-modules/requests.xml"/>
|
---|
| 333 |
|
---|
[7d35ee59] | 334 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
[5fe69261] | 335 | href="python-modules/scour.xml"/>
|
---|
[7d35ee59] | 336 |
|
---|
[505c46cc] | 337 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
[5fe69261] | 338 | href="python-modules/six.xml"/>
|
---|
[505c46cc] | 339 |
|
---|
[0cf85fa] | 340 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
| 341 | href="python-modules/sphinx.xml"/>
|
---|
| 342 |
|
---|
[6e86a83] | 343 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
| 344 | href="python-modules/sphinx_rtd_theme.xml"/>
|
---|
| 345 |
|
---|
[ce892ab3] | 346 | </sect1>
|
---|