Mac/Demo/index.html - platform/external/python/cpython2 - Gitiles

 <HTML><HEAD><TITLE>Macintosh Python crash course</TITLE></HEAD>
 <BODY>
 <H1><IMG SRC="html.icons/python.gif">Macintosh Python crash course</H1>
 <HR>

 <p>This set of documents provides an introduction to various aspects of
 Python programming on the Mac. It is assumed that the reader is
 already familiar with Python and, to some extent, with MacOS Toolbox
 programming. Other readers may find something interesting here too,
 your mileage may vary. </p>

 <p>As the previous paragraph reveals to the careful observer these examples
 are dated, most of them were writting before OSX and haven't been updated
 afterwards. They still show how to use the Carbon wrappers but aren't
 necessarily the best way to use the Carbon API's in OSX.</p>

 Another set of Macintosh-savvy examples, more aimed at beginners, is
 maintained by Joseph Strout, at Python Tidbits in <A
 HREF="http://www.strout.net/python/">
 http://www.strout.net/python/</A>.
 <P>

 The <a href="http://www.python.org/doc/lib/Top.html">Python Library
 Reference</a> contains a section on <a
 href="http://www.python.org/doc/lib/Macintosh-Specific-Services.html">Macintosh-specific
 modules</a> that you should also read. Documentation is also available
 in PostScript and other forms, see the <a
 href="http://www.python.org/doc/">documentation</a> section on the
 webserver. <p>

 <p>The W widget set by Just van Rossum, does not have complete documentation as
 of this writing, but Corran Webster has documented most of it on his
 <A HREF="http://www.nevada.edu/~cwebster/Python/">Python Page</A>.</p>

 There are also some documentation links, as well as other MacPython-related
 pages, in the
 <A HREF="http://dmoz.org/Computers/Systems/Macintosh/Development/Scripting/Python/">
 Open Directory</A>.


 <H2>Table of contents</H2>

 <blockquote><B>Note:</B>
 Some of these documents were actually written a long time ago and have seen
 little maintainance, so use with care. </blockquote>
 <UL>
 <LI>
 <A HREF="example0.html">Using python to create Macintosh applications,
 part zero</A> whets your appetite by showing you how to ask the user
 for a filename, and how to display a message. It explains about end-of-line
 confusion while doing so.

 <LI>
 <A HREF="example1.html">Using python to create Macintosh applications,
 part one</A> explains how to create a simple modal-dialog application
 in Python. It also takes a glance at using the toolbox modules Res and
 Dlg, and EasyDialogs for simple question-dialogs.

 <LI>
 <A HREF="example2.html">Using python to create Macintosh applications,
 part two</A> turns the previous example program into a more complete
 mac application, using a modeless dialog, menus, etc. It also explains
 how to create applets, standalone applications written in Python.

 <LI>
 <A HREF="freezing.html">Freezing Python programs</A> extends on this concept,
 and shows you how to create applications that can be used on machines without
 a full Python installed. This one is probably best skipped on first contact
 with MacPython.

 <LI>
 <A HREF="textedit.html">Using FrameWork and TextEdit</A> shows you
 how to use <code>FrameWork</code> application framework and the
 <code>TextEdit</code> toolbox to build a text editor.

 <LI>
 <A HREF="plugins.html">Creating a C extension module on the Macintosh</A>
 is meant for the hardcore programmer, and shows how to create an
 extension module in C. It also handles using Modulator to create the
 boilerplate for your module, and creating dynamically-loadable modules
 on PowerPC Macs. It assumes you use CodeWarrior for you development.

 <LI>
 <A HREF="mpwextensions.html">Creating C extension modules using MPW</A>
 is a companion document, written by Corran Webster, which explains how you
 can develop Python extensions using Apple's free MPW compiler environment.

 <LI>
 <A HREF="applescript.html">Using Open Scripting Architecture from Python</A> explains
 how to create a Python module interfacing to a scriptable application,
 and how to use that module in your python program.

 <LI>
 <A HREF="cgi.html">Using python to create CGI scripts</A> is a preliminary
 introduction to writing CGI scripts in Python and to writing scriptable applications
 in Python.

 <LI>
 <A HREF="building.html">Building Mac Python from source</A> explains
 how to build a PPC or 68K interpreter from a source distribution.

 <LI>
 <A HREF="embed.html">Embedding Python on the Mac</A> is a minimal example of
 how to embed Python in other Mac applications.

 </UL>

 The Python distribution contains a few more examples, all unexplained:
 <UL>
 <LI>
 <I>PICTbrowse</I> is an application that locates PICT
 resources and displays them, it demonstrates some quickdraw and the
 resource and list managers. In the same folder you will find the very
 similar scripts ICONbrowse and cicnbrowse. oldPICTbrowse is the same program
 but form the pre-Appearance era, it uses a dialog with a user item and
 creates and manages its own List object.

 <LI>
 <I>Imgbrowse</I> displays image files in
 many different formats (gif, tiff, pbm, etc). It shows how to use the
 img modules on the mac.

 <LI>
 <I>Quicktime</I> has the standard <code>MovieInWindow</code> and
 <code>VerySimplePlayer</code> examples, re-coded in Python.

 <LI>
 <I>Resources</I>, <I>Sound</I> and <I>Speech</I> have some examples
 on using the respective managers. In the <i>Mac:Lib</i> folder you
 will also find modules that do useful things with the Communications
 Toolbox, the Finder interface, etc.

 <LI>
 <I>Printing</I> has an example on using the Printing module to, you guessed
 it, print from Python. The code is somewhat self-documenting. Donated
 by Just van Rossum, who also donated the Printing module itself.
 </UL>

 At some point in the (possibly distant) future, I will add chapters on
 how to use bgen to create modules completely automatic and how to make
 your Python program scriptable, but that will have to wait. <p>

 <HR>

 Please let me know if you miss critical information in this
 document. I am quite sure that I will never find the time to turn it
 into a complete MacPython programmers guide (which would probably be a
 400-page book instead of 10 lousy html-files), but it should contain
 at least the information that is neither in the standard Python
 documentation nor in Inside Mac or other Mac programmers
 documentation. <p>

 <HR>
 <A HREF="http://www.cwi.nl/~jack">Jack Jansen</A>,
 <A HREF="mailto:jack@cwi.nl">jack@cwi.nl</A>, 22-Apr-00.
 </BODY></HTML>
	<HTML><HEAD><TITLE>Macintosh Python crash course</TITLE></HEAD>
	<BODY>
	<H1><IMG SRC="html.icons/python.gif">Macintosh Python crash course</H1>
	<HR>

	<p>This set of documents provides an introduction to various aspects of
	Python programming on the Mac. It is assumed that the reader is
	already familiar with Python and, to some extent, with MacOS Toolbox
	programming. Other readers may find something interesting here too,
	your mileage may vary. </p>

	<p>As the previous paragraph reveals to the careful observer these examples
	are dated, most of them were writting before OSX and haven't been updated
	afterwards. They still show how to use the Carbon wrappers but aren't
	necessarily the best way to use the Carbon API's in OSX.</p>

	Another set of Macintosh-savvy examples, more aimed at beginners, is
	maintained by Joseph Strout, at Python Tidbits in <A
	HREF="http://www.strout.net/python/">
	http://www.strout.net/python/</A>.
	<P>

	The <a href="http://www.python.org/doc/lib/Top.html">Python Library
	Reference</a> contains a section on <a
	href="http://www.python.org/doc/lib/Macintosh-Specific-Services.html">Macintosh-specific
	modules</a> that you should also read. Documentation is also available
	in PostScript and other forms, see the <a
	href="http://www.python.org/doc/">documentation</a> section on the
	webserver. <p>

	<p>The W widget set by Just van Rossum, does not have complete documentation as
	of this writing, but Corran Webster has documented most of it on his
	<A HREF="http://www.nevada.edu/~cwebster/Python/">Python Page</A>.</p>

	There are also some documentation links, as well as other MacPython-related
	pages, in the
	<A HREF="http://dmoz.org/Computers/Systems/Macintosh/Development/Scripting/Python/">
	Open Directory</A>.


	<H2>Table of contents</H2>

	<blockquote><B>Note:</B>
	Some of these documents were actually written a long time ago and have seen
	little maintainance, so use with care. </blockquote>
	<UL>
	<LI>
	<A HREF="example0.html">Using python to create Macintosh applications,
	part zero</A> whets your appetite by showing you how to ask the user
	for a filename, and how to display a message. It explains about end-of-line
	confusion while doing so.

	<LI>
	<A HREF="example1.html">Using python to create Macintosh applications,
	part one</A> explains how to create a simple modal-dialog application
	in Python. It also takes a glance at using the toolbox modules Res and
	Dlg, and EasyDialogs for simple question-dialogs.

	<LI>
	<A HREF="example2.html">Using python to create Macintosh applications,
	part two</A> turns the previous example program into a more complete
	mac application, using a modeless dialog, menus, etc. It also explains
	how to create applets, standalone applications written in Python.

	<LI>
	<A HREF="freezing.html">Freezing Python programs</A> extends on this concept,
	and shows you how to create applications that can be used on machines without
	a full Python installed. This one is probably best skipped on first contact
	with MacPython.

	<LI>
	<A HREF="textedit.html">Using FrameWork and TextEdit</A> shows you
	how to use <code>FrameWork</code> application framework and the
	<code>TextEdit</code> toolbox to build a text editor.

	<LI>
	<A HREF="plugins.html">Creating a C extension module on the Macintosh</A>
	is meant for the hardcore programmer, and shows how to create an
	extension module in C. It also handles using Modulator to create the
	boilerplate for your module, and creating dynamically-loadable modules
	on PowerPC Macs. It assumes you use CodeWarrior for you development.

	<LI>
	<A HREF="mpwextensions.html">Creating C extension modules using MPW</A>
	is a companion document, written by Corran Webster, which explains how you
	can develop Python extensions using Apple's free MPW compiler environment.

	<LI>
	<A HREF="applescript.html">Using Open Scripting Architecture from Python</A> explains
	how to create a Python module interfacing to a scriptable application,
	and how to use that module in your python program.

	<LI>
	<A HREF="cgi.html">Using python to create CGI scripts</A> is a preliminary
	introduction to writing CGI scripts in Python and to writing scriptable applications
	in Python.

	<LI>
	<A HREF="building.html">Building Mac Python from source</A> explains
	how to build a PPC or 68K interpreter from a source distribution.

	<LI>
	<A HREF="embed.html">Embedding Python on the Mac</A> is a minimal example of
	how to embed Python in other Mac applications.

	</UL>

	The Python distribution contains a few more examples, all unexplained:
	<UL>
	<LI>
	<I>PICTbrowse</I> is an application that locates PICT
	resources and displays them, it demonstrates some quickdraw and the
	resource and list managers. In the same folder you will find the very
	similar scripts ICONbrowse and cicnbrowse. oldPICTbrowse is the same program
	but form the pre-Appearance era, it uses a dialog with a user item and
	creates and manages its own List object.

	<LI>
	<I>Imgbrowse</I> displays image files in
	many different formats (gif, tiff, pbm, etc). It shows how to use the
	img modules on the mac.

	<LI>
	<I>Quicktime</I> has the standard <code>MovieInWindow</code> and
	<code>VerySimplePlayer</code> examples, re-coded in Python.

	<LI>
	<I>Resources</I>, <I>Sound</I> and <I>Speech</I> have some examples
	on using the respective managers. In the <i>Mac:Lib</i> folder you
	will also find modules that do useful things with the Communications
	Toolbox, the Finder interface, etc.

	<LI>
	<I>Printing</I> has an example on using the Printing module to, you guessed
	it, print from Python. The code is somewhat self-documenting. Donated
	by Just van Rossum, who also donated the Printing module itself.
	</UL>

	At some point in the (possibly distant) future, I will add chapters on
	how to use bgen to create modules completely automatic and how to make
	your Python program scriptable, but that will have to wait. <p>

	<HR>

	Please let me know if you miss critical information in this
	document. I am quite sure that I will never find the time to turn it
	into a complete MacPython programmers guide (which would probably be a
	400-page book instead of 10 lousy html-files), but it should contain
	at least the information that is neither in the standard Python
	documentation nor in Inside Mac or other Mac programmers
	documentation. <p>

	<HR>
	<A HREF="http://www.cwi.nl/~jack">Jack Jansen</A>,
	<A HREF="mailto:jack@cwi.nl">jack@cwi.nl</A>, 22-Apr-00.
	</BODY></HTML>