3
œ(ƒhN  ã               @   s6   d Z ddlmZmZmZ ddlmZ i Zddd„ZdS )	aÊ  A collection of modules for building different kinds of tree 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             K   s²   | j ƒ } | tkr¨| dkrLddlm} |dkr<ddlm} |}|j|f|ŽjS | dkrlddlm} |jt| < n<| d	krœdd
lm	} |dkrŒt
}|j|f|ŽjS td|  ƒ‚tj| ƒS )a¨  Get a TreeBuilder class for various types of tree with built-in support

    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.

    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.Údomé   )r   Nr   )Ú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   © r   úD/tmp/pip-install-q3hcpn_q/html5lib/html5lib/treebuilders/__init__.pyÚgetTreeBuilder$   s$    r   )N)	Ú__doc__Ú
__future__r   r   r   Ú_utilsr   r   r   r   r   r   r   Ú<module>   s   