Document Alternatives to pip bundle

[dstufft]

Suggested by @ionelmc in #1046 we should document an alternative to pip bundle now that it's gone.

An example from @ionelmc

build

$ tempdir=$(mktemp -d /tmp/wheelhouse-XXXXX)
$ pip wheel -r requirements.txt --timeout=60 --download-cache=.pip-cache --use-mirrors --wheel-dir=$tempdir
$ cwd=`pwd`
$ (cd "$tempdir"; tar -cjvf "$cwd/deps.tar.bz2" *)

install

$ tempdir=$(mktemp -d /tmp/wheelhouse-XXXXX)
$ (cd $tempdir; tar -xvf /path/to/deps.tar.bz2)
$ /path/to/environment/bin/pip install --force-reinstall --ignore-installed --upgrade --no-index --use-wheel --no-deps $tempdir/*

[qwcode]

Yes, the shell example makes it clear that an alternative is pretty simple. The only catch here is editables. pip wheel doesn't build wheels for editables. Unless I'm mistaken, the old bundle, bundled editables. For the shell example to cover that, you'd need to build out packages for your editables first

[dstufft]

That's correct.

It might be reasonable for pip wheel to build a package from an editable if one is given to it.

[qwcode]

#1787 at least made it true that pip wheel builds wheels for dependencies of editables, but I wasn't sure about editables themselves. I agree that it's something to consider.

[ionelmc]

One more thing, looks like I have --no-use-wheel in the wheel building command in my latest code. It's because pip wheel doesn't build anything in the wheeldir if the package has a wheel on PyPI. This should be included in the example if you didn't change the behaviour of the wheel command.

[qwcode]

pip wheel doesn't build anything in the wheeldir if the package has a wheel on PyPI

#1524 fixed that. released in v1.5.3

[Diaoul]

Can I use this if I don't want modules to be built but just packed?

This behavior is useful when the packaging is not done on the same system as the installation (cross compilation).

[qwcode]

@Diaoul you could replace pip wheel with pip install --download --no-use-wheel, i.e. instead of building wheels into a location, you're just gathering all the sdists you need into a location, and sdists are not pre-built.