+
2i( c s a 0 t $ ^ RIHt ^ RIHtHtHtHtHtH t H
t
H t ^ RI H
t
^ RIHt ]
' d ^ RIHt ! R R]4 t ! R R ]4 t ! R
R ]4 t]! ]P* R 7 ]P, R
& ]! ]P. RRR7 ]P, R& ]! ]P* RRR7 ]P, R& ]! ]P0 R 7 ]P, R& ]! RR 7 ]P, R& ]! ]P* R 7 ]P, R
& ]! ]P0 R 7 ]P, R& ]! RR 7 ]P, R& ]].]3, tR]R& ] ]]3, t R# )i ) annotations)CallableDictIterableOptionalSetTuple
TYPE_CHECKINGUnion) TypeAlias)EntitySubstitution)_AttributeValuec s ] tR t^
t$ RtRtR]R& RtR]R& ]! ] ! RR.4 R 7 t
R
]R & R ]R
& R]R& R]R& R]R& R]R& R]R& R R lt R"R R llt R R lt
R R ltR R ltR!tR# )# 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.
htmlstrHTMLZxmlXMLZscriptZstyle)cdata_containing_tagszDict[str, Set[str]]
HTML_DEFAULTS
Optional[str]language%Optional[_EntitySubstitutionFunction]entity_substitutionvoid_element_close_prefixSet[str]r indentbool empty_attributes_are_booleansc s( V ^8 d QhRRRRRRRR/# ) r r valueOptional[Set[str]]kwargreturnr Zformat "2/usr/lib/python3.14/site-packages/bs4/formatter.py __annotate__Formatter.__annotate__B s, ) ) )$6 )?B ) ) c sh Ve V# WP 8X d \ 4 # V P V, # )N)r setr )selfr r r s &&&&r$ _defaultZFormatter._defaultB s5 L xx 5L !!%((r' Nc s0 V ^8 d QhRRRRRRRRR R
R R /# )
r r r r r r r r r r r r Union[int, str]r! r" r# r$ r% r& O sG 9! 9! 9! C9! $' 9!
2 9! (,
9! 9!r' c
sD T;' g
V P V n W n W0n V P V P VR4 V n WPn Vf ^ p\ V\ 4 ' d V^ 8 d ^ pRV, pM\ V\ 4 ' d TpMRpWpn
R# )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,