
вEbc           @` 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   (    (    sG   /tmp/pip-build-UPPWic/pip/pip/_vendor/html5lib/treebuilders/__init__.pyt   getTreeBuilder'   s$    		N(
   t   __doc__t
   __future__R    R   R   t   _utilsR   R	   R   R   (    (    (    sG   /tmp/pip-build-UPPWic/pip/pip/_vendor/html5lib/treebuilders/__init__.pyt   <module>   s   