| Jack Jansen | a630813 | 1996-03-18 13:38:52 +0000 | [diff] [blame] | 1 | <HTML><HEAD><TITLE>Macintosh Python crash course</TITLE></HEAD> |
| 2 | <BODY> |
| 3 | <H1><IMG SRC="html.icons/python.gif">Macintosh Python crash course</H1> |
| 4 | <HR> |
| 5 | |
| 6 | This set of documents provides an introduction to various aspects of |
| 7 | Python programming on the Mac. It is assumed that the reader is |
| 8 | already familiar with Python and, to some extent, with MacOS Toolbox |
| 9 | programming. Other readers may find something interesting here too, |
| 10 | your mileage may vary. <p> |
| 11 | |
| Jack Jansen | 5f962c2 | 1996-04-10 14:52:59 +0000 | [diff] [blame^] | 12 | There is a companion document <a href="using.html">Using Python on the Mac</a> |
| 13 | which you should read before starting here: it explains the basics of using |
| 14 | python on the Macintosh. <p> |
| 15 | |
| Jack Jansen | a630813 | 1996-03-18 13:38:52 +0000 | [diff] [blame] | 16 | Another set of Macintosh-savvy examples, more aimed at beginners, is |
| 17 | maintained by Joseph Strout, at <A |
| 18 | HREF="http://www-acs.ucsd.edu/~jstrout/python/"> |
| 19 | http://www-acs.ucsd.edu/~jstrout/python/</A>. |
| 20 | <P> |
| 21 | |
| 22 | The document was actually written while I was working on a "real" |
| 23 | project: creating a single-button application that will allow my |
| 24 | girlfriend to read her mail (which actually pass thry <EM>my</EM> |
| 25 | mailbox, so I get to read it too, but don't tell her:-) without her |
| 26 | having to worry about internet connections, unix commands, etc. The |
| 27 | application, when finished, will connect to the net using InterSLIP, |
| 28 | start a (pseudo-)POP server on unix using rsh and use AppleScript to |
| 29 | tell Eudora to connect to that server and retrieve messages. <p> |
| 30 | |
| 31 | <CITE> |
| 32 | If you want to try the examples here you will have to download some |
| 33 | fixes to the 1.3 distribution to your Macintosh. You need an updated |
| 34 | version of <A HREF="update-to-1.3/FrameWork.py">FrameWork.py</A> (to |
| 35 | go in <CODE>Lib:mac</CODE> and updated <A |
| 36 | HREF="update-to-1.3/into-PlugIns.hqx">project templates</A> to go into |
| 37 | the <CODE>PlugIns</CODE> folder for PPC users. |
| 38 | Users of 1.3.1 or later distributions don't need these fixes.<P> |
| 39 | </CITE> |
| 40 | |
| 41 | If you are reading this document on the web and would prefer to read |
| 42 | it offline you can transfer the whole stuff (as a BinHexed StuffIt |
| 43 | archive) from <A HREF="complete.hqx"> here</A>. This archive includes |
| 44 | the fixes mentioned in the previous paragraph. <p> |
| 45 | |
| 46 | <H2>Table of contents</H2> |
| 47 | |
| 48 | <UL> |
| 49 | <LI> |
| 50 | <A HREF="example1.html">Using python to create Macintosh applications, |
| 51 | part one</A> explains how to create a simple modal-dialog application |
| 52 | in Python. It also takes a glance at using the toolbox modules Res and |
| 53 | Dlg, and EasyDialogs for simple question-dialogs. |
| 54 | |
| 55 | <LI> |
| 56 | <A HREF="example2.html">Using python to create Macintosh applications, |
| 57 | part two</A> turns the previous example program into a more complete |
| 58 | mac application, using a modeless dialog, menus, etc. It also explains |
| 59 | how to create applets, standalone applications written in Python. |
| 60 | |
| 61 | <LI> |
| 62 | In the Python distribution two more examples are included without |
| 63 | explanation. <I>PICTbrowse</I> is an application that locates PICT |
| 64 | resources and displays them, it demonstrates some quickdraw and the |
| 65 | resource and list namagers. <I>Imgbrowse</I> displays image files in |
| 66 | many different formats (gif, tiff, pbm, etc). It shows how to use the |
| 67 | img modules on the mac. |
| 68 | |
| 69 | <LI> |
| 70 | <A HREF="plugins.html">Creating a C extension module on the Macintosh</A> |
| 71 | is meant for the hardcore programmer, and shows how to create an |
| 72 | extension module in C. It also handles using Modulator to create the |
| 73 | boilerplate for your module, and creating dynamically-loadable modules |
| 74 | on PowerPC Macs. |
| 75 | |
| 76 | <LI> |
| 77 | <A HREF="applescript.html">Using Open Scripting Architecture from Python</A> explains |
| 78 | how to create a Python module interfacing to a scriptable application, |
| 79 | and how to use that module in your python program. |
| 80 | </UL> |
| 81 | |
| 82 | At some point in the (possibly distant) future, I will add chapters on |
| 83 | how to use bgen to create modules completely automatic and how to make |
| 84 | your Python program scriptable, but that will have to wait. <p> |
| 85 | |
| 86 | <HR> |
| 87 | |
| 88 | Please let me know if you miss critical information in this |
| 89 | document. I am quite sure that I will never find the time to turn it |
| 90 | into a complete MacPython programmers guide (which would probably be a |
| 91 | 400-page book instead of 5 lousy html-files), but it should contain |
| 92 | at least the information that is neither in the standard Python |
| 93 | documentation nor in Inside Mac or other Mac programmers |
| 94 | documentation. <p> |
| 95 | |
| 96 | <HR> |
| 97 | <A HREF="http://www.cwi.nl/~jack">Jack Jansen</A>, |
| Jack Jansen | 5f962c2 | 1996-04-10 14:52:59 +0000 | [diff] [blame^] | 98 | <A HREF="mailto:jack@cwi.nl">jack@cwi.nl</A>, 7-Apr-1996. |