B
    2d                 @   s   d dl mZ G dd deZG dd deZG dd deZeejdejd	< eejd
ddejd< eejdejd< ed
dejd
< eejdejd	< eejdejd< eeejd
dejd
< d
S )    )EntitySubstitutionc               @   s\   e Zd ZdZi Zi ZdZdZee	ddgdZ
dd ZdddZdd Zdd Zdd Zd	S )	Formattera   Describes a strategy to use when outputting a parse tree to a string.

    Some parts of this strategy come from the distinction between
    HTML4, HTML5, and XML. Others are configurable by the user.

    Formatters are passed in as the `formatter` argument to methods
    like `PageElement.encode`. Most people won't need to think about
    formatters, and most people who need to think about them can pass
    in one of these predefined strings as `formatter` rather than
    making a new Formatter object:

    For HTML documents:
     * 'html' - HTML entity substitution for generic HTML documents. (default)
     * 'html5' - HTML entity substitution for HTML5 documents, as
                 well as some optimizations in the way tags are rendered.
     * 'minimal' - Only make the substitutions necessary to guarantee
                   valid HTML.
     * None - Do not perform any substitution. This will be faster
              but may result in invalid markup.

    For XML documents:
     * 'html' - Entity substitution for XHTML documents.
     * 'minimal' - Only make the substitutions necessary to guarantee
                   valid XML. (default)
     * None - Do not perform any substitution. This will be faster
              but may result in invalid markup.
    htmlxmlscriptstyle)cdata_containing_tagsc             C   s&   |d k	r|S || j krt S | j| S )N)XMLsetHTML_DEFAULTS)selflanguagevaluekwarg r   Z/work/yifan.wang/ringdown/master-ringdown-env/lib/python3.7/site-packages/bs4/formatter.py_default*   s
    
zFormatter._defaultN/F   c             C   sr   || _ || _|| _| ||d| _|| _|dkr4d}t|trT|dk rJd}d| }nt|trd|}nd}|| _	dS )a)  Constructor.

        :param language: This should be Formatter.XML if you are formatting
           XML markup and Formatter.HTML if you are formatting HTML markup.

        :param entity_substitution: A function to call to replace special
           characters with XML/HTML entities. For examples, see 
           bs4.dammit.EntitySubstitution.substitute_html and substitute_xml.
        :param void_element_close_prefix: By default, void elements
           are represented as <tag/> (XML rules) rather than <tag>
           (HTML rules). To get <tag>, pass in the empty string.
        :param cdata_containing_tags: The list of tags that are defined
           as containing CDATA in this dialect. For example, in HTML,
           <script> and <style> tags are defined as containing CDATA,
           and their contents should not be formatted.
        :param blank_attributes_are_booleans: Render attributes whose value
            is the empty string as HTML-style boolean attributes.
            (Attributes whose value is None are always rendered this way.)

        :param indent: If indent is a non-negative integer or string,
            then the contents of elements will be indented
            appropriately when pretty-printing. An indent level of 0,
            negative, or "" will only insert newlines. Using a
            positive integer indent indents that many spaces per
            level. If indent is a string (such as "	"), that string
            is used to indent each level. The default behavior to
            indent one space per level.
        r   Nr    )
r   entity_substitutionvoid_element_close_prefixr   r   empty_attributes_are_booleans
isinstanceintstrindent)r   r   r   r   r   r   r   r   r   r   __init__1   s     !


zFormatter.__init__c             C   sF   | j s
|S ddlm} t||r<|jdk	r<|jj| jkr<|S |  |S )a  Process a string that needs to undergo entity substitution.
        This may be a string encountered in an attribute value or as
        text.

        :param ns: A string.
        :return: A string with certain characters replaced by named
           or numeric entities.
        r   )NavigableStringN)r   elementr   r   parentnamer   )r   nsr   r   r   r   
substitutee   s    	

zFormatter.substitutec             C   s
   |  |S )zProcess the value of an attribute.

        :param ns: A string.
        :return: A string with certain characters replaced by named
           or numeric entities.
        )r#   )r   r   r   r   r   attribute_valuey   s    zFormatter.attribute_valuec                s.   |j dkrg S t fddt|j  D S )a  Reorder a tag's attributes however you want.
        
        By default, attributes are sorted alphabetically. This makes
        behavior consistent between Python 2 and Python 3, and preserves
        backwards compatibility with older versions of Beautiful Soup.

        If `empty_boolean_attributes` is True, then attributes whose
        values are set to the empty string will be treated as boolean
        attributes.
        Nc             3   s,   | ]$\}}| j r|d krdn|fV  qdS ) N)r   ).0kv)r   r   r   	<genexpr>   s   z'Formatter.attributes.<locals>.<genexpr>)attrssortedlistitems)r   tagr   )r   r   
attributes   s
    

zFormatter.attributes)NNr   NFr   )__name__
__module____qualname____doc__ZXML_FORMATTERSZHTML_FORMATTERSHTMLr	   dictr
   r   r   r   r#   r$   r/   r   r   r   r   r      s     
1	r   c                   s$   e Zd ZdZi Z fddZ  ZS )HTMLFormatterzA generic Formatter for HTML.c                s   t t| j| jf|| d S )N)superr6   r   r4   )r   argskwargs)	__class__r   r   r      s    zHTMLFormatter.__init__)r0   r1   r2   r3   REGISTRYr   __classcell__r   r   )r:   r   r6      s   r6   c                   s$   e Zd ZdZi Z fddZ  ZS )XMLFormatterzA generic Formatter for XML.c                s   t t| j| jf|| d S )N)r7   r=   r   r	   )r   r8   r9   )r:   r   r   r      s    zXMLFormatter.__init__)r0   r1   r2   r3   r;   r   r<   r   r   )r:   r   r=      s   r=   )r   r   NT)r   r   r   html5Zminimal)	Z
bs4.dammitr   r   r6   r=   Zsubstitute_htmlr;   Zsubstitute_xmlr	   r   r   r   r   <module>   s(    