summaryrefslogtreecommitdiffstats
path: root/libxml2/python/generator.py
diff options
context:
space:
mode:
authorWilliam Joye <wjoye@cfa.harvard.edu>2016-11-17 21:09:46 (GMT)
committerWilliam Joye <wjoye@cfa.harvard.edu>2016-11-17 21:09:46 (GMT)
commitfc7f7edd0b8011cb71573b15462ef83068d9e54b (patch)
tree459fb7d1a9611f563e3000386df5cb7cdf506916 /libxml2/python/generator.py
parent4f65b25b474bf534e40c3d3aa47d43e8457fcc9a (diff)
downloadblt-fc7f7edd0b8011cb71573b15462ef83068d9e54b.zip
blt-fc7f7edd0b8011cb71573b15462ef83068d9e54b.tar.gz
blt-fc7f7edd0b8011cb71573b15462ef83068d9e54b.tar.bz2
local fork libxml2
Diffstat (limited to 'libxml2/python/generator.py')
-rwxr-xr-xlibxml2/python/generator.py1228
1 files changed, 0 insertions, 1228 deletions
diff --git a/libxml2/python/generator.py b/libxml2/python/generator.py
deleted file mode 100755
index c0cb3ad..0000000
--- a/libxml2/python/generator.py
+++ /dev/null
@@ -1,1228 +0,0 @@
-#!/usr/bin/python -u
-#
-# generate python wrappers from the XML API description
-#
-
-functions = {}
-enums = {} # { enumType: { enumConstant: enumValue } }
-
-import os
-import sys
-import string
-
-if __name__ == "__main__":
- # launched as a script
- srcPref = os.path.dirname(sys.argv[0])
-else:
- # imported
- srcPref = os.path.dirname(__file__)
-
-#######################################################################
-#
-# That part if purely the API acquisition phase from the
-# XML API description
-#
-#######################################################################
-import os
-import xml.sax
-
-debug = 0
-
-def getparser():
- # Attach parser to an unmarshalling object. return both objects.
- target = docParser()
- parser = xml.sax.make_parser()
- parser.setContentHandler(target)
- return parser, target
-
-class docParser(xml.sax.handler.ContentHandler):
- def __init__(self):
- self._methodname = None
- self._data = []
- self.in_function = 0
-
- self.startElement = self.start
- self.endElement = self.end
- self.characters = self.data
-
- def close(self):
- if debug:
- print("close")
-
- def getmethodname(self):
- return self._methodname
-
- def data(self, text):
- if debug:
- print("data %s" % text)
- self._data.append(text)
-
- def start(self, tag, attrs):
- if debug:
- print("start %s, %s" % (tag, attrs))
- if tag == 'function':
- self._data = []
- self.in_function = 1
- self.function = None
- self.function_cond = None
- self.function_args = []
- self.function_descr = None
- self.function_return = None
- self.function_file = None
- if 'name' in attrs.keys():
- self.function = attrs['name']
- if 'file' in attrs.keys():
- self.function_file = attrs['file']
- elif tag == 'cond':
- self._data = []
- elif tag == 'info':
- self._data = []
- elif tag == 'arg':
- if self.in_function == 1:
- self.function_arg_name = None
- self.function_arg_type = None
- self.function_arg_info = None
- if 'name' in attrs.keys():
- self.function_arg_name = attrs['name']
- if 'type' in attrs.keys():
- self.function_arg_type = attrs['type']
- if 'info' in attrs.keys():
- self.function_arg_info = attrs['info']
- elif tag == 'return':
- if self.in_function == 1:
- self.function_return_type = None
- self.function_return_info = None
- self.function_return_field = None
- if 'type' in attrs.keys():
- self.function_return_type = attrs['type']
- if 'info' in attrs.keys():
- self.function_return_info = attrs['info']
- if 'field' in attrs.keys():
- self.function_return_field = attrs['field']
- elif tag == 'enum':
- enum(attrs['type'],attrs['name'],attrs['value'])
-
- def end(self, tag):
- if debug:
- print("end %s" % tag)
- if tag == 'function':
- if self.function != None:
- function(self.function, self.function_descr,
- self.function_return, self.function_args,
- self.function_file, self.function_cond)
- self.in_function = 0
- elif tag == 'arg':
- if self.in_function == 1:
- self.function_args.append([self.function_arg_name,
- self.function_arg_type,
- self.function_arg_info])
- elif tag == 'return':
- if self.in_function == 1:
- self.function_return = [self.function_return_type,
- self.function_return_info,
- self.function_return_field]
- elif tag == 'info':
- str = ''
- for c in self._data:
- str = str + c
- if self.in_function == 1:
- self.function_descr = str
- elif tag == 'cond':
- str = ''
- for c in self._data:
- str = str + c
- if self.in_function == 1:
- self.function_cond = str
-
-
-def function(name, desc, ret, args, file, cond):
- functions[name] = (desc, ret, args, file, cond)
-
-def enum(type, name, value):
- if type not in enums:
- enums[type] = {}
- enums[type][name] = value
-
-#######################################################################
-#
-# Some filtering rukes to drop functions/types which should not
-# be exposed as-is on the Python interface
-#
-#######################################################################
-
-skipped_modules = {
- 'xmlmemory': None,
- 'DOCBparser': None,
- 'SAX': None,
- 'hash': None,
- 'list': None,
- 'threads': None,
-# 'xpointer': None,
-}
-skipped_types = {
- 'int *': "usually a return type",
- 'xmlSAXHandlerPtr': "not the proper interface for SAX",
- 'htmlSAXHandlerPtr': "not the proper interface for SAX",
- 'xmlRMutexPtr': "thread specific, skipped",
- 'xmlMutexPtr': "thread specific, skipped",
- 'xmlGlobalStatePtr': "thread specific, skipped",
- 'xmlListPtr': "internal representation not suitable for python",
- 'xmlBufferPtr': "internal representation not suitable for python",
- 'FILE *': None,
-}
-
-#######################################################################
-#
-# Table of remapping to/from the python type or class to the C
-# counterpart.
-#
-#######################################################################
-
-py_types = {
- 'void': (None, None, None, None),
- 'int': ('i', None, "int", "int"),
- 'long': ('l', None, "long", "long"),
- 'double': ('d', None, "double", "double"),
- 'unsigned int': ('i', None, "int", "int"),
- 'xmlChar': ('c', None, "int", "int"),
- 'unsigned char *': ('z', None, "charPtr", "char *"),
- 'char *': ('z', None, "charPtr", "char *"),
- 'const char *': ('z', None, "charPtrConst", "const char *"),
- 'xmlChar *': ('z', None, "xmlCharPtr", "xmlChar *"),
- 'const xmlChar *': ('z', None, "xmlCharPtrConst", "const xmlChar *"),
- 'xmlNodePtr': ('O', "xmlNode", "xmlNodePtr", "xmlNodePtr"),
- 'const xmlNodePtr': ('O', "xmlNode", "xmlNodePtr", "xmlNodePtr"),
- 'xmlNode *': ('O', "xmlNode", "xmlNodePtr", "xmlNodePtr"),
- 'const xmlNode *': ('O', "xmlNode", "xmlNodePtr", "xmlNodePtr"),
- 'xmlDtdPtr': ('O', "xmlNode", "xmlNodePtr", "xmlNodePtr"),
- 'const xmlDtdPtr': ('O', "xmlNode", "xmlNodePtr", "xmlNodePtr"),
- 'xmlDtd *': ('O', "xmlNode", "xmlNodePtr", "xmlNodePtr"),
- 'const xmlDtd *': ('O', "xmlNode", "xmlNodePtr", "xmlNodePtr"),
- 'xmlAttrPtr': ('O', "xmlNode", "xmlNodePtr", "xmlNodePtr"),
- 'const xmlAttrPtr': ('O', "xmlNode", "xmlNodePtr", "xmlNodePtr"),
- 'xmlAttr *': ('O', "xmlNode", "xmlNodePtr", "xmlNodePtr"),
- 'const xmlAttr *': ('O', "xmlNode", "xmlNodePtr", "xmlNodePtr"),
- 'xmlEntityPtr': ('O', "xmlNode", "xmlNodePtr", "xmlNodePtr"),
- 'const xmlEntityPtr': ('O', "xmlNode", "xmlNodePtr", "xmlNodePtr"),
- 'xmlEntity *': ('O', "xmlNode", "xmlNodePtr", "xmlNodePtr"),
- 'const xmlEntity *': ('O', "xmlNode", "xmlNodePtr", "xmlNodePtr"),
- 'xmlElementPtr': ('O', "xmlElement", "xmlElementPtr", "xmlElementPtr"),
- 'const xmlElementPtr': ('O', "xmlElement", "xmlElementPtr", "xmlElementPtr"),
- 'xmlElement *': ('O', "xmlElement", "xmlElementPtr", "xmlElementPtr"),
- 'const xmlElement *': ('O', "xmlElement", "xmlElementPtr", "xmlElementPtr"),
- 'xmlAttributePtr': ('O', "xmlAttribute", "xmlAttributePtr", "xmlAttributePtr"),
- 'const xmlAttributePtr': ('O', "xmlAttribute", "xmlAttributePtr", "xmlAttributePtr"),
- 'xmlAttribute *': ('O', "xmlAttribute", "xmlAttributePtr", "xmlAttributePtr"),
- 'const xmlAttribute *': ('O', "xmlAttribute", "xmlAttributePtr", "xmlAttributePtr"),
- 'xmlNsPtr': ('O', "xmlNode", "xmlNsPtr", "xmlNsPtr"),
- 'const xmlNsPtr': ('O', "xmlNode", "xmlNsPtr", "xmlNsPtr"),
- 'xmlNs *': ('O', "xmlNode", "xmlNsPtr", "xmlNsPtr"),
- 'const xmlNs *': ('O', "xmlNode", "xmlNsPtr", "xmlNsPtr"),
- 'xmlDocPtr': ('O', "xmlNode", "xmlDocPtr", "xmlDocPtr"),
- 'const xmlDocPtr': ('O', "xmlNode", "xmlDocPtr", "xmlDocPtr"),
- 'xmlDoc *': ('O', "xmlNode", "xmlDocPtr", "xmlDocPtr"),
- 'const xmlDoc *': ('O', "xmlNode", "xmlDocPtr", "xmlDocPtr"),
- 'htmlDocPtr': ('O', "xmlNode", "xmlDocPtr", "xmlDocPtr"),
- 'const htmlDocPtr': ('O', "xmlNode", "xmlDocPtr", "xmlDocPtr"),
- 'htmlDoc *': ('O', "xmlNode", "xmlDocPtr", "xmlDocPtr"),
- 'const htmlDoc *': ('O', "xmlNode", "xmlDocPtr", "xmlDocPtr"),
- 'htmlNodePtr': ('O', "xmlNode", "xmlNodePtr", "xmlNodePtr"),
- 'const htmlNodePtr': ('O', "xmlNode", "xmlNodePtr", "xmlNodePtr"),
- 'htmlNode *': ('O', "xmlNode", "xmlNodePtr", "xmlNodePtr"),
- 'const htmlNode *': ('O', "xmlNode", "xmlNodePtr", "xmlNodePtr"),
- 'xmlXPathContextPtr': ('O', "xmlXPathContext", "xmlXPathContextPtr", "xmlXPathContextPtr"),
- 'xmlXPathContext *': ('O', "xpathContext", "xmlXPathContextPtr", "xmlXPathContextPtr"),
- 'xmlXPathParserContextPtr': ('O', "xmlXPathParserContext", "xmlXPathParserContextPtr", "xmlXPathParserContextPtr"),
- 'xmlParserCtxtPtr': ('O', "parserCtxt", "xmlParserCtxtPtr", "xmlParserCtxtPtr"),
- 'xmlParserCtxt *': ('O', "parserCtxt", "xmlParserCtxtPtr", "xmlParserCtxtPtr"),
- 'htmlParserCtxtPtr': ('O', "parserCtxt", "xmlParserCtxtPtr", "xmlParserCtxtPtr"),
- 'htmlParserCtxt *': ('O', "parserCtxt", "xmlParserCtxtPtr", "xmlParserCtxtPtr"),
- 'xmlValidCtxtPtr': ('O', "ValidCtxt", "xmlValidCtxtPtr", "xmlValidCtxtPtr"),
- 'xmlCatalogPtr': ('O', "catalog", "xmlCatalogPtr", "xmlCatalogPtr"),
- 'FILE *': ('O', "File", "FILEPtr", "FILE *"),
- 'xmlURIPtr': ('O', "URI", "xmlURIPtr", "xmlURIPtr"),
- 'xmlErrorPtr': ('O', "Error", "xmlErrorPtr", "xmlErrorPtr"),
- 'xmlOutputBufferPtr': ('O', "outputBuffer", "xmlOutputBufferPtr", "xmlOutputBufferPtr"),
- 'xmlParserInputBufferPtr': ('O', "inputBuffer", "xmlParserInputBufferPtr", "xmlParserInputBufferPtr"),
- 'xmlRegexpPtr': ('O', "xmlReg", "xmlRegexpPtr", "xmlRegexpPtr"),
- 'xmlTextReaderLocatorPtr': ('O', "xmlTextReaderLocator", "xmlTextReaderLocatorPtr", "xmlTextReaderLocatorPtr"),
- 'xmlTextReaderPtr': ('O', "xmlTextReader", "xmlTextReaderPtr", "xmlTextReaderPtr"),
- 'xmlRelaxNGPtr': ('O', "relaxNgSchema", "xmlRelaxNGPtr", "xmlRelaxNGPtr"),
- 'xmlRelaxNGParserCtxtPtr': ('O', "relaxNgParserCtxt", "xmlRelaxNGParserCtxtPtr", "xmlRelaxNGParserCtxtPtr"),
- 'xmlRelaxNGValidCtxtPtr': ('O', "relaxNgValidCtxt", "xmlRelaxNGValidCtxtPtr", "xmlRelaxNGValidCtxtPtr"),
- 'xmlSchemaPtr': ('O', "Schema", "xmlSchemaPtr", "xmlSchemaPtr"),
- 'xmlSchemaParserCtxtPtr': ('O', "SchemaParserCtxt", "xmlSchemaParserCtxtPtr", "xmlSchemaParserCtxtPtr"),
- 'xmlSchemaValidCtxtPtr': ('O', "SchemaValidCtxt", "xmlSchemaValidCtxtPtr", "xmlSchemaValidCtxtPtr"),
-}
-
-py_return_types = {
- 'xmlXPathObjectPtr': ('O', "foo", "xmlXPathObjectPtr", "xmlXPathObjectPtr"),
-}
-
-unknown_types = {}
-
-foreign_encoding_args = (
- 'htmlCreateMemoryParserCtxt',
- 'htmlCtxtReadMemory',
- 'htmlParseChunk',
- 'htmlReadMemory',
- 'xmlCreateMemoryParserCtxt',
- 'xmlCtxtReadMemory',
- 'xmlCtxtResetPush',
- 'xmlParseChunk',
- 'xmlParseMemory',
- 'xmlReadMemory',
- 'xmlRecoverMemory',
-)
-
-#######################################################################
-#
-# This part writes the C <-> Python stubs libxml2-py.[ch] and
-# the table libxml2-export.c to add when registrering the Python module
-#
-#######################################################################
-
-# Class methods which are written by hand in libxml.c but the Python-level
-# code is still automatically generated (so they are not in skip_function()).
-skip_impl = (
- 'xmlSaveFileTo',
- 'xmlSaveFormatFileTo',
-)
-
-def skip_function(name):
- if name[0:12] == "xmlXPathWrap":
- return 1
- if name == "xmlFreeParserCtxt":
- return 1
- if name == "xmlCleanupParser":
- return 1
- if name == "xmlFreeTextReader":
- return 1
-# if name[0:11] == "xmlXPathNew":
-# return 1
- # the next function is defined in libxml.c
- if name == "xmlRelaxNGFreeValidCtxt":
- return 1
- if name == "xmlFreeValidCtxt":
- return 1
- if name == "xmlSchemaFreeValidCtxt":
- return 1
-
-#
-# Those are skipped because the Const version is used of the bindings
-# instead.
-#
- if name == "xmlTextReaderBaseUri":
- return 1
- if name == "xmlTextReaderLocalName":
- return 1
- if name == "xmlTextReaderName":
- return 1
- if name == "xmlTextReaderNamespaceUri":
- return 1
- if name == "xmlTextReaderPrefix":
- return 1
- if name == "xmlTextReaderXmlLang":
- return 1
- if name == "xmlTextReaderValue":
- return 1
- if name == "xmlOutputBufferClose": # handled by by the superclass
- return 1
- if name == "xmlOutputBufferFlush": # handled by by the superclass
- return 1
- if name == "xmlErrMemory":
- return 1
-
- if name == "xmlValidBuildContentModel":
- return 1
- if name == "xmlValidateElementDecl":
- return 1
- if name == "xmlValidateAttributeDecl":
- return 1
- if name == "xmlPopInputCallbacks":
- return 1
-
- return 0
-
-def print_function_wrapper(name, output, export, include):
- global py_types
- global unknown_types
- global functions
- global skipped_modules
-
- try:
- (desc, ret, args, file, cond) = functions[name]
- except:
- print("failed to get function %s infos")
- return
-
- if file in skipped_modules:
- return 0
- if skip_function(name) == 1:
- return 0
- if name in skip_impl:
- # Don't delete the function entry in the caller.
- return 1
-
- c_call = ""
- format=""
- format_args=""
- c_args=""
- c_return=""
- c_convert=""
- c_release=""
- num_bufs=0
- for arg in args:
- # This should be correct
- if arg[1][0:6] == "const ":
- arg[1] = arg[1][6:]
- c_args = c_args + " %s %s;\n" % (arg[1], arg[0])
- if arg[1] in py_types:
- (f, t, n, c) = py_types[arg[1]]
- if (f == 'z') and (name in foreign_encoding_args) and (num_bufs == 0):
- f = 's#'
- if f != None:
- format = format + f
- if t != None:
- format_args = format_args + ", &pyobj_%s" % (arg[0])
- c_args = c_args + " PyObject *pyobj_%s;\n" % (arg[0])
- c_convert = c_convert + \
- " %s = (%s) Py%s_Get(pyobj_%s);\n" % (arg[0],
- arg[1], t, arg[0])
- else:
- format_args = format_args + ", &%s" % (arg[0])
- if f == 's#':
- format_args = format_args + ", &py_buffsize%d" % num_bufs
- c_args = c_args + " int py_buffsize%d;\n" % num_bufs
- num_bufs = num_bufs + 1
- if c_call != "":
- c_call = c_call + ", "
- c_call = c_call + "%s" % (arg[0])
- if t == "File":
- c_release = c_release + \
- " PyFile_Release(%s);\n" % (arg[0])
- else:
- if arg[1] in skipped_types:
- return 0
- if arg[1] in unknown_types:
- lst = unknown_types[arg[1]]
- lst.append(name)
- else:
- unknown_types[arg[1]] = [name]
- return -1
- if format != "":
- format = format + ":%s" % (name)
-
- if ret[0] == 'void':
- if file == "python_accessor":
- if args[1][1] == "char *" or args[1][1] == "xmlChar *":
- c_call = "\n if (%s->%s != NULL) xmlFree(%s->%s);\n" % (
- args[0][0], args[1][0], args[0][0], args[1][0])
- c_call = c_call + " %s->%s = (%s)xmlStrdup((const xmlChar *)%s);\n" % (args[0][0],
- args[1][0], args[1][1], args[1][0])
- else:
- c_call = "\n %s->%s = %s;\n" % (args[0][0], args[1][0],
- args[1][0])
- else:
- c_call = "\n %s(%s);\n" % (name, c_call)
- ret_convert = " Py_INCREF(Py_None);\n return(Py_None);\n"
- elif ret[0] in py_types:
- (f, t, n, c) = py_types[ret[0]]
- c_return = c_return + " %s c_retval;\n" % (ret[0])
- if file == "python_accessor" and ret[2] != None:
- c_call = "\n c_retval = %s->%s;\n" % (args[0][0], ret[2])
- else:
- c_call = "\n c_retval = %s(%s);\n" % (name, c_call)
- ret_convert = " py_retval = libxml_%sWrap((%s) c_retval);\n" % (n,c)
- ret_convert = ret_convert + " return(py_retval);\n"
- elif ret[0] in py_return_types:
- (f, t, n, c) = py_return_types[ret[0]]
- c_return = c_return + " %s c_retval;\n" % (ret[0])
- c_call = "\n c_retval = %s(%s);\n" % (name, c_call)
- ret_convert = " py_retval = libxml_%sWrap((%s) c_retval);\n" % (n,c)
- ret_convert = ret_convert + " return(py_retval);\n"
- else:
- if ret[0] in skipped_types:
- return 0
- if ret[0] in unknown_types:
- lst = unknown_types[ret[0]]
- lst.append(name)
- else:
- unknown_types[ret[0]] = [name]
- return -1
-
- if cond != None and cond != "":
- include.write("#if %s\n" % cond)
- export.write("#if %s\n" % cond)
- output.write("#if %s\n" % cond)
-
- include.write("PyObject * ")
- include.write("libxml_%s(PyObject *self, PyObject *args);\n" % (name))
-
- export.write(" { (char *)\"%s\", libxml_%s, METH_VARARGS, NULL },\n" %
- (name, name))
-
- if file == "python":
- # Those have been manually generated
- if cond != None and cond != "":
- include.write("#endif\n")
- export.write("#endif\n")
- output.write("#endif\n")
- return 1
- if file == "python_accessor" and ret[0] != "void" and ret[2] is None:
- # Those have been manually generated
- if cond != None and cond != "":
- include.write("#endif\n")
- export.write("#endif\n")
- output.write("#endif\n")
- return 1
-
- output.write("PyObject *\n")
- output.write("libxml_%s(PyObject *self ATTRIBUTE_UNUSED," % (name))
- output.write(" PyObject *args")
- if format == "":
- output.write(" ATTRIBUTE_UNUSED")
- output.write(") {\n")
- if ret[0] != 'void':
- output.write(" PyObject *py_retval;\n")
- if c_return != "":
- output.write(c_return)
- if c_args != "":
- output.write(c_args)
- if format != "":
- output.write("\n if (!PyArg_ParseTuple(args, (char *)\"%s\"%s))\n" %
- (format, format_args))
- output.write(" return(NULL);\n")
- if c_convert != "":
- output.write(c_convert)
-
- output.write(c_call)
- if c_release != "":
- output.write(c_release)
- output.write(ret_convert)
- output.write("}\n\n")
- if cond != None and cond != "":
- include.write("#endif /* %s */\n" % cond)
- export.write("#endif /* %s */\n" % cond)
- output.write("#endif /* %s */\n" % cond)
- return 1
-
-def buildStubs():
- global py_types
- global py_return_types
- global unknown_types
-
- try:
- f = open(os.path.join(srcPref,"libxml2-api.xml"))
- data = f.read()
- (parser, target) = getparser()
- parser.feed(data)
- parser.close()
- except IOError as msg:
- try:
- f = open(os.path.join(srcPref,"..","doc","libxml2-api.xml"))
- data = f.read()
- (parser, target) = getparser()
- parser.feed(data)
- parser.close()
- except IOError as msg:
- print(file, ":", msg)
- sys.exit(1)
-
- n = len(list(functions.keys()))
- print("Found %d functions in libxml2-api.xml" % (n))
-
- py_types['pythonObject'] = ('O', "pythonObject", "pythonObject", "pythonObject")
- try:
- f = open(os.path.join(srcPref,"libxml2-python-api.xml"))
- data = f.read()
- (parser, target) = getparser()
- parser.feed(data)
- parser.close()
- except IOError as msg:
- print(file, ":", msg)
-
-
- print("Found %d functions in libxml2-python-api.xml" % (
- len(list(functions.keys())) - n))
- nb_wrap = 0
- failed = 0
- skipped = 0
-
- include = open("libxml2-py.h", "w")
- include.write("/* Generated */\n\n")
- export = open("libxml2-export.c", "w")
- export.write("/* Generated */\n\n")
- wrapper = open("libxml2-py.c", "w")
- wrapper.write("/* Generated */\n\n")
- wrapper.write("#include <Python.h>\n")
- wrapper.write("#include <libxml/xmlversion.h>\n")
- wrapper.write("#include <libxml/tree.h>\n")
- wrapper.write("#include <libxml/xmlschemastypes.h>\n")
- wrapper.write("#include \"libxml_wrap.h\"\n")
- wrapper.write("#include \"libxml2-py.h\"\n\n")
- for function in sorted(functions.keys()):
- ret = print_function_wrapper(function, wrapper, export, include)
- if ret < 0:
- failed = failed + 1
- del functions[function]
- if ret == 0:
- skipped = skipped + 1
- del functions[function]
- if ret == 1:
- nb_wrap = nb_wrap + 1
- include.close()
- export.close()
- wrapper.close()
-
- print("Generated %d wrapper functions, %d failed, %d skipped\n" % (nb_wrap,
- failed, skipped))
- print("Missing type converters: ")
- for type in list(unknown_types.keys()):
- print("%s:%d " % (type, len(unknown_types[type])))
- print()
-
-#######################################################################
-#
-# This part writes part of the Python front-end classes based on
-# mapping rules between types and classes and also based on function
-# renaming to get consistent function names at the Python level
-#
-#######################################################################
-
-#
-# The type automatically remapped to generated classes
-#
-classes_type = {
- "xmlNodePtr": ("._o", "xmlNode(_obj=%s)", "xmlNode"),
- "xmlNode *": ("._o", "xmlNode(_obj=%s)", "xmlNode"),
- "xmlDocPtr": ("._o", "xmlDoc(_obj=%s)", "xmlDoc"),
- "xmlDoc *": ("._o", "xmlDoc(_obj=%s)", "xmlDoc"),
- "htmlDocPtr": ("._o", "xmlDoc(_obj=%s)", "xmlDoc"),
- "htmlxmlDocPtr *": ("._o", "xmlDoc(_obj=%s)", "xmlDoc"),
- "xmlAttrPtr": ("._o", "xmlAttr(_obj=%s)", "xmlAttr"),
- "xmlAttr *": ("._o", "xmlAttr(_obj=%s)", "xmlAttr"),
- "xmlNsPtr": ("._o", "xmlNs(_obj=%s)", "xmlNs"),
- "xmlNs *": ("._o", "xmlNs(_obj=%s)", "xmlNs"),
- "xmlDtdPtr": ("._o", "xmlDtd(_obj=%s)", "xmlDtd"),
- "xmlDtd *": ("._o", "xmlDtd(_obj=%s)", "xmlDtd"),
- "xmlEntityPtr": ("._o", "xmlEntity(_obj=%s)", "xmlEntity"),
- "xmlEntity *": ("._o", "xmlEntity(_obj=%s)", "xmlEntity"),
- "xmlElementPtr": ("._o", "xmlElement(_obj=%s)", "xmlElement"),
- "xmlElement *": ("._o", "xmlElement(_obj=%s)", "xmlElement"),
- "xmlAttributePtr": ("._o", "xmlAttribute(_obj=%s)", "xmlAttribute"),
- "xmlAttribute *": ("._o", "xmlAttribute(_obj=%s)", "xmlAttribute"),
- "xmlXPathContextPtr": ("._o", "xpathContext(_obj=%s)", "xpathContext"),
- "xmlXPathContext *": ("._o", "xpathContext(_obj=%s)", "xpathContext"),
- "xmlXPathParserContext *": ("._o", "xpathParserContext(_obj=%s)", "xpathParserContext"),
- "xmlXPathParserContextPtr": ("._o", "xpathParserContext(_obj=%s)", "xpathParserContext"),
- "xmlParserCtxtPtr": ("._o", "parserCtxt(_obj=%s)", "parserCtxt"),
- "xmlParserCtxt *": ("._o", "parserCtxt(_obj=%s)", "parserCtxt"),
- "htmlParserCtxtPtr": ("._o", "parserCtxt(_obj=%s)", "parserCtxt"),
- "htmlParserCtxt *": ("._o", "parserCtxt(_obj=%s)", "parserCtxt"),
- "xmlValidCtxtPtr": ("._o", "ValidCtxt(_obj=%s)", "ValidCtxt"),
- "xmlCatalogPtr": ("._o", "catalog(_obj=%s)", "catalog"),
- "xmlURIPtr": ("._o", "URI(_obj=%s)", "URI"),
- "xmlErrorPtr": ("._o", "Error(_obj=%s)", "Error"),
- "xmlOutputBufferPtr": ("._o", "outputBuffer(_obj=%s)", "outputBuffer"),
- "xmlParserInputBufferPtr": ("._o", "inputBuffer(_obj=%s)", "inputBuffer"),
- "xmlRegexpPtr": ("._o", "xmlReg(_obj=%s)", "xmlReg"),
- "xmlTextReaderLocatorPtr": ("._o", "xmlTextReaderLocator(_obj=%s)", "xmlTextReaderLocator"),
- "xmlTextReaderPtr": ("._o", "xmlTextReader(_obj=%s)", "xmlTextReader"),
- 'xmlRelaxNGPtr': ('._o', "relaxNgSchema(_obj=%s)", "relaxNgSchema"),
- 'xmlRelaxNGParserCtxtPtr': ('._o', "relaxNgParserCtxt(_obj=%s)", "relaxNgParserCtxt"),
- 'xmlRelaxNGValidCtxtPtr': ('._o', "relaxNgValidCtxt(_obj=%s)", "relaxNgValidCtxt"),
- 'xmlSchemaPtr': ("._o", "Schema(_obj=%s)", "Schema"),
- 'xmlSchemaParserCtxtPtr': ("._o", "SchemaParserCtxt(_obj=%s)", "SchemaParserCtxt"),
- 'xmlSchemaValidCtxtPtr': ("._o", "SchemaValidCtxt(_obj=%s)", "SchemaValidCtxt"),
-}
-
-converter_type = {
- "xmlXPathObjectPtr": "xpathObjectRet(%s)",
-}
-
-primary_classes = ["xmlNode", "xmlDoc"]
-
-classes_ancestor = {
- "xmlNode" : "xmlCore",
- "xmlDtd" : "xmlNode",
- "xmlDoc" : "xmlNode",
- "xmlAttr" : "xmlNode",
- "xmlNs" : "xmlNode",
- "xmlEntity" : "xmlNode",
- "xmlElement" : "xmlNode",
- "xmlAttribute" : "xmlNode",
- "outputBuffer": "ioWriteWrapper",
- "inputBuffer": "ioReadWrapper",
- "parserCtxt": "parserCtxtCore",
- "xmlTextReader": "xmlTextReaderCore",
- "ValidCtxt": "ValidCtxtCore",
- "SchemaValidCtxt": "SchemaValidCtxtCore",
- "relaxNgValidCtxt": "relaxNgValidCtxtCore",
-}
-classes_destructors = {
- "parserCtxt": "xmlFreeParserCtxt",
- "catalog": "xmlFreeCatalog",
- "URI": "xmlFreeURI",
-# "outputBuffer": "xmlOutputBufferClose",
- "inputBuffer": "xmlFreeParserInputBuffer",
- "xmlReg": "xmlRegFreeRegexp",
- "xmlTextReader": "xmlFreeTextReader",
- "relaxNgSchema": "xmlRelaxNGFree",
- "relaxNgParserCtxt": "xmlRelaxNGFreeParserCtxt",
- "relaxNgValidCtxt": "xmlRelaxNGFreeValidCtxt",
- "Schema": "xmlSchemaFree",
- "SchemaParserCtxt": "xmlSchemaFreeParserCtxt",
- "SchemaValidCtxt": "xmlSchemaFreeValidCtxt",
- "ValidCtxt": "xmlFreeValidCtxt",
-}
-
-functions_noexcept = {
- "xmlHasProp": 1,
- "xmlHasNsProp": 1,
- "xmlDocSetRootElement": 1,
- "xmlNodeGetNs": 1,
- "xmlNodeGetNsDefs": 1,
- "xmlNextElementSibling": 1,
- "xmlPreviousElementSibling": 1,
- "xmlFirstElementChild": 1,
- "xmlLastElementChild": 1,
-}
-
-reference_keepers = {
- "xmlTextReader": [('inputBuffer', 'input')],
- "relaxNgValidCtxt": [('relaxNgSchema', 'schema')],
- "SchemaValidCtxt": [('Schema', 'schema')],
-}
-
-function_classes = {}
-
-function_classes["None"] = []
-
-def nameFixup(name, classe, type, file):
- listname = classe + "List"
- ll = len(listname)
- l = len(classe)
- if name[0:l] == listname:
- func = name[l:]
- func = func[0:1].lower() + func[1:]
- elif name[0:12] == "xmlParserGet" and file == "python_accessor":
- func = name[12:]
- func = func[0:1].lower() + func[1:]
- elif name[0:12] == "xmlParserSet" and file == "python_accessor":
- func = name[12:]
- func = func[0:1].lower() + func[1:]
- elif name[0:10] == "xmlNodeGet" and file == "python_accessor":
- func = name[10:]
- func = func[0:1].lower() + func[1:]
- elif name[0:9] == "xmlURIGet" and file == "python_accessor":
- func = name[9:]
- func = func[0:1].lower() + func[1:]
- elif name[0:9] == "xmlURISet" and file == "python_accessor":
- func = name[6:]
- func = func[0:1].lower() + func[1:]
- elif name[0:11] == "xmlErrorGet" and file == "python_accessor":
- func = name[11:]
- func = func[0:1].lower() + func[1:]
- elif name[0:17] == "xmlXPathParserGet" and file == "python_accessor":
- func = name[17:]
- func = func[0:1].lower() + func[1:]
- elif name[0:11] == "xmlXPathGet" and file == "python_accessor":
- func = name[11:]
- func = func[0:1].lower() + func[1:]
- elif name[0:11] == "xmlXPathSet" and file == "python_accessor":
- func = name[8:]
- func = func[0:1].lower() + func[1:]
- elif name[0:15] == "xmlOutputBuffer" and file != "python":
- func = name[15:]
- func = func[0:1].lower() + func[1:]
- elif name[0:20] == "xmlParserInputBuffer" and file != "python":
- func = name[20:]
- func = func[0:1].lower() + func[1:]
- elif name[0:9] == "xmlRegexp" and file == "xmlregexp":
- func = "regexp" + name[9:]
- elif name[0:6] == "xmlReg" and file == "xmlregexp":
- func = "regexp" + name[6:]
- elif name[0:20] == "xmlTextReaderLocator" and file == "xmlreader":
- func = name[20:]
- elif name[0:18] == "xmlTextReaderConst" and file == "xmlreader":
- func = name[18:]
- elif name[0:13] == "xmlTextReader" and file == "xmlreader":
- func = name[13:]
- elif name[0:12] == "xmlReaderNew" and file == "xmlreader":
- func = name[9:]
- elif name[0:11] == "xmlACatalog":
- func = name[11:]
- func = func[0:1].lower() + func[1:]
- elif name[0:l] == classe:
- func = name[l:]
- func = func[0:1].lower() + func[1:]
- elif name[0:7] == "libxml_":
- func = name[7:]
- func = func[0:1].lower() + func[1:]
- elif name[0:6] == "xmlGet":
- func = name[6:]
- func = func[0:1].lower() + func[1:]
- elif name[0:3] == "xml":
- func = name[3:]
- func = func[0:1].lower() + func[1:]
- else:
- func = name
- if func[0:5] == "xPath":
- func = "xpath" + func[5:]
- elif func[0:4] == "xPtr":
- func = "xpointer" + func[4:]
- elif func[0:8] == "xInclude":
- func = "xinclude" + func[8:]
- elif func[0:2] == "iD":
- func = "ID" + func[2:]
- elif func[0:3] == "uRI":
- func = "URI" + func[3:]
- elif func[0:4] == "uTF8":
- func = "UTF8" + func[4:]
- elif func[0:3] == 'sAX':
- func = "SAX" + func[3:]
- return func
-
-
-def functionCompare(info1, info2):
- (index1, func1, name1, ret1, args1, file1) = info1
- (index2, func2, name2, ret2, args2, file2) = info2
- if file1 == file2:
- if func1 < func2:
- return -1
- if func1 > func2:
- return 1
- if file1 == "python_accessor":
- return -1
- if file2 == "python_accessor":
- return 1
- if file1 < file2:
- return -1
- if file1 > file2:
- return 1
- return 0
-
-def cmp_to_key(mycmp):
- 'Convert a cmp= function into a key= function'
- class K(object):
- def __init__(self, obj, *args):
- self.obj = obj
- def __lt__(self, other):
- return mycmp(self.obj, other.obj) < 0
- def __gt__(self, other):
- return mycmp(self.obj, other.obj) > 0
- def __eq__(self, other):
- return mycmp(self.obj, other.obj) == 0
- def __le__(self, other):
- return mycmp(self.obj, other.obj) <= 0
- def __ge__(self, other):
- return mycmp(self.obj, other.obj) >= 0
- def __ne__(self, other):
- return mycmp(self.obj, other.obj) != 0
- return K
-def writeDoc(name, args, indent, output):
- if functions[name][0] is None or functions[name][0] == "":
- return
- val = functions[name][0]
- val = val.replace("NULL", "None")
- output.write(indent)
- output.write('"""')
- while len(val) > 60:
- if val[0] == " ":
- val = val[1:]
- continue
- str = val[0:60]
- i = str.rfind(" ")
- if i < 0:
- i = 60
- str = val[0:i]
- val = val[i:]
- output.write(str)
- output.write('\n ')
- output.write(indent)
- output.write(val)
- output.write(' """\n')
-
-def buildWrappers():
- global ctypes
- global py_types
- global py_return_types
- global unknown_types
- global functions
- global function_classes
- global classes_type
- global classes_list
- global converter_type
- global primary_classes
- global converter_type
- global classes_ancestor
- global converter_type
- global primary_classes
- global classes_ancestor
- global classes_destructors
- global functions_noexcept
-
- for type in classes_type.keys():
- function_classes[classes_type[type][2]] = []
-
- #
- # Build the list of C types to look for ordered to start
- # with primary classes
- #
- ctypes = []
- classes_list = []
- ctypes_processed = {}
- classes_processed = {}
- for classe in primary_classes:
- classes_list.append(classe)
- classes_processed[classe] = ()
- for type in classes_type.keys():
- tinfo = classes_type[type]
- if tinfo[2] == classe:
- ctypes.append(type)
- ctypes_processed[type] = ()
- for type in sorted(classes_type.keys()):
- if type in ctypes_processed:
- continue
- tinfo = classes_type[type]
- if tinfo[2] not in classes_processed:
- classes_list.append(tinfo[2])
- classes_processed[tinfo[2]] = ()
-
- ctypes.append(type)
- ctypes_processed[type] = ()
-
- for name in functions.keys():
- found = 0
- (desc, ret, args, file, cond) = functions[name]
- for type in ctypes:
- classe = classes_type[type][2]
-
- if name[0:3] == "xml" and len(args) >= 1 and args[0][1] == type:
- found = 1
- func = nameFixup(name, classe, type, file)
- info = (0, func, name, ret, args, file)
- function_classes[classe].append(info)
- elif name[0:3] == "xml" and len(args) >= 2 and args[1][1] == type \
- and file != "python_accessor":
- found = 1
- func = nameFixup(name, classe, type, file)
- info = (1, func, name, ret, args, file)
- function_classes[classe].append(info)
- elif name[0:4] == "html" and len(args) >= 1 and args[0][1] == type:
- found = 1
- func = nameFixup(name, classe, type, file)
- info = (0, func, name, ret, args, file)
- function_classes[classe].append(info)
- elif name[0:4] == "html" and len(args) >= 2 and args[1][1] == type \
- and file != "python_accessor":
- found = 1
- func = nameFixup(name, classe, type, file)
- info = (1, func, name, ret, args, file)
- function_classes[classe].append(info)
- if found == 1:
- continue
- if name[0:8] == "xmlXPath":
- continue
- if name[0:6] == "xmlStr":
- continue
- if name[0:10] == "xmlCharStr":
- continue
- func = nameFixup(name, "None", file, file)
- info = (0, func, name, ret, args, file)
- function_classes['None'].append(info)
-
- classes = open("libxml2class.py", "w")
- txt = open("libxml2class.txt", "w")
- txt.write(" Generated Classes for libxml2-python\n\n")
-
- txt.write("#\n# Global functions of the module\n#\n\n")
- if "None" in function_classes:
- flist = function_classes["None"]
- flist = sorted(flist, key=cmp_to_key(functionCompare))
- oldfile = ""
- for info in flist:
- (index, func, name, ret, args, file) = info
- if file != oldfile:
- classes.write("#\n# Functions from module %s\n#\n\n" % file)
- txt.write("\n# functions from module %s\n" % file)
- oldfile = file
- classes.write("def %s(" % func)
- txt.write("%s()\n" % func)
- n = 0
- for arg in args:
- if n != 0:
- classes.write(", ")
- classes.write("%s" % arg[0])
- n = n + 1
- classes.write("):\n")
- writeDoc(name, args, ' ', classes)
-
- for arg in args:
- if arg[1] in classes_type:
- classes.write(" if %s is None: %s__o = None\n" %
- (arg[0], arg[0]))
- classes.write(" else: %s__o = %s%s\n" %
- (arg[0], arg[0], classes_type[arg[1]][0]))
- if arg[1] in py_types:
- (f, t, n, c) = py_types[arg[1]]
- if t == "File":
- classes.write(" if %s is not None: %s.flush()\n" % (
- arg[0], arg[0]))
-
- if ret[0] != "void":
- classes.write(" ret = ")
- else:
- classes.write(" ")
- classes.write("libxml2mod.%s(" % name)
- n = 0
- for arg in args:
- if n != 0:
- classes.write(", ")
- classes.write("%s" % arg[0])
- if arg[1] in classes_type:
- classes.write("__o")
- n = n + 1
- classes.write(")\n")
-
-# This may be needed to reposition the I/O, but likely to cause more harm
-# than good. Those changes in Python3 really break the model.
-# for arg in args:
-# if arg[1] in py_types:
-# (f, t, n, c) = py_types[arg[1]]
-# if t == "File":
-# classes.write(" if %s is not None: %s.seek(0,0)\n"%(
-# arg[0], arg[0]))
-
- if ret[0] != "void":
- if ret[0] in classes_type:
- #
- # Raise an exception
- #
- if name in functions_noexcept:
- classes.write(" if ret is None:return None\n")
- elif name.find("URI") >= 0:
- classes.write(
- " if ret is None:raise uriError('%s() failed')\n"
- % (name))
- elif name.find("XPath") >= 0:
- classes.write(
- " if ret is None:raise xpathError('%s() failed')\n"
- % (name))
- elif name.find("Parse") >= 0:
- classes.write(
- " if ret is None:raise parserError('%s() failed')\n"
- % (name))
- else:
- classes.write(
- " if ret is None:raise treeError('%s() failed')\n"
- % (name))
- classes.write(" return ")
- classes.write(classes_type[ret[0]][1] % ("ret"))
- classes.write("\n")
- else:
- classes.write(" return ret\n")
- classes.write("\n")
-
- txt.write("\n\n#\n# Set of classes of the module\n#\n\n")
- for classname in classes_list:
- if classname == "None":
- pass
- else:
- if classname in classes_ancestor:
- txt.write("\n\nClass %s(%s)\n" % (classname,
- classes_ancestor[classname]))
- classes.write("class %s(%s):\n" % (classname,
- classes_ancestor[classname]))
- classes.write(" def __init__(self, _obj=None):\n")
- if classes_ancestor[classname] == "xmlCore" or \
- classes_ancestor[classname] == "xmlNode":
- classes.write(" if checkWrapper(_obj) != 0:")
- classes.write(" raise TypeError")
- classes.write("('%s got a wrong wrapper object type')\n" % \
- classname)
- if classname in reference_keepers:
- rlist = reference_keepers[classname]
- for ref in rlist:
- classes.write(" self.%s = None\n" % ref[1])
- classes.write(" self._o = _obj\n")
- classes.write(" %s.__init__(self, _obj=_obj)\n\n" % (
- classes_ancestor[classname]))
- if classes_ancestor[classname] == "xmlCore" or \
- classes_ancestor[classname] == "xmlNode":
- classes.write(" def __repr__(self):\n")
- format = "<%s (%%s) object at 0x%%x>" % (classname)
- classes.write(" return \"%s\" %% (self.name, int(pos_id (self)))\n\n" % (
- format))
- else:
- txt.write("Class %s()\n" % (classname))
- classes.write("class %s:\n" % (classname))
- classes.write(" def __init__(self, _obj=None):\n")
- if classname in reference_keepers:
- list = reference_keepers[classname]
- for ref in list:
- classes.write(" self.%s = None\n" % ref[1])
- classes.write(" if _obj != None:self._o = _obj;return\n")
- classes.write(" self._o = None\n\n")
- destruct=None
- if classname in classes_destructors:
- classes.write(" def __del__(self):\n")
- classes.write(" if self._o != None:\n")
- classes.write(" libxml2mod.%s(self._o)\n" %
- classes_destructors[classname])
- classes.write(" self._o = None\n\n")
- destruct=classes_destructors[classname]
- flist = function_classes[classname]
- flist = sorted(flist, key=cmp_to_key(functionCompare))
- oldfile = ""
- for info in flist:
- (index, func, name, ret, args, file) = info
- #
- # Do not provide as method the destructors for the class
- # to avoid double free
- #
- if name == destruct:
- continue
- if file != oldfile:
- if file == "python_accessor":
- classes.write(" # accessors for %s\n" % (classname))
- txt.write(" # accessors\n")
- else:
- classes.write(" #\n")
- classes.write(" # %s functions from module %s\n" % (
- classname, file))
- txt.write("\n # functions from module %s\n" % file)
- classes.write(" #\n\n")
- oldfile = file
- classes.write(" def %s(self" % func)
- txt.write(" %s()\n" % func)
- n = 0
- for arg in args:
- if n != index:
- classes.write(", %s" % arg[0])
- n = n + 1
- classes.write("):\n")
- writeDoc(name, args, ' ', classes)
- n = 0
- for arg in args:
- if arg[1] in classes_type:
- if n != index:
- classes.write(" if %s is None: %s__o = None\n" %
- (arg[0], arg[0]))
- classes.write(" else: %s__o = %s%s\n" %
- (arg[0], arg[0], classes_type[arg[1]][0]))
- n = n + 1
- if ret[0] != "void":
- classes.write(" ret = ")
- else:
- classes.write(" ")
- classes.write("libxml2mod.%s(" % name)
- n = 0
- for arg in args:
- if n != 0:
- classes.write(", ")
- if n != index:
- classes.write("%s" % arg[0])
- if arg[1] in classes_type:
- classes.write("__o")
- else:
- classes.write("self")
- if arg[1] in classes_type:
- classes.write(classes_type[arg[1]][0])
- n = n + 1
- classes.write(")\n")
- if ret[0] != "void":
- if ret[0] in classes_type:
- #
- # Raise an exception
- #
- if name in functions_noexcept:
- classes.write(
- " if ret is None:return None\n")
- elif name.find("URI") >= 0:
- classes.write(
- " if ret is None:raise uriError('%s() failed')\n"
- % (name))
- elif name.find("XPath") >= 0:
- classes.write(
- " if ret is None:raise xpathError('%s() failed')\n"
- % (name))
- elif name.find("Parse") >= 0:
- classes.write(
- " if ret is None:raise parserError('%s() failed')\n"
- % (name))
- else:
- classes.write(
- " if ret is None:raise treeError('%s() failed')\n"
- % (name))
-
- #
- # generate the returned class wrapper for the object
- #
- classes.write(" __tmp = ")
- classes.write(classes_type[ret[0]][1] % ("ret"))
- classes.write("\n")
-
- #
- # Sometime one need to keep references of the source
- # class in the returned class object.
- # See reference_keepers for the list
- #
- tclass = classes_type[ret[0]][2]
- if tclass in reference_keepers:
- list = reference_keepers[tclass]
- for pref in list:
- if pref[0] == classname:
- classes.write(" __tmp.%s = self\n" %
- pref[1])
- #
- # return the class
- #
- classes.write(" return __tmp\n")
- elif ret[0] in converter_type:
- #
- # Raise an exception
- #
- if name in functions_noexcept:
- classes.write(
- " if ret is None:return None")
- elif name.find("URI") >= 0:
- classes.write(
- " if ret is None:raise uriError('%s() failed')\n"
- % (name))
- elif name.find("XPath") >= 0:
- classes.write(
- " if ret is None:raise xpathError('%s() failed')\n"
- % (name))
- elif name.find("Parse") >= 0:
- classes.write(
- " if ret is None:raise parserError('%s() failed')\n"
- % (name))
- else:
- classes.write(
- " if ret is None:raise treeError('%s() failed')\n"
- % (name))
- classes.write(" return ")
- classes.write(converter_type[ret[0]] % ("ret"))
- classes.write("\n")
- else:
- classes.write(" return ret\n")
- classes.write("\n")
-
- #
- # Generate enum constants
- #
- for type,enum in enums.items():
- classes.write("# %s\n" % type)
- items = enum.items()
- items = sorted(items, key=(lambda i: int(i[1])))
- for name,value in items:
- classes.write("%s = %s\n" % (name,value))
- classes.write("\n")
-
- txt.close()
- classes.close()
-
-buildStubs()
-buildWrappers()