Jack Jansen | 538bd13 | 2000-10-19 21:58:27 +0000 | [diff] [blame] | 1 | How to install Python 2.0 on your Macintosh |
| 2 | ------------------------------------------- |
Jack Jansen | 83cab72 | 1997-08-26 13:25:06 +0000 | [diff] [blame] | 3 | |
| 4 | If this is your first encounter with Python: you definitely need the |
| 5 | common user documentation (common to all platforms). You can find this |
Jack Jansen | 538bd13 | 2000-10-19 21:58:27 +0000 | [diff] [blame] | 6 | (in various forms) on www.pythonlabs.com, www.python.org and |
| 7 | ftp.python.org. Through there, or via |
| 8 | http://www.cwi.nl/~jack/macpython.html you can also find the most recent |
| 9 | MacPython distribution. |
Jack Jansen | 83cab72 | 1997-08-26 13:25:06 +0000 | [diff] [blame] | 10 | |
| 11 | Mac-specific documentation is included in this distribution in folder |
| 12 | Mac:Demo. The documentation is sparse, but it will have to serve for |
| 13 | now. The documentation is in HTML format, start with index.html. |
| 14 | |
Jack Jansen | d0ddb66 | 1998-04-27 15:14:36 +0000 | [diff] [blame] | 15 | Caveats |
| 16 | ------- |
Jack Jansen | de51909 | 2000-10-12 21:21:43 +0000 | [diff] [blame] | 17 | This is a final candidate version, so use with caution, and please report |
| 18 | problems as soon as possible, to pythonmac-sig@python.org. |
Jack Jansen | ffd61a6 | 2000-04-09 18:37:50 +0000 | [diff] [blame] | 19 | |
Jack Jansen | 8a6cdcc | 2000-09-10 12:02:28 +0000 | [diff] [blame] | 20 | Aside from the general new Python 2.0 features (compared to 1.5.2, there |
| 21 | was no 1.6 for the macintosh) like unicode support the main new features |
| 22 | of this MacPython release is support for multithreading. This has had |
| 23 | some preliminary testing, but please report any success or failure on |
| 24 | the mailing list. |
Jack Jansen | ffd61a6 | 2000-04-09 18:37:50 +0000 | [diff] [blame] | 25 | |
Jack Jansen | 8a6cdcc | 2000-09-10 12:02:28 +0000 | [diff] [blame] | 26 | This installer installs MacPython for PowerPC only, if you really want |
| 27 | 68k support you will have to stay with 1.5.2. Or, if you are willing to |
| 28 | invest the time and have access to CodeWarrior you are welcome to try |
| 29 | and build a 68k distribution, most of the projects and sources are |
| 30 | reasonably up to date (May 2000). Contact me for details. |
Jack Jansen | ecbc1cc | 1998-01-06 12:13:16 +0000 | [diff] [blame] | 31 | |
Jack Jansen | 965226b | 2000-09-14 20:58:24 +0000 | [diff] [blame] | 32 | This version of Python expects a recent version of Appearance, so it may |
| 33 | be that users with pre MacOS 8.5 systems have trouble running it. If |
| 34 | that is the case try getting CarbonLib from Apple, I am told this |
| 35 | includes Appearance and NavServices. You may also have to disable the |
| 36 | "Use navservices" preference for best results. |
| 37 | |
Jack Jansen | 83cab72 | 1997-08-26 13:25:06 +0000 | [diff] [blame] | 38 | What to install |
| 39 | --------------- |
| 40 | |
Jack Jansen | 8a6cdcc | 2000-09-10 12:02:28 +0000 | [diff] [blame] | 41 | This installer is PPC only: too many new MacOS features are not |
| 42 | available on 68K, and doing workarounds, even just #ifdeffing in the |
| 43 | code, is too much work for me right now. If someone wants to revive |
| 44 | 68K-MacPython: please do so. The project files still contain the 68K |
| 45 | targets (they're simply skipped by the build process) so all that is |
| 46 | needed is CodeWarrior, a source distribution and commitment. |
Jack Jansen | 12a37b7 | 2000-05-06 23:01:07 +0000 | [diff] [blame] | 47 | |
| 48 | The optional parts in this distribution are |
| 49 | - TK+PIL: Tkinter and support modules, plus Imaging, the Python image manipulation |
| 50 | package (allows you to read, write and display images and do lots of operations on them). |
| 51 | - img: another imaging package. Has more file format support and is faster |
| 52 | than imaging, but has only limited operations on images. There is a bridge |
| 53 | between the packages. |
| 54 | - Numeric: the LLNL Numeric Python extension. All sorts of nifty operations |
Jack Jansen | 8a6cdcc | 2000-09-10 12:02:28 +0000 | [diff] [blame] | 55 | on matrices and such. This is the most recent version from the sourceforge archive. |
Jack Jansen | 12a37b7 | 2000-05-06 23:01:07 +0000 | [diff] [blame] | 56 | - Developers kit: all header files and some tools and sample projects to get you started on |
| 57 | writing Python extensions if you have CodeWarrior. |
| 58 | All these except the DevKit are installed with Easy Install. |
Jack Jansen | 83cab72 | 1997-08-26 13:25:06 +0000 | [diff] [blame] | 59 | |
Jack Jansen | 0b72695 | 1997-10-08 15:34:42 +0000 | [diff] [blame] | 60 | After the installer finishes it automatically launches the |
Jack Jansen | 12a37b7 | 2000-05-06 23:01:07 +0000 | [diff] [blame] | 61 | ConfigurePython applet, to finish configuration of your Python. |
Jack Jansen | 538bd13 | 2000-10-19 21:58:27 +0000 | [diff] [blame] | 62 | If you have previously installed another copy of 2.0 you should manually |
Jack Jansen | 8a6cdcc | 2000-09-10 12:02:28 +0000 | [diff] [blame] | 63 | remove your preference file first (but no such action is needed for installing |
| 64 | beside older MacPythons, and they will live together happily). |
Jack Jansen | 83cab72 | 1997-08-26 13:25:06 +0000 | [diff] [blame] | 65 | |
Jack Jansen | 2e42bdd | 2000-11-14 20:37:37 +0000 | [diff] [blame] | 66 | Moving your Python installation after installing is generally not a good idea. |
| 67 | If you have to do this anyway you should remove your preference file, run |
| 68 | ConfigurePython and remove all .pyc files. |
| 69 | |
Jack Jansen | 83cab72 | 1997-08-26 13:25:06 +0000 | [diff] [blame] | 70 | If you don't have enough memory: the sizes choosen are somewhat |
Jack Jansen | 9080e9b | 2001-01-23 21:03:52 +0000 | [diff] [blame] | 71 | arbitrary, and they are as high as they are so that test.autotest runs with fewer |
| 72 | problems. An average Python program can make do with much less memory. |
| 73 | Try lowering the application sizes in the finder "get info" |
| 74 | window, and seeing whether the resulting python is still usable. |
Jack Jansen | 83cab72 | 1997-08-26 13:25:06 +0000 | [diff] [blame] | 75 | |
Jack Jansen | 83cab72 | 1997-08-26 13:25:06 +0000 | [diff] [blame] | 76 | After installing |
| 77 | ---------------- |
| 78 | |
Jack Jansen | 8a6cdcc | 2000-09-10 12:02:28 +0000 | [diff] [blame] | 79 | It is probably a good idea to run the automatic tests. Start |
Jack Jansen | de51909 | 2000-10-12 21:21:43 +0000 | [diff] [blame] | 80 | Python and "import test.autotest". |
| 81 | |
Jack Jansen | 2e42bdd | 2000-11-14 20:37:37 +0000 | [diff] [blame] | 82 | Three tests will fail on the mac, all with MemoryErrors: test_sha, |
| 83 | test_longexp and test_zlib. If you increase the PythonInterpreter memory |
| 84 | partition size they will pass. It will, however, print some messages |
| 85 | about optional features not supported. You should not worry about these, |
| 86 | they are modules that are supported by Python on other platforms. Also, |
| 87 | if you didn't run compileall before autotesting you may run out of |
| 88 | memory the first time you run the tests. test_socket may also fail if |
| 89 | you have no internet connection. Please also read the Relnotes file for |
| 90 | other minor problems with this distribution. |
Jack Jansen | 83cab72 | 1997-08-26 13:25:06 +0000 | [diff] [blame] | 91 | |
Jack Jansen | 12a37b7 | 2000-05-06 23:01:07 +0000 | [diff] [blame] | 92 | Using Python is most easily done from the IDE, which has a builtin editor, |
| 93 | debugger and other goodies. The alternative is to use PythonInterpreter, |
| 94 | which is the lowlevel interpreter with a console-window only (similar to Unix |
| 95 | Python). |
Jack Jansen | 83cab72 | 1997-08-26 13:25:06 +0000 | [diff] [blame] | 96 | |
Jack Jansen | 8a6cdcc | 2000-09-10 12:02:28 +0000 | [diff] [blame] | 97 | If your program uses Tkinter you MUST run it under PythonInterpreter, Tkinter |
| 98 | and IDE are incompatible and your program will fail in strange ways. |
| 99 | |
Jack Jansen | 0b72695 | 1997-10-08 15:34:42 +0000 | [diff] [blame] | 100 | Uninstalling |
| 101 | ------------ |
| 102 | |
| 103 | Two items are installed in the system folder: the interpreter shared |
Jack Jansen | 538bd13 | 2000-10-19 21:58:27 +0000 | [diff] [blame] | 104 | library "PythonCore 2.0" lives in the Extensions folder and the |
| 105 | "Python 2.0 Preferences" file in the Python subfolder in the |
Jack Jansen | 8a6cdcc | 2000-09-10 12:02:28 +0000 | [diff] [blame] | 106 | Preferences folder. All the rest of Python lives in the folder you |
| 107 | installed in. |
Jack Jansen | 0b72695 | 1997-10-08 15:34:42 +0000 | [diff] [blame] | 108 | |
Jack Jansen | 83cab72 | 1997-08-26 13:25:06 +0000 | [diff] [blame] | 109 | Things to see |
| 110 | ------------- |
| 111 | |
Jack Jansen | 12a37b7 | 2000-05-06 23:01:07 +0000 | [diff] [blame] | 112 | Start off at Mac:Demo:index.html. Read at least the first few sections. |
| 113 | |
Jack Jansen | 8a6cdcc | 2000-09-10 12:02:28 +0000 | [diff] [blame] | 114 | There are also some interesting files in the "Relnotes" folder that may |
Jack Jansen | 83cab72 | 1997-08-26 13:25:06 +0000 | [diff] [blame] | 115 | contain useful information. There is also a first stab at documentation |
| 116 | (plus examples) in the Mac:Demo folder. The toplevel Demo folder has |
Jack Jansen | 12a37b7 | 2000-05-06 23:01:07 +0000 | [diff] [blame] | 117 | machine-independent demos. |
| 118 | The Mac:Lib:test folder also has some programs that show simple |
Jack Jansen | 83cab72 | 1997-08-26 13:25:06 +0000 | [diff] [blame] | 119 | capabilities of various modules. |
| 120 | |
Jack Jansen | 8a6cdcc | 2000-09-10 12:02:28 +0000 | [diff] [blame] | 121 | The ":Mac:scripts" folder has some sample scripts. Some are useful, some are |
Jack Jansen | 83cab72 | 1997-08-26 13:25:06 +0000 | [diff] [blame] | 122 | just interesting to look at to see how various things work. The MkDistr, |
| 123 | mkapplet and fullbuild scripts (plus the ones mentioned above) may help |
| 124 | you to understand how to use AppleEvents and various other toolboxes |
| 125 | from python. |
| 126 | |
Jack Jansen | 8a6cdcc | 2000-09-10 12:02:28 +0000 | [diff] [blame] | 127 | Other mac-specific goodies can be found in :Mac:Tools, of which the IDE sources |
| 128 | and a CGI framework deserve special mention. |
| 129 | |
Jack Jansen | 83cab72 | 1997-08-26 13:25:06 +0000 | [diff] [blame] | 130 | The 'img' group of modules, which handles I/O of many different image |
Jack Jansen | d0ddb66 | 1998-04-27 15:14:36 +0000 | [diff] [blame] | 131 | formats is included, but without documentation. You can find docs at |
| 132 | ftp://ftp.cwi.nl/pub/jack/python/img (or somewhere around there). |
| 133 | |
| 134 | Finally there is a Mac:Contrib folder which contains some contributed |
Jack Jansen | 12a37b7 | 2000-05-06 23:01:07 +0000 | [diff] [blame] | 135 | software. |
Jack Jansen | 83cab72 | 1997-08-26 13:25:06 +0000 | [diff] [blame] | 136 | |
| 137 | Upgrading from older Python releases |
| 138 | ------------------------------------ |
| 139 | |
| 140 | Since release 1.4 Python releases are independent of each other, with |
| 141 | separate Preferences files, shared library names, etc. The good news is |
| 142 | that this means you can keep your older version around if you are unsure |
| 143 | whether to upgrade. The bad news is that your old preference settings |
| 144 | are lost and you have to set them again. |
| 145 | |
Jack Jansen | 538bd13 | 2000-10-19 21:58:27 +0000 | [diff] [blame] | 146 | After you are satisfied that 2.0 works as expected you can trash |
Jack Jansen | 83cab72 | 1997-08-26 13:25:06 +0000 | [diff] [blame] | 147 | anything in the system folder that has "python" in the name and not |
Jack Jansen | 538bd13 | 2000-10-19 21:58:27 +0000 | [diff] [blame] | 148 | "2.0". |
Jack Jansen | 83cab72 | 1997-08-26 13:25:06 +0000 | [diff] [blame] | 149 | |
| 150 | The installer |
| 151 | ------------- |
| 152 | |
Jack Jansen | 12a37b7 | 2000-05-06 23:01:07 +0000 | [diff] [blame] | 153 | The installer for this product was created using Installer VISE |
| 154 | from MindVision Software. For more information on Installer VISE, |
Jack Jansen | 83cab72 | 1997-08-26 13:25:06 +0000 | [diff] [blame] | 155 | contact: |
| 156 | MindVision Software |
| 157 | 7201 North 7th Street |
| 158 | Lincoln, NE 68521-8913 |
| 159 | Voice: 402-477-3269 |
| 160 | Fax: 402-477-1395 |
| 161 | Internet: mindvision@mindvision.com |
| 162 | http://www.mindvision.com |
| 163 | |
Jack Jansen | 12a37b7 | 2000-05-06 23:01:07 +0000 | [diff] [blame] | 164 | Just van Rossum <just@letterror.nl> created the initial version of the |
| 165 | installer (with Installer Vise Lite), and Jack worked from there. |
Jack Jansen | 83cab72 | 1997-08-26 13:25:06 +0000 | [diff] [blame] | 166 | |
Jack Jansen | 01ae9eb | 2000-04-22 22:57:25 +0000 | [diff] [blame] | 167 | Thanks! |
| 168 | ------- |
| 169 | |
Jack Jansen | 965226b | 2000-09-14 20:58:24 +0000 | [diff] [blame] | 170 | Thanks go to the whole Python community with Guido in the lead, of |
| 171 | course. Mac-specific thanks go to the pythonmac-sig, Just van Rossum, |
| 172 | Corran Webster, Tony Ingraldi, Erik van Blokland, Bill Bedford, Chris |
| 173 | Stern, Gordon Worley, Oliver Steele, M. Papillon, Steven Majewski, David |
Jack Jansen | 538bd13 | 2000-10-19 21:58:27 +0000 | [diff] [blame] | 174 | Goodger, Chris Barker, Luc Lefebvre, Tattoo Mabonzo K., Russell Finn, |
| 175 | Tom Bridgman and all the other people who provided feedback, code or both! |
Jack Jansen | 01ae9eb | 2000-04-22 22:57:25 +0000 | [diff] [blame] | 176 | |
Jack Jansen | de51909 | 2000-10-12 21:21:43 +0000 | [diff] [blame] | 177 | MacPython includes waste, a TextEdit replacement which is (c) 1998 Marco Piovanelli. |
| 178 | |
Jack Jansen | 9080e9b | 2001-01-23 21:03:52 +0000 | [diff] [blame] | 179 | A special mention is deserved by Matthias Neeracher, who has written the brilliant |
| 180 | unix-compatible GUSI I/O library, without which MacPython would not have sockets |
| 181 | or select, and to Alexandre Parenteau, who has ported this library to Carbon. |
| 182 | |
Jack Jansen | 83cab72 | 1997-08-26 13:25:06 +0000 | [diff] [blame] | 183 | Feedback |
| 184 | -------- |
| 185 | |
| 186 | Send bug reports, suggestions, contributions and fanmail to |
Jack Jansen | ecbc1cc | 1998-01-06 12:13:16 +0000 | [diff] [blame] | 187 | <jack@cwi.nl>. However, a better way to discuss MacPython is to join the |
Jack Jansen | 83cab72 | 1997-08-26 13:25:06 +0000 | [diff] [blame] | 188 | <pythonmac-sig@python.org> mailing list, which is explicitly meant for |
| 189 | this purpose. |
| 190 | |
| 191 | Alternatively, you can try sending to comp.lang.python or |
| 192 | python-list@cwi.nl, but since I read the newsgroup, not the mailinglist, |
| 193 | I may miss it there (but other people may know quite a bit more than me |
| 194 | anyway:-). |
| 195 | |
| 196 | Jack Jansen |
Jack Jansen | 12a37b7 | 2000-05-06 23:01:07 +0000 | [diff] [blame] | 197 | Oratrix Development BV |
| 198 | Valeriusplein 30 |
| 199 | Amsterdam |
Jack Jansen | 83cab72 | 1997-08-26 13:25:06 +0000 | [diff] [blame] | 200 | the Netherlands |
| 201 | |
| 202 | <jack@cwi.nl>, http://www.cwi.nl/~jack |