File: README.rst

package info (click to toggle)
python-diskimage-builder 3.37.0-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 5,572 kB
  • sloc: sh: 7,380; python: 6,444; makefile: 37
file content (35 lines) | stat: -rw-r--r-- 1,293 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
==========
dib-python
==========

.. note::

   This element is deprecated.  All distributions support Python 3 so
   tools running in the chroot can simply use ``/usr/bin/python3``.

Adds a symlink to ``/usr/local/bin/dib-python`` which points at either a
``python2`` or ``python3`` executable as appropriate.

In-chroot scripts should use this as their interpreter
(``#!/usr/local/bin/dib-python``) to make scripts that are compatible
with both ``python2`` and ``python3``.  We can not assume
``/usr/bin/python`` exists, as some platforms have started shipping with
only Python 3.

``DIB_PYTHON`` will be exported as the python interpreter.  You should
use this instead of ``python script.py`` (e.g. ``${DIB_PYTHON}
script.py``).  Note you can also call ``/usr/local/bin/dib-python
script.py`` but in some circumstances, such as creating a ``virtualenv``,
it can create somewhat confusing references to ``dib-python`` that
remain in the built image.

This does not install a python if one does not exist, and instead fails.

This also exports a variable ``DIB_PYTHON_VERSION`` which will either be
'2' or '3' depending on the python version which dib-python points to.


.. note::

  The ``dib-python`` interpreter will be removed in ``cleanup.d``.  It
  is only intended for build scripts.