diff --git a/Mac/Demo/plugins.html b/Mac/Demo/plugins.html index 368f50be529..a49da68b179 100644 --- a/Mac/Demo/plugins.html +++ b/Mac/Demo/plugins.html @@ -7,28 +7,25 @@

Creating a C extension module on the Macintosh

extension module on the mac. For this example, we will create a module to interface to the programmers' API of InterSLIP, a package that allows you to use MacTCP (and, hence, all internet services) over a -modem connection.

+modem connection. The actual example does not work anymore, as both +MacTCP and Interslip died long ago, but the text is still mostly +correct.

Prerequisites

There are a few things you need to pull this off. First and foremost, you need a C development environment. Actually, you need a specific development environment, CodeWarrior by MetroWerks. You will probably -need the latest version. You may be able to get by with an older +HREF="http://www.metrowerks.com/">MetroWerks. You will +need Version 7 or later. You may be able to get by with an older version of CodeWarrior or with another development environment (Up to about 1994 python was developed with THINK C, and in the dim past it was compiled with MPW C) assuming you have managed to get Python to compile under your development environment, but the step-by-step character of this document will be lost.

-Next, you need a python source -distribution. For PowerPC and cfm68k development you can actually -get by without a full source distribution, using the Development -distribution. You'll also need a functional python interpreter, and -the Modulator program (which lives in Tools:Modulator in -the standard source distribution). You may also find that Guido's Extending and embedding the Python interpreter is a very handy piece of documentation. I will skip lots of details that are handled there, like complete @@ -155,70 +152,36 @@

Using Modulator without Tk

all the methods. It is, of course, not yet complete in a functional way...

-

Adding a module to Classic 68K Python

- -What you do now depends on whether you're developing for PowerPC (or -for CFM68K) or for "traditional" mac. For a traditional 68K Python, -you will have to add your new module to the project file of the Python -interpreter, and you have to edit "config.c" to add the module to the -set of builtin modules. In config.c you will add the module at two -places: near the start of the file there is a list of external -declarations for all init() routines. Add a line of the form -
-		extern void initinterslip();
-
 -here. Further down the file there is an array that is initialized with -modulename/initfunction pairs. Add a line of the form -
-		{"interslip",	initinterslip},
-
 -here. You may want to bracket these two lines with -
-	#ifdef USE_INTERSLIP
-	#endif
-
 -lines, that way you can easily control whether the module is -incorporated into python at compile time. If you decide to do the -latter edit your config file (you can find the name in the "C/C++ -language" section of the MW preferences dialog, it will probably be -"mwerks_nonshared_config.h") and add a -
-	#define USE_INTERSLIP
-
 - -Make the new interpreter and check that you can import the module, see -the methods (with "dir(interslip)") and call them.

-

Creating a plugin module

-For PowerPC or cfm68k development you could follow the same path, but it is -actually a better idea to use a dynamically loadable module. The -advantage of dynamically loadable modules is that they are not loaded -until a python program actually uses them (resulting in less memory -usage by the interpreter) and that development is a lot simpler (since -your projects will all be smaller). Moreover, you can distribute a -plugin module by itself without haveing to distribute a complete -python interpreter.

+The easiest way to build a plugin module is to use the distutils package, +this works fine on MacOS with CodeWarrior. See the distutils documentation +for details. Keep in mind that even though you are on the Mac you specify +filenames with Unix syntax: they are actually URLs, not filenames. +

-Go to the "PlugIns" folder and copy the files xx.prj, -and xx.prj.exp to interslipmodule.prj and -interslipmodule.prj.exp, respectively. Edit -interslipmodule.prj.exp and change the name of the exported routine -"initxx" to "initinterslip". Open interslipmodule.prj with CodeWarrior, +Alternatively you can build the project file by hand. +Go to the ":Mac:Build" folder and copy the files xx.carbon.mcp, +and xx.carbon.mcp.exp to interslipmodule.carbon.mcp and +interslipmodule.carbon.mcp.exp, respectively. Edit +interslipmodule.carbon.mcp.exp and change the name of the exported routine +"initxx" to "initinterslip". Open interslipmodule.carbon.mcp with CodeWarrior, remove the file xxmodule.c and add interslipmodule.c and make a number of adjustments to the preferences:

-Next, compile and link your module, fire up python and do the same -tests as for 68K python.

+Next, compile and link your module, fire up python and test it.

Getting the module to do real work