o ÿ%ßeã@s6dZddlmZmZmZddlmZiZddd„ZdS) a)A collection of modules for building different kinds of trees from HTML documents. To create a treebuilder for a new type of tree, you need to do implement several things: 1. A set of classes for various types of elements: Document, Doctype, Comment, Element. These must implement the interface of ``base.treebuilders.Node`` (although comment nodes have a different signature for their constructor, see ``treebuilders.etree.Comment``) Textual content may also be implemented as another node type, or not, as your tree implementation requires. 2. A treebuilder object (called ``TreeBuilder`` by convention) that inherits from ``treebuilders.base.TreeBuilder``. This has 4 required attributes: * ``documentClass`` - the class to use for the bottommost node of a document * ``elementClass`` - the class to use for HTML Elements * ``commentClass`` - the class to use for comments * ``doctypeClass`` - the class to use for doctypes It also has one required method: * ``getDocument`` - Returns the root node of the complete document tree 3. If you wish to run the unit tests, you must also create a ``testSerializer`` method on your treebuilder which accepts a node and returns a string containing Node and its children serialized according to the format used in the unittests é)Úabsolute_importÚdivisionÚunicode_literalsé)Ú default_etreeNcKsº| ¡}|tvrX|dkr(ddlm}|durddlm}|}|j|fi|¤ŽjS|dkr8ddlm}|jt|<n |d krRdd lm }|durHt }|j |fi|¤ŽjSt d |ƒ‚t  |¡S) aGet a TreeBuilder class for various types of trees with built-in support :arg treeType: the name of the tree type required (case-insensitive). Supported values are: * "dom" - A generic builder for DOM implementations, defaulting to a xml.dom.minidom based implementation. * "etree" - A generic builder for tree implementations exposing an ElementTree-like interface, defaulting to xml.etree.cElementTree if available and xml.etree.ElementTree if not. * "lxml" - A etree-based builder for lxml.etree, handling limitations of lxml's implementation. :arg implementation: (Currently applies to the "etree" and "dom" tree types). A module implementing the tree type e.g. xml.etree.ElementTree or xml.etree.cElementTree. :arg kwargs: Any additional options to pass to the TreeBuilder when creating it. Example: >>> from html5lib.treebuilders import getTreeBuilder >>> builder = getTreeBuilder('etree') Údomé)rNr)ÚminidomÚlxml)Ú etree_lxmlÚetree)r zUnrecognised treebuilder "%s" )ÚlowerÚtreeBuilderCacheÚrÚxml.domr Ú getDomModuleÚ TreeBuilderr r rÚgetETreeModuleÚ ValueErrorÚget)ÚtreeTypeÚimplementationÚkwargsrr r r ©rúQ/var/www/html/venv/lib/python3.10/site-packages/html5lib/treebuilders/__init__.pyÚgetTreeBuilder's$       r)N) Ú__doc__Ú __future__rrrÚ_utilsrrrrrrrÚs