McSinyx
/
pip
mirror of https://github.com/pypa/pip
1
1
Fork 0
Code Issues Releases Activity

refactor the "Fast & Local Installs" section to "Installing from local 

packages".  With pip's index caching, and wheel caching,  the motivation
to find a way to speed up pip is not as pressing anymore, although it is
still true that people may need a local-only install for certain cases.
This commit is contained in:
Marcus Smith 2015-09-10 21:30:38 -07:00
parent 80aa1a98b3
commit 9259e2e66b
2 changed files with 21 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
docs/reference/pip_install.rst
View File

@ -372,8 +372,8 @@ This allows pip to function as a browser would, and allows the index server
to communicate to pip how long it is reasonable to cache any particular item.
While this cache attempts to minimize network activity, it does not prevent
network access altogether. If you want a fast/local install solution that
circumvents accessing PyPI, see :ref:`Fast & Local Installs`.
network access altogether. If you want a local install solution that
circumvents accessing PyPI, see :ref:`Installing from local packages`.
The default location for the cache directory depends on the Operating System:

26
docs/user_guide.rst
View File

@ -439,20 +439,32 @@ directly with the eval function of you shell, e.g. by adding the following to yo
.. _`Fast & Local Installs`:
.. _`Installing from local packages`:
Fast & Local Installs
*********************
Installing from local packages
******************************
Often, you will want a fast install from local archives, without probing PyPI.
In some cases, you may want to install from local packages only, with no traffic
to PyPI.
First, download the archives that fulfill your requirements::
$ pip install --download <DIR> -r requirements.txt
$ pip install --download DIR -r requirements.txt
Then, install using :ref:`--find-links <--find-links>` and :ref:`--no-index <--no-index>`::
$ pip install --no-index --find-links=[file://]<DIR> -r requirements.txt
Note that ``pip install --download`` will look in your wheel cache first, before
trying to download from PyPI. If you've never installed your requirements
before, you won't have a wheel cache for those items. In that case, if some of
your requirements don't come as wheels from PyPI, and you want wheels, then run
this instead::
$ pip wheel --wheel-dir DIR -r requirements.txt
Then, to install from local only, you'll be using :ref:`--find-links
<--find-links>` and :ref:`--no-index <--no-index>` like so::
$ pip install --no-index --find-links=DIR -r requirements.txt
"Only if needed" Recursive Upgrade