Mac/Modules/help/helpsupport.py

   1 # This script generates a Python interface for an Apple Macintosh Manager.
   2 # It uses the "bgen" package to generate C code.
   3 # The function specifications are generated by scanning the mamager's header file,
   4 # using the "scantools" package (customized for this particular manager).
   5
   6 import string
   7
   8 # Declarations that change for each manager
   9 MACHEADERFILE = 'Balloons.h'            # The Apple header file
  10 MODNAME = 'Help'                                # The name of the module
  11 OBJECTNAME = 'UNUSED'                   # The basic name of the objects used here
  12 KIND = 'Record'                         # Usually 'Ptr' or 'Handle'
  13
  14 # The following is *usually* unchanged but may still require tuning
  15 MODPREFIX = MODNAME                     # The prefix for module-wide routines
  16 OBJECTTYPE = OBJECTNAME + KIND          # The C type used to represent them
  17 OBJECTPREFIX = MODPREFIX + 'Obj'        # The prefix for object methods
  18 INPUTFILE = string.lower(MODPREFIX) + 'gen.py' # The file generated by the scanner
  19 OUTPUTFILE = MODNAME + "module.c"       # The file generated by this program
  20
  21 from macsupport import *
  22
  23 # Create the type objects
  24 MenuRef = OpaqueByValueType("MenuRef", "MenuObj")
  25
  26
  27 #WindowPeek = OpaqueByValueType("WindowPeek", OBJECTPREFIX)
  28
  29 RgnHandle = FakeType("(RgnHandle)0")
  30 # XXXX Should be next, but this will break a lot of code...
  31 # RgnHandle = OpaqueByValueType("RgnHandle", "OptResObj")
  32
  33 KeyMap = ArrayOutputBufferType("KeyMap")
  34 ##MacOSEventKind = Type("MacOSEventKind", "h") # Old-style
  35 ##MacOSEventMask = Type("MacOSEventMask", "h") # Old-style
  36 EventMask = Type("EventMask", "H")
  37 EventKind = Type("EventKind", "H")
  38
  39 includestuff = includestuff + """
  40 #include <%s>""" % MACHEADERFILE + """
  41 """
  42
  43 class MyObjectDefinition(GlobalObjectDefinition):
  44         def outputCheckNewArg(self):
  45                 Output("if (itself == NULL) return PyMac_Error(resNotFound);")
  46         def outputCheckConvertArg(self):
  47                 OutLbrace("if (DlgObj_Check(v))")
  48                 Output("*p_itself = ((WindowObject *)v)->ob_itself;")
  49                 Output("return 1;")
  50                 OutRbrace()
  51                 Out("""
  52                 if (v == Py_None) { *p_itself = NULL; return 1; }
  53                 if (PyInt_Check(v)) { *p_itself = (WindowPtr)PyInt_AsLong(v); return 1; }
  54                 """)
  55
  56 # From here on it's basically all boiler plate...
  57
  58 # Create the generator groups and link them
  59 module = MacModule(MODNAME, MODPREFIX, includestuff, finalstuff, initstuff)
  60 ##object = MyObjectDefinition(OBJECTNAME, OBJECTPREFIX, OBJECTTYPE)
  61 ##module.addobject(object)
  62
  63 # Create the generator classes used to populate the lists
  64 Function = OSErrFunctionGenerator
  65 ##Method = OSErrMethodGenerator
  66
  67 # Create and populate the lists
  68 functions = []
  69 ##methods = []
  70 execfile(INPUTFILE)
  71
  72 # add the populated lists to the generator groups
  73 # (in a different wordl the scan program would generate this)
  74 for f in functions: module.add(f)
  75 ##for f in methods: object.add(f)
  76
  77 # generate output (open the output file as late as possible)
  78 SetOutputFileName(OUTPUTFILE)
  79 module.generate()
  80