Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / python / cpython3 / 1c4d96fde80fbbff2873b8c89d6cad64ee0dbef3 / . / Mac / Demo / index.html
blob: adb0acc98969e3b464782b3104986588b6bb20eb [file] [log] [blame]
Jack Jansena6308131996-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
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 +0000[diff] [blame]12There 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 +0000[diff] [blame]16Another 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 +0000[diff] [blame]22The <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 +0000[diff] [blame]29
Jack Jansen3412c5d1997-08-27 14:08:22 +0000[diff] [blame]30Some 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 +0000[diff] [blame]32
Jack Jansena6308131996-03-18 13:38:52 +0000[diff] [blame]33<H2>Table of contents</H2>
34
35<UL>
36<LI>
Jack Jansen024a3871996-07-18 16:07:05 +0000[diff] [blame]37<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 +0000[diff] [blame]43<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 +0000[diff] [blame]55<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 +0000[diff] [blame]61<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 +0000[diff] [blame]68
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 +0000[diff] [blame]80
81<LI>
Jack Jansen09da2091996-09-09 01:48:03 +0000[diff] [blame]82<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 +0000[diff] [blame]87<A HREF="building.html">Building Mac Python from source</A> explains
Jack Jansen41222161996-05-20 11:32:49 +0000[diff] [blame]88how to build a PPC or 68K interpreter from a source distribution.
Jack Jansen6ad8d131997-01-15 16:53:37 +0000[diff] [blame]89
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 +0000[diff] [blame]94</UL>
95
Jack Jansen08365421996-04-19 15:56:08 +0000[diff] [blame]96The 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
Jack Jansen1c4d96f1999-01-21 14:30:55 +0000[diff] [blame^]101resource and list managers. In the same folder you will find the very
102similar scripts ICONbrowse and cicnbrowse.
Jack Jansen08365421996-04-19 15:56:08 +0000[diff] [blame]103
104<LI>
105<I>Imgbrowse</I> displays image files in
106many different formats (gif, tiff, pbm, etc). It shows how to use the
107img modules on the mac.
108
109<LI>
110<I>Quicktime</I> has the standard <code>MovieInWindow</code> and
111<code>VerySimplePlayer</code> examples, re-coded in Python.
112
113<LI>
114<I>Resources</I>, <I>Sound</I> and <I>Speech</I> have some examples
Jack Jansena2139fe1998-02-25 15:40:35 +0000[diff] [blame]115on using the respective managers. In the <i>Mac:Lib</i> folder you
116will also find modules that do useful things with the Communications
117Toolbox, the Finder interface, etc.
Jack Jansen5073b371998-04-27 15:06:50 +0000[diff] [blame]118
119<LI>
120<I>Printing</I> has an example on using the Printing module to, you guessed
121it, print from Python. The code is somewhat self-documenting. Donated
122by Just van Rossum, who also donated the Printing module itself.
Jack Jansen08365421996-04-19 15:56:08 +0000[diff] [blame]123</UL>
124
Jack Jansena6308131996-03-18 13:38:52 +0000[diff] [blame]125At some point in the (possibly distant) future, I will add chapters on
126how to use bgen to create modules completely automatic and how to make
127your Python program scriptable, but that will have to wait. <p>
128
129<HR>
130
131Please let me know if you miss critical information in this
132document. I am quite sure that I will never find the time to turn it
133into a complete MacPython programmers guide (which would probably be a
Jack Jansena2139fe1998-02-25 15:40:35 +0000[diff] [blame]134400-page book instead of 10 lousy html-files), but it should contain
Jack Jansena6308131996-03-18 13:38:52 +0000[diff] [blame]135at least the information that is neither in the standard Python
136documentation nor in Inside Mac or other Mac programmers
137documentation. <p>
138
139<HR>
140<A HREF="http://www.cwi.nl/~jack">Jack Jansen</A>,
Jack Jansend9690611998-06-26 15:01:52 +0000[diff] [blame]141<A HREF="mailto:jack@cwi.nl">jack@cwi.nl</A>, 26-Jun-98.
Jack Jansen024a3871996-07-18 16:07:05 +0000[diff] [blame]142</BODY></HTML>