blob: e061a06350ba6f26153a0c619763ce26d957f38e [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.
Ned Deilyb94efe62013-11-23 18:40:41 -080039If you do not want the installer to do this, select the "Customize"
40option at the "Installation Type" step and uncheck the "Install or
41ugprade pip" option.
Ned Deily41ab6c32013-11-22 22:25:43 -080042
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
Ned Deilyb94efe62013-11-23 18:40:41 -080047"Customize" and unchecking the "Shell profile updater" option. You
48can also update your shell profile later by launching the "Update
49Shell Profile" command found in the /Applications/Python $VERSION
50folder. You may need to start a new terminal window for the
51changes to take effect.
Ned Deily41ab6c32013-11-22 22:25:43 -080052
53Python.org Python $VERSION and 2.7.x versions can both be installed and
54will not conflict. Command names for Python 3 contain a 3 in them,
55python3 (or python$VERSION), idle3 (or idle$VERSION), pip3 (or pip$VERSION), etc.
56Python 2.7 command names contain a 2 or no digit: python2 (or
57python2.7 or python), idle2 (or idle2.7 or idle), etc. If you want to
58use pip with Python 2.7.x, you will need to download and install a
59separate copy of it from the Python Package Index
60(https://pypi.python.org/pypi).
61
Ned Deily981b6932013-09-06 01:18:36 -070062Using this version of Python on OS X
63====================================
64
Ned Deily4ce92b22011-01-15 04:37:12 +000065Python consists of the Python programming language interpreter, plus
66a set of programs to allow easy access to it for Mac users including
67an integrated development environment, IDLE, plus a set of pre-built
68extension modules that open up specific Macintosh technologies to
69Python programs.
Thomas Wouters477c8d52006-05-27 19:21:47 +000070
Ned Deily4ce92b22011-01-15 04:37:12 +000071The installer puts applications, an "Update Shell Profile" command,
Ned Deilyeb698da2011-02-07 16:44:19 +000072and a link to the optionally installed Python Documentation into the
Ned Deily4ce92b22011-01-15 04:37:12 +000073"Python $VERSION" subfolder of the system Applications folder,
74and puts the underlying machinery into the folder
75$PYTHONFRAMEWORKINSTALLDIR. It can
76optionally place links to the command-line tools in /usr/local/bin as
77well. Double-click on the "Update Shell Profile" command to add the
78"bin" directory inside the framework to your shell's search path.
Thomas Wouters477c8d52006-05-27 19:21:47 +000079
Ned Deily5c0b1ca2012-08-24 19:57:33 -070080You must install onto your current boot disk, even though the
Ned Deily981b6932013-09-06 01:18:36 -070081installer may not enforce this, otherwise things will not work.
Ned Deily5c0b1ca2012-08-24 19:57:33 -070082
83You can verify the integrity of the disk image file containing the
84installer package and this ReadMe file by comparing its md5 checksum
85and size with the values published on the release page linked at
86http://www.python.org/download/
87
Ned Deily981b6932013-09-06 01:18:36 -070088Installation requires approximately $INSTALL_SIZE MB of disk space,
89ignore the message that it will take zero bytes.
90
Ronald Oussoren50987bc2009-02-12 15:24:51 +000091More information on Python in general can be found at
Thomas Wouters477c8d52006-05-27 19:21:47 +000092http://www.python.org.