+
    Ĝi                     8    R t ^ RIHtHtHt ^RIHt / tRR ltR# )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_etreeNc                   V P                  4       p V \        9  d   V R8X  d0   ^RIHp Vf	   ^ RIHp TpVP                  ! V3/ VB P                  # V R8X  d   ^RIHp VP                  \        V &   MFV R8X  d.   ^RIH	p Vf   \        pVP                  ! V3/ VB P                  # \        RV ,          4      h\        P                  V 4      # )	a  Get 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)r   )minidomlxml)
etree_lxmletree)r   zUnrecognised treebuilder "%s" )lowertreeBuilderCache r   xml.domr   getDomModuleTreeBuilderr
   r   r   getETreeModule
ValueErrorget)treeTypeimplementationkwargsr   r   r
   r   s   &&,    g/Users/mibo/.openclaw/workspace/.venv-ak/lib/python3.14/site-packages/html5lib/treebuilders/__init__.pygetTreeBuilderr   '   s    8 ~~H''u%+!(##N=f=III$)3)?)?X& %!.''A&AMMMAHLMM))    )N)	__doc__
__future__r   r   r   _utilsr   r   r    r   r   <module>r      s!   > C B " 1*r   