blob: 63fa7e5f3b9faeead3ec402477e22b6da2ed438a [file] [log] [blame]
Ronald Oussoren360bcac2009-05-19 19:30:44 +00001This package will install Python $FULL_VERSION for Mac OS X
Ned Deily4ce92b22011-01-15 04:37:12 +00002$MACOSX_DEPLOYMENT_TARGET for the following architecture(s):
3$ARCHITECTURES.
Thomas Wouters477c8d52006-05-27 19:21:47 +00004
Ned Deily981b6932013-09-06 01:18:36 -07005 **** IMPORTANT ****
Thomas Wouters477c8d52006-05-27 19:21:47 +00006
Ned Deily981b6932013-09-06 01:18:36 -07007Installing on OS X 10.8 (Mountain Lion) or later systems
8========================================================
9
10If you are attempting to install on an OS X 10.8+ system, you may
Ned Deily5c0b1ca2012-08-24 19:57:33 -070011see a message that Python can't be installed because it is from an
12unidentified developer. This is because this Python installer
13package is not yet compatible with the Gatekeeper security feature
14introduced in OS X 10.8. To allow Python to be installed, you
15can override the Gatekeeper policy for this install. In the Finder,
16instead of double-clicking, control-click or right click the "Python"
17installer package icon. Then select "Open using ... Installer" from
18the contextual menu that appears.
Thomas Wouters477c8d52006-05-27 19:21:47 +000019
Ned Deilyaa6a2122013-11-23 03:30:11 -080020 **** IMPORTANT ****
21
22Update your version of Tcl/Tk to use IDLE or other Tk applications
23==================================================================
24
25To use IDLE or other programs that use the Tkinter graphical user
26interface toolkit, you may need to install a newer third-party version
27of the Tcl/Tk frameworks. Visit http://www.python.org/download/mac/tcltk/
28for current information about supported and recommended versions of
29Tcl/Tk for this version of Python and of Mac OS X.
30
Ned Deily41ab6c32013-11-22 22:25:43 -080031 **NEW* As of Python 3.4.0b1:
32
33New Installation Options and Defaults
34=====================================
35
36The Python installer now includes an option to automatically install
37or upgrade pip, a tool for installing and managing Python packages.
38This option is enabled by default and no Internet access is required.
39If you do want the installer to do this, select the "Customize" option
40at the "Installation Type" step and uncheck the "Install or ugprade
41pip" option.
42
43To make it easier to use scripts installed by third-party Python
44packages, with pip or by other means, the "Shell profile updater"
45option is now enabled by default, as has been the case with Python
462.7.x installers. You can also turn this option off by selecting
47"Customize" and unchecking the "Shell profile updater" option. You can
48also update your shell profile later by launching the "Update Shell
49Profile" command found in the /Applications/Python $VERSION folder. You may
50need to start a new terminal window for the changes to take effect.
51
52Python.org Python $VERSION and 2.7.x versions can both be installed and
53will not conflict. Command names for Python 3 contain a 3 in them,
54python3 (or python$VERSION), idle3 (or idle$VERSION), pip3 (or pip$VERSION), etc.
55Python 2.7 command names contain a 2 or no digit: python2 (or
56python2.7 or python), idle2 (or idle2.7 or idle), etc. If you want to
57use pip with Python 2.7.x, you will need to download and install a
58separate copy of it from the Python Package Index
59(https://pypi.python.org/pypi).
60
Ned Deily981b6932013-09-06 01:18:36 -070061Using this version of Python on OS X
62====================================
63
Ned Deily4ce92b22011-01-15 04:37:12 +000064Python consists of the Python programming language interpreter, plus
65a set of programs to allow easy access to it for Mac users including
66an integrated development environment, IDLE, plus a set of pre-built
67extension modules that open up specific Macintosh technologies to
68Python programs.
Thomas Wouters477c8d52006-05-27 19:21:47 +000069
Ned Deily4ce92b22011-01-15 04:37:12 +000070The installer puts applications, an "Update Shell Profile" command,
Ned Deilyeb698da2011-02-07 16:44:19 +000071and a link to the optionally installed Python Documentation into the
Ned Deily4ce92b22011-01-15 04:37:12 +000072"Python $VERSION" subfolder of the system Applications folder,
73and puts the underlying machinery into the folder
74$PYTHONFRAMEWORKINSTALLDIR. It can
75optionally place links to the command-line tools in /usr/local/bin as
76well. Double-click on the "Update Shell Profile" command to add the
77"bin" directory inside the framework to your shell's search path.
Thomas Wouters477c8d52006-05-27 19:21:47 +000078
Ned Deily5c0b1ca2012-08-24 19:57:33 -070079You must install onto your current boot disk, even though the
Ned Deily981b6932013-09-06 01:18:36 -070080installer may not enforce this, otherwise things will not work.
Ned Deily5c0b1ca2012-08-24 19:57:33 -070081
82You can verify the integrity of the disk image file containing the
83installer package and this ReadMe file by comparing its md5 checksum
84and size with the values published on the release page linked at
85http://www.python.org/download/
86
Ned Deily981b6932013-09-06 01:18:36 -070087Installation requires approximately $INSTALL_SIZE MB of disk space,
88ignore the message that it will take zero bytes.
89
Ronald Oussoren50987bc2009-02-12 15:24:51 +000090More information on Python in general can be found at
Thomas Wouters477c8d52006-05-27 19:21:47 +000091http://www.python.org.