o
MK&h( @ sH U d dl mZ d dlmZmZmZmZmZmZm Z m
Z
d dl m Z d dl
mZ e r/d dlmZ G dd deZG dd d eZG d
d d eZeejd ejd
< eejdddejd< eejdddejd< eejd ejd< edd ejd< eejd ejd
< eejd ejd< edd ejd< eegef Zded< e
eef ZdS ) ) annotations)CallableDictIterableOptionalSetTuple
TYPE_CHECKINGUnion) TypeAlias)EntitySubstitution)_AttributeValuec @ s e Zd ZU dZdZded< dZded< eeddgd Z d
ed < d ed
< ded< ded< ded< ded< ded< d-ddZ
d.d/d!d"Z d0d$d%Z d1d&d'Z
d2d+d,Zd S )3 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 `bs4.element.Tag.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.
* 'html5-4.12.0' - The version of the 'html5' formatter used prior to
Beautiful Soup 4.13.0.
* '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.
htmlstrHTMLxmlXMLscriptstyle)cdata_containing_tagszDict[str, Set[str]]
HTML_DEFAULTS
Optional[str]language%Optional[_EntitySubstitutionFunction]entity_substitutionvoid_element_close_prefixSet[str]r indentbool empty_attributes_are_booleansvalueOptional[Set[str]]kwargreturnc C s& |d ur|S || j krt S | j| S )N)r setr )selfr r! r# r' @/var/www/html/venv/lib/python3.10/site-packages/bs4/formatter.py_defaultB s
zFormatter._defaultN/F Union[int, str]c C sz |p| j | _|| _|| _| | j|d| _|| _|du r d}t|tr.|dk r)d}d| }n
t|t r6|}nd}|| _
dS )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 (XML rules) rather than
(HTML rules). To get , pass in the empty string.
:param cdata_containing_tags: The set of tags that are defined
as containing CDATA in this dialect. For example, in HTML,