Skip to content

Commit 6711e7f

Browse files
author
Adam Nelson
committed
Removed references to Setuptools/easy_install in favor of pip. A new Python user hardly needs to know that easy_install ever existed
1 parent 4a3c975 commit 6711e7f

File tree

1 file changed

+20
-24
lines changed

1 file changed

+20
-24
lines changed

docs/starting/install/osx.rst

Lines changed: 20 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -5,11 +5,11 @@ Installing Python on Mac OS X
55

66
The latest version of Mac OS X, El Capitan, **comes with Python 2.7 out of the box**.
77

8-
You do not need to install or configure anything else to use Python. Having
9-
said that, I would strongly recommend that you install the tools and libraries
10-
described in the next section before you start building Python applications
11-
for real-world use. In particular, you should always install Setuptools, as it
12-
makes it much easier for you to use other third-party Python libraries.
8+
You do not need to install or configure anything else to use Python. Having said
9+
that, I would strongly recommend that you install the tools and libraries
10+
described in the next section before you start building Python applications for
11+
real-world use. In particular, you should always install ``pip``, as it makes
12+
it much easier for you to install and manage other third-party Python libraries.
1313

1414
The version of Python that ships with OS X is great for learning but it's not
1515
good for development. The version shipped with OS X may be out of date from the
@@ -33,11 +33,11 @@ package.
3333
diagnose.
3434

3535
.. note::
36-
If you perform a fresh install of XCode, you will also need to add the
36+
If you perform a fresh install of XCode, you will also need to add the
3737
commandline tools by running ``xcode-select --install`` on the terminal.
3838

3939
While OS X comes with a large number of UNIX utilities, those familiar with
40-
Linux systems will notice one key component missing: a decent package manager.
40+
Linux systems will notice one key component missing: a package manager.
4141
`Homebrew <http://brew.sh>`_ fills this void.
4242

4343
To `install Homebrew <http://brew.sh/#install>`_, open :file:`Terminal` or
@@ -63,37 +63,33 @@ Now, we can install Python 2.7:
6363
6464
$ brew install python
6565
66-
This will take a minute or two.
66+
This will take a minute or two.
6767

6868

69-
Setuptools & Pip
69+
Pip
7070
----------------
7171

72-
Homebrew installs Setuptools and ``pip`` for you.
72+
Homebrew installs ``pip`` for you.
7373

74-
Setuptools enables you to download and install any compliant Python
75-
software over a network (usually the Internet) with a single command
76-
(``easy_install``). It also enables you to add this network installation
77-
capability to your own Python software with very little work.
78-
79-
``pip`` is a tool for easily installing and managing Python packages,
80-
that is recommended over ``easy_install``. It is superior to ``easy_install`` in `several ways <https://python-packaging-user-guide.readthedocs.org/en/latest/pip_easy_install/#pip-vs-easy-install>`_,
74+
``pip`` is a tool for easily installing and managing Python packages, that is
75+
recommended over the deprecated ``easy_install``. It is superior to
76+
``easy_install`` in `several ways
77+
<https://python-packaging-user-guide.readthedocs.org/en/latest/pip_easy_install/#pip-vs-easy-install>`_,
8178
and is actively maintained.
8279

8380

8481
Virtual Environments
8582
--------------------
8683

87-
A Virtual Environment is a tool to keep the dependencies required by different projects
88-
in separate places, by creating virtual Python environments for them. It solves the
89-
"Project X depends on version 1.x but, Project Y needs 4.x" dilemma, and keeps
84+
A Virtual Environment (commonly referred to as a 'virtualenv') is a tool to keep the dependencies required by different projects
85+
in separate places, by creating virtual Python environments for them. It solves the
86+
"Project X depends on version 1.x but, Project Y needs 4.x" dilemma, and keeps
9087
your global site-packages directory clean and manageable.
9188

92-
For example, you can work on a project which requires Django 1.3 while also
93-
maintaining a project which requires Django 1.0.
94-
95-
To start using this and see more information: :ref:`Virtual Environments <virtualenvironments-ref>` docs.
89+
For example, you can work on a project which requires Django 1.10 while also
90+
maintaining a project which requires Django 1.7.
9691

92+
To start using this and see more information: :ref:`Virtual Environments <virtualenvironments-ref>` docs.
9793

9894
--------------------------------
9995

0 commit comments

Comments
 (0)