mirror of
https://github.com/kennethreitz/python-guide.git
synced 2026-06-05 23:00:18 +00:00
Brian Painter
162 lines
4.9 KiB
ReStructuredText
162 lines
4.9 KiB
ReStructuredText
Properly Installing Python
|
|
==========================
|
|
|
|
Mac OS X
|
|
::::::::
|
|
|
|
*Or, "Installing Python 2.7 via Homebrew".*
|
|
|
|
Package Manager
|
|
---------------
|
|
|
|
While Snow Leopard comes with a large number of UNIX utilities, those
|
|
familiar with Linux systems will notice one key component missing: a
|
|
package manager. Mxcl's `Homebrew <http://mxcl.github.com/homebrew/>`_ is the answer.
|
|
|
|
To `install Homebrew <https://github.com/mxcl/homebrew/wiki/installation>`_, simply run: ::
|
|
|
|
$ ruby -e "$(curl -fsS https://raw.github.com/gist/323731)"
|
|
|
|
|
|
It's basic commands are **update**, **install**, and **remove**.
|
|
|
|
.. man brew
|
|
|
|
|
|
And we can now install Python 2.7: ::
|
|
|
|
$ brew install python --framework
|
|
|
|
|
|
The ``--framework`` option tells Homebrew to compile a Framework-style Python build, rather than a UNIX-style build. The outdated version of Python that Snow Leopard comes packaged with
|
|
is built as a Framework, so this helps avoid some future module installation
|
|
bugs.
|
|
|
|
*Don't forget to update your environment PATH.*
|
|
|
|
Building From Source
|
|
--------------------
|
|
|
|
.. todo:: Write "Building From Source"
|
|
|
|
|
|
Distribute & Pip
|
|
----------------
|
|
|
|
*Distribute* is a fantastic drop-in replacement for *easy_install* and
|
|
*setuptools*. It allows you to install and manage python packages from
|
|
pypi.python.org, amongst a few other sources. It also plays well with
|
|
*virtualenv* and user-enviornments.
|
|
|
|
**easy_install** is considered by many to be a deprecated system, so we
|
|
will install it's replacement: **pip**. Pip allows for uninstallation
|
|
of packages, and is actively maintained, unlike setuptool's easy_install.
|
|
|
|
To install *pip* and Distribute's *easy_install*:
|
|
|
|
If you have homebrew: ::
|
|
|
|
$ brew install pip
|
|
|
|
...And, if you're a masochist: ::
|
|
|
|
$ curl -O http://python-distribute.org/distribute_setup.py
|
|
$ python distribute_setup.py
|
|
|
|
$ easy_install pip
|
|
|
|
Hopefully you'll never have to use **easy_install** again.
|
|
|
|
|
|
Updating Python
|
|
---------------
|
|
|
|
Homebrew makes it simple. ::
|
|
|
|
$ brew update
|
|
$ brew install --force python
|
|
|
|
|
|
Windows
|
|
:::::::
|
|
|
|
|
|
|
|
Prerequisites:
|
|
--------------
|
|
|
|
* Python2.7 (x86) from Python.org
|
|
* Microsoft Visual Studio
|
|
|
|
|
|
Step 1: Set PATH variables
|
|
--------------------------
|
|
If you haven't set your PATH variables as part of the Python2.7 install, now is the time to do that. Right click on My Computer and select properties.
|
|
**Windows 7**
|
|
* Click Advanced System Settings from left hand list (Advanced Tab on Windows XP)
|
|
* Click the Environment Variables button at the bottom
|
|
* In the System variables section double click on the variable line named Path
|
|
* Scroll to the end of the variable value field
|
|
* add semicolon (;) if one doesn't exist and then type ``C:\Python27\;C:\Python27\Scripts\``
|
|
|
|
|
|
Step 2: Install Distribute & Pip
|
|
--------------------------------
|
|
|
|
**Distribute** is a fantastic drop-in replacement for **easy_install** and **setuptools**. It allows you to install and manage python packages from PyPi, amongst a few other sources.
|
|
|
|
To install it, run the python script available here:
|
|
<http://python-distribute.org/distribute_setup.py>
|
|
|
|
**easy_install** is considered by many to be a deprecated system, so we will install it's replacement: **pip**. Pip allows for uninstallation of packages, and is actively maintained, unlike setuptool's easy_install.
|
|
|
|
To install pip, simply open a command prompt and run: ::
|
|
|
|
> easy_install pip
|
|
|
|
|
|
Linux (Ubuntu)
|
|
::::::::::::::
|
|
|
|
Oneiric Ocelot, the latest version of Ubuntu, **comes with Python 2.7 out of the box**. Python 3.2 can be installed and run with the following commands::
|
|
|
|
$ sudo apt-get install python3-minimal
|
|
$ python3
|
|
|
|
Older versions of Python aren't available from the official repository. However, if it's needed (for example to support legacy code), we can add an unsupported repository and install an older version of Python (2.5 in the example below)::
|
|
|
|
$ sudo apt-get install python-software-properties
|
|
$ sudo add-apt-repository ppa:fkrull/deadsnakes
|
|
$ sudo apt-get update
|
|
$ sudo apt-get install python2.5
|
|
|
|
Installing setuptools and pip
|
|
-----------------------------
|
|
|
|
While Python has an extensive standard library, the set of packages available from the Internet is even more extensive. In order to install them easily, we'll install the ``distribute`` package and then ``pip``::
|
|
|
|
$ wget http://python-distribute.org/distribute_setup.py
|
|
$ sudo python distribute_setup.py
|
|
$ sudo easy_install pip
|
|
|
|
Now, most Python packages can be installed using the ``pip`` command. For example, if we wanted to install Django::
|
|
|
|
$ sudo pip install django
|
|
|
|
A full list of ``pip``'s capabilities is available by typing ``pip --help``.
|
|
|
|
Linux (Manual)
|
|
--------------
|
|
|
|
While your system will quite likely already have Python installation, you might wish to install a different version. This is done in the typical Linux software source install procedure::
|
|
|
|
$ wget http://www.python.org/ftp/python/2.7.2/Python-2.7.2.tgz
|
|
$ tar -xvf Python-2.7.2.tgz
|
|
$ cd Python-2.7.2
|
|
$ ./configure
|
|
$ make
|
|
$ make install
|
|
|
|
|
|
|