Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / python / cpython3 / b06007a3ba0dcc3bfdc50131a0729dd21882a4ea / . / Mac / Demo / index.html
blob: 9845c201947229e9a06a2dee56cda396d9b0228b [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
Jack Jansenb06007a1999-12-23 14:45:41 +0000[diff] [blame^]102similar scripts ICONbrowse and cicnbrowse. oldPICTbrowse is the same program
103but form the pre-Appearance era, it uses a dialog with a user item and
104creates and manages its own List object.
Jack Jansen08365421996-04-19 15:56:08 +0000[diff] [blame]105
106<LI>
107<I>Imgbrowse</I> displays image files in
108many different formats (gif, tiff, pbm, etc). It shows how to use the
109img modules on the mac.
110
111<LI>
112<I>Quicktime</I> has the standard <code>MovieInWindow</code> and
113<code>VerySimplePlayer</code> examples, re-coded in Python.
114
115<LI>
116<I>Resources</I>, <I>Sound</I> and <I>Speech</I> have some examples
Jack Jansena2139fe1998-02-25 15:40:35 +0000[diff] [blame]117on using the respective managers. In the <i>Mac:Lib</i> folder you
118will also find modules that do useful things with the Communications
119Toolbox, the Finder interface, etc.
Jack Jansen5073b371998-04-27 15:06:50 +0000[diff] [blame]120
121<LI>
122<I>Printing</I> has an example on using the Printing module to, you guessed
123it, print from Python. The code is somewhat self-documenting. Donated
124by Just van Rossum, who also donated the Printing module itself.
Jack Jansen08365421996-04-19 15:56:08 +0000[diff] [blame]125</UL>
126
Jack Jansena6308131996-03-18 13:38:52 +0000[diff] [blame]127At some point in the (possibly distant) future, I will add chapters on
128how to use bgen to create modules completely automatic and how to make
129your Python program scriptable, but that will have to wait. <p>
130
131<HR>
132
133Please let me know if you miss critical information in this
134document. I am quite sure that I will never find the time to turn it
135into a complete MacPython programmers guide (which would probably be a
Jack Jansena2139fe1998-02-25 15:40:35 +0000[diff] [blame]136400-page book instead of 10 lousy html-files), but it should contain
Jack Jansena6308131996-03-18 13:38:52 +0000[diff] [blame]137at least the information that is neither in the standard Python
138documentation nor in Inside Mac or other Mac programmers
139documentation. <p>
140
141<HR>
142<A HREF="http://www.cwi.nl/~jack">Jack Jansen</A>,
Jack Jansend9690611998-06-26 15:01:52 +0000[diff] [blame]143<A HREF="mailto:jack@cwi.nl">jack@cwi.nl</A>, 26-Jun-98.
Jack Jansen024a3871996-07-18 16:07:05 +0000[diff] [blame]144</BODY></HTML>