Skip to content

C
cpython
Commit 364b2218 authored by Ronald Oussoren's avatar Ronald Oussoren
Browse files
Options

Remove some old MacPython files that are no longer relevant.

parent cc00a262
Expand all Show whitespace changes
Inline Side-by-side
Showing with 1 addition and 1617 deletions
Mac/Makefile.in
View file @ 364b2218
...@@ -38,12 +38,7 @@ STRIPFLAG=-s ...@@ -38,12 +38,7 @@ STRIPFLAG=-s
CPMAC=/Developer/Tools/CpMac CPMAC=/Developer/Tools/CpMac
APPTEMPLATE=$(srcdir)/Resources/app APPTEMPLATE=$(srcdir)/Resources/app
APPSUBDIRS=MacOS Resources Resources/English.lproj \ APPSUBDIRS=MacOS Resources
Resources/English.lproj/Documentation \
Resources/English.lproj/Documentation/doc \
Resources/English.lproj/Documentation/ide
DOCDIR=$(srcdir)/Resources/app/Resources/English.lproj/Documentation
DOCINDEX=$(DOCDIR)/"Documentation idx"
CACHERSRC=$(srcdir)/scripts/cachersrc.py CACHERSRC=$(srcdir)/scripts/cachersrc.py
compileall=$(srcdir)/../Lib/compileall.py compileall=$(srcdir)/../Lib/compileall.py
...@@ -161,9 +156,6 @@ install_PythonLauncher: ...@@ -161,9 +156,6 @@ install_PythonLauncher:
cd PythonLauncher && make install DESTDIR=$(DESTDIR) cd PythonLauncher && make install DESTDIR=$(DESTDIR)
install_Python: install_Python:
@if test ! -f $(DOCINDEX); then \
echo WARNING: you should run Apple Help Indexing Tool on $(DOCDIR); \
fi
@for i in "$(PYTHONAPPSDIR)" "$(APPINSTALLDIR)" "$(APPINSTALLDIR)/Contents"; do \ @for i in "$(PYTHONAPPSDIR)" "$(APPINSTALLDIR)" "$(APPINSTALLDIR)/Contents"; do \
if test ! -d "$(DESTDIR)$$i"; then \ if test ! -d "$(DESTDIR)$$i"; then \
echo "Creating directory $(DESTDIR)$$i"; \ echo "Creating directory $(DESTDIR)$$i"; \
......
Mac/Resources/app/Resources/English.lproj/Documentation/community.html deleted 100644 → 0
View file @ cc00a262
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
<html lang="en">
<head>
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1">
<title>What is MacPython?</title>
<meta name="generator" content="BBEdit 6.5.3">
<link rel="SHORTCUT ICON" href="pythonsmall.gif">
<META NAME="AppleIcon" CONTENT="pythonsmall.gif">
</head>
<body>
<table>
<tr>
<td>
<img src="python.gif" width="128" height="128" align="top" alt="">
</td>
<td>
<h1>MacPython Community</h1>
</td>
</tr>
</table>
<hr>
<h2>Web Sites</h2>
<p>The MacPython homepage, <a href="http://www.cwi.nl/~jack/macpython.html">
www.cwi.nl/~jack/macpython.html</a>
is where you can find installers, documents, links to useful packages and more.
And, of course,
<a href="http://www.python.org">www.python.org</a> has a much larger collection
of material on Python that is not Mac-specific.</p>
<h2>News groups and Mailing lists</h2>
<p>There are a lot of mailing lists on Python. Some of the more interesting
ones are:</p>
<ul>
<li><a href="mailto:python-help@python.org">python-help@python.org</a> where
you can send questions for individual support. Please check the websites mentioned
above first, though!</li>
<li>The <a href="news:comp.lang.python">comp.lang.python</a> newsgroup for general
discussion. Also available as a
<a href="http://www.python.org/mailman/listinfo/python-list">mailing list</a>.</li>
<li>The <a href="news:comp.lang.python.announce">comp.lang.python.announce</a>
newsgroup for announcements. Low-volume and moderated. Also available as a
<a href="http://www.python.org/mailman/listinfo/python-announce-list">mailing list</a>.</li>
<li>Last but not least, the <a href="http://www.python.org/sigs/pythonmac-sig/">pythonmac-sig</a>
mailing list is specifically for MacPython. Discussions on the implementation of new
features, but beginners questions are welcome too.</li>
</ul>
<p>In addition there are Python <a href="http://www.python.org/sigs/">Special Interest Group</a>
mailing lists on a wide variety of topics such as image processing, numerical algorithms
and more.</p>
<h2>More</h2>
<p>An index of conferences, Wiki's, bookshops and more can be found at the
<a href="http://www.python.org/psa/">Community</a> section of the Python website.</p>
<p>If you find a bug you are kindly requested to report it, preferrably through the
automatic bug tracker at <a href="http://www.python.org">www.python.org</a></p>
<p>If you want to become an active developer you are very welcome! Join the
pythonmac-sig mailing list mentioned above, and read the
<a href="http://www.python.org/dev/">Developer</a> section on the Python website.</p>
</body>
</html>
Mac/Resources/app/Resources/English.lproj/Documentation/doc/index.html deleted 100644 → 0
View file @ cc00a262
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
<html lang="en">
<head>
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1">
<title>Python Language Documentation</title>
<meta name="generator" content="BBEdit 6.5.3">
</head>
<body>
<h1>Python Language and runtime documentation</h1>
<p>This volume of documentation is rather big (17 Megabytes) and contains
a tutorial, full description of the Python library (all the modules
and packages included), formal description of the language and more.</p>
<p>You can <a href="http://www.python.org/doc">view it online</a>, where
you can also download PDFs for printing, or you can download and install it
through the <a href="../packman.html">Package Manager</a> for viewing and
searching via Apple Help Viewer.</p>
</body>
</html>
Mac/Resources/app/Resources/English.lproj/Documentation/finder.html deleted 100644 → 0
View file @ cc00a262
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
<html lang="en">
<head>
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1">
<title>Python and the Finder</title>
<meta name="generator" content="BBEdit 6.5.3">
<link rel="SHORTCUT ICON" href="pythonsmall.gif">
<META NAME="AppleIcon" CONTENT="pythonsmall.gif">
</head>
<body>
<h1>Running Python scripts from the Finder</h1>
<table>
<tr>
<td>
<img src="python.gif" width="128" height="128" align="top" alt="">
</td>
<td>
<p>The application PythonLauncher will start a Python interpreter
when you drop a Python source file onto it, any file with a <tt>.py</tt>
or <tt>.pyw</tt> extension. If you set PythonLauncher as the default
application to open a file
(<a href="help:search=Changing%20the%20application%20that%20opens%20a%20file bookID=Mac%20Help">
tell me more</a>) this also works when you double click a Python script.</p>
<p>PythonLauncher has preferences per filetype for selecting
the interpreter to use, and how to launch it: in a Terminal window
or not, etc. Holding the Option key while launching your script will
bring up a window that allows changing these settings for a single
run. </p>
</td>
</tr>
</table>
<hr>
</body>
</html>
Mac/Resources/app/Resources/English.lproj/Documentation/gui.html deleted 100644 → 0
View file @ cc00a262
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
<html lang="en">
<head>
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1">
<title>Creating a User Interface with MacPython</title>
<meta name="generator" content="BBEdit 6.5.3">
<link rel="SHORTCUT ICON" href="pythonsmall.gif">
<META NAME="AppleIcon" CONTENT="pythonsmall.gif">
</head>
<body>
<h1>Creating a User Interface with MacPython</h1>
<p>There are a number of packages that allow creation of a user interface
for your Python code, each of which has its own merits:</p>
<ul>
<li> The Carbon package gives low-level access to the old Macintosh toolbox
calls for windows, events, dialogs and more. The <tt>FrameWork</tt> module
wraps these in a minimal framework. For documentation see the Macintosh
Library section of the <a href="doc/index.html">Python Language and runtime
documentation</a> and the Human Interface Toolbox section of
<a href="help:openbook=Carbon">Apple's Carbon Documentation</a>.
This solution is compatible with MacPython-OS9.</li>
<li> The <tt>W</tt> framework is built on top of this, and easier to use.
The MacPython IDE uses W. Some documentation is available on
<a href="http://www.nevada.edu/~cwebster/Python/index.html">Corran Webster's website</a>.
Compatible with MacPython-OS9.</li>
</ul>
<p>For new work, however, one of the following packages may be better suited.
They may be available out of the box in this distribution, otherwise you
can install them through the <a href="packman.html">Package Manager</a>:</p>
<ul>
<li> <a href="http://pyobjc.sourceforge.net/">PyObjC</a> allows complete access to Cocoa.
In technical terms it is a
bidirectional bridge between Python and Objectve-C, similar to Apple's Java
bridge. Probably the best choice for Mac OS X-only applications, but at the
time of this writing PyObjC is still in beta.</li>
<li> <a href="http://wxpython.sourceforge.net/">wxPython</a> gives Python programs
access to the wxWindows GUI toolkit. Many people consider this
the best open source cross-platform GUI solution available today.</li>
<li> Tkinter is the oldest cross-platform GUI toolkit for Python, bridging Python
to Tcl/Tk. If you install AquaTk it creates a native user interface on Mac OS X.
Documented in the Library section, Tkinter subsection of the
<a href="doc/index.html">Python Language and runtime documentation</a>. Tkinter
is not available for MacPython-OS9.</li>
</ul>
</body>
</html>
Mac/Resources/app/Resources/English.lproj/Documentation/ide/IDE.gif deleted 100644 → 0
View file @ cc00a262
This diff was suppressed by a .gitattributes entry.
Mac/Resources/app/Resources/English.lproj/Documentation/ide/index.html deleted 100644 → 0
View file @ cc00a262
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
<html lang="en">
<head>
<title>One Day of MacPython IDE Toying</title>
<link rel="SHORTCUT ICON" href="../pythonsmall.gif">
<META NAME="AppleIcon" CONTENT="../pythonsmall.gif">
</head>
<body bgcolor="#ffffff">
<h1>One Day of MacPython IDE Toying</h1>
<table>
<tr>
<td>
<img src="IDE.gif" alt="">
</td>
<td>
<p>This document gives a very basic introduction to the
MacPython <b>I</b>ntegrated <b>D</b>evelopment <b>E</b>nvironment (IDE) on Mac OS. It was
written specifically for MacPython 2.3 on Mac OS X, but most of
it is applicable to MacPython-OS9 too. It is based on
<a href="http://www-hkn.eecs.berkeley.edu/~dyoo/python/idle_intro/">&quot;One
Day of IDLE Toying&quot;</a> by Danny Yoo, which you should read if
you want to use the cross-platform IDLE Python development
environment.</p>
</td>
</tr>
</table>
<hr>
<br style="page-break-after: always">
<p>Ok, let's assume that we've already installed Python. (If not, we can
visit: <a href="http://www.cwi.nl/~jack/macpython.html">http://www.cwi.nl/~jack/macpython.html</a>
or <a href="http://python.org">http://python.org</a>
and download the most recent Python interpreter. Get the Mac OSX binary
installer.) The first thing we'd like to do is actually start running it!
We can do this by opening up the IDE, which should be in Applications
under the newly-created MacPython program folder: </p><p><img
src="loading_ide.gif" border=1 alt="image of IDE icon"></p>
<hr><br style="page-break-after: always">
<p>The IDE starts up and shows an interactive window: </p>
<p><img src="new_ide_window.gif" alt="image of new window"></p>
<p>If the window does not show up (because you have run the IDE before
and closed it: it remembers that between runs) open it with the <tt>Windows-&gt;Python Interactive</tt>
menu entry. </p>
<p>This is the interactive window to the IDE, it allows us to enter
commands directly into Python, and as soon as we enter a command,
Python will execute it and spit its result back to us. We'll be
using this interactive window a lot when we're exploring Python: it's
very nice because we get back our results immediately. If it helps,
we can think of it as a very powerful calculator.</p>
<hr><br style="page-break-after: always">
<p>Let's try something now! As per tradition, let's get Python to say
the immortal words, "Hello World". <img src="hello_world.gif"
border=1 alt="image of hello world program"></p> <p>Those '<tt>&gt;&gt;&gt;</tt>' signs act as a prompt
for us: Python is ready to read in a new command by giving us that
visual cue. Also, we notice that as we enter commands, Python will
give us its output immediately.
</p>
<hr><br style="page-break-after: always">
<p>Ok, this seems pretty simple enough. Let's try a few more
commands. If we look below:</p>
<p><img src="simple_commands.gif" border=1 alt="image of command window"></p>
<p>we'll see the result of running a few more commands. Don't worry
too much about knowing the exact rules for making programs yet: the
idea is that we can experiment with Python by typing in commands. If
things don't work, then we can correct the mistake, and try it
again.</p>
<p>If you got to this point, you now know enough to start playing
around with Python! Crack open one of the tutorials from the <a
href="http://python.org/doc/Newbies.html">Python For Beginners</a> web
page, and start exploring with the interpreter. No time limit here. *grin*</p>
<hr><br style="page-break-after: always">
<p>Now that we've paddled long enough, we might be asking: ok, this is
neat, but if we close down Python and start it up again, how do we get
the computer to remember what we typed?</p>
<p>The solution is a little subtle: we can't directly save what's in
the interpreter window, because it will include both our commands and
the system's responses. What we'd like is to make a prepared file,
with just our own commands, and to be able to save that file as a
document. When we're in the mood, we can later open that file and
"run" Python over it, saving us the time of retyping the whole
thing over again.</p>
<p>Let's try this. First, let's start with a clean slate by opening
up a new window.</p>
<p><img src="making_new_window.gif" border=1 alt="image of making new window"></p>
<p>Here's the result of that menu command:</p>
<p><img src="new_window_made.gif" border=1 alt="image of new window"></p>
<p>We notice that there's nothing in this new window. What this means
is that this file is purely for our commands: Python won't interject
with its own responses as we enter the program, that is, not until we
tell it to. This is called an edit window, and it is very similar
to edit windows in other editors such as TextEdit or BBEdit.</p>
<hr><br style="page-break-after: always">
<p>What we wanted to do before was save some of the stuff we had
tried out on the interpreter window. Let's do that by typing (or
copy/pasting) those commands into our edit window.</p>
<p><img src="entering_in_new_window.gif" border=1 alt="image of entering commands"></p>
<p>Ok, we're done with copying and pasting.
One big thing to notice
is that we're careful to get rid of the "<tt>&gt;&gt;&gt;</tt>"
prompts because they're not really part of our program. The
interpreter uses them just to tell us that we're in the interpreter,
but now that we're editing in a separate file, we can remove the
artifacts that the interpreter introduces.
I have added
an extra empty print statement so our output ends with a newline.
</p>
<hr><br style="page-break-after: always">
<p>Let's save the file now. The Save command is located under the <tt>File</tt> menu:</p>
<p><img src="saving_edited_file.gif" border=1 alt="image of saving file"></p>
<hr><br style="page-break-after: always">
<p>Now that we've saved the program, how do we run the program? Use the
Run All button at the top of the editing window, or the equivalent
menu command <tt>Python-&gt;Run Window</tt>. The output will appear in a new
window called Output Window. </p>
<p>By the way, one thing to notice is that I made a typo: I didn't
quite copy exactly what I had entered in the interpreter window
before. Does this affect things?</p>
<p><img src="syntax_error.gif" border=1 alt="image of syntax error"></p>
<p>Ooops. Here is an example of what Python calls a "syntax error".
Python sees that we made a typo, and warns us to take a much closer
look at our program. The designers of Python feel that having the
system point out the error is better than trying to guess at what the
programmer meant. Press the Edit button and you will be brought to
the trouble spot. </p>
<p>Python is often perceptive enough to direct us toward the problem,
and in this case, it's telling us that we forgot to put something at
the end of this line. In this case, we need to add a
quotation mark at the end. Let's add that in now.</p>
<p>Other errors, which usually occur later, when your program has
already done something, result in a different dialog that allows you
to look at variables and such in addition to showing you where
the error occurred. </p>
<hr><br style="page-break-after: always">
<p>Ok, let's say that we fixed that silly typo. Let's try to run the
program again. This gives us a new window, the Output window, showing
the output of our program:</p>
<p><img src="output_window.gif" border=1 alt="image of output window"></p>
<hr><br style="page-break-after: always">
<p>As we play with Python, we'll find ourselves "switching modes"
between the Interpreter window and the edit window. However,
if we try anything more complicated than two or three lines it
is often a good idea to work in an edit window. Align
your edit and output window such that you can see them at the same time.</p>
<p>This is pretty much all we need to know about the MacPython IDE to actually do
interesting things. There is a lot more to the IDE, here is a quick
breakdown of things to see and explore:</p>
<ul>
<li>All sorts of edit commands such as find and replace can be
used in the editor windows. See the <tt>Edit</tt> menu.</li>
<li>The bottom of the edit window has the scrollbar, but at the
left are two navigation devices: a line number box that you can type
numbers into to quickly go to a specific place, and a popup menu
that lists all classes, functions and methods in your file.</li>
<li>Above the vertical scrollbar you find another popup menu, this
influences how the Run command works. You should try the debugger
some time! If you do, and you wonder what the new small column on
the left of your script is: you can click in it to make Python stop
when it reaches this line so you can inspect things. The profiler
is also nifty: it shows you where your program is spending its time.</li>
<li>The module browser (<tt>Python-&gt;Module Browser</tt>) shows you all Python
modules currently loaded. You can look at the contents of the module with
Browse... and (for modules written in Python) at the source with Source...</li>
<li>The Package Manager (under the <tt>File</tt> menu, also available as a
separate application) allows you to easily install Python extension packages
for all sorts of things: scientific computation, image processing,
building user interfaces and more. </li>
<li>The <tt>Help</tt> menu gives you quick access to both the Python documentation,
if you have installed it with the Package Manager, and the Apple Developer
documentation. </li>
<li>The <tt>File-&gt;Save as Applet</tt> menu command saves your script as a MacOSX
application. This allows you to create a script that you can drop files on,
and much more. The IDE itself is such an applet, completely written in Python. </li>
</ul>
</body>
</html>
Mac/Resources/app/Resources/English.lproj/Documentation/index.html deleted 100644 → 0
View file @ cc00a262
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
<html lang="en">
<head>
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1">
<title>MacPython Help</title>
<meta name="generator" content="BBEdit 6.5.3">
<link rel="SHORTCUT ICON" href="pythonsmall.gif">
<META NAME="AppleIcon" CONTENT="pythonsmall.gif">
<META NAME="AppleTitle" CONTENT="MacPython Help">
</head>
<body>
<h1>MacPython Help</h1>
<table>
<tr>
<td>
<img src="python.gif" width="128" height="128" align="top" alt="">
</td>
<td>
<p>Choose a topic, or enter keywords into the search field:</p>
<ul>
<li><a href="intro.html">What is MacPython?</a>
</li>
<li><a href="ide/index.html">MacPython
Integrated Development Environment Introduction</a>
</li>
<li><a href="doc/index.html">Python Language and runtime documentation</a>
</li>
<li><a href="finder.html">Running Python scripts from the Finder</a>
</li>
<li><a href="shell.html">Running Python scripts from the Unix Shell</a>
</li>
<li><a href="gui.html">Creating a User Interface with MacPython</a>
</li>
<li><a href="scripting.html">Controlling other Applications from MacPython</a>
</li>
<li><a href="packman.html">Installing additional functionality with the
Package Manager</a>
</li>
<li><a href="community.html">MacPython community</a>
</li>
</ul>
</td>
</tr>
</table>
<hr>
</body>
</html>
Mac/Resources/app/Resources/English.lproj/Documentation/intro.html deleted 100644 → 0
View file @ cc00a262
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
<html lang="en">
<head>
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1">
<title>What is MacPython?</title>
<meta name="generator" content="BBEdit 6.5.3">
<link rel="SHORTCUT ICON" href="pythonsmall.gif">
<META NAME="AppleIcon" CONTENT="pythonsmall.gif">
</head>
<body>
<h1>What is MacPython?</h1>
<table>
<tr>
<td>
<img src="python.gif" width="128" height="128" align="top" alt="">
</td>
<td>
<p>Python is a programming language. MacPython is a package containing
that programming language plus Mac-specific tools and extensions.</p>
</td>
</tr>
</table>
<hr>
<h2>The Python Language</h2>
<p>The Python programming language is available for many hardware
platforms, and most general documentation is Unix- or Windows-centered. Keep
this in mind when reading the rest of this help, or information on the web.
</p>
<p>The Python website, <a href="http://www.python.org">www.python.org</a>,
has a <em>Beginners Guide</em> section including an
<a href="http://python.org/doc/essays/blurb.html">executive summary</a> on
the language and a
<a href="http://python.org/doc/essays/comparisons.html">comparison</a> of Python
to other languages. Or read the (rather longwinded) Python
Tutorial in the <a href="doc/index.html">Python Language and runtime documentation</a>.</p>
<p>MacPython contains a complete <a href="shell.html">unix interpreter</a> so
if you are familiar with Python on unix you should feel right at home.</p>
<h2>MacPython additions</h2>
<p>The MacPython Integrated Development Environment (IDE) allows
easy editing, running and debugging of scripts. Read the
<a href="ide/index.html">Introduction
to the IDE</a> to whet your appetite.</p>
<p>MacPython comes with lots of modules that allow access to
MacOS-specific technology, such as Carbon, Quicktime and AppleScript.
See the <em>Macintosh
Modules</em> section of the
<a href="doc/index.html">Python Language and runtime documentation</a>,
but please keep in mind that some information there still pertains to
Mac OS 9.
Full access to the Cocoa APIs
and tools such as Interface Builder is available separately through the
<a href="packman.html">Package Manager</a>.</p>
<p>The <a href="packman.html">Package Manager</a> also gives you access to extension
packages for cross-platform GUI development (Tkinter, wxPython, PyOpenGL),
image processing (PIL), scientific
computing (Numeric) and much more. <em>PyObjC</em> deserves a special mention: it allows
transparent access to Cocoa and Interface Builder, similar to what Java provides,
thereby making Python a first class citizen in the Mac OS X developer world. </p>
<p>Python scripts can be saved as <em>applets</em>, semi-standalone applications
that work just like a normal application. Additionally you can even create
true standalone application that have everything embedded and can be
shipped to anyone, without the need to install Python. You do <em>not</em>
need to install the Apple Developer Tools for this. </p>
</body>
</html>
Mac/Resources/app/Resources/English.lproj/Documentation/packman.html deleted 100644 → 0
View file @ cc00a262
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
<html lang="en">
<head>
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1">
<title>Python Package Manager</title>
<meta name="generator" content="BBEdit 6.5.3">
<link rel="SHORTCUT ICON" href="pythonsmall.gif">
<META NAME="AppleIcon" CONTENT="pythonsmall.gif">
</head>
<body>
<h1>Installing additional Python Packages</h1>
<table>
<tr>
<td>
<img src="PackageManager.gif" width="128" height="128" align="top" alt="">
</td>
<td>
<p>The Python Package Manager helps you installing additional
packages that enhance Python. It determines the exact MacOS version
and Python version you have and uses that information to download
a database that has packages that are test and tried on that
combination. In other words: if something is in your Package Manager
window but does not work you are free to blame the database maintainer.</p>
<p>PackageManager then checks which of the packages you have installed
and which ones not. This should also work when you have installed packages
outside of PackageManager.
You can select packages and install them, and PackageManager will work
out the requirements and install these too.</p>
<p>Often PackageManager will list a package in two flavors: binary
and source. Binary should always work, source will only work if
you have installed the Apple Developer Tools. PackageManager will warn
you about this, and also about other external dependencies.</p>
<p>PackageManager is available as a separate application and also
as a function of the IDE, through the <tt>File-&gt;Package Manager</tt> menu
entry. </p>
<h2>Troubleshooting</h2>
<p>If package manager fails to open the database first check that you are
connected to the internet. If you are connected then the problem
could be that there is no database (yet?) for your version of Mac OS X.
You may be able to find an alternative
database that works for your system at
<a href="http://www.python.org/packman">http://www.python.org/packman</a>.
In the standalone Package Manager you can then open such an alternative database
with the <tt>File-&gt;Open URL...</tt> command, but you should realize that
you are now on untested ground.</p>
<p>Another potential problem source is that you are behind a firewall. This version
of PackageManager uses the Unix method of setting a firewall: you need to set the
environment variable <tt>http_proxy</tt> to <tt>"http://<i>proxyhost</i>:<i>port</i>"</tt>.
See <a href="http://developer.apple.com/qa/qa2001/qa1067.html">Apple Technical
Q&amp;A QA1067</a> for instructions.</p>
</td>
</tr>
</table>
<hr>
</body>
</html>
Mac/Resources/app/Resources/English.lproj/Documentation/python.gif deleted 100644 → 0
View file @ cc00a262
This diff was suppressed by a .gitattributes entry.
Mac/Resources/app/Resources/English.lproj/Documentation/scripting.html deleted 100644 → 0
View file @ cc00a262
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
<html lang="en">
<head>
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1">
<title>Controlling other Applications from MacPython</title>
<meta name="generator" content="BBEdit 6.5.3">
<link rel="SHORTCUT ICON" href="pythonsmall.gif">
<META NAME="AppleIcon" CONTENT="pythonsmall.gif">
</head>
<body>
<h1>Controlling other Applications from MacPython</h1>
<p>Python has a fairly complete implementation of the Open Scripting
Architecure (OSA, also commonly referred to as AppleScript), allowing
you to control scriptable applications from your Python program,
and with a fairly pythonic interface. This piece of
Python:</p>
<blockquote><pre><tt>
import Finder
f = Finder.Finder()
print f.get(f.window(1).name)
</tt></pre></blockquote>
<p>is identical to the following piece of AppleScript:</p>
<blockquote><pre><tt>
tell application "Finder"
get name of window 1
end tell
</tt></pre></blockquote>
<p>To send AppleEvents to an application you must first create the Python
modules interfacing to the terminology of the application (what
<tt>Script Editor</tt> calls the "Dictionary"). Use the IDE menu command
<tt>File-&gt;Generate OSA Suite...</tt> for this. For more control run</p>
<blockquote><tt>
pythonw .../Lib/plat-mac/gensuitemodule.py --help
</tt></blockquote>
<p>from a terminal window.</p>
<h2>Creating a scriptable application in Python</h2>
You can also create a scriptable application in Python, but this is not
very well documented. For Carbon
applications you should look at the <tt>MiniAEFrame</tt> module.
</body>
</html>
Mac/Resources/app/Resources/English.lproj/Documentation/shell.html deleted 100644 → 0
View file @ cc00a262
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
<html lang="en">
<head>
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1">
<title>Python and the Unix Shell</title>
<meta name="generator" content="BBEdit 6.5.3">
<link rel="SHORTCUT ICON" href="pythonsmall.gif">
<META NAME="AppleIcon" CONTENT="pythonsmall.gif">
</head>
<body>
<h1>Running Python scripts from the Unix Shell</h1>
<table>
<tr>
<td>
<img src="python.gif" width="128" height="128" align="top" alt="">
</td>
<td>
<p>MacPython 2.3 installs a perfectly normal Unix commandline
python interpreter in <tt>/usr/local/bin/python</tt>. As of Mac OS X 10.2, however,
<tt>/usr/local/bin</tt> is not on the search path of your shell. Moreover,
Apple's python 2.2, which lives in <tt>/usr/bin</tt> <em>is</em> on your
search path, so this can lead to confusion.</p>
<p>If you use <tt>tcsh</tt> you should add the following line
to the file <tt>.login</tt> in your home directory and restart Terminal:
<br>
<tt>setenv PATH /usr/local/bin:$PATH</tt>
</p>
<p>If you use <tt>bash</tt> or <tt>zsh</tt>
you should add the following line
to the file <tt>.profile</tt> in your home directory and restart Terminal:
<br>
<tt>export PATH=/usr/local/bin:$PATH</tt>
</p>
<h2>GUI scripts</h2>
<p>Due to the way MacOS handles windowing applications you need to run
<em>all</em> scripts that use the window manager (be it through
Carbon, Cocoa, Tkinter, wxPython, PyOpenGL or anything else) with the
<tt>pythonw</tt> interpreter, also installed in <tt>/usr/local/bin</tt>.</p>
<p>Running with <tt>python</tt> results in an inability to bring the
script to the front, or interacting with it. </p>
</td>
</tr>
</table>
<hr>
</body>
</html>
Mac/Tools/Doc/HelpIndexingTool/Help_Indexing_Tool_Suite.py deleted 100644 → 0
View file @ cc00a262
"""Suite Help Indexing Tool Suite: Special events that just the Help Indexing Tool supports.
Level 0, version 0
Generated from /Developer/Applications/Apple Help Indexing Tool.app
AETE/AEUT resource version 1/1, language 0, script 0
"""
import aetools
import MacOS
_code = 'HIT '
class Help_Indexing_Tool_Suite_Events:
def turn_anchor_indexing(self, _object, _attributes={}, **_arguments):
"""turn anchor indexing: Turns anchor indexing on or off.
Required argument: \xd2on\xd3 or \xd2off\xd3, to turn anchor indexing on or off
Keyword argument _attributes: AppleEvent attribute dictionary
"""
_code = 'HIT '
_subcode = 'tAnc'
if _arguments: raise TypeError, 'No optional args expected'
_arguments['----'] = _object
_reply, _arguments, _attributes = self.send(_code, _subcode,
_arguments, _attributes)
if _arguments.get('errn', 0):
raise aetools.Error, aetools.decodeerror(_arguments)
# XXXX Optionally decode result
if _arguments.has_key('----'):
return _arguments['----']
_argmap_turn_remote_root = {
'with_root_url' : 'rURL',
}
def turn_remote_root(self, _object, _attributes={}, **_arguments):
"""turn remote root: Turn usage of remote root for content on the web on or off. If turning \xd2on\xd3, supply a string as second parameter.
Required argument: \xd2on\xd3 or \xd2off\xd3, to turn remote root on or off
Keyword argument with_root_url: The remote root to use, in the form of \xd2http://www.apple.com/help/\xd3.
Keyword argument _attributes: AppleEvent attribute dictionary
"""
_code = 'HIT '
_subcode = 'tRem'
aetools.keysubst(_arguments, self._argmap_turn_remote_root)
_arguments['----'] = _object
_reply, _arguments, _attributes = self.send(_code, _subcode,
_arguments, _attributes)
if _arguments.get('errn', 0):
raise aetools.Error, aetools.decodeerror(_arguments)
# XXXX Optionally decode result
if _arguments.has_key('----'):
return _arguments['----']
def use_tokenizer(self, _object, _attributes={}, **_arguments):
"""use tokenizer: Tells the indexing tool which tokenizer to use.
Required argument: Specify \xd2English\xd3, \xd2European\xd3, \xd2Japanese\xd3, \xd2Korean\xd3, or \xd2Simple\xd3.
Keyword argument _attributes: AppleEvent attribute dictionary
"""
_code = 'HIT '
_subcode = 'uTok'
if _arguments: raise TypeError, 'No optional args expected'
_arguments['----'] = _object
_reply, _arguments, _attributes = self.send(_code, _subcode,
_arguments, _attributes)
if _arguments.get('errn', 0):
raise aetools.Error, aetools.decodeerror(_arguments)
# XXXX Optionally decode result
if _arguments.has_key('----'):
return _arguments['----']
class application(aetools.ComponentItem):
"""application - Application class """
want = 'capp'
class _Prop_idleStatus(aetools.NProperty):
"""idleStatus - """
which = 'sIdl'
want = 'bool'
application._superclassnames = []
application._privpropdict = {
'idleStatus' : _Prop_idleStatus,
}
application._privelemdict = {
}
#
# Indices of types declared in this module
#
_classdeclarations = {
'capp' : application,
}
_propdeclarations = {
'sIdl' : _Prop_idleStatus,
}
_compdeclarations = {
}
_enumdeclarations = {
}
Mac/Tools/Doc/HelpIndexingTool/Miscellaneous_Standards.py deleted 100644 → 0
View file @ cc00a262
"""Suite Miscellaneous Standards: Useful events that aren\xd5t in any other suite
Level 0, version 0
Generated from /Developer/Applications/Apple Help Indexing Tool.app
AETE/AEUT resource version 1/1, language 0, script 0
"""
import aetools
import MacOS
_code = 'misc'
class Miscellaneous_Standards_Events:
def revert(self, _object, _attributes={}, **_arguments):
"""revert: Revert an object to the most recently saved version
Required argument: object to revert
Keyword argument _attributes: AppleEvent attribute dictionary
"""
_code = 'misc'
_subcode = 'rvrt'
if _arguments: raise TypeError, 'No optional args expected'
_arguments['----'] = _object
_reply, _arguments, _attributes = self.send(_code, _subcode,
_arguments, _attributes)
if _arguments.get('errn', 0):
raise aetools.Error, aetools.decodeerror(_arguments)
# XXXX Optionally decode result
if _arguments.has_key('----'):
return _arguments['----']
#
# Indices of types declared in this module
#
_classdeclarations = {
}
_propdeclarations = {
}
_compdeclarations = {
}
_enumdeclarations = {
}
Mac/Tools/Doc/HelpIndexingTool/Required_Suite.py deleted 100644 → 0
View file @ cc00a262
"""Suite Required Suite: Terms that every application should support
Level 1, version 1
Generated from /Developer/Applications/Apple Help Indexing Tool.app
AETE/AEUT resource version 1/1, language 0, script 0
"""
import aetools
import MacOS
_code = 'reqd'
from StdSuites.Required_Suite import *
class Required_Suite_Events(Required_Suite_Events):
pass
#
# Indices of types declared in this module
#
_classdeclarations = {
}
_propdeclarations = {
}
_compdeclarations = {
}
_enumdeclarations = {
}
Mac/Tools/Doc/HelpIndexingTool/Standard_Suite.py deleted 100644 → 0
View file @ cc00a262
This diff is collapsed.
Mac/Tools/Doc/HelpIndexingTool/__init__.py deleted 100644 → 0
View file @ cc00a262
"""
Package generated from /Developer/Applications/Apple Help Indexing Tool.app
"""
import aetools
Error = aetools.Error
import Standard_Suite
import Help_Indexing_Tool_Suite
import odds_and_ends
import Miscellaneous_Standards
import Required_Suite
_code_to_module = {
'CoRe' : Standard_Suite,
'HIT ' : Help_Indexing_Tool_Suite,
'Odds' : odds_and_ends,
'misc' : Miscellaneous_Standards,
'reqd' : Required_Suite,
}
_code_to_fullname = {
'CoRe' : ('HelpIndexingTool.Standard_Suite', 'Standard_Suite'),
'HIT ' : ('HelpIndexingTool.Help_Indexing_Tool_Suite', 'Help_Indexing_Tool_Suite'),
'Odds' : ('HelpIndexingTool.odds_and_ends', 'odds_and_ends'),
'misc' : ('HelpIndexingTool.Miscellaneous_Standards', 'Miscellaneous_Standards'),
'reqd' : ('HelpIndexingTool.Required_Suite', 'Required_Suite'),
}
from Standard_Suite import *
from Help_Indexing_Tool_Suite import *
from odds_and_ends import *
from Miscellaneous_Standards import *
from Required_Suite import *
def getbaseclasses(v):
if not getattr(v, '_propdict', None):
v._propdict = {}
v._elemdict = {}
for superclassname in getattr(v, '_superclassnames', []):
superclass = eval(superclassname)
getbaseclasses(superclass)
v._propdict.update(getattr(superclass, '_propdict', {}))
v._elemdict.update(getattr(superclass, '_elemdict', {}))
v._propdict.update(getattr(v, '_privpropdict', {}))
v._elemdict.update(getattr(v, '_privelemdict', {}))
import StdSuites
#
# Set property and element dictionaries now that all classes have been defined
#
getbaseclasses(window)
getbaseclasses(application)
getbaseclasses(document)
getbaseclasses(application)
#
# Indices of types declared in this module
#
_classdeclarations = {
'cwin' : window,
'capp' : application,
'docu' : document,
'capp' : application,
}
class HelpIndexingTool(Standard_Suite_Events,
Help_Indexing_Tool_Suite_Events,
odds_and_ends_Events,
Miscellaneous_Standards_Events,
Required_Suite_Events,
aetools.TalkTo):
_signature = 'hiti'
_moduleName = 'HelpIndexingTool'
Mac/Tools/Doc/HelpIndexingTool/odds_and_ends.py deleted 100644 → 0
View file @ cc00a262
"""Suite odds and ends: Things that should be in some standard suite, but aren\xd5t
Level 1, version 1
Generated from /Developer/Applications/Apple Help Indexing Tool.app
AETE/AEUT resource version 1/1, language 0, script 0
"""
import aetools
import MacOS
_code = 'Odds'
class odds_and_ends_Events:
def select(self, _object=None, _attributes={}, **_arguments):
"""select: Select the specified object
Required argument: the object to select
Keyword argument _attributes: AppleEvent attribute dictionary
"""
_code = 'misc'
_subcode = 'slct'
if _arguments: raise TypeError, 'No optional args expected'
_arguments['----'] = _object
_reply, _arguments, _attributes = self.send(_code, _subcode,
_arguments, _attributes)
if _arguments.get('errn', 0):
raise aetools.Error, aetools.decodeerror(_arguments)
# XXXX Optionally decode result
if _arguments.has_key('----'):
return _arguments['----']
#
# Indices of types declared in this module
#
_classdeclarations = {
}
_propdeclarations = {
}
_compdeclarations = {
}
_enumdeclarations = {
}
Mac/Tools/Doc/README deleted 100644 → 0
View file @ cc00a262
In this directory you can build the Python documentation in a form that
is suitable for access with Apple Help Viewer. This will enable the
"Python Documentation" menu entries in the MacPython IDE Help menu.
Unfortunately the procedure to build the docs is not very streamlined.
First, edit setup.py. At the top, edit MAJOR_VERSION and MINOR_VERSION,
and check that DESTDIR makes sense. The documentation will be installed
inside PythonIDE.app.
In DocBuild.initialize_options, set self.download to True if you want to
download the docs. Set it to False if you want to build the docs from
the source tree, but this requires LaTex and lots of other stuff.
Doable, but not easy.
Second, if you want to download the docs you may need to do a couple
more edits. The way the docs are packaged will often change between
major releases. Fiddle DocBuild.downloadDocs to make it do the right
thing (download the docs from python.org, unpack them, rename the
directory to "build/html").
After these edits you should be ready to roll. "pythonw setup.py build"
should download and unpack (or build) the docs. Next, it will do some
magic to make the docs indexable. Finally, it will run the Apple Help
Indexing Tool. (This last step is the reason you must use "pythonw" as
opposed to "python"). Usually it will time out while waiting for AHIT to
do its work. Wait until AHIT is done.
Now you're ready to install with "python setup.py install".
After this is done test your work. Fire up PythonIDE, and check that
Help->Python Documentation brings up the documentation in the Help Viewer.
Also open an IDE edit window, type something like "import sys", select
"import", and use Help->Lookup in Python Documentation to check that the
index has been generated correctly.
Mac/Tools/Doc/setup.py deleted 100644 → 0
View file @ cc00a262
# Build and install an Apple Help Viewer compatible version of the Python
# documentation into the framework.
# Code by Bill Fancher, with some modifications by Jack Jansen.
#
# You must run this as a two-step process
# 1. python setupDocs.py build
# 2. Wait for Apple Help Indexing Tool to finish
# 3. python setupDocs.py install
#
# To do:
# - test whether the docs are available locally before downloading
# - fix buildDocsFromSource
# - Get documentation version from sys.version, fallback to 2.2.1
# - See if we can somehow detect that Apple Help Indexing Tool is finished
# - data_files to setup() doesn't seem the right way to pass the arguments
#
import sys, os, re
from distutils.cmd import Command
from distutils.command.build import build
from distutils.core import setup
from distutils.file_util import copy_file
from distutils.dir_util import copy_tree
from distutils.log import log
from distutils.spawn import spawn
from distutils import sysconfig, dep_util
from distutils.util import change_root
import HelpIndexingTool
import Carbon.File
import time
MAJOR_VERSION='2.4'
MINOR_VERSION='2.4.1'
DESTDIR='/Applications/MacPython-%s/PythonIDE.app/Contents/Resources/English.lproj/PythonDocumentation' % MAJOR_VERSION
class DocBuild(build):
def initialize_options(self):
build.initialize_options(self)
self.build_html = None
self.build_dest = None
self.download = 1
self.doc_version = MINOR_VERSION # Only needed if download is true
def finalize_options(self):
build.finalize_options(self)
if self.build_html is None:
self.build_html = os.path.join(self.build_base, 'html')
if self.build_dest is None:
self.build_dest = os.path.join(self.build_base, 'PythonDocumentation')
def spawn(self, *args):
spawn(args, 1, self.verbose, self.dry_run)
def downloadDocs(self):
workdir = os.getcwd()
# XXX Note: the next strings may change from version to version
url = 'http://www.python.org/ftp/python/doc/%s/html-%s.tar.bz2' % \
(self.doc_version,self.doc_version)
tarfile = 'html-%s.tar.bz2' % self.doc_version
dirname = 'Python-Docs-%s' % self.doc_version
if os.path.exists(self.build_html):
raise RuntimeError, '%s: already exists, please remove and try again' % self.build_html
os.chdir(self.build_base)
self.spawn('curl','-O', url)
self.spawn('tar', '-xjf', tarfile)
os.rename(dirname, 'html')
os.chdir(workdir)
## print "** Please unpack %s" % os.path.join(self.build_base, tarfile)
## print "** Unpack the files into %s" % self.build_html
## raise RuntimeError, "You need to unpack the docs manually"
def buildDocsFromSource(self):
srcdir = '../../..'
docdir = os.path.join(srcdir, 'Doc')
htmldir = os.path.join(docdir, 'html')
spawn(('make','--directory', docdir, 'html'), 1, self.verbose, self.dry_run)
self.mkpath(self.build_html)
copy_tree(htmldir, self.build_html)
def ensureHtml(self):
if not os.path.exists(self.build_html):
if self.download:
self.downloadDocs()
else:
self.buildDocsFromSource()
def hackIndex(self):
ind_html = 'index.html'
#print 'self.build_dest =', self.build_dest
hackedIndex = file(os.path.join(self.build_dest, ind_html),'w')
origIndex = file(os.path.join(self.build_html,ind_html))
r = re.compile('<style type="text/css">.*</style>', re.DOTALL)
hackedIndex.write(r.sub('<META NAME="AppleTitle" CONTENT="Python Documentation">',origIndex.read()))
def hackFile(self,d,f):
origPath = os.path.join(d,f)
assert(origPath[:len(self.build_html)] == self.build_html)
outPath = os.path.join(self.build_dest, d[len(self.build_html)+1:], f)
(name, ext) = os.path.splitext(f)
if os.path.isdir(origPath):
self.mkpath(outPath)
elif ext == '.html':
if self.verbose: print 'hacking %s to %s' % (origPath,outPath)
hackedFile = file(outPath, 'w')
origFile = file(origPath,'r')
hackedFile.write(self.r.sub('<dl><dt><dd>', origFile.read()))
else:
copy_file(origPath, outPath)
def hackHtml(self):
self.r = re.compile('<dl><dd>')
os.path.walk(self.build_html, self.visit, None)
def visit(self, dummy, dirname, filenames):
for f in filenames:
self.hackFile(dirname, f)
def makeHelpIndex(self):
app = '/Developer/Applications/Apple Help Indexing Tool.app'
self.spawn('open', '-a', app , self.build_dest)
print "Please wait until Apple Help Indexing Tool finishes before installing"
def makeHelpIndex(self):
app = HelpIndexingTool.HelpIndexingTool(start=1)
app.open(Carbon.File.FSSpec(self.build_dest))
sys.stderr.write("Waiting for Help Indexing Tool to start...")
while 1:
# This is bad design in the suite generation code!
idle = app._get(HelpIndexingTool.Help_Indexing_Tool_Suite._Prop_idleStatus())
time.sleep(10)
if not idle: break
sys.stderr.write(".")
sys.stderr.write("\n")
sys.stderr.write("Waiting for Help Indexing Tool to finish...")
while 1:
# This is bad design in the suite generation code!
idle = app._get(HelpIndexingTool.Help_Indexing_Tool_Suite._Prop_idleStatus())
time.sleep(10)
if idle: break
sys.stderr.write(".")
sys.stderr.write("\n")
def run(self):
self.ensure_finalized()
self.mkpath(self.build_base)
self.ensureHtml()
if not os.path.isdir(self.build_html):
raise RuntimeError, \
"Can't find source folder for documentation."
self.mkpath(self.build_dest)
if dep_util.newer(os.path.join(self.build_html,'index.html'), os.path.join(self.build_dest,'index.html')):
self.mkpath(self.build_dest)
self.hackHtml()
self.hackIndex()
self.makeHelpIndex()
class AHVDocInstall(Command):
description = "install Apple Help Viewer html files"
user_options = [('install-doc=', 'd',
'directory to install HTML tree'),
('root=', None,
"install everything relative to this alternate root directory"),
]
def initialize_options(self):
self.build_dest = None
self.install_doc = None
self.prefix = None
self.root = None
def finalize_options(self):
self.set_undefined_options('install',
('prefix', 'prefix'),
('root', 'root'))
# import pdb ; pdb.set_trace()
build_cmd = self.get_finalized_command('build')
if self.build_dest is None:
build_cmd = self.get_finalized_command('build')
self.build_dest = build_cmd.build_dest
if self.install_doc is None:
self.install_doc = os.path.join(self.prefix, DESTDIR)
print 'INSTALL', self.build_dest, '->', self.install_doc
def run(self):
self.finalize_options()
self.ensure_finalized()
print "Running Installer"
instloc = self.install_doc
if self.root:
instloc = change_root(self.root, instloc)
self.mkpath(instloc)
copy_tree(self.build_dest, instloc)
print "Installation complete"
def mungeVersion(infile, outfile):
i = file(infile,'r')
o = file(outfile,'w')
o.write(re.sub('\$\(VERSION\)',sysconfig.get_config_var('VERSION'),i.read()))
i.close()
o.close()
def main():
# turn off warnings when deprecated modules are imported
## import warnings
## warnings.filterwarnings("ignore",category=DeprecationWarning)
setup(name = 'Documentation',
version = '%d.%d' % sys.version_info[:2],
cmdclass = {'install_data':AHVDocInstall, 'build':DocBuild},
data_files = ['dummy'],
)
if __name__ == '__main__':
main()
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment
GitLab Nexedi Edition | About GitLab | About Nexedi | 沪ICP备2021021310号-2 | 沪ICP备2021021310号-7