Home | History | Annotate | Download | only in python
      1 #!/usr/bin/python -u
      2 #
      3 # generate python wrappers from the XML API description
      4 #
      5 
      6 functions = {}
      7 enums = {} # { enumType: { enumConstant: enumValue } }
      8 
      9 import os
     10 import sys
     11 import string
     12 
     13 if __name__ == "__main__":
     14     # launched as a script
     15     srcPref = os.path.dirname(sys.argv[0])
     16 else:
     17     # imported
     18     srcPref = os.path.dirname(__file__)
     19 
     20 #######################################################################
     21 #
     22 #  That part if purely the API acquisition phase from the
     23 #  XML API description
     24 #
     25 #######################################################################
     26 import os
     27 import xml.sax
     28 
     29 debug = 0
     30 
     31 def getparser():
     32     # Attach parser to an unmarshalling object. return both objects.
     33     target = docParser()
     34     parser = xml.sax.make_parser()
     35     parser.setContentHandler(target)
     36     return parser, target
     37 
     38 class docParser(xml.sax.handler.ContentHandler):
     39     def __init__(self):
     40         self._methodname = None
     41         self._data = []
     42         self.in_function = 0
     43 
     44         self.startElement = self.start
     45         self.endElement = self.end
     46         self.characters = self.data
     47 
     48     def close(self):
     49         if debug:
     50             print("close")
     51 
     52     def getmethodname(self):
     53         return self._methodname
     54 
     55     def data(self, text):
     56         if debug:
     57             print("data %s" % text)
     58         self._data.append(text)
     59 
     60     def start(self, tag, attrs):
     61         if debug:
     62             print("start %s, %s" % (tag, attrs))
     63         if tag == 'function':
     64             self._data = []
     65             self.in_function = 1
     66             self.function = None
     67             self.function_cond = None
     68             self.function_args = []
     69             self.function_descr = None
     70             self.function_return = None
     71             self.function_file = None
     72             if 'name' in attrs.keys():
     73                 self.function = attrs['name']
     74             if 'file' in attrs.keys():
     75                 self.function_file = attrs['file']
     76         elif tag == 'cond':
     77             self._data = []
     78         elif tag == 'info':
     79             self._data = []
     80         elif tag == 'arg':
     81             if self.in_function == 1:
     82                 self.function_arg_name = None
     83                 self.function_arg_type = None
     84                 self.function_arg_info = None
     85                 if 'name' in attrs.keys():
     86                     self.function_arg_name = attrs['name']
     87                 if 'type' in attrs.keys():
     88                     self.function_arg_type = attrs['type']
     89                 if 'info' in attrs.keys():
     90                     self.function_arg_info = attrs['info']
     91         elif tag == 'return':
     92             if self.in_function == 1:
     93                 self.function_return_type = None
     94                 self.function_return_info = None
     95                 self.function_return_field = None
     96                 if 'type' in attrs.keys():
     97                     self.function_return_type = attrs['type']
     98                 if 'info' in attrs.keys():
     99                     self.function_return_info = attrs['info']
    100                 if 'field' in attrs.keys():
    101                     self.function_return_field = attrs['field']
    102         elif tag == 'enum':
    103             enum(attrs['type'],attrs['name'],attrs['value'])
    104 
    105     def end(self, tag):
    106         if debug:
    107             print("end %s" % tag)
    108         if tag == 'function':
    109             if self.function != None:
    110                 function(self.function, self.function_descr,
    111                          self.function_return, self.function_args,
    112                          self.function_file, self.function_cond)
    113                 self.in_function = 0
    114         elif tag == 'arg':
    115             if self.in_function == 1:
    116                 self.function_args.append([self.function_arg_name,
    117                                            self.function_arg_type,
    118                                            self.function_arg_info])
    119         elif tag == 'return':
    120             if self.in_function == 1:
    121                 self.function_return = [self.function_return_type,
    122                                         self.function_return_info,
    123                                         self.function_return_field]
    124         elif tag == 'info':
    125             str = ''
    126             for c in self._data:
    127                 str = str + c
    128             if self.in_function == 1:
    129                 self.function_descr = str
    130         elif tag == 'cond':
    131             str = ''
    132             for c in self._data:
    133                 str = str + c
    134             if self.in_function == 1:
    135                 self.function_cond = str
    136 
    137 
    138 def function(name, desc, ret, args, file, cond):
    139     functions[name] = (desc, ret, args, file, cond)
    140 
    141 def enum(type, name, value):
    142     if type not in enums:
    143         enums[type] = {}
    144     enums[type][name] = value
    145 
    146 #######################################################################
    147 #
    148 #  Some filtering rukes to drop functions/types which should not
    149 #  be exposed as-is on the Python interface
    150 #
    151 #######################################################################
    152 
    153 skipped_modules = {
    154     'xmlmemory': None,
    155     'DOCBparser': None,
    156     'SAX': None,
    157     'hash': None,
    158     'list': None,
    159     'threads': None,
    160 #    'xpointer': None,
    161 }
    162 skipped_types = {
    163     'int *': "usually a return type",
    164     'xmlSAXHandlerPtr': "not the proper interface for SAX",
    165     'htmlSAXHandlerPtr': "not the proper interface for SAX",
    166     'xmlRMutexPtr': "thread specific, skipped",
    167     'xmlMutexPtr': "thread specific, skipped",
    168     'xmlGlobalStatePtr': "thread specific, skipped",
    169     'xmlListPtr': "internal representation not suitable for python",
    170     'xmlBufferPtr': "internal representation not suitable for python",
    171     'FILE *': None,
    172 }
    173 
    174 #######################################################################
    175 #
    176 #  Table of remapping to/from the python type or class to the C
    177 #  counterpart.
    178 #
    179 #######################################################################
    180 
    181 py_types = {
    182     'void': (None, None, None, None),
    183     'int':  ('i', None, "int", "int"),
    184     'long':  ('l', None, "long", "long"),
    185     'double':  ('d', None, "double", "double"),
    186     'unsigned int':  ('i', None, "int", "int"),
    187     'xmlChar':  ('c', None, "int", "int"),
    188     'unsigned char *':  ('z', None, "charPtr", "char *"),
    189     'char *':  ('z', None, "charPtr", "char *"),
    190     'const char *':  ('z', None, "charPtrConst", "const char *"),
    191     'xmlChar *':  ('z', None, "xmlCharPtr", "xmlChar *"),
    192     'const xmlChar *':  ('z', None, "xmlCharPtrConst", "const xmlChar *"),
    193     'xmlNodePtr':  ('O', "xmlNode", "xmlNodePtr", "xmlNodePtr"),
    194     'const xmlNodePtr':  ('O', "xmlNode", "xmlNodePtr", "xmlNodePtr"),
    195     'xmlNode *':  ('O', "xmlNode", "xmlNodePtr", "xmlNodePtr"),
    196     'const xmlNode *':  ('O', "xmlNode", "xmlNodePtr", "xmlNodePtr"),
    197     'xmlDtdPtr':  ('O', "xmlNode", "xmlNodePtr", "xmlNodePtr"),
    198     'const xmlDtdPtr':  ('O', "xmlNode", "xmlNodePtr", "xmlNodePtr"),
    199     'xmlDtd *':  ('O', "xmlNode", "xmlNodePtr", "xmlNodePtr"),
    200     'const xmlDtd *':  ('O', "xmlNode", "xmlNodePtr", "xmlNodePtr"),
    201     'xmlAttrPtr':  ('O', "xmlNode", "xmlNodePtr", "xmlNodePtr"),
    202     'const xmlAttrPtr':  ('O', "xmlNode", "xmlNodePtr", "xmlNodePtr"),
    203     'xmlAttr *':  ('O', "xmlNode", "xmlNodePtr", "xmlNodePtr"),
    204     'const xmlAttr *':  ('O', "xmlNode", "xmlNodePtr", "xmlNodePtr"),
    205     'xmlEntityPtr':  ('O', "xmlNode", "xmlNodePtr", "xmlNodePtr"),
    206     'const xmlEntityPtr':  ('O', "xmlNode", "xmlNodePtr", "xmlNodePtr"),
    207     'xmlEntity *':  ('O', "xmlNode", "xmlNodePtr", "xmlNodePtr"),
    208     'const xmlEntity *':  ('O', "xmlNode", "xmlNodePtr", "xmlNodePtr"),
    209     'xmlElementPtr':  ('O', "xmlElement", "xmlElementPtr", "xmlElementPtr"),
    210     'const xmlElementPtr':  ('O', "xmlElement", "xmlElementPtr", "xmlElementPtr"),
    211     'xmlElement *':  ('O', "xmlElement", "xmlElementPtr", "xmlElementPtr"),
    212     'const xmlElement *':  ('O', "xmlElement", "xmlElementPtr", "xmlElementPtr"),
    213     'xmlAttributePtr':  ('O', "xmlAttribute", "xmlAttributePtr", "xmlAttributePtr"),
    214     'const xmlAttributePtr':  ('O', "xmlAttribute", "xmlAttributePtr", "xmlAttributePtr"),
    215     'xmlAttribute *':  ('O', "xmlAttribute", "xmlAttributePtr", "xmlAttributePtr"),
    216     'const xmlAttribute *':  ('O', "xmlAttribute", "xmlAttributePtr", "xmlAttributePtr"),
    217     'xmlNsPtr':  ('O', "xmlNode", "xmlNsPtr", "xmlNsPtr"),
    218     'const xmlNsPtr':  ('O', "xmlNode", "xmlNsPtr", "xmlNsPtr"),
    219     'xmlNs *':  ('O', "xmlNode", "xmlNsPtr", "xmlNsPtr"),
    220     'const xmlNs *':  ('O', "xmlNode", "xmlNsPtr", "xmlNsPtr"),
    221     'xmlDocPtr':  ('O', "xmlNode", "xmlDocPtr", "xmlDocPtr"),
    222     'const xmlDocPtr':  ('O', "xmlNode", "xmlDocPtr", "xmlDocPtr"),
    223     'xmlDoc *':  ('O', "xmlNode", "xmlDocPtr", "xmlDocPtr"),
    224     'const xmlDoc *':  ('O', "xmlNode", "xmlDocPtr", "xmlDocPtr"),
    225     'htmlDocPtr':  ('O', "xmlNode", "xmlDocPtr", "xmlDocPtr"),
    226     'const htmlDocPtr':  ('O', "xmlNode", "xmlDocPtr", "xmlDocPtr"),
    227     'htmlDoc *':  ('O', "xmlNode", "xmlDocPtr", "xmlDocPtr"),
    228     'const htmlDoc *':  ('O', "xmlNode", "xmlDocPtr", "xmlDocPtr"),
    229     'htmlNodePtr':  ('O', "xmlNode", "xmlNodePtr", "xmlNodePtr"),
    230     'const htmlNodePtr':  ('O', "xmlNode", "xmlNodePtr", "xmlNodePtr"),
    231     'htmlNode *':  ('O', "xmlNode", "xmlNodePtr", "xmlNodePtr"),
    232     'const htmlNode *':  ('O', "xmlNode", "xmlNodePtr", "xmlNodePtr"),
    233     'xmlXPathContextPtr':  ('O', "xmlXPathContext", "xmlXPathContextPtr", "xmlXPathContextPtr"),
    234     'xmlXPathContext *':  ('O', "xpathContext", "xmlXPathContextPtr", "xmlXPathContextPtr"),
    235     'xmlXPathParserContextPtr':  ('O', "xmlXPathParserContext", "xmlXPathParserContextPtr", "xmlXPathParserContextPtr"),
    236     'xmlParserCtxtPtr': ('O', "parserCtxt", "xmlParserCtxtPtr", "xmlParserCtxtPtr"),
    237     'xmlParserCtxt *': ('O', "parserCtxt", "xmlParserCtxtPtr", "xmlParserCtxtPtr"),
    238     'htmlParserCtxtPtr': ('O', "parserCtxt", "xmlParserCtxtPtr", "xmlParserCtxtPtr"),
    239     'htmlParserCtxt *': ('O', "parserCtxt", "xmlParserCtxtPtr", "xmlParserCtxtPtr"),
    240     'xmlValidCtxtPtr': ('O', "ValidCtxt", "xmlValidCtxtPtr", "xmlValidCtxtPtr"),
    241     'xmlCatalogPtr': ('O', "catalog", "xmlCatalogPtr", "xmlCatalogPtr"),
    242     'FILE *': ('O', "File", "FILEPtr", "FILE *"),
    243     'xmlURIPtr': ('O', "URI", "xmlURIPtr", "xmlURIPtr"),
    244     'xmlErrorPtr': ('O', "Error", "xmlErrorPtr", "xmlErrorPtr"),
    245     'xmlOutputBufferPtr': ('O', "outputBuffer", "xmlOutputBufferPtr", "xmlOutputBufferPtr"),
    246     'xmlParserInputBufferPtr': ('O', "inputBuffer", "xmlParserInputBufferPtr", "xmlParserInputBufferPtr"),
    247     'xmlRegexpPtr': ('O', "xmlReg", "xmlRegexpPtr", "xmlRegexpPtr"),
    248     'xmlTextReaderLocatorPtr': ('O', "xmlTextReaderLocator", "xmlTextReaderLocatorPtr", "xmlTextReaderLocatorPtr"),
    249     'xmlTextReaderPtr': ('O', "xmlTextReader", "xmlTextReaderPtr", "xmlTextReaderPtr"),
    250     'xmlRelaxNGPtr': ('O', "relaxNgSchema", "xmlRelaxNGPtr", "xmlRelaxNGPtr"),
    251     'xmlRelaxNGParserCtxtPtr': ('O', "relaxNgParserCtxt", "xmlRelaxNGParserCtxtPtr", "xmlRelaxNGParserCtxtPtr"),
    252     'xmlRelaxNGValidCtxtPtr': ('O', "relaxNgValidCtxt", "xmlRelaxNGValidCtxtPtr", "xmlRelaxNGValidCtxtPtr"),
    253     'xmlSchemaPtr': ('O', "Schema", "xmlSchemaPtr", "xmlSchemaPtr"),
    254     'xmlSchemaParserCtxtPtr': ('O', "SchemaParserCtxt", "xmlSchemaParserCtxtPtr", "xmlSchemaParserCtxtPtr"),
    255     'xmlSchemaValidCtxtPtr': ('O', "SchemaValidCtxt", "xmlSchemaValidCtxtPtr", "xmlSchemaValidCtxtPtr"),
    256 }
    257 
    258 py_return_types = {
    259     'xmlXPathObjectPtr':  ('O', "foo", "xmlXPathObjectPtr", "xmlXPathObjectPtr"),
    260 }
    261 
    262 unknown_types = {}
    263 
    264 foreign_encoding_args = (
    265     'htmlCreateMemoryParserCtxt',
    266     'htmlCtxtReadMemory',
    267     'htmlParseChunk',
    268     'htmlReadMemory',
    269     'xmlCreateMemoryParserCtxt',
    270     'xmlCtxtReadMemory',
    271     'xmlCtxtResetPush',
    272     'xmlParseChunk',
    273     'xmlParseMemory',
    274     'xmlReadMemory',
    275     'xmlRecoverMemory',
    276 )
    277 
    278 #######################################################################
    279 #
    280 #  This part writes the C <-> Python stubs libxml2-py.[ch] and
    281 #  the table libxml2-export.c to add when registrering the Python module
    282 #
    283 #######################################################################
    284 
    285 # Class methods which are written by hand in libxml.c but the Python-level
    286 # code is still automatically generated (so they are not in skip_function()).
    287 skip_impl = (
    288     'xmlSaveFileTo',
    289     'xmlSaveFormatFileTo',
    290 )
    291 
    292 def skip_function(name):
    293     if name[0:12] == "xmlXPathWrap":
    294         return 1
    295     if name == "xmlFreeParserCtxt":
    296         return 1
    297     if name == "xmlCleanupParser":
    298         return 1
    299     if name == "xmlFreeTextReader":
    300         return 1
    301 #    if name[0:11] == "xmlXPathNew":
    302 #        return 1
    303     # the next function is defined in libxml.c
    304     if name == "xmlRelaxNGFreeValidCtxt":
    305         return 1
    306     if name == "xmlFreeValidCtxt":
    307         return 1
    308     if name == "xmlSchemaFreeValidCtxt":
    309         return 1
    310 
    311 #
    312 # Those are skipped because the Const version is used of the bindings
    313 # instead.
    314 #
    315     if name == "xmlTextReaderBaseUri":
    316         return 1
    317     if name == "xmlTextReaderLocalName":
    318         return 1
    319     if name == "xmlTextReaderName":
    320         return 1
    321     if name == "xmlTextReaderNamespaceUri":
    322         return 1
    323     if name == "xmlTextReaderPrefix":
    324         return 1
    325     if name == "xmlTextReaderXmlLang":
    326         return 1
    327     if name == "xmlTextReaderValue":
    328         return 1
    329     if name == "xmlOutputBufferClose": # handled by by the superclass
    330         return 1
    331     if name == "xmlOutputBufferFlush": # handled by by the superclass
    332         return 1
    333     if name == "xmlErrMemory":
    334         return 1
    335 
    336     if name == "xmlValidBuildContentModel":
    337         return 1
    338     if name == "xmlValidateElementDecl":
    339         return 1
    340     if name == "xmlValidateAttributeDecl":
    341         return 1
    342     if name == "xmlPopInputCallbacks":
    343         return 1
    344 
    345     return 0
    346 
    347 def print_function_wrapper(name, output, export, include):
    348     global py_types
    349     global unknown_types
    350     global functions
    351     global skipped_modules
    352 
    353     try:
    354         (desc, ret, args, file, cond) = functions[name]
    355     except:
    356         print("failed to get function %s infos")
    357         return
    358 
    359     if file in skipped_modules:
    360         return 0
    361     if skip_function(name) == 1:
    362         return 0
    363     if name in skip_impl:
    364         # Don't delete the function entry in the caller.
    365         return 1
    366 
    367     c_call = ""
    368     format=""
    369     format_args=""
    370     c_args=""
    371     c_return=""
    372     c_convert=""
    373     c_release=""
    374     num_bufs=0
    375     for arg in args:
    376         # This should be correct
    377         if arg[1][0:6] == "const ":
    378             arg[1] = arg[1][6:]
    379         c_args = c_args + "    %s %s;\n" % (arg[1], arg[0])
    380         if arg[1] in py_types:
    381             (f, t, n, c) = py_types[arg[1]]
    382             if (f == 'z') and (name in foreign_encoding_args) and (num_bufs == 0):
    383                 f = 's#'
    384             if f != None:
    385                 format = format + f
    386             if t != None:
    387                 format_args = format_args + ", &pyobj_%s" % (arg[0])
    388                 c_args = c_args + "    PyObject *pyobj_%s;\n" % (arg[0])
    389                 c_convert = c_convert + \
    390                    "    %s = (%s) Py%s_Get(pyobj_%s);\n" % (arg[0],
    391                    arg[1], t, arg[0])
    392             else:
    393                 format_args = format_args + ", &%s" % (arg[0])
    394             if f == 's#':
    395                 format_args = format_args + ", &py_buffsize%d" % num_bufs
    396                 c_args = c_args + "    int py_buffsize%d;\n" % num_bufs
    397                 num_bufs = num_bufs + 1
    398             if c_call != "":
    399                 c_call = c_call + ", "
    400             c_call = c_call + "%s" % (arg[0])
    401             if t == "File":
    402                 c_release = c_release + \
    403 		            "    PyFile_Release(%s);\n" % (arg[0])
    404         else:
    405             if arg[1] in skipped_types:
    406                 return 0
    407             if arg[1] in unknown_types:
    408                 lst = unknown_types[arg[1]]
    409                 lst.append(name)
    410             else:
    411                 unknown_types[arg[1]] = [name]
    412             return -1
    413     if format != "":
    414         format = format + ":%s" % (name)
    415 
    416     if ret[0] == 'void':
    417         if file == "python_accessor":
    418             if args[1][1] == "char *" or args[1][1] == "xmlChar *":
    419                 c_call = "\n    if (%s->%s != NULL) xmlFree(%s->%s);\n" % (
    420                                  args[0][0], args[1][0], args[0][0], args[1][0])
    421                 c_call = c_call + "    %s->%s = (%s)xmlStrdup((const xmlChar *)%s);\n" % (args[0][0],
    422                                  args[1][0], args[1][1], args[1][0])
    423             else:
    424                 c_call = "\n    %s->%s = %s;\n" % (args[0][0], args[1][0],
    425                                                    args[1][0])
    426         else:
    427             c_call = "\n    %s(%s);\n" % (name, c_call)
    428         ret_convert = "    Py_INCREF(Py_None);\n    return(Py_None);\n"
    429     elif ret[0] in py_types:
    430         (f, t, n, c) = py_types[ret[0]]
    431         c_return = c_return + "    %s c_retval;\n" % (ret[0])
    432         if file == "python_accessor" and ret[2] != None:
    433             c_call = "\n    c_retval = %s->%s;\n" % (args[0][0], ret[2])
    434         else:
    435             c_call = "\n    c_retval = %s(%s);\n" % (name, c_call)
    436         ret_convert = "    py_retval = libxml_%sWrap((%s) c_retval);\n" % (n,c)
    437         ret_convert = ret_convert + "    return(py_retval);\n"
    438     elif ret[0] in py_return_types:
    439         (f, t, n, c) = py_return_types[ret[0]]
    440         c_return = c_return + "    %s c_retval;\n" % (ret[0])
    441         c_call = "\n    c_retval = %s(%s);\n" % (name, c_call)
    442         ret_convert = "    py_retval = libxml_%sWrap((%s) c_retval);\n" % (n,c)
    443         ret_convert = ret_convert + "    return(py_retval);\n"
    444     else:
    445         if ret[0] in skipped_types:
    446             return 0
    447         if ret[0] in unknown_types:
    448             lst = unknown_types[ret[0]]
    449             lst.append(name)
    450         else:
    451             unknown_types[ret[0]] = [name]
    452         return -1
    453 
    454     if cond != None and cond != "":
    455         include.write("#if %s\n" % cond)
    456         export.write("#if %s\n" % cond)
    457         output.write("#if %s\n" % cond)
    458 
    459     include.write("PyObject * ")
    460     include.write("libxml_%s(PyObject *self, PyObject *args);\n" % (name))
    461 
    462     export.write("    { (char *)\"%s\", libxml_%s, METH_VARARGS, NULL },\n" %
    463                  (name, name))
    464 
    465     if file == "python":
    466         # Those have been manually generated
    467         if cond != None and cond != "":
    468             include.write("#endif\n")
    469             export.write("#endif\n")
    470             output.write("#endif\n")
    471         return 1
    472     if file == "python_accessor" and ret[0] != "void" and ret[2] is None:
    473         # Those have been manually generated
    474         if cond != None and cond != "":
    475             include.write("#endif\n")
    476             export.write("#endif\n")
    477             output.write("#endif\n")
    478         return 1
    479 
    480     output.write("PyObject *\n")
    481     output.write("libxml_%s(PyObject *self ATTRIBUTE_UNUSED," % (name))
    482     output.write(" PyObject *args")
    483     if format == "":
    484         output.write(" ATTRIBUTE_UNUSED")
    485     output.write(") {\n")
    486     if ret[0] != 'void':
    487         output.write("    PyObject *py_retval;\n")
    488     if c_return != "":
    489         output.write(c_return)
    490     if c_args != "":
    491         output.write(c_args)
    492     if format != "":
    493         output.write("\n    if (!PyArg_ParseTuple(args, (char *)\"%s\"%s))\n" %
    494                      (format, format_args))
    495         output.write("        return(NULL);\n")
    496     if c_convert != "":
    497         output.write(c_convert)
    498 
    499     output.write(c_call)
    500     if c_release != "":
    501         output.write(c_release)
    502     output.write(ret_convert)
    503     output.write("}\n\n")
    504     if cond != None and cond != "":
    505         include.write("#endif /* %s */\n" % cond)
    506         export.write("#endif /* %s */\n" % cond)
    507         output.write("#endif /* %s */\n" % cond)
    508     return 1
    509 
    510 def buildStubs():
    511     global py_types
    512     global py_return_types
    513     global unknown_types
    514 
    515     try:
    516         f = open(os.path.join(srcPref,"libxml2-api.xml"))
    517         data = f.read()
    518         (parser, target)  = getparser()
    519         parser.feed(data)
    520         parser.close()
    521     except IOError as msg:
    522         try:
    523             f = open(os.path.join(srcPref,"..","doc","libxml2-api.xml"))
    524             data = f.read()
    525             (parser, target)  = getparser()
    526             parser.feed(data)
    527             parser.close()
    528         except IOError as msg:
    529             print(file, ":", msg)
    530             sys.exit(1)
    531 
    532     n = len(list(functions.keys()))
    533     print("Found %d functions in libxml2-api.xml" % (n))
    534 
    535     py_types['pythonObject'] = ('O', "pythonObject", "pythonObject", "pythonObject")
    536     try:
    537         f = open(os.path.join(srcPref,"libxml2-python-api.xml"))
    538         data = f.read()
    539         (parser, target)  = getparser()
    540         parser.feed(data)
    541         parser.close()
    542     except IOError as msg:
    543         print(file, ":", msg)
    544 
    545 
    546     print("Found %d functions in libxml2-python-api.xml" % (
    547           len(list(functions.keys())) - n))
    548     nb_wrap = 0
    549     failed = 0
    550     skipped = 0
    551 
    552     include = open("libxml2-py.h", "w")
    553     include.write("/* Generated */\n\n")
    554     export = open("libxml2-export.c", "w")
    555     export.write("/* Generated */\n\n")
    556     wrapper = open("libxml2-py.c", "w")
    557     wrapper.write("/* Generated */\n\n")
    558     wrapper.write("#include <Python.h>\n")
    559     wrapper.write("#include <libxml/xmlversion.h>\n")
    560     wrapper.write("#include <libxml/tree.h>\n")
    561     wrapper.write("#include <libxml/xmlschemastypes.h>\n")
    562     wrapper.write("#include \"libxml_wrap.h\"\n")
    563     wrapper.write("#include \"libxml2-py.h\"\n\n")
    564     for function in sorted(functions.keys()):
    565         ret = print_function_wrapper(function, wrapper, export, include)
    566         if ret < 0:
    567             failed = failed + 1
    568             del functions[function]
    569         if ret == 0:
    570             skipped = skipped + 1
    571             del functions[function]
    572         if ret == 1:
    573             nb_wrap = nb_wrap + 1
    574     include.close()
    575     export.close()
    576     wrapper.close()
    577 
    578     print("Generated %d wrapper functions, %d failed, %d skipped\n" % (nb_wrap,
    579                                                               failed, skipped))
    580     print("Missing type converters: ")
    581     for type in list(unknown_types.keys()):
    582         print("%s:%d " % (type, len(unknown_types[type])))
    583     print()
    584 
    585 #######################################################################
    586 #
    587 #  This part writes part of the Python front-end classes based on
    588 #  mapping rules between types and classes and also based on function
    589 #  renaming to get consistent function names at the Python level
    590 #
    591 #######################################################################
    592 
    593 #
    594 # The type automatically remapped to generated classes
    595 #
    596 classes_type = {
    597     "xmlNodePtr": ("._o", "xmlNode(_obj=%s)", "xmlNode"),
    598     "xmlNode *": ("._o", "xmlNode(_obj=%s)", "xmlNode"),
    599     "xmlDocPtr": ("._o", "xmlDoc(_obj=%s)", "xmlDoc"),
    600     "xmlDoc *": ("._o", "xmlDoc(_obj=%s)", "xmlDoc"),
    601     "htmlDocPtr": ("._o", "xmlDoc(_obj=%s)", "xmlDoc"),
    602     "htmlxmlDocPtr *": ("._o", "xmlDoc(_obj=%s)", "xmlDoc"),
    603     "xmlAttrPtr": ("._o", "xmlAttr(_obj=%s)", "xmlAttr"),
    604     "xmlAttr *": ("._o", "xmlAttr(_obj=%s)", "xmlAttr"),
    605     "xmlNsPtr": ("._o", "xmlNs(_obj=%s)", "xmlNs"),
    606     "xmlNs *": ("._o", "xmlNs(_obj=%s)", "xmlNs"),
    607     "xmlDtdPtr": ("._o", "xmlDtd(_obj=%s)", "xmlDtd"),
    608     "xmlDtd *": ("._o", "xmlDtd(_obj=%s)", "xmlDtd"),
    609     "xmlEntityPtr": ("._o", "xmlEntity(_obj=%s)", "xmlEntity"),
    610     "xmlEntity *": ("._o", "xmlEntity(_obj=%s)", "xmlEntity"),
    611     "xmlElementPtr": ("._o", "xmlElement(_obj=%s)", "xmlElement"),
    612     "xmlElement *": ("._o", "xmlElement(_obj=%s)", "xmlElement"),
    613     "xmlAttributePtr": ("._o", "xmlAttribute(_obj=%s)", "xmlAttribute"),
    614     "xmlAttribute *": ("._o", "xmlAttribute(_obj=%s)", "xmlAttribute"),
    615     "xmlXPathContextPtr": ("._o", "xpathContext(_obj=%s)", "xpathContext"),
    616     "xmlXPathContext *": ("._o", "xpathContext(_obj=%s)", "xpathContext"),
    617     "xmlXPathParserContext *": ("._o", "xpathParserContext(_obj=%s)", "xpathParserContext"),
    618     "xmlXPathParserContextPtr": ("._o", "xpathParserContext(_obj=%s)", "xpathParserContext"),
    619     "xmlParserCtxtPtr": ("._o", "parserCtxt(_obj=%s)", "parserCtxt"),
    620     "xmlParserCtxt *": ("._o", "parserCtxt(_obj=%s)", "parserCtxt"),
    621     "htmlParserCtxtPtr": ("._o", "parserCtxt(_obj=%s)", "parserCtxt"),
    622     "htmlParserCtxt *": ("._o", "parserCtxt(_obj=%s)", "parserCtxt"),
    623     "xmlValidCtxtPtr": ("._o", "ValidCtxt(_obj=%s)", "ValidCtxt"),
    624     "xmlCatalogPtr": ("._o", "catalog(_obj=%s)", "catalog"),
    625     "xmlURIPtr": ("._o", "URI(_obj=%s)", "URI"),
    626     "xmlErrorPtr": ("._o", "Error(_obj=%s)", "Error"),
    627     "xmlOutputBufferPtr": ("._o", "outputBuffer(_obj=%s)", "outputBuffer"),
    628     "xmlParserInputBufferPtr": ("._o", "inputBuffer(_obj=%s)", "inputBuffer"),
    629     "xmlRegexpPtr": ("._o", "xmlReg(_obj=%s)", "xmlReg"),
    630     "xmlTextReaderLocatorPtr": ("._o", "xmlTextReaderLocator(_obj=%s)", "xmlTextReaderLocator"),
    631     "xmlTextReaderPtr": ("._o", "xmlTextReader(_obj=%s)", "xmlTextReader"),
    632     'xmlRelaxNGPtr': ('._o', "relaxNgSchema(_obj=%s)", "relaxNgSchema"),
    633     'xmlRelaxNGParserCtxtPtr': ('._o', "relaxNgParserCtxt(_obj=%s)", "relaxNgParserCtxt"),
    634     'xmlRelaxNGValidCtxtPtr': ('._o', "relaxNgValidCtxt(_obj=%s)", "relaxNgValidCtxt"),
    635     'xmlSchemaPtr': ("._o", "Schema(_obj=%s)", "Schema"),
    636     'xmlSchemaParserCtxtPtr': ("._o", "SchemaParserCtxt(_obj=%s)", "SchemaParserCtxt"),
    637     'xmlSchemaValidCtxtPtr': ("._o", "SchemaValidCtxt(_obj=%s)", "SchemaValidCtxt"),
    638 }
    639 
    640 converter_type = {
    641     "xmlXPathObjectPtr": "xpathObjectRet(%s)",
    642 }
    643 
    644 primary_classes = ["xmlNode", "xmlDoc"]
    645 
    646 classes_ancestor = {
    647     "xmlNode" : "xmlCore",
    648     "xmlDtd" : "xmlNode",
    649     "xmlDoc" : "xmlNode",
    650     "xmlAttr" : "xmlNode",
    651     "xmlNs" : "xmlNode",
    652     "xmlEntity" : "xmlNode",
    653     "xmlElement" : "xmlNode",
    654     "xmlAttribute" : "xmlNode",
    655     "outputBuffer": "ioWriteWrapper",
    656     "inputBuffer": "ioReadWrapper",
    657     "parserCtxt": "parserCtxtCore",
    658     "xmlTextReader": "xmlTextReaderCore",
    659     "ValidCtxt": "ValidCtxtCore",
    660     "SchemaValidCtxt": "SchemaValidCtxtCore",
    661     "relaxNgValidCtxt": "relaxNgValidCtxtCore",
    662 }
    663 classes_destructors = {
    664     "parserCtxt": "xmlFreeParserCtxt",
    665     "catalog": "xmlFreeCatalog",
    666     "URI": "xmlFreeURI",
    667 #    "outputBuffer": "xmlOutputBufferClose",
    668     "inputBuffer": "xmlFreeParserInputBuffer",
    669     "xmlReg": "xmlRegFreeRegexp",
    670     "xmlTextReader": "xmlFreeTextReader",
    671     "relaxNgSchema": "xmlRelaxNGFree",
    672     "relaxNgParserCtxt": "xmlRelaxNGFreeParserCtxt",
    673     "relaxNgValidCtxt": "xmlRelaxNGFreeValidCtxt",
    674         "Schema": "xmlSchemaFree",
    675         "SchemaParserCtxt": "xmlSchemaFreeParserCtxt",
    676         "SchemaValidCtxt": "xmlSchemaFreeValidCtxt",
    677         "ValidCtxt": "xmlFreeValidCtxt",
    678 }
    679 
    680 functions_noexcept = {
    681     "xmlHasProp": 1,
    682     "xmlHasNsProp": 1,
    683     "xmlDocSetRootElement": 1,
    684     "xmlNodeGetNs": 1,
    685     "xmlNodeGetNsDefs": 1,
    686     "xmlNextElementSibling": 1,
    687     "xmlPreviousElementSibling": 1,
    688     "xmlFirstElementChild": 1,
    689     "xmlLastElementChild": 1,
    690 }
    691 
    692 reference_keepers = {
    693     "xmlTextReader": [('inputBuffer', 'input')],
    694     "relaxNgValidCtxt": [('relaxNgSchema', 'schema')],
    695         "SchemaValidCtxt": [('Schema', 'schema')],
    696 }
    697 
    698 function_classes = {}
    699 
    700 function_classes["None"] = []
    701 
    702 def nameFixup(name, classe, type, file):
    703     listname = classe + "List"
    704     ll = len(listname)
    705     l = len(classe)
    706     if name[0:l] == listname:
    707         func = name[l:]
    708         func = func[0:1].lower() + func[1:]
    709     elif name[0:12] == "xmlParserGet" and file == "python_accessor":
    710         func = name[12:]
    711         func = func[0:1].lower() + func[1:]
    712     elif name[0:12] == "xmlParserSet" and file == "python_accessor":
    713         func = name[12:]
    714         func = func[0:1].lower() + func[1:]
    715     elif name[0:10] == "xmlNodeGet" and file == "python_accessor":
    716         func = name[10:]
    717         func = func[0:1].lower() + func[1:]
    718     elif name[0:9] == "xmlURIGet" and file == "python_accessor":
    719         func = name[9:]
    720         func = func[0:1].lower() + func[1:]
    721     elif name[0:9] == "xmlURISet" and file == "python_accessor":
    722         func = name[6:]
    723         func = func[0:1].lower() + func[1:]
    724     elif name[0:11] == "xmlErrorGet" and file == "python_accessor":
    725         func = name[11:]
    726         func = func[0:1].lower() + func[1:]
    727     elif name[0:17] == "xmlXPathParserGet" and file == "python_accessor":
    728         func = name[17:]
    729         func = func[0:1].lower() + func[1:]
    730     elif name[0:11] == "xmlXPathGet" and file == "python_accessor":
    731         func = name[11:]
    732         func = func[0:1].lower() + func[1:]
    733     elif name[0:11] == "xmlXPathSet" and file == "python_accessor":
    734         func = name[8:]
    735         func = func[0:1].lower() + func[1:]
    736     elif name[0:15] == "xmlOutputBuffer" and file != "python":
    737         func = name[15:]
    738         func = func[0:1].lower() + func[1:]
    739     elif name[0:20] == "xmlParserInputBuffer" and file != "python":
    740         func = name[20:]
    741         func = func[0:1].lower() + func[1:]
    742     elif name[0:9] == "xmlRegexp" and file == "xmlregexp":
    743         func = "regexp" + name[9:]
    744     elif name[0:6] == "xmlReg" and file == "xmlregexp":
    745         func = "regexp" + name[6:]
    746     elif name[0:20] == "xmlTextReaderLocator" and file == "xmlreader":
    747         func = name[20:]
    748     elif name[0:18] == "xmlTextReaderConst" and file == "xmlreader":
    749         func = name[18:]
    750     elif name[0:13] == "xmlTextReader" and file == "xmlreader":
    751         func = name[13:]
    752     elif name[0:12] == "xmlReaderNew" and file == "xmlreader":
    753         func = name[9:]
    754     elif name[0:11] == "xmlACatalog":
    755         func = name[11:]
    756         func = func[0:1].lower() + func[1:]
    757     elif name[0:l] == classe:
    758         func = name[l:]
    759         func = func[0:1].lower() + func[1:]
    760     elif name[0:7] == "libxml_":
    761         func = name[7:]
    762         func = func[0:1].lower() + func[1:]
    763     elif name[0:6] == "xmlGet":
    764         func = name[6:]
    765         func = func[0:1].lower() + func[1:]
    766     elif name[0:3] == "xml":
    767         func = name[3:]
    768         func = func[0:1].lower() + func[1:]
    769     else:
    770         func = name
    771     if func[0:5] == "xPath":
    772         func = "xpath" + func[5:]
    773     elif func[0:4] == "xPtr":
    774         func = "xpointer" + func[4:]
    775     elif func[0:8] == "xInclude":
    776         func = "xinclude" + func[8:]
    777     elif func[0:2] == "iD":
    778         func = "ID" + func[2:]
    779     elif func[0:3] == "uRI":
    780         func = "URI" + func[3:]
    781     elif func[0:4] == "uTF8":
    782         func = "UTF8" + func[4:]
    783     elif func[0:3] == 'sAX':
    784         func = "SAX" + func[3:]
    785     return func
    786 
    787 
    788 def functionCompare(info1, info2):
    789     (index1, func1, name1, ret1, args1, file1) = info1
    790     (index2, func2, name2, ret2, args2, file2) = info2
    791     if file1 == file2:
    792         if func1 < func2:
    793             return -1
    794         if func1 > func2:
    795             return 1
    796     if file1 == "python_accessor":
    797         return -1
    798     if file2 == "python_accessor":
    799         return 1
    800     if file1 < file2:
    801         return -1
    802     if file1 > file2:
    803         return 1
    804     return 0
    805 
    806 def cmp_to_key(mycmp):
    807     'Convert a cmp= function into a key= function'
    808     class K(object):
    809         def __init__(self, obj, *args):
    810             self.obj = obj
    811         def __lt__(self, other):
    812             return mycmp(self.obj, other.obj) < 0
    813         def __gt__(self, other):
    814             return mycmp(self.obj, other.obj) > 0
    815         def __eq__(self, other):
    816             return mycmp(self.obj, other.obj) == 0
    817         def __le__(self, other):
    818             return mycmp(self.obj, other.obj) <= 0
    819         def __ge__(self, other):
    820             return mycmp(self.obj, other.obj) >= 0
    821         def __ne__(self, other):
    822             return mycmp(self.obj, other.obj) != 0
    823     return K
    824 def writeDoc(name, args, indent, output):
    825      if functions[name][0] is None or functions[name][0] == "":
    826          return
    827      val = functions[name][0]
    828      val = val.replace("NULL", "None")
    829      output.write(indent)
    830      output.write('"""')
    831      while len(val) > 60:
    832          if val[0] == " ":
    833              val = val[1:]
    834              continue
    835          str = val[0:60]
    836          i = str.rfind(" ")
    837          if i < 0:
    838              i = 60
    839          str = val[0:i]
    840          val = val[i:]
    841          output.write(str)
    842          output.write('\n  ')
    843          output.write(indent)
    844      output.write(val)
    845      output.write(' """\n')
    846 
    847 def buildWrappers():
    848     global ctypes
    849     global py_types
    850     global py_return_types
    851     global unknown_types
    852     global functions
    853     global function_classes
    854     global classes_type
    855     global classes_list
    856     global converter_type
    857     global primary_classes
    858     global converter_type
    859     global classes_ancestor
    860     global converter_type
    861     global primary_classes
    862     global classes_ancestor
    863     global classes_destructors
    864     global functions_noexcept
    865 
    866     for type in classes_type.keys():
    867         function_classes[classes_type[type][2]] = []
    868 
    869     #
    870     # Build the list of C types to look for ordered to start
    871     # with primary classes
    872     #
    873     ctypes = []
    874     classes_list = []
    875     ctypes_processed = {}
    876     classes_processed = {}
    877     for classe in primary_classes:
    878         classes_list.append(classe)
    879         classes_processed[classe] = ()
    880         for type in classes_type.keys():
    881             tinfo = classes_type[type]
    882             if tinfo[2] == classe:
    883                 ctypes.append(type)
    884                 ctypes_processed[type] = ()
    885     for type in sorted(classes_type.keys()):
    886         if type in ctypes_processed:
    887             continue
    888         tinfo = classes_type[type]
    889         if tinfo[2] not in classes_processed:
    890             classes_list.append(tinfo[2])
    891             classes_processed[tinfo[2]] = ()
    892 
    893         ctypes.append(type)
    894         ctypes_processed[type] = ()
    895 
    896     for name in functions.keys():
    897         found = 0
    898         (desc, ret, args, file, cond) = functions[name]
    899         for type in ctypes:
    900             classe = classes_type[type][2]
    901 
    902             if name[0:3] == "xml" and len(args) >= 1 and args[0][1] == type:
    903                 found = 1
    904                 func = nameFixup(name, classe, type, file)
    905                 info = (0, func, name, ret, args, file)
    906                 function_classes[classe].append(info)
    907             elif name[0:3] == "xml" and len(args) >= 2 and args[1][1] == type \
    908                 and file != "python_accessor":
    909                 found = 1
    910                 func = nameFixup(name, classe, type, file)
    911                 info = (1, func, name, ret, args, file)
    912                 function_classes[classe].append(info)
    913             elif name[0:4] == "html" and len(args) >= 1 and args[0][1] == type:
    914                 found = 1
    915                 func = nameFixup(name, classe, type, file)
    916                 info = (0, func, name, ret, args, file)
    917                 function_classes[classe].append(info)
    918             elif name[0:4] == "html" and len(args) >= 2 and args[1][1] == type \
    919                 and file != "python_accessor":
    920                 found = 1
    921                 func = nameFixup(name, classe, type, file)
    922                 info = (1, func, name, ret, args, file)
    923                 function_classes[classe].append(info)
    924         if found == 1:
    925             continue
    926         if name[0:8] == "xmlXPath":
    927             continue
    928         if name[0:6] == "xmlStr":
    929             continue
    930         if name[0:10] == "xmlCharStr":
    931             continue
    932         func = nameFixup(name, "None", file, file)
    933         info = (0, func, name, ret, args, file)
    934         function_classes['None'].append(info)
    935    
    936     classes = open("libxml2class.py", "w")
    937     txt = open("libxml2class.txt", "w")
    938     txt.write("          Generated Classes for libxml2-python\n\n")
    939 
    940     txt.write("#\n# Global functions of the module\n#\n\n")
    941     if "None" in function_classes:
    942         flist = function_classes["None"]
    943         flist = sorted(flist, key=cmp_to_key(functionCompare))
    944         oldfile = ""
    945         for info in flist:
    946             (index, func, name, ret, args, file) = info
    947             if file != oldfile:
    948                 classes.write("#\n# Functions from module %s\n#\n\n" % file)
    949                 txt.write("\n# functions from module %s\n" % file)
    950                 oldfile = file
    951             classes.write("def %s(" % func)
    952             txt.write("%s()\n" % func)
    953             n = 0
    954             for arg in args:
    955                 if n != 0:
    956                     classes.write(", ")
    957                 classes.write("%s" % arg[0])
    958                 n = n + 1
    959             classes.write("):\n")
    960             writeDoc(name, args, '    ', classes)
    961 
    962             for arg in args:
    963                 if arg[1] in classes_type:
    964                     classes.write("    if %s is None: %s__o = None\n" %
    965                                   (arg[0], arg[0]))
    966                     classes.write("    else: %s__o = %s%s\n" %
    967                                   (arg[0], arg[0], classes_type[arg[1]][0]))
    968                 if arg[1] in py_types:
    969                     (f, t, n, c) = py_types[arg[1]]
    970                     if t == "File":
    971                         classes.write("    if %s is not None: %s.flush()\n" % (
    972                                       arg[0], arg[0]))
    973 
    974             if ret[0] != "void":
    975                 classes.write("    ret = ")
    976             else:
    977                 classes.write("    ")
    978             classes.write("libxml2mod.%s(" % name)
    979             n = 0
    980             for arg in args:
    981                 if n != 0:
    982                     classes.write(", ")
    983                 classes.write("%s" % arg[0])
    984                 if arg[1] in classes_type:
    985                     classes.write("__o")
    986                 n = n + 1
    987             classes.write(")\n")
    988 
    989 # This may be needed to reposition the I/O, but likely to cause more harm
    990 # than good. Those changes in Python3 really break the model.
    991 #           for arg in args:
    992 #               if arg[1] in py_types:
    993 #                   (f, t, n, c) = py_types[arg[1]]
    994 #                   if t == "File":
    995 #                       classes.write("    if %s is not None: %s.seek(0,0)\n"%(
    996 #                                     arg[0], arg[0]))
    997 
    998             if ret[0] != "void":
    999                 if ret[0] in classes_type:
   1000                     #
   1001                     # Raise an exception
   1002                     #
   1003                     if name in functions_noexcept:
   1004                         classes.write("    if ret is None:return None\n")
   1005                     elif name.find("URI") >= 0:
   1006                         classes.write(
   1007                         "    if ret is None:raise uriError('%s() failed')\n"
   1008                                       % (name))
   1009                     elif name.find("XPath") >= 0:
   1010                         classes.write(
   1011                         "    if ret is None:raise xpathError('%s() failed')\n"
   1012                                       % (name))
   1013                     elif name.find("Parse") >= 0:
   1014                         classes.write(
   1015                         "    if ret is None:raise parserError('%s() failed')\n"
   1016                                       % (name))
   1017                     else:
   1018                         classes.write(
   1019                         "    if ret is None:raise treeError('%s() failed')\n"
   1020                                       % (name))
   1021                     classes.write("    return ")
   1022                     classes.write(classes_type[ret[0]][1] % ("ret"))
   1023                     classes.write("\n")
   1024                 else:
   1025                     classes.write("    return ret\n")
   1026             classes.write("\n")
   1027 
   1028     txt.write("\n\n#\n# Set of classes of the module\n#\n\n")
   1029     for classname in classes_list:
   1030         if classname == "None":
   1031             pass
   1032         else:
   1033             if classname in classes_ancestor:
   1034                 txt.write("\n\nClass %s(%s)\n" % (classname,
   1035                           classes_ancestor[classname]))
   1036                 classes.write("class %s(%s):\n" % (classname,
   1037                               classes_ancestor[classname]))
   1038                 classes.write("    def __init__(self, _obj=None):\n")
   1039                 if classes_ancestor[classname] == "xmlCore" or \
   1040                    classes_ancestor[classname] == "xmlNode":
   1041                     classes.write("        if checkWrapper(_obj) != 0:")
   1042                     classes.write("            raise TypeError")
   1043                     classes.write("('%s got a wrong wrapper object type')\n" % \
   1044                                 classname)
   1045                 if classname in reference_keepers:
   1046                     rlist = reference_keepers[classname]
   1047                     for ref in rlist:
   1048                         classes.write("        self.%s = None\n" % ref[1])
   1049                 classes.write("        self._o = _obj\n")
   1050                 classes.write("        %s.__init__(self, _obj=_obj)\n\n" % (
   1051                               classes_ancestor[classname]))
   1052                 if classes_ancestor[classname] == "xmlCore" or \
   1053                    classes_ancestor[classname] == "xmlNode":
   1054                     classes.write("    def __repr__(self):\n")
   1055                     format = "<%s (%%s) object at 0x%%x>" % (classname)
   1056                     classes.write("        return \"%s\" %% (self.name, int(pos_id (self)))\n\n" % (
   1057                                   format))
   1058             else:
   1059                 txt.write("Class %s()\n" % (classname))
   1060                 classes.write("class %s:\n" % (classname))
   1061                 classes.write("    def __init__(self, _obj=None):\n")
   1062                 if classname in reference_keepers:
   1063                     list = reference_keepers[classname]
   1064                     for ref in list:
   1065                         classes.write("        self.%s = None\n" % ref[1])
   1066                 classes.write("        if _obj != None:self._o = _obj;return\n")
   1067                 classes.write("        self._o = None\n\n")
   1068             destruct=None
   1069             if classname in classes_destructors:
   1070                 classes.write("    def __del__(self):\n")
   1071                 classes.write("        if self._o != None:\n")
   1072                 classes.write("            libxml2mod.%s(self._o)\n" %
   1073                               classes_destructors[classname])
   1074                 classes.write("        self._o = None\n\n")
   1075                 destruct=classes_destructors[classname]
   1076             flist = function_classes[classname]
   1077             flist = sorted(flist, key=cmp_to_key(functionCompare))
   1078             oldfile = ""
   1079             for info in flist:
   1080                 (index, func, name, ret, args, file) = info
   1081                 #
   1082                 # Do not provide as method the destructors for the class
   1083                 # to avoid double free
   1084                 #
   1085                 if name == destruct:
   1086                     continue
   1087                 if file != oldfile:
   1088                     if file == "python_accessor":
   1089                         classes.write("    # accessors for %s\n" % (classname))
   1090                         txt.write("    # accessors\n")
   1091                     else:
   1092                         classes.write("    #\n")
   1093                         classes.write("    # %s functions from module %s\n" % (
   1094                                       classname, file))
   1095                         txt.write("\n    # functions from module %s\n" % file)
   1096                         classes.write("    #\n\n")
   1097                 oldfile = file
   1098                 classes.write("    def %s(self" % func)
   1099                 txt.write("    %s()\n" % func)
   1100                 n = 0
   1101                 for arg in args:
   1102                     if n != index:
   1103                         classes.write(", %s" % arg[0])
   1104                     n = n + 1
   1105                 classes.write("):\n")
   1106                 writeDoc(name, args, '        ', classes)
   1107                 n = 0
   1108                 for arg in args:
   1109                     if arg[1] in classes_type:
   1110                         if n != index:
   1111                             classes.write("        if %s is None: %s__o = None\n" %
   1112                                           (arg[0], arg[0]))
   1113                             classes.write("        else: %s__o = %s%s\n" %
   1114                                           (arg[0], arg[0], classes_type[arg[1]][0]))
   1115                     n = n + 1
   1116                 if ret[0] != "void":
   1117                     classes.write("        ret = ")
   1118                 else:
   1119                     classes.write("        ")
   1120                 classes.write("libxml2mod.%s(" % name)
   1121                 n = 0
   1122                 for arg in args:
   1123                     if n != 0:
   1124                         classes.write(", ")
   1125                     if n != index:
   1126                         classes.write("%s" % arg[0])
   1127                         if arg[1] in classes_type:
   1128                             classes.write("__o")
   1129                     else:
   1130                         classes.write("self")
   1131                         if arg[1] in classes_type:
   1132                             classes.write(classes_type[arg[1]][0])
   1133                     n = n + 1
   1134                 classes.write(")\n")
   1135                 if ret[0] != "void":
   1136                     if ret[0] in classes_type:
   1137                         #
   1138                         # Raise an exception
   1139                         #
   1140                         if name in functions_noexcept:
   1141                             classes.write(
   1142                                 "        if ret is None:return None\n")
   1143                         elif name.find("URI") >= 0:
   1144                             classes.write(
   1145                     "        if ret is None:raise uriError('%s() failed')\n"
   1146                                           % (name))
   1147                         elif name.find("XPath") >= 0:
   1148                             classes.write(
   1149                     "        if ret is None:raise xpathError('%s() failed')\n"
   1150                                           % (name))
   1151                         elif name.find("Parse") >= 0:
   1152                             classes.write(
   1153                     "        if ret is None:raise parserError('%s() failed')\n"
   1154                                           % (name))
   1155                         else:
   1156                             classes.write(
   1157                     "        if ret is None:raise treeError('%s() failed')\n"
   1158                                           % (name))
   1159 
   1160                         #
   1161                         # generate the returned class wrapper for the object
   1162                         #
   1163                         classes.write("        __tmp = ")
   1164                         classes.write(classes_type[ret[0]][1] % ("ret"))
   1165                         classes.write("\n")
   1166 
   1167                         #
   1168                         # Sometime one need to keep references of the source
   1169                         # class in the returned class object.
   1170                         # See reference_keepers for the list
   1171                         #
   1172                         tclass = classes_type[ret[0]][2]
   1173                         if tclass in reference_keepers:
   1174                             list = reference_keepers[tclass]
   1175                             for pref in list:
   1176                                 if pref[0] == classname:
   1177                                     classes.write("        __tmp.%s = self\n" %
   1178                                                   pref[1])
   1179                         #
   1180                         # return the class
   1181                         #
   1182                         classes.write("        return __tmp\n")
   1183                     elif ret[0] in converter_type:
   1184                         #
   1185                         # Raise an exception
   1186                         #
   1187                         if name in functions_noexcept:
   1188                             classes.write(
   1189                                 "        if ret is None:return None")
   1190                         elif name.find("URI") >= 0:
   1191                             classes.write(
   1192                     "        if ret is None:raise uriError('%s() failed')\n"
   1193                                           % (name))
   1194                         elif name.find("XPath") >= 0:
   1195                             classes.write(
   1196                     "        if ret is None:raise xpathError('%s() failed')\n"
   1197                                           % (name))
   1198                         elif name.find("Parse") >= 0:
   1199                             classes.write(
   1200                     "        if ret is None:raise parserError('%s() failed')\n"
   1201                                           % (name))
   1202                         else:
   1203                             classes.write(
   1204                     "        if ret is None:raise treeError('%s() failed')\n"
   1205                                           % (name))
   1206                         classes.write("        return ")
   1207                         classes.write(converter_type[ret[0]] % ("ret"))
   1208                         classes.write("\n")
   1209                     else:
   1210                         classes.write("        return ret\n")
   1211                 classes.write("\n")
   1212 
   1213     #
   1214     # Generate enum constants
   1215     #
   1216     for type,enum in enums.items():
   1217         classes.write("# %s\n" % type)
   1218         items = enum.items()
   1219         items = sorted(items, key=(lambda i: int(i[1])))
   1220         for name,value in items:
   1221             classes.write("%s = %s\n" % (name,value))
   1222         classes.write("\n")
   1223 
   1224     txt.close()
   1225     classes.close()
   1226 
   1227 buildStubs()
   1228 buildWrappers()
   1229