blob: f073086915e361d55eb1bbd52de65ab3549c6a34 [file] [log] [blame]
Jack Jansena6308131996-03-18 13:38:52 +00001<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
6This set of documents provides an introduction to various aspects of
7Python programming on the Mac. It is assumed that the reader is
8already familiar with Python and, to some extent, with MacOS Toolbox
9programming. Other readers may find something interesting here too,
10your mileage may vary. <p>
11
Jack Jansen5f962c21996-04-10 14:52:59 +000012There is a companion document <a href="using.html">Using Python on the Mac</a>
13which you should read before starting here: it explains the basics of using
14python on the Macintosh. <p>
15
Jack Jansena6308131996-03-18 13:38:52 +000016Another set of Macintosh-savvy examples, more aimed at beginners, is
17maintained by Joseph Strout, at <A
18HREF="http://www-acs.ucsd.edu/~jstrout/python/">
19http://www-acs.ucsd.edu/~jstrout/python/</A>.
20<P>
21
Jack Jansen3412c5d1997-08-27 14:08:22 +000022The <a href="http://www.python.org/doc/lib/Top.html">Python Library
23Reference</a> contains a section on <a
24href="http://www.python.org/doc/lib/Macintosh-Specific-Services.html">Macintosh-specific
25modules</a> that you should also read. Documentation is also available
26in PostScript and other forms, see the <a
27href="http://www.python.org/doc/">documentation</a> section on the
28webserver. <p>
Jack Jansen024a3871996-07-18 16:07:05 +000029
Jack Jansen3412c5d1997-08-27 14:08:22 +000030Some of these documents were actually written a long time ago and have seen
31little maintainance, so use with care. <p>
Jack Jansena6308131996-03-18 13:38:52 +000032
Jack Jansena6308131996-03-18 13:38:52 +000033<H2>Table of contents</H2>
34
35<UL>
36<LI>
Jack Jansen024a3871996-07-18 16:07:05 +000037<A HREF="example0.html">Using python to create Macintosh applications,
38part zero</A> whets your appetite by showing you how to ask the user
39for a filename, and how to display a message. It explains about end-of-line
40confusion while doing so.
41
42<LI>
Jack Jansena6308131996-03-18 13:38:52 +000043<A HREF="example1.html">Using python to create Macintosh applications,
44part one</A> explains how to create a simple modal-dialog application
45in Python. It also takes a glance at using the toolbox modules Res and
46Dlg, and EasyDialogs for simple question-dialogs.
47
48<LI>
49<A HREF="example2.html">Using python to create Macintosh applications,
50part two</A> turns the previous example program into a more complete
51mac application, using a modeless dialog, menus, etc. It also explains
52how to create applets, standalone applications written in Python.
53
54<LI>
Jack Jansend9690611998-06-26 15:01:52 +000055<A HREF="freezing.html">Freezing Python programs</A> extends on this concept,
56and shows you how to create applications that can be used on machines without
57a full Python installed. This one is probably best skipped on first contact
58with MacPython.
59
60<LI>
Jack Jansen08365421996-04-19 15:56:08 +000061<A HREF="textedit.html">Using FrameWork and TextEdit</A> shows you
62how to use <code>FrameWork</code> application framework and the
63<code>TextEdit</code> toolbox to build a text editor.
64
65<LI>
66<A HREF="waste.html">Using WASTE</A> expands on this editor by using
67WASTE, an extended TextEdit replacement.
Jack Jansena6308131996-03-18 13:38:52 +000068
69<LI>
70<A HREF="plugins.html">Creating a C extension module on the Macintosh</A>
71is meant for the hardcore programmer, and shows how to create an
72extension module in C. It also handles using Modulator to create the
73boilerplate for your module, and creating dynamically-loadable modules
74on PowerPC Macs.
75
76<LI>
77<A HREF="applescript.html">Using Open Scripting Architecture from Python</A> explains
78how to create a Python module interfacing to a scriptable application,
79and how to use that module in your python program.
Jack Jansen41222161996-05-20 11:32:49 +000080
81<LI>
Jack Jansen09da2091996-09-09 01:48:03 +000082<A HREF="cgi.html">Using python to create CGI scripts</A> is a preliminary
83introduction to writing CGI scripts in Python and to writing scriptable applications
84in Python.
85
86<LI>
Jack Jansen36389351996-08-07 13:19:16 +000087<A HREF="building.html">Building Mac Python from source</A> explains
Jack Jansen41222161996-05-20 11:32:49 +000088how to build a PPC or 68K interpreter from a source distribution.
Jack Jansen6ad8d131997-01-15 16:53:37 +000089
90<LI>
91<A HREF="embed.html">Embedding Python on the Mac</A> is a minimal example of
92how to embed Python in other Mac applications.
93
Jack Jansena6308131996-03-18 13:38:52 +000094</UL>
95
Jack Jansen08365421996-04-19 15:56:08 +000096The Python distribution contains a few more examples, all unexplained:
97<UL>
98<LI>
99<I>PICTbrowse</I> is an application that locates PICT
100resources and displays them, it demonstrates some quickdraw and the
101resource and list managers.
102
103<LI>
104<I>Imgbrowse</I> displays image files in
105many different formats (gif, tiff, pbm, etc). It shows how to use the
106img modules on the mac.
107
108<LI>
109<I>Quicktime</I> has the standard <code>MovieInWindow</code> and
110<code>VerySimplePlayer</code> examples, re-coded in Python.
111
112<LI>
113<I>Resources</I>, <I>Sound</I> and <I>Speech</I> have some examples
Jack Jansena2139fe1998-02-25 15:40:35 +0000114on using the respective managers. In the <i>Mac:Lib</i> folder you
115will also find modules that do useful things with the Communications
116Toolbox, the Finder interface, etc.
Jack Jansen5073b371998-04-27 15:06:50 +0000117
118<LI>
119<I>Printing</I> has an example on using the Printing module to, you guessed
120it, print from Python. The code is somewhat self-documenting. Donated
121by Just van Rossum, who also donated the Printing module itself.
Jack Jansen08365421996-04-19 15:56:08 +0000122</UL>
123
Jack Jansena6308131996-03-18 13:38:52 +0000124At some point in the (possibly distant) future, I will add chapters on
125how to use bgen to create modules completely automatic and how to make
126your Python program scriptable, but that will have to wait. <p>
127
128<HR>
129
130Please let me know if you miss critical information in this
131document. I am quite sure that I will never find the time to turn it
132into a complete MacPython programmers guide (which would probably be a
Jack Jansena2139fe1998-02-25 15:40:35 +0000133400-page book instead of 10 lousy html-files), but it should contain
Jack Jansena6308131996-03-18 13:38:52 +0000134at least the information that is neither in the standard Python
135documentation nor in Inside Mac or other Mac programmers
136documentation. <p>
137
138<HR>
139<A HREF="http://www.cwi.nl/~jack">Jack Jansen</A>,
Jack Jansend9690611998-06-26 15:01:52 +0000140<A HREF="mailto:jack@cwi.nl">jack@cwi.nl</A>, 26-Jun-98.
Jack Jansen024a3871996-07-18 16:07:05 +0000141</BODY></HTML>