[ab4fdfc] | 1 | <?xml version="1.0" encoding="UTF-8"?>
|
---|
[ce892ab3] | 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>
|
---|
[a3e69b9b] | 117 | <listitem>
|
---|
| 118 | <para>
|
---|
| 119 | <xref linkend="html5lib"/>
|
---|
| 120 | </para>
|
---|
| 121 | </listitem>
|
---|
[ce892ab3] | 122 | <listitem>
|
---|
[66b546a] | 123 | <para>
|
---|
[53d92c8] | 124 | <xref linkend="lxml"/>
|
---|
[d3ea9e8] | 125 | </para>
|
---|
[ce892ab3] | 126 | </listitem>
|
---|
[a73f7b02] | 127 | <listitem>
|
---|
| 128 | <para>
|
---|
[53d92c8] | 129 | <xref linkend="Mako"/>
|
---|
[a73f7b02] | 130 | </para>
|
---|
| 131 | </listitem>
|
---|
[7b3ac32] | 132 | <listitem>
|
---|
| 133 | <para>
|
---|
| 134 | <xref linkend="numpy"/>
|
---|
| 135 | </para>
|
---|
| 136 | </listitem>
|
---|
[82eddd4] | 137 | <listitem>
|
---|
| 138 | <para>
|
---|
[53d92c8] | 139 | <xref linkend="packaging"/>
|
---|
[82eddd4] | 140 | </para>
|
---|
| 141 | </listitem>
|
---|
[c28ea47b] | 142 | <listitem>
|
---|
| 143 | <para>
|
---|
| 144 | <xref linkend="ply"/>
|
---|
| 145 | </para>
|
---|
| 146 | </listitem>
|
---|
[2563594f] | 147 | <listitem>
|
---|
| 148 | <para>
|
---|
| 149 | <xref linkend="psutil"/>
|
---|
| 150 | </para>
|
---|
| 151 | </listitem>
|
---|
[10092cde] | 152 | <listitem>
|
---|
| 153 | <para>
|
---|
[53d92c8] | 154 | <xref linkend="py3c"/>
|
---|
[10092cde] | 155 | </para>
|
---|
| 156 | </listitem>
|
---|
[07f61e4] | 157 | <listitem>
|
---|
| 158 | <para>
|
---|
[53d92c8] | 159 | <xref linkend="pyatspi2"/>
|
---|
[07f61e4] | 160 | </para>
|
---|
| 161 | </listitem>
|
---|
[b29fc64] | 162 | <!-- <listitem>
|
---|
[66b546a] | 163 | <para>
|
---|
[53d92c8] | 164 | <xref linkend="pycairo2"/>
|
---|
[66b546a] | 165 | </para>
|
---|
[b29fc64] | 166 | </listitem>-->
|
---|
[ce892ab3] | 167 | <listitem>
|
---|
[66b546a] | 168 | <para>
|
---|
[53d92c8] | 169 | <xref linkend="pycairo"/>
|
---|
[66b546a] | 170 | </para>
|
---|
[ce892ab3] | 171 | </listitem>
|
---|
[2563594f] | 172 | <listitem>
|
---|
[66b546a] | 173 | <para>
|
---|
[2563594f] | 174 | <xref linkend="pygdbmi"/>
|
---|
[66b546a] | 175 | </para>
|
---|
[2563594f] | 176 | </listitem>
|
---|
[d938ca94] | 177 | <listitem>
|
---|
| 178 | <para>
|
---|
[53d92c8] | 179 | <xref linkend="pygments"/>
|
---|
[22f9c48] | 180 | </para>
|
---|
[08093b3] | 181 | </listitem>
|
---|
[b29fc64] | 182 | <!-- <listitem>
|
---|
[cd964c8] | 183 | <para>
|
---|
[53d92c8] | 184 | <xref linkend="pygobject2"/>
|
---|
[cd964c8] | 185 | </para>
|
---|
[b29fc64] | 186 | </listitem> -->
|
---|
[7d35ee59] | 187 | <listitem>
|
---|
[23e36d1] | 188 | <para>
|
---|
[53d92c8] | 189 | <xref linkend="pygobject3"/>
|
---|
[23e36d1] | 190 | </para>
|
---|
| 191 | </listitem>
|
---|
[b29fc64] | 192 | <!-- <listitem>
|
---|
[22f9c48] | 193 | <para>
|
---|
[53d92c8] | 194 | <xref linkend="pygtk"/>
|
---|
[22f9c48] | 195 | </para>
|
---|
[b29fc64] | 196 | </listitem> -->
|
---|
[53d92c8] | 197 | <listitem>
|
---|
[22f9c48] | 198 | <para>
|
---|
[53d92c8] | 199 | <xref linkend="pyparsing"/>
|
---|
[22f9c48] | 200 | </para>
|
---|
| 201 | </listitem>
|
---|
[cbc9210] | 202 | <listitem>
|
---|
| 203 | <para>
|
---|
| 204 | <xref linkend="pyserial"/>
|
---|
| 205 | </para>
|
---|
| 206 | </listitem>
|
---|
[0499056] | 207 | <listitem>
|
---|
[22f9c48] | 208 | <para>
|
---|
[53d92c8] | 209 | <xref linkend="pytest"/>
|
---|
[22f9c48] | 210 | </para>
|
---|
| 211 | </listitem>
|
---|
[6e98a080] | 212 | <listitem>
|
---|
| 213 | <para>
|
---|
[53d92c8] | 214 | <xref linkend="pyxdg"/>
|
---|
[6e98a080] | 215 | </para>
|
---|
| 216 | </listitem>
|
---|
[855f309] | 217 | <listitem>
|
---|
| 218 | <para>
|
---|
| 219 | <xref linkend="PyYAML"/>
|
---|
| 220 | </para>
|
---|
| 221 | </listitem>
|
---|
[a8b202a] | 222 | <listitem>
|
---|
| 223 | <para>
|
---|
| 224 | <xref linkend="recommonmark"/>
|
---|
| 225 | </para>
|
---|
| 226 | </listitem>
|
---|
[2dfb0a58] | 227 | <listitem>
|
---|
| 228 | <para>
|
---|
| 229 | <xref linkend="requests"/>
|
---|
| 230 | </para>
|
---|
| 231 | </listitem>
|
---|
[2563594f] | 232 | <listitem>
|
---|
| 233 | <para>
|
---|
| 234 | <xref linkend="sentry-sdk"/>
|
---|
| 235 | </para>
|
---|
| 236 | </listitem>
|
---|
[7d35ee59] | 237 | <listitem>
|
---|
| 238 | <para>
|
---|
| 239 | <xref linkend="scour"/>
|
---|
| 240 | </para>
|
---|
| 241 | </listitem>
|
---|
[505c46cc] | 242 | <listitem>
|
---|
| 243 | <para>
|
---|
| 244 | <xref linkend="six"/>
|
---|
| 245 | </para>
|
---|
| 246 | </listitem>
|
---|
[0cf85fa] | 247 | <listitem>
|
---|
| 248 | <para>
|
---|
| 249 | <xref linkend="sphinx"/>
|
---|
| 250 | </para>
|
---|
| 251 | </listitem>
|
---|
[6e86a83] | 252 | <listitem>
|
---|
| 253 | <para>
|
---|
| 254 | <xref linkend="sphinx_rtd_theme"/>
|
---|
| 255 | </para>
|
---|
| 256 | </listitem>
|
---|
[ce892ab3] | 257 | </itemizedlist>
|
---|
| 258 | </sect2>
|
---|
| 259 |
|
---|
[3ef383c] | 260 | <!--
|
---|
| 261 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
| 262 | href="python-dependencies/pythonhosted.xml"/>
|
---|
| 263 | -->
|
---|
[141ee0a5] | 264 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
[5fe69261] | 265 | href="python-modules/asciidoc.xml"/>
|
---|
[141ee0a5] | 266 |
|
---|
[5a434ec] | 267 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
| 268 | href="python-modules/cssselect.xml"/>
|
---|
| 269 |
|
---|
[381cfd18] | 270 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
| 271 | href="python-modules/cachecontrol.xml"/>
|
---|
| 272 |
|
---|
[7b459c22] | 273 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
[5fe69261] | 274 | href="python-modules/cython.xml"/>
|
---|
[7b459c22] | 275 |
|
---|
[53d92c8] | 276 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
| 277 | href="python-modules/python-dbusmock.xml"/>
|
---|
| 278 |
|
---|
[d2b1e2e] | 279 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
[5fe69261] | 280 | href="python-modules/dbus-python.xml"/>
|
---|
[a73f7b02] | 281 |
|
---|
[d3ea9e8] | 282 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
[5fe69261] | 283 | href="python-modules/docutils.xml"/>
|
---|
[d3ea9e8] | 284 |
|
---|
[622cc86e] | 285 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
| 286 | href="python-modules/doxypypy.xml"/>
|
---|
| 287 |
|
---|
| 288 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
| 289 | href="python-modules/doxyqml.xml"/>
|
---|
| 290 |
|
---|
[8828c760] | 291 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
| 292 | href="python-modules/gi-docgen.xml"/>
|
---|
| 293 |
|
---|
[a3e69b9b] | 294 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
| 295 | href="python-modules/html5lib.xml"/>
|
---|
| 296 |
|
---|
[0c2e5325] | 297 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
[53d92c8] | 298 | href="python-modules/lxml.xml"/>
|
---|
[0c2e5325] | 299 |
|
---|
[82eddd4] | 300 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
[53d92c8] | 301 | href="python-modules/mako.xml"/>
|
---|
[a73f7b02] | 302 |
|
---|
[7b3ac32] | 303 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
| 304 | href="python-modules/numpy.xml"/>
|
---|
| 305 |
|
---|
[07f61e4] | 306 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
[53d92c8] | 307 | href="python-modules/packaging.xml"/>
|
---|
[07f61e4] | 308 |
|
---|
[c28ea47b] | 309 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
| 310 | href="python-modules/ply.xml"/>
|
---|
| 311 |
|
---|
[2563594f] | 312 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
| 313 | href="python-modules/psutil.xml"/>
|
---|
| 314 |
|
---|
[d2b1e2e] | 315 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
[53d92c8] | 316 | href="python-modules/py3c.xml"/>
|
---|
[a73f7b02] | 317 |
|
---|
[d2b1e2e] | 318 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
[53d92c8] | 319 | href="python-modules/pyatspi2.xml"/>
|
---|
[a73f7b02] | 320 |
|
---|
[b29fc64] | 321 | <!-- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
| 322 | href="python-modules/pycairo2.xml"/>-->
|
---|
[f4472d1] | 323 |
|
---|
[d2b1e2e] | 324 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
[53d92c8] | 325 | href="python-modules/pycairo.xml"/>
|
---|
[d938ca94] | 326 |
|
---|
[2563594f] | 327 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
| 328 | href="python-modules/pygdbmi.xml"/>
|
---|
[a8b202a] | 329 |
|
---|
[22f9c48] | 330 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
[53d92c8] | 331 | href="python-modules/pygments.xml"/>
|
---|
[b29fc64] | 332 | <!--
|
---|
[cd964c8] | 333 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
[53d92c8] | 334 | href="python-modules/pygobject2.xml"/>
|
---|
[b29fc64] | 335 | -->
|
---|
[23e36d1] | 336 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
[53d92c8] | 337 | href="python-modules/pygobject3.xml"/>
|
---|
[b29fc64] | 338 | <!--
|
---|
[22f9c48] | 339 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
[53d92c8] | 340 | href="python-modules/pygtk.xml"/>
|
---|
[b29fc64] | 341 | -->
|
---|
[22f9c48] | 342 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
[53d92c8] | 343 | href="python-modules/pyparsing.xml"/>
|
---|
[22f9c48] | 344 |
|
---|
[cbc9210] | 345 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
| 346 | href="python-modules/pyserial.xml"/>
|
---|
| 347 |
|
---|
[22f9c48] | 348 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
[53d92c8] | 349 | href="python-modules/pytest.xml"/>
|
---|
[22f9c48] | 350 |
|
---|
[6e98a080] | 351 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
[53d92c8] | 352 | href="python-modules/pyxdg.xml"/>
|
---|
[6e98a080] | 353 |
|
---|
[855f309] | 354 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
| 355 | href="python-modules/pyyaml.xml"/>
|
---|
| 356 |
|
---|
[22f9c48] | 357 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
[53d92c8] | 358 | href="python-modules/recommonmark.xml"/>
|
---|
[22f9c48] | 359 |
|
---|
[2dfb0a58] | 360 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
| 361 | href="python-modules/requests.xml"/>
|
---|
| 362 |
|
---|
[7d35ee59] | 363 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
[5fe69261] | 364 | href="python-modules/scour.xml"/>
|
---|
[7d35ee59] | 365 |
|
---|
[2563594f] | 366 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
| 367 | href="python-modules/sentry-sdk.xml"/>
|
---|
| 368 |
|
---|
[505c46cc] | 369 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
[5fe69261] | 370 | href="python-modules/six.xml"/>
|
---|
[505c46cc] | 371 |
|
---|
[0cf85fa] | 372 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
| 373 | href="python-modules/sphinx.xml"/>
|
---|
| 374 |
|
---|
[6e86a83] | 375 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
| 376 | href="python-modules/sphinx_rtd_theme.xml"/>
|
---|
| 377 |
|
---|
[ce892ab3] | 378 | </sect1>
|
---|