@@ -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
208149PyPI 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