summaryrefslogtreecommitdiff
path: root/Mac/BuildScript/resources/ReadMe.rtf
blob: 8133c35b2169dfe57de5fdd1003955bb3cbbfc74 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
{\rtf1\ansi\ansicpg1252\cocoartf1671\cocoasubrtf100
{\fonttbl\f0\fswiss\fcharset0 Helvetica;\f1\fswiss\fcharset0 Helvetica-Bold;\f2\fswiss\fcharset0 Helvetica-Oblique;
\f3\fmodern\fcharset0 CourierNewPSMT;}
{\colortbl;\red255\green255\blue255;}
{\*\expandedcolortbl;;}
\margl1440\margr1440\vieww15240\viewh15540\viewkind0
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural\partightenfactor0

\f0\fs24 \cf0 This package will install Python $FULL_VERSION for macOS $MACOSX_DEPLOYMENT_TARGET for the following architecture(s): $ARCHITECTURES.\
\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural\partightenfactor0

\f1\b \cf0 \ul \ulc0 Which installer variant should I use? [CHANGED in 2.7.15]
\f0\b0 \ulnone \
\
With Python 2.7.15, the python.org website now provides two installer variants for download: one that installs a 
\f2\i 64-bit-only 
\f0\i0 Python capable of running on 
\f2\i macOS 10.9 (Mavericks)
\f0\i0  or later; and one that installs a 
\f2\i 64-bit/32-bit Intel
\f0\i0  Python capable of running on 
\f2\i macOS 10.6 (Snow Leopard)
\f0\i0  or later.  (This ReadMe was installed with the 
\f2\i $MACOSX_DEPLOYMENT_TARGET
\f0\i0  variant.)  Previous Python 2.7.x releases provided the 10.6 or later installer and a 10.5 or later 32-bit-only variant. If you are running on macOS 10.9 or later and if you have no need for compatibility with older systems, use the 10.9 variant.  Use the 10.6 variant if you are running on macOS 10.6 through 10.8, if you need to maintain compatibility with previous 2.7.x releases, or if you want to produce standalone applications that can run on systems from 10.6.  The Pythons installed by these installers are built with private copies of some third-party libraries not included with or newer than those in macOS itself.  The list of these libraries varies by installer variant and is included at the end of the 
\f3 License.rtf
\f0  file.\

\f1\b \ul \
Certificate verification and OpenSSL_[CHANGED in 2.7.15]\

\f0\b0 \ulnone \
This variant of Python 2.7 now includes its own private copy of OpenSSL 1.0.2.  Unlike previous releases, the deprecated Apple-supplied OpenSSL libraries are no longer used.  This also means that the trust certificates in system and user keychains managed by the 
\f2\i Keychain Access 
\f0\i0 application and the 
\f2\i security
\f0\i0  command line utility are no longer used as defaults by the Python 
\f3 ssl
\f0  module.  A sample command script is included in 
\f3 /Applications/Python 2.7
\f0  to install a curated bundle of default root certificates from the third-party 
\f3 certifi
\f0  package ({\field{\*\fldinst{HYPERLINK "https://pypi.python.org/pypi/certifi"}}{\fldrslt https://pypi.python.org/pypi/certifi}}).  Click on 
\f3 Install Certificates
\f0  to run it.  If you choose to use 
\f3 certifi
\f0 , you should consider subscribing to the{\field{\*\fldinst{HYPERLINK "https://certifi.io/en/latest/"}}{\fldrslt  project's email update service}} to be notified when the certificate bundle is updated.\
\
The bundled 
\f3 pip
\f0  included with the Python 2.7 installer has its own default certificate store for verifying download connections.\
\

\f1\b \ul Using IDLE or other Tk applications [NEW/CHANGED in 2.7.15] 
\f0\b0 \ulnone \
\
As of 2.7.15, the 10.9+ installer variant comes with its own private version of Tcl/Tk 8.6. It does not use system-supplied or third-party supplied versions of Tcl/Tk.\
\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural\partightenfactor0

\f1\b \cf0 CHANGED in 2.7.16: 
\f0\b0 The 10.6+ variant now also uses a private version of Tcl/Tk 8.6.\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural\partightenfactor0

\f1\b \cf0 \ul \ulc0 \
Binary installer support for Mac OS X 10.5 and earlier discontinued [CHANGED for Python 2.7.15]
\f0\b0 \ulnone \
\
As of Python 2.7.15, binary installers from python.org no longer support Mac OS X 10.5 (Leopard) systems.   Binary installer support for Mac OS X 10.3.9 (Panther) and 10.4.x (Tiger) systems was previously dropped in Python 2.7.9.  Mac OS X 10.5 was originally released by Apple in 2007 and last updated in 2009 and was the last OS X release for PPC machines (G4 and G5).  If needed, it is still possible to build Python from source for 10.3.9, 10.4, or 10.5.\
\

\f1\b \ul Packages installed with the system Python 2.7 are no longer searched for [CHANGED for Python 2.7.13]
\f0\b0 \ulnone \
\
As of Python 2.7.0, user-installed Python 2.7 versions from python.org installers added the system-wide site-packages directory for the Apple-supplied Python 2.7 to the end of their search path.  This meant that packages installed with the system Python 2.7 could also be used by the user-installed Python 2.7.  While sometimes convenient, this also often caused confusion with the implicit coupling between the two Python instances.  Separately, as of macOS 10.12, Apple changed the layout of the system site-packages directory, 
\f3 /Library/Python/2.7/site-packages
\f0 , in a way that can now cause installation of 
\f3 pip
\f0  components to fail.  To avoid the confusion and the installation failures, as of 2.7.13 user-installed Pythons no longer add 
\f3 /Library/Python/2.7/site-packages
\f0  to 
\f3 sys.path
\f0 .  If you are using a package with both a user-installed Python 2.7 and the system Python 2.7, you will now need to ensure that separate copies of the package are installed for each instance.\
\

\f1\b \ul Installing on OS X 10.8 (Mountain Lion) or later systems [CHANGED for Python 2.7.9]
\f0\b0 \ulnone \
\
As of Python 2.7.9, installer packages from python.org are now compatible with the Gatekeeper security feature introduced in OS X 10.8.   Downloaded packages can now be directly installed by double-clicking with the default system security settings.  Python.org installer packages for macOS are signed with the Developer ID of the builder, as identified on {\field{\*\fldinst{HYPERLINK "https://www.python.org/downloads/"}}{\fldrslt the download page}} for this release.  To inspect the digital signature of the package, click on the lock icon in the upper right corner of the 
\f2\i Install Python
\f0\i0  installer window.  Refer to Apple\'92s support pages for {\field{\*\fldinst{HYPERLINK "http://support.apple.com/kb/ht5290"}}{\fldrslt more information on Gatekeeper}}.\
\

\f1\b \ul Simplified web-based installs [NEW for Python 2.7.9]
\f0\b0 \ulnone \
\
With the change to the newer flat format installer package, the download file now has a 
\f3 .pkg
\f0  extension as it is no longer necessary to embed the installer within a disk image (
\f3 .dmg
\f0 ) container.   If you download the Python installer through a web browser, the macOS installer application may open automatically to allow you to perform the install.  If your browser settings do not allow automatic open, double click on the downloaded installer file.\
\

\f1\b \ul New Installation Options and Defaults [NEW for Python 2.7.9]
\f0\b0 \ulnone \
\
The Python installer now includes an option to automatically install or upgrade 
\f3 pip
\f0 , a tool for installing and managing Python packages.  This option is enabled by default and no Internet access is required.  If you do not want the installer to do this, select the 
\f2\i Customize
\f0\i0  option at the 
\f2\i Installation Type
\f0\i0  step and uncheck the 
\f2\i Install or upgrade pip
\f0\i0  option.  For other changes in this release, see the 
\f2\i Release Notes
\f0\i0  link for this release at {\field{\*\fldinst{HYPERLINK "https://www.python.org/downloads/"}}{\fldrslt https://www.python.org/downloads/}}.\
\

\f1\b \ul Python 3 and Python 2 Co-existence\

\f0\b0 \ulnone \
Python.org Python 2.7 and 3.x versions can both be installed on your system and will not conflict.  Python 2.7 command names contain a 2 or no digit: 
\f3 python2
\f0  (or 
\f3 python2.7
\f0  or 
\f3 python
\f0 ), 
\f3 idle2
\f0  (or 
\f3 idle2.7
\f0  or 
\f3 idle
\f0 ), 
\f3 pip2
\f0  (or 
\f3 pip2.7
\f0  or 
\f3 pip
\f0 ), etc.  Command names for Python 3 contain a 3 in them, 
\f3 python3
\f0 , 
\f3 idle3
\f0 , 
\f3 pip3
\f0 , etc.  Also, installing a python.org Python 2.7 does not alter or remove any Apple-supplied system Pythons, found in 
\f3 /usr/bin
\f0 .\
\
\
}