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