Skip to content

Commit eee5d16

Browse files
committed
remove the duplicate "PyPI mirrors and caches" sections
1 parent 6cc9f7f commit eee5d16

File tree

1 file changed

+50
-63
lines changed

1 file changed

+50
-63
lines changed

source/deployment.rst

Lines changed: 50 additions & 63 deletions
Original file line numberDiff line numberDiff line change
@@ -8,65 +8,6 @@ Development & Deployment
88

99
.. contents::
1010

11-
.. _`PyPI mirrors and caches`:
12-
13-
PyPI mirrors and caches
14-
=======================
15-
16-
Mirroring or caching of PyPI can be used to speed up local package
17-
installation, allow offline work, handle corporate firewalls or just plain
18-
Internet flakiness.
19-
20-
Three options are available in this area:
21-
22-
1. pip provides local caching options,
23-
2. devpi provides higher-level caching option, potentially shared amongst
24-
many users or machines, and
25-
3. bandersnatch provides a local complete mirror of all packages on PyPI.
26-
27-
28-
Caching with pip
29-
----------------
30-
31-
pip provides a number of facilities for speeding up installation by using
32-
local cached copies of packages:
33-
34-
1. `Fast & local installs
35-
<https://pip.pypa.io/en/latest/user_guide.html#fast-local-installs>`_ by
36-
downloading all the requirements for a project and then pointing pip at
37-
those downloaded files instead of going to PyPI.
38-
2. A variation on the above which pre-builds the installation files for
39-
the requirements using `pip wheel
40-
<http://pip.readthedocs.org/en/latest/reference/pip_wheel.html>`_::
41-
42-
$ pip wheel --wheel-dir=/tmp/wheelhouse SomePackage
43-
$ pip install --no-index --find-links=/tmp/wheelhouse SomePackage
44-
45-
46-
Caching with devpi
47-
------------------
48-
49-
devpi is a caching proxy server which you run on your laptop, or some other
50-
machine you know will always be available to you. See the `devpi
51-
documentation for getting started`__.
52-
53-
__ http://doc.devpi.net/latest/quickstart-pypimirror.html
54-
55-
56-
Complete mirror with bandersnatch
57-
----------------------------------
58-
59-
bandersnatch will set up a complete local mirror of all packages on PyPI
60-
(externally-hosted packages are not mirrored). See the
61-
`bandersnatch documentation for getting that going`__.
62-
63-
__ https://bitbucket.org/pypa/bandersnatch/overview
64-
65-
A benefit of devpi is that it will create a mirror which includes packages
66-
that are external to PyPI, unlike bandersnatch which will only cache packages
67-
hosted on PyPI.
68-
69-
7011

7112
.. _`Supporting multiple Python versions`:
7213

@@ -208,12 +149,58 @@ There are a few techniques to store the version in your project code without dup
208149
PyPI mirrors and caches
209150
=======================
210151

211-
::
152+
Mirroring or caching of PyPI can be used to speed up local package
153+
installation, allow offline work, handle corporate firewalls or just plain
154+
Internet flakiness.
212155

213-
FIXME
156+
Three options are available in this area:
157+
158+
1. pip provides local caching options,
159+
2. devpi provides higher-level caching option, potentially shared amongst
160+
many users or machines, and
161+
3. bandersnatch provides a local complete mirror of all packages on PyPI.
214162

215-
- local --find-links
216-
- tools like https://pypi.python.org/pypi/devpi-server
163+
164+
Caching with pip
165+
----------------
166+
167+
pip provides a number of facilities for speeding up installation by using
168+
local cached copies of packages:
169+
170+
1. `Fast & local installs
171+
<https://pip.pypa.io/en/latest/user_guide.html#fast-local-installs>`_ by
172+
downloading all the requirements for a project and then pointing pip at
173+
those downloaded files instead of going to PyPI.
174+
2. A variation on the above which pre-builds the installation files for
175+
the requirements using `pip wheel
176+
<http://pip.readthedocs.org/en/latest/reference/pip_wheel.html>`_::
177+
178+
$ pip wheel --wheel-dir=/tmp/wheelhouse SomePackage
179+
$ pip install --no-index --find-links=/tmp/wheelhouse SomePackage
180+
181+
182+
Caching with devpi
183+
------------------
184+
185+
devpi is a caching proxy server which you run on your laptop, or some other
186+
machine you know will always be available to you. See the `devpi
187+
documentation for getting started`__.
188+
189+
__ http://doc.devpi.net/latest/quickstart-pypimirror.html
190+
191+
192+
Complete mirror with bandersnatch
193+
----------------------------------
194+
195+
bandersnatch will set up a complete local mirror of all packages on PyPI
196+
(externally-hosted packages are not mirrored). See the
197+
`bandersnatch documentation for getting that going`__.
198+
199+
__ https://bitbucket.org/pypa/bandersnatch/overview
200+
201+
A benefit of devpi is that it will create a mirror which includes packages
202+
that are external to PyPI, unlike bandersnatch which will only cache packages
203+
hosted on PyPI.
217204

218205

219206
.. _`Patching & Forking`:

0 commit comments

Comments
 (0)