1 import libxml2mod 2 import types 3 import sys 4 5 # The root of all libxml2 errors. 6 class libxmlError(Exception): pass 7 8 # Type of the wrapper class for the C objects wrappers 9 def checkWrapper(obj): 10 try: 11 n = type(_obj).__name__ 12 if n != 'PyCObject' and n != 'PyCapsule': 13 return 1 14 except: 15 return 0 16 return 0 17 18 # 19 # id() is sometimes negative ... 20 # 21 def pos_id(o): 22 i = id(o) 23 if (i < 0): 24 return (sys.maxsize - i) 25 return i 26 27 # 28 # Errors raised by the wrappers when some tree handling failed. 29 # 30 class treeError(libxmlError): 31 def __init__(self, msg): 32 self.msg = msg 33 def __str__(self): 34 return self.msg 35 36 class parserError(libxmlError): 37 def __init__(self, msg): 38 self.msg = msg 39 def __str__(self): 40 return self.msg 41 42 class uriError(libxmlError): 43 def __init__(self, msg): 44 self.msg = msg 45 def __str__(self): 46 return self.msg 47 48 class xpathError(libxmlError): 49 def __init__(self, msg): 50 self.msg = msg 51 def __str__(self): 52 return self.msg 53 54 class ioWrapper: 55 def __init__(self, _obj): 56 self.__io = _obj 57 self._o = None 58 59 def io_close(self): 60 if self.__io == None: 61 return(-1) 62 self.__io.close() 63 self.__io = None 64 return(0) 65 66 def io_flush(self): 67 if self.__io == None: 68 return(-1) 69 self.__io.flush() 70 return(0) 71 72 def io_read(self, len = -1): 73 if self.__io == None: 74 return(-1) 75 try: 76 if len < 0: 77 ret = self.__io.read() 78 else: 79 ret = self.__io.read(len) 80 except Exception: 81 import sys 82 e = sys.exc_info()[1] 83 print("failed to read from Python:", type(e)) 84 print("on IO:", self.__io) 85 self.__io == None 86 return(-1) 87 88 return(ret) 89 90 def io_write(self, str, len = -1): 91 if self.__io == None: 92 return(-1) 93 if len < 0: 94 return(self.__io.write(str)) 95 return(self.__io.write(str, len)) 96 97 class ioReadWrapper(ioWrapper): 98 def __init__(self, _obj, enc = ""): 99 ioWrapper.__init__(self, _obj) 100 self._o = libxml2mod.xmlCreateInputBuffer(self, enc) 101 102 def __del__(self): 103 print("__del__") 104 self.io_close() 105 if self._o != None: 106 libxml2mod.xmlFreeParserInputBuffer(self._o) 107 self._o = None 108 109 def close(self): 110 self.io_close() 111 if self._o != None: 112 libxml2mod.xmlFreeParserInputBuffer(self._o) 113 self._o = None 114 115 class ioWriteWrapper(ioWrapper): 116 def __init__(self, _obj, enc = ""): 117 # print "ioWriteWrapper.__init__", _obj 118 if type(_obj) == type(''): 119 print("write io from a string") 120 self.o = None 121 elif type(_obj).__name__ == 'PyCapsule': 122 file = libxml2mod.outputBufferGetPythonFile(_obj) 123 if file != None: 124 ioWrapper.__init__(self, file) 125 else: 126 ioWrapper.__init__(self, _obj) 127 self._o = _obj 128 # elif type(_obj) == types.InstanceType: 129 # print(("write io from instance of %s" % (_obj.__class__))) 130 # ioWrapper.__init__(self, _obj) 131 # self._o = libxml2mod.xmlCreateOutputBuffer(self, enc) 132 else: 133 file = libxml2mod.outputBufferGetPythonFile(_obj) 134 if file != None: 135 ioWrapper.__init__(self, file) 136 else: 137 ioWrapper.__init__(self, _obj) 138 self._o = _obj 139 140 def __del__(self): 141 # print "__del__" 142 self.io_close() 143 if self._o != None: 144 libxml2mod.xmlOutputBufferClose(self._o) 145 self._o = None 146 147 def flush(self): 148 self.io_flush() 149 if self._o != None: 150 libxml2mod.xmlOutputBufferClose(self._o) 151 self._o = None 152 153 def close(self): 154 self.io_flush() 155 if self._o != None: 156 libxml2mod.xmlOutputBufferClose(self._o) 157 self._o = None 158 159 # 160 # Example of a class to handle SAX events 161 # 162 class SAXCallback: 163 """Base class for SAX handlers""" 164 def startDocument(self): 165 """called at the start of the document""" 166 pass 167 168 def endDocument(self): 169 """called at the end of the document""" 170 pass 171 172 def startElement(self, tag, attrs): 173 """called at the start of every element, tag is the name of 174 the element, attrs is a dictionary of the element's attributes""" 175 pass 176 177 def endElement(self, tag): 178 """called at the start of every element, tag is the name of 179 the element""" 180 pass 181 182 def characters(self, data): 183 """called when character data have been read, data is the string 184 containing the data, multiple consecutive characters() callback 185 are possible.""" 186 pass 187 188 def cdataBlock(self, data): 189 """called when CDATA section have been read, data is the string 190 containing the data, multiple consecutive cdataBlock() callback 191 are possible.""" 192 pass 193 194 def reference(self, name): 195 """called when an entity reference has been found""" 196 pass 197 198 def ignorableWhitespace(self, data): 199 """called when potentially ignorable white spaces have been found""" 200 pass 201 202 def processingInstruction(self, target, data): 203 """called when a PI has been found, target contains the PI name and 204 data is the associated data in the PI""" 205 pass 206 207 def comment(self, content): 208 """called when a comment has been found, content contains the comment""" 209 pass 210 211 def externalSubset(self, name, externalID, systemID): 212 """called when a DOCTYPE declaration has been found, name is the 213 DTD name and externalID, systemID are the DTD public and system 214 identifier for that DTd if available""" 215 pass 216 217 def internalSubset(self, name, externalID, systemID): 218 """called when a DOCTYPE declaration has been found, name is the 219 DTD name and externalID, systemID are the DTD public and system 220 identifier for that DTD if available""" 221 pass 222 223 def entityDecl(self, name, type, externalID, systemID, content): 224 """called when an ENTITY declaration has been found, name is the 225 entity name and externalID, systemID are the entity public and 226 system identifier for that entity if available, type indicates 227 the entity type, and content reports it's string content""" 228 pass 229 230 def notationDecl(self, name, externalID, systemID): 231 """called when an NOTATION declaration has been found, name is the 232 notation name and externalID, systemID are the notation public and 233 system identifier for that notation if available""" 234 pass 235 236 def attributeDecl(self, elem, name, type, defi, defaultValue, nameList): 237 """called when an ATTRIBUTE definition has been found""" 238 pass 239 240 def elementDecl(self, name, type, content): 241 """called when an ELEMENT definition has been found""" 242 pass 243 244 def entityDecl(self, name, publicId, systemID, notationName): 245 """called when an unparsed ENTITY declaration has been found, 246 name is the entity name and publicId,, systemID are the entity 247 public and system identifier for that entity if available, 248 and notationName indicate the associated NOTATION""" 249 pass 250 251 def warning(self, msg): 252 #print msg 253 pass 254 255 def error(self, msg): 256 raise parserError(msg) 257 258 def fatalError(self, msg): 259 raise parserError(msg) 260 261 # 262 # This class is the ancestor of all the Node classes. It provides 263 # the basic functionalities shared by all nodes (and handle 264 # gracefylly the exception), like name, navigation in the tree, 265 # doc reference, content access and serializing to a string or URI 266 # 267 class xmlCore: 268 def __init__(self, _obj=None): 269 if _obj != None: 270 self._o = _obj; 271 return 272 self._o = None 273 274 def __eq__(self, other): 275 if other == None: 276 return False 277 ret = libxml2mod.compareNodesEqual(self._o, other._o) 278 if ret == None: 279 return False 280 return ret == True 281 def __ne__(self, other): 282 if other == None: 283 return True 284 ret = libxml2mod.compareNodesEqual(self._o, other._o) 285 return not ret 286 def __hash__(self): 287 ret = libxml2mod.nodeHash(self._o) 288 return ret 289 290 def __str__(self): 291 return self.serialize() 292 def get_parent(self): 293 ret = libxml2mod.parent(self._o) 294 if ret == None: 295 return None 296 return nodeWrap(ret) 297 def get_children(self): 298 ret = libxml2mod.children(self._o) 299 if ret == None: 300 return None 301 return nodeWrap(ret) 302 def get_last(self): 303 ret = libxml2mod.last(self._o) 304 if ret == None: 305 return None 306 return nodeWrap(ret) 307 def get_next(self): 308 ret = libxml2mod.next(self._o) 309 if ret == None: 310 return None 311 return nodeWrap(ret) 312 def get_properties(self): 313 ret = libxml2mod.properties(self._o) 314 if ret == None: 315 return None 316 return xmlAttr(_obj=ret) 317 def get_prev(self): 318 ret = libxml2mod.prev(self._o) 319 if ret == None: 320 return None 321 return nodeWrap(ret) 322 def get_content(self): 323 return libxml2mod.xmlNodeGetContent(self._o) 324 getContent = get_content # why is this duplicate naming needed ? 325 def get_name(self): 326 return libxml2mod.name(self._o) 327 def get_type(self): 328 return libxml2mod.type(self._o) 329 def get_doc(self): 330 ret = libxml2mod.doc(self._o) 331 if ret == None: 332 if self.type in ["document_xml", "document_html"]: 333 return xmlDoc(_obj=self._o) 334 else: 335 return None 336 return xmlDoc(_obj=ret) 337 # 338 # Those are common attributes to nearly all type of nodes 339 # defined as python2 properties 340 # 341 import sys 342 if float(sys.version[0:3]) < 2.2: 343 def __getattr__(self, attr): 344 if attr == "parent": 345 ret = libxml2mod.parent(self._o) 346 if ret == None: 347 return None 348 return nodeWrap(ret) 349 elif attr == "properties": 350 ret = libxml2mod.properties(self._o) 351 if ret == None: 352 return None 353 return xmlAttr(_obj=ret) 354 elif attr == "children": 355 ret = libxml2mod.children(self._o) 356 if ret == None: 357 return None 358 return nodeWrap(ret) 359 elif attr == "last": 360 ret = libxml2mod.last(self._o) 361 if ret == None: 362 return None 363 return nodeWrap(ret) 364 elif attr == "next": 365 ret = libxml2mod.next(self._o) 366 if ret == None: 367 return None 368 return nodeWrap(ret) 369 elif attr == "prev": 370 ret = libxml2mod.prev(self._o) 371 if ret == None: 372 return None 373 return nodeWrap(ret) 374 elif attr == "content": 375 return libxml2mod.xmlNodeGetContent(self._o) 376 elif attr == "name": 377 return libxml2mod.name(self._o) 378 elif attr == "type": 379 return libxml2mod.type(self._o) 380 elif attr == "doc": 381 ret = libxml2mod.doc(self._o) 382 if ret == None: 383 if self.type == "document_xml" or self.type == "document_html": 384 return xmlDoc(_obj=self._o) 385 else: 386 return None 387 return xmlDoc(_obj=ret) 388 raise AttributeError(attr) 389 else: 390 parent = property(get_parent, None, None, "Parent node") 391 children = property(get_children, None, None, "First child node") 392 last = property(get_last, None, None, "Last sibling node") 393 next = property(get_next, None, None, "Next sibling node") 394 prev = property(get_prev, None, None, "Previous sibling node") 395 properties = property(get_properties, None, None, "List of properies") 396 content = property(get_content, None, None, "Content of this node") 397 name = property(get_name, None, None, "Node name") 398 type = property(get_type, None, None, "Node type") 399 doc = property(get_doc, None, None, "The document this node belongs to") 400 401 # 402 # Serialization routines, the optional arguments have the following 403 # meaning: 404 # encoding: string to ask saving in a specific encoding 405 # indent: if 1 the serializer is asked to indent the output 406 # 407 def serialize(self, encoding = None, format = 0): 408 return libxml2mod.serializeNode(self._o, encoding, format) 409 def saveTo(self, file, encoding = None, format = 0): 410 return libxml2mod.saveNodeTo(self._o, file, encoding, format) 411 412 # 413 # Canonicalization routines: 414 # 415 # nodes: the node set (tuple or list) to be included in the 416 # canonized image or None if all document nodes should be 417 # included. 418 # exclusive: the exclusive flag (0 - non-exclusive 419 # canonicalization; otherwise - exclusive canonicalization) 420 # prefixes: the list of inclusive namespace prefixes (strings), 421 # or None if there is no inclusive namespaces (only for 422 # exclusive canonicalization, ignored otherwise) 423 # with_comments: include comments in the result (!=0) or not 424 # (==0) 425 def c14nMemory(self, 426 nodes=None, 427 exclusive=0, 428 prefixes=None, 429 with_comments=0): 430 if nodes: 431 nodes = [n._o for n in nodes] 432 return libxml2mod.xmlC14NDocDumpMemory( 433 self.get_doc()._o, 434 nodes, 435 exclusive != 0, 436 prefixes, 437 with_comments != 0) 438 def c14nSaveTo(self, 439 file, 440 nodes=None, 441 exclusive=0, 442 prefixes=None, 443 with_comments=0): 444 if nodes: 445 nodes = [n._o for n in nodes] 446 return libxml2mod.xmlC14NDocSaveTo( 447 self.get_doc()._o, 448 nodes, 449 exclusive != 0, 450 prefixes, 451 with_comments != 0, 452 file) 453 454 # 455 # Selecting nodes using XPath, a bit slow because the context 456 # is allocated/freed every time but convenient. 457 # 458 def xpathEval(self, expr): 459 doc = self.doc 460 if doc == None: 461 return None 462 ctxt = doc.xpathNewContext() 463 ctxt.setContextNode(self) 464 res = ctxt.xpathEval(expr) 465 ctxt.xpathFreeContext() 466 return res 467 468 # # 469 # # Selecting nodes using XPath, faster because the context 470 # # is allocated just once per xmlDoc. 471 # # 472 # # Removed: DV memleaks c.f. #126735 473 # # 474 # def xpathEval2(self, expr): 475 # doc = self.doc 476 # if doc == None: 477 # return None 478 # try: 479 # doc._ctxt.setContextNode(self) 480 # except: 481 # doc._ctxt = doc.xpathNewContext() 482 # doc._ctxt.setContextNode(self) 483 # res = doc._ctxt.xpathEval(expr) 484 # return res 485 def xpathEval2(self, expr): 486 return self.xpathEval(expr) 487 488 # Remove namespaces 489 def removeNsDef(self, href): 490 """ 491 Remove a namespace definition from a node. If href is None, 492 remove all of the ns definitions on that node. The removed 493 namespaces are returned as a linked list. 494 495 Note: If any child nodes referred to the removed namespaces, 496 they will be left with dangling links. You should call 497 renconciliateNs() to fix those pointers. 498 499 Note: This method does not free memory taken by the ns 500 definitions. You will need to free it manually with the 501 freeNsList() method on the returns xmlNs object. 502 """ 503 504 ret = libxml2mod.xmlNodeRemoveNsDef(self._o, href) 505 if ret is None:return None 506 __tmp = xmlNs(_obj=ret) 507 return __tmp 508 509 # support for python2 iterators 510 def walk_depth_first(self): 511 return xmlCoreDepthFirstItertor(self) 512 def walk_breadth_first(self): 513 return xmlCoreBreadthFirstItertor(self) 514 __iter__ = walk_depth_first 515 516 def free(self): 517 try: 518 self.doc._ctxt.xpathFreeContext() 519 except: 520 pass 521 libxml2mod.xmlFreeDoc(self._o) 522 523 524 # 525 # implements the depth-first iterator for libxml2 DOM tree 526 # 527 class xmlCoreDepthFirstItertor: 528 def __init__(self, node): 529 self.node = node 530 self.parents = [] 531 def __iter__(self): 532 return self 533 def __next__(self): 534 while 1: 535 if self.node: 536 ret = self.node 537 self.parents.append(self.node) 538 self.node = self.node.children 539 return ret 540 try: 541 parent = self.parents.pop() 542 except IndexError: 543 raise StopIteration 544 self.node = parent.next 545 next = __next__ 546 547 # 548 # implements the breadth-first iterator for libxml2 DOM tree 549 # 550 class xmlCoreBreadthFirstItertor: 551 def __init__(self, node): 552 self.node = node 553 self.parents = [] 554 def __iter__(self): 555 return self 556 def __next__(self): 557 while 1: 558 if self.node: 559 ret = self.node 560 self.parents.append(self.node) 561 self.node = self.node.next 562 return ret 563 try: 564 parent = self.parents.pop() 565 except IndexError: 566 raise StopIteration 567 self.node = parent.children 568 next = __next__ 569 570 # 571 # converters to present a nicer view of the XPath returns 572 # 573 def nodeWrap(o): 574 # TODO try to cast to the most appropriate node class 575 name = libxml2mod.type(o) 576 if name == "element" or name == "text": 577 return xmlNode(_obj=o) 578 if name == "attribute": 579 return xmlAttr(_obj=o) 580 if name[0:8] == "document": 581 return xmlDoc(_obj=o) 582 if name == "namespace": 583 return xmlNs(_obj=o) 584 if name == "elem_decl": 585 return xmlElement(_obj=o) 586 if name == "attribute_decl": 587 return xmlAttribute(_obj=o) 588 if name == "entity_decl": 589 return xmlEntity(_obj=o) 590 if name == "dtd": 591 return xmlDtd(_obj=o) 592 return xmlNode(_obj=o) 593 594 def xpathObjectRet(o): 595 otype = type(o) 596 if otype == type([]): 597 ret = list(map(xpathObjectRet, o)) 598 return ret 599 elif otype == type(()): 600 ret = list(map(xpathObjectRet, o)) 601 return tuple(ret) 602 elif otype == type('') or otype == type(0) or otype == type(0.0): 603 return o 604 else: 605 return nodeWrap(o) 606 607 # 608 # register an XPath function 609 # 610 def registerXPathFunction(ctxt, name, ns_uri, f): 611 ret = libxml2mod.xmlRegisterXPathFunction(ctxt, name, ns_uri, f) 612 613 # 614 # For the xmlTextReader parser configuration 615 # 616 PARSER_LOADDTD=1 617 PARSER_DEFAULTATTRS=2 618 PARSER_VALIDATE=3 619 PARSER_SUBST_ENTITIES=4 620 621 # 622 # For the error callback severities 623 # 624 PARSER_SEVERITY_VALIDITY_WARNING=1 625 PARSER_SEVERITY_VALIDITY_ERROR=2 626 PARSER_SEVERITY_WARNING=3 627 PARSER_SEVERITY_ERROR=4 628 629 # 630 # register the libxml2 error handler 631 # 632 def registerErrorHandler(f, ctx): 633 """Register a Python written function to for error reporting. 634 The function is called back as f(ctx, error). """ 635 import sys 636 if 'libxslt' not in sys.modules: 637 # normal behaviour when libxslt is not imported 638 ret = libxml2mod.xmlRegisterErrorHandler(f,ctx) 639 else: 640 # when libxslt is already imported, one must 641 # use libxst's error handler instead 642 import libxslt 643 ret = libxslt.registerErrorHandler(f,ctx) 644 return ret 645 646 class parserCtxtCore: 647 648 def __init__(self, _obj=None): 649 if _obj != None: 650 self._o = _obj; 651 return 652 self._o = None 653 654 def __del__(self): 655 if self._o != None: 656 libxml2mod.xmlFreeParserCtxt(self._o) 657 self._o = None 658 659 def setErrorHandler(self,f,arg): 660 """Register an error handler that will be called back as 661 f(arg,msg,severity,reserved). 662 663 @reserved is currently always None.""" 664 libxml2mod.xmlParserCtxtSetErrorHandler(self._o,f,arg) 665 666 def getErrorHandler(self): 667 """Return (f,arg) as previously registered with setErrorHandler 668 or (None,None).""" 669 return libxml2mod.xmlParserCtxtGetErrorHandler(self._o) 670 671 def addLocalCatalog(self, uri): 672 """Register a local catalog with the parser""" 673 return libxml2mod.addLocalCatalog(self._o, uri) 674 675 676 class ValidCtxtCore: 677 678 def __init__(self, *args, **kw): 679 pass 680 681 def setValidityErrorHandler(self, err_func, warn_func, arg=None): 682 """ 683 Register error and warning handlers for DTD validation. 684 These will be called back as f(msg,arg) 685 """ 686 libxml2mod.xmlSetValidErrors(self._o, err_func, warn_func, arg) 687 688 689 class SchemaValidCtxtCore: 690 691 def __init__(self, *args, **kw): 692 pass 693 694 def setValidityErrorHandler(self, err_func, warn_func, arg=None): 695 """ 696 Register error and warning handlers for Schema validation. 697 These will be called back as f(msg,arg) 698 """ 699 libxml2mod.xmlSchemaSetValidErrors(self._o, err_func, warn_func, arg) 700 701 702 class relaxNgValidCtxtCore: 703 704 def __init__(self, *args, **kw): 705 pass 706 707 def setValidityErrorHandler(self, err_func, warn_func, arg=None): 708 """ 709 Register error and warning handlers for RelaxNG validation. 710 These will be called back as f(msg,arg) 711 """ 712 libxml2mod.xmlRelaxNGSetValidErrors(self._o, err_func, warn_func, arg) 713 714 715 def _xmlTextReaderErrorFunc(xxx_todo_changeme,msg,severity,locator): 716 """Intermediate callback to wrap the locator""" 717 (f,arg) = xxx_todo_changeme 718 return f(arg,msg,severity,xmlTextReaderLocator(locator)) 719 720 class xmlTextReaderCore: 721 722 def __init__(self, _obj=None): 723 self.input = None 724 if _obj != None:self._o = _obj;return 725 self._o = None 726 727 def __del__(self): 728 if self._o != None: 729 libxml2mod.xmlFreeTextReader(self._o) 730 self._o = None 731 732 def SetErrorHandler(self,f,arg): 733 """Register an error handler that will be called back as 734 f(arg,msg,severity,locator).""" 735 if f is None: 736 libxml2mod.xmlTextReaderSetErrorHandler(\ 737 self._o,None,None) 738 else: 739 libxml2mod.xmlTextReaderSetErrorHandler(\ 740 self._o,_xmlTextReaderErrorFunc,(f,arg)) 741 742 def GetErrorHandler(self): 743 """Return (f,arg) as previously registered with setErrorHandler 744 or (None,None).""" 745 f,arg = libxml2mod.xmlTextReaderGetErrorHandler(self._o) 746 if f is None: 747 return None,None 748 else: 749 # assert f is _xmlTextReaderErrorFunc 750 return arg 751 752 # 753 # The cleanup now goes though a wrapper in libxml.c 754 # 755 def cleanupParser(): 756 libxml2mod.xmlPythonCleanupParser() 757 758 # 759 # The interface to xmlRegisterInputCallbacks. 760 # Since this API does not allow to pass a data object along with 761 # match/open callbacks, it is necessary to maintain a list of all 762 # Python callbacks. 763 # 764 __input_callbacks = [] 765 def registerInputCallback(func): 766 def findOpenCallback(URI): 767 for cb in reversed(__input_callbacks): 768 o = cb(URI) 769 if o is not None: 770 return o 771 libxml2mod.xmlRegisterInputCallback(findOpenCallback) 772 __input_callbacks.append(func) 773 774 def popInputCallbacks(): 775 # First pop python-level callbacks, when no more available - start 776 # popping built-in ones. 777 if len(__input_callbacks) > 0: 778 __input_callbacks.pop() 779 if len(__input_callbacks) == 0: 780 libxml2mod.xmlUnregisterInputCallback() 781 782 # WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING 783 # 784 # Everything before this line comes from libxml.py 785 # Everything after this line is automatically generated 786 # 787 # WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING 788 789
