mirror of https://github.com/python/cpython
80 lines
2.1 KiB
Plaintext
80 lines
2.1 KiB
Plaintext
|
BGEN -- An Experiment: Automatic Generation of Extension Modules
|
||
|
|
================================================================
|
||
|
|
|
||
|
|
This directory contains BGEN -- a package that helps in generating
|
||
|
|
complete source code for Python extension module. It currently also
|
||
|
|
contains a set of examples that were generated with BGEN. These
|
||
|
|
examples are mostly interfaces to a number of important managers in
|
||
|
|
the Macintosh toolbox.
|
||
|
|
|
||
|
|
|
||
|
|
Overview of Subdirectories
|
||
|
|
--------------------------
|
||
|
|
|
||
|
|
Main subdirectories:
|
||
|
|
|
||
|
|
bgen the code generator package
|
||
|
|
|
||
|
|
Example subdirectories:
|
||
|
|
|
||
|
|
ae AppleEvents
|
||
|
|
ctl Controls
|
||
|
|
dlg Dialogs
|
||
|
|
evt Events
|
||
|
|
menu Menus
|
||
|
|
qd QuickDraw
|
||
|
|
res Resources
|
||
|
|
snd Sound
|
||
|
|
win Windows
|
||
|
|
|
||
|
|
|
||
|
|
Contents of Subdirectories
|
||
|
|
--------------------------
|
||
|
|
|
||
|
|
The contents of each example subdirectory is similar (<Foobar> is
|
||
|
|
for instance AppleEvents, while <foo> is ae):
|
||
|
|
|
||
|
|
<foo>scan.py Scan the <Foobar>.h header, generating <foo>gen.py
|
||
|
|
<foo>gen.py Output of <foo>scan.py, input for <foo>support.py
|
||
|
|
<foo>edit.py Manually written complement of <foo>gen.py, sometimes
|
||
|
|
<foo>support.py Generate <Foo>module.c from <foo>gen.py and <foo>edit.py
|
||
|
|
<Foo>module.c The interface module, ready to be compiled
|
||
|
|
<Foobar>.py Symbolic constants extracted from <Foobar.h>
|
||
|
|
|
||
|
|
|
||
|
|
Tests and Examples
|
||
|
|
------------------
|
||
|
|
|
||
|
|
Other files in these subdirectories are usually examples using the
|
||
|
|
extension. If there's a file t<foo>.py, it usually is a really
|
||
|
|
boring test program.
|
||
|
|
|
||
|
|
Some test programs contain pathnames that should be edited before
|
||
|
|
trying them.
|
||
|
|
|
||
|
|
Some of the less boring tests and examples:
|
||
|
|
|
||
|
|
At the top level:
|
||
|
|
|
||
|
|
test.py Application mainloop, uses most Mac extensions
|
||
|
|
|
||
|
|
In ae:
|
||
|
|
|
||
|
|
aetools.py Conversions between AE and Python data type
|
||
|
|
echo.py Dummy AE server, echoes all data back
|
||
|
|
tell.py Primitive AE client
|
||
|
|
aete.py Decode 'aete' and 'aeut' resources (incomplete)
|
||
|
|
|
||
|
|
In res:
|
||
|
|
|
||
|
|
listres.py List *all* resources in current and in all res files
|
||
|
|
copyres.py Copy a resource file
|
||
|
|
mkerrstrres.py Read "errors.txt" and create a set of "Estr" resources
|
||
|
|
|
||
|
|
In snd:
|
||
|
|
|
||
|
|
playaiff.py Play an AIFF file
|
||
|
|
morse.py Turn text into Morse code
|
||
|
|
audiodev.py The standard audiodev.py extended with Mac support
|
||
|
|
Audio_mac.py The Mac support for audiodev.py
|