1#!/usr/bin/python -u
2#
3# generate python wrappers from the XML API description
4#
5
6functions = {}
7enums = {} # { enumType: { enumConstant: enumValue } }
8
9import os
10import sys
11import string
12
13if __name__ == "__main__":
14    # launched as a script
15    srcPref = os.path.dirname(sys.argv[0])
16else:
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#######################################################################
26import os
27import xml.sax
28
29debug = 0
30
31def 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
38class 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
138def function(name, desc, ret, args, file, cond):
139    functions[name] = (desc, ret, args, file, cond)
140
141def 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
153skipped_modules = {
154    'xmlmemory': None,
155    'DOCBparser': None,
156    'SAX': None,
157    'hash': None,
158    'list': None,
159    'threads': None,
160#    'xpointer': None,
161}
162skipped_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
181py_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
258py_return_types = {
259    'xmlXPathObjectPtr':  ('O', "foo", "xmlXPathObjectPtr", "xmlXPathObjectPtr"),
260}
261
262unknown_types = {}
263
264foreign_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()).
287skip_impl = (
288    'xmlSaveFileTo',
289    'xmlSaveFormatFileTo',
290)
291
292def 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
347def 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
510def 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#
596classes_type = {
597    "xmlNodePtr": ("._o", "xmlNode(_obj=%s)", "xmlNode"),
598    "xmlNode *": ("._o", "xmlNode(_obj=%s)", "xmlNode"),
599    "xmlDocPtr": ("._o", "xmlDoc(_obj=%s)", "xmlDoc"),
600    "xmlDocPtr *": ("._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
640converter_type = {
641    "xmlXPathObjectPtr": "xpathObjectRet(%s)",
642}
643
644primary_classes = ["xmlNode", "xmlDoc"]
645
646classes_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}
663classes_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
680functions_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
692reference_keepers = {
693    "xmlTextReader": [('inputBuffer', 'input')],
694    "relaxNgValidCtxt": [('relaxNgSchema', 'schema')],
695        "SchemaValidCtxt": [('Schema', 'schema')],
696}
697
698function_classes = {}
699
700function_classes["None"] = []
701
702def 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
788def 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
806def 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
824def 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
847def 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
1227buildStubs()
1228buildWrappers()
1229