/usr/share/diskimage-builder/elements/pip-cache/README.rst is in python-diskimage-builder 1.0.0-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 | =========
pip-cache
=========
# Use a cache for pip
Using a download cache speeds up image builds.
Including this element in an image build causes
$HOME/.cache/image-create/pip to be bind mounted as /tmp/pip inside
the image build chroot. The $PIP_DOWNLOAD_CACHE environment variable
is then defined as /tmp/pip, which causes pip to cache all downloads
to the defined location.
Note that pip and its use of $PIP_DOWNLOAD_CACHE is not concurrency
safe. Running multiple instances of diskimage-builder concurrently
can cause issues. Therefore, it is advised to only have one instance
of diskimage-builder that includes the pip-cache element running at a
time.
The pip concurrency issue is being tracked upstream at
https://github.com/pypa/pip/issues/1141
|