�
�t�_c @` sH d Z d d l m Z m Z m Z d d l m Z i Z d d � Z d S( u) 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
i ( t absolute_importt divisiont unicode_literalsi ( t
default_etreec K` s� | j � } | t k r� | d k rl d d l m } | d k rY d d l m } | } n | j | | � j S| d k r� d d l m } | j t | <q� | d k r� d d l m
} | d k r� t } n | j | | � j St
d
| � � n t j | � S( u 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')
u domi ( t domi ( t minidomu lxml( t
etree_lxmlu etree( t etreeu Unrecognised treebuilder "%s" N( t lowert treeBuilderCachet R t Nonet xml.domR t getDomModulet TreeBuilderR R R t getETreeModulet
ValueErrort get( t treeTypet implementationt kwargsR R R R ( ( s[ /opt/alt/python35/lib/python3.5/site-packages/pip/_vendor/html5lib/treebuilders/__init__.pyt getTreeBuilder' s$ N(
t __doc__t
__future__R R R t _utilsR R R R ( ( ( s[ /opt/alt/python35/lib/python3.5/site-packages/pip/_vendor/html5lib/treebuilders/__init__.pyt <module> s