mirror of https://github.com/python/cpython.git
a4007eb816 | ||
---|---|---|
.. | ||
bgen | ||
README |
README
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