
    n9d                        d dl mZ  G d de          Z G d de          Z G d de          Z eej                  ej        d	<    eej        d
d          ej        d<    eej                  ej        d<    ed
          ej        d
<    eej                  ej        d	<    eej                  ej        d<    e eej        d
                    ej        d
<   d
S )    )EntitySubstitutionc                   v    e Zd ZdZi Zi ZdZdZ e e	ddg                    Z
d Z	 	 	 ddZd Zd Z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                 V    ||S || j         k    rt                      S | j        |         S N)XMLsetHTML_DEFAULTS)selflanguagevaluekwargs       -lib/python3.11/site-packages/bs4/formatter.py_defaultzFormatter._default*   s1    Ltx55L!%((    N/F   c                    || _         || _        || _        |                     ||d          | _        || _        |d}t          |t                    r|dk     rd}d|z  }nt          |t                    r|}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!   s          r   __init__zFormatter.__init__1   s    B !#6 )B&%)]]+-D&
 &
" ,I*>Ffc"" 	zz6\FF$$ 	FFFr   c                     | j         s|S ddlm} t          ||          r|j        |j        j        | j        v 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   )NavigableString)r   elementr$   r   parentnamer
   )r   nsr$   s      r   
substitutezFormatter.substitutee   sk     ' 	I,,,,,,r?++ 		%	$"<<<I''+++r   c                 ,    |                      |          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   s     r   attribute_valuezFormatter.attribute_valuey   s     u%%%r   c                      |j         g S t           f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   D   K   | ]\  }}|j         r|d k    rdn|fV  dS ) N)r   ).0kvr   s      r   	<genexpr>z'Formatter.attributes.<locals>.<genexpr>   sT       
 
1 ;NRQP
 
 
 
 
 
r   )attrssortedlistitems)r   tags   ` r   
attributeszFormatter.attributes   s^     9I 
 
 
 
SY__..//
 
 
 
 
 	
r   )NNr   NFr   )__name__
__module____qualname____doc__XML_FORMATTERSHTML_FORMATTERSHTMLr   dictr   r   r   r"   r)   r+   r8    r   r   r   r      s         8 NOD
CD!c8W"566  M) ) ) 6:AE892 2 2 2h, , ,(& & &
 
 
 
 
r   r   c                   &     e Zd ZdZi Z fdZ xZS )HTMLFormatterzA generic Formatter for HTML.c                 Z     t          t          |           j        | j        g|R i | d S r   )superrC   r"   r?   r   argskwargs	__class__s      r   r"   zHTMLFormatter.__init__   s8    +mT""+DIGGGGGGGGGr   r9   r:   r;   r<   REGISTRYr"   __classcell__rI   s   @r   rC   rC      sL        ''HH H H H H H H H Hr   rC   c                   &     e Zd ZdZi Z fdZ xZS )XMLFormatterzA generic Formatter for XML.c                 Z     t          t          |           j        | j        g|R i | d S r   )rE   rO   r"   r   rF   s      r   r"   zXMLFormatter.__init__   s8    *lD!!*48EdEEEfEEEEEr   rJ   rM   s   @r   rO   rO      sL        &&HF F F F F F F F Fr   rO   )r   r   NT)r   r   r   html5minimal)	
bs4.dammitr   r   rC   rO   substitute_htmlrK   substitute_xmlr   rA   r   r   <module>rV      s   ) ) ) ) ) )O
 O
 O
 O
 O
" O
 O
 O
bH H H H HI H H HF F F F F9 F F F "/*:" " " v  #0-*:""&# # # w 
 %2M*9% % % y !  -}      t  ".*:" " " f  $0<*9$ $ $ i   (iIim666  d   r   