Skip to content

Commit 8df8e0f

Browse files
committed
mention that you may need to install wheel for wheel caching
1 parent 5514242 commit 8df8e0f

File tree

1 file changed

+16
-9
lines changed

1 file changed

+16
-9
lines changed

source/current.rst

Lines changed: 16 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ Tool Recommendations
55
====================
66

77
:Page Status: Complete
8-
:Last Reviewed: 2014-11-11
8+
:Last Reviewed: 2015-08-31
99

1010
If you're familiar with Python packaging and installation, and just want to know
1111
what tools are currently recommended, then here it is.
@@ -15,10 +15,12 @@ Installation Tool Recommendations
1515
=================================
1616

1717
* Use :ref:`pip` to install Python :term:`packages <Distribution Package>` from
18-
:term:`PyPI <Python Package Index (PyPI)>`. [1]_ [2]_
18+
:term:`PyPI <Python Package Index (PyPI)>`. [1]_ [2]_ Depending how :ref:`pip`
19+
is installed, you made need to also install :ref:`wheel` to get the benefit
20+
of :ref:`wheel caching <pip:Wheel cache>`. [3]_
1921

2022
* Use :ref:`virtualenv`, or `pyvenv`_ to isolate application specific
21-
dependencies from a shared Python installation. [3]_
23+
dependencies from a shared Python installation. [4]_
2224

2325
* If you're looking for management of fully integrated cross-platform software
2426
stacks, consider :ref:`buildout` (primarily focused on the web development
@@ -31,11 +33,11 @@ Packaging Tool Recommendations
3133
==============================
3234

3335
* Use :ref:`setuptools` to define projects and create :term:`Source Distributions
34-
<Source Distribution (or "sdist")>`. [4]_ [5]_
36+
<Source Distribution (or "sdist")>`. [5]_ [6]_
3537

3638
* Use the ``bdist_wheel`` :ref:`setuptools` extension available from the
3739
:ref:`wheel project <wheel>` to create :term:`wheels <Wheel>`. This is
38-
especially beneficial, if your project contains binary extensions. [6]_
40+
especially beneficial, if your project contains binary extensions. [7]_
3941

4042
* Use `twine <https://pypi.python.org/pypi/twine>`_ for uploading distributions
4143
to :term:`PyPI <Python Package Index (PyPI)>`.
@@ -54,12 +56,17 @@ Packaging Tool Recommendations
5456
<http://www.python.org/dev/peps/pep-0453/#rationale>`_ from :ref:`PEP453
5557
<pypa:PEP453s>` as for why pip was chosen.
5658
57-
.. [3] Beginning with Python 3.4, ``pyvenv`` will create virtualenv environments
59+
.. [3] :ref:`get-pip.py <pip:get-pip>` and :ref:`virtualenv` install
60+
:ref:`wheel`, whereas :ref:`ensurepip` and :ref:`pyvenv <venv>` do not
61+
currently. Also, the common "python-pip" package that's found in various
62+
linux distros, does not depend on "python-wheel" currently.
63+
64+
.. [4] Beginning with Python 3.4, ``pyvenv`` will create virtualenv environments
5865
with ``pip`` installed, thereby making it an equal alternative to
5966
:ref:`virtualenv`. However, using :ref:`virtualenv` will still be
6067
recommended for users that need cross-version consistency.
6168
62-
.. [4] Although you can use pure ``distutils`` for many projects, it does not
69+
.. [5] Although you can use pure ``distutils`` for many projects, it does not
6370
support defining dependencies on other projects and is missing several
6471
convenience utilities for automatically populating distribution metadata
6572
correctly that are provided by ``setuptools``. Being outside the
@@ -73,11 +80,11 @@ Packaging Tool Recommendations
7380
from a prebuilt :term:`wheel <Wheel>` file), it will actually build
7481
your project using :ref:`setuptools` instead.
7582
76-
.. [5] `distribute`_ (a fork of setuptools) was merged back into
83+
.. [6] `distribute`_ (a fork of setuptools) was merged back into
7784
:ref:`setuptools` in June 2013, thereby making setuptools the default
7885
choice for packaging.
7986
80-
.. [6] :term:`PyPI <Python Package Index (PyPI)>` currently only allows
87+
.. [7] :term:`PyPI <Python Package Index (PyPI)>` currently only allows
8188
uploading Windows and Mac OS X wheels, and they should be compatible with
8289
the binary installers provided for download from python.org. Enhancements
8390
will have to be made to the :ref:`wheel compatibility tagging scheme

0 commit comments

Comments
 (0)