,hG^dZddlmZddlZddlZddlmZmZmZgdZ dZ dZ dZ d Z d Zd ZGd d eZeZGddeZGddeZGddeZdZGddeZddlmZee ddlmZee ddlmZeey#e$rYwxYw#e$rYywxYw)MIT) defaultdictN)CharsetMetaAttributeValueContentMetaAttributeValuenonwhitespace_re)HTMLTreeBuilderSAXTreeBuilder TreeBuilderTreeBuilderRegistryfast permissivestrictxmlhtmlhtml5c"eZdZdZdZdZdZy)r zYA way of looking up TreeBuilder subclasses by their name or by desired features. c:tt|_g|_yN)rlistbuilders_for_featurebuildersselfs V/var/www/html/Resume-Scraper/venv/lib/python3.12/site-packages/bs4/builder/__init__.py__init__zTreeBuilderRegistry.__init__"s$/$5! c|jD]!}|j|jd|#|jjd|y)zRegister a treebuilder based on its advertised features. :param treebuilder_class: A subclass of Treebuilder. its .features attribute should list its features. rN)featuresrinsertr)rtreebuilder_classfeatures rregisterzTreeBuilderRegistry.register&sL )11 LG  % %g . 5 5a9J K L Q 12rct|jdk(ryt|dk(r|jdSt|}|jd}d}t|dkDrs|j }|j j |g}t|dkDr*||}t|}n|jt|}t|dkDrs|y|D] }||vs|cSy)ajLook up a TreeBuilder subclass with the desired features. :param features: A list of features to look for. If none are provided, the most recently registered TreeBuilder subclass will be used. :return: A TreeBuilder subclass, or None if there's no registered subclass with all the requested features. rN) lenrrreversepoprgetset intersection)rr candidates candidate_setr!we_have_the_feature candidates rlookupzTreeBuilderRegistry.lookup0s t}}  " x=A ==# #>  (mallnG"&";";"?"?"L &'!+%!4J$' OM%2$>$>/0%2M(ma  # !IM)   !rN)__name__ __module__ __qualname____doc__rr"r.rrr r s3,rr ceZdZdZdZgZgZdZdZdZ iZ e Z e ZdZeeefdZdZdZdZd Z dd Zd Zd Zd Zy)r z:Turn a textual document into a Beautiful Soup object tree.z[Unknown tree builder]FNcd|_||jur |j}||_||jur |j}||_||jk(r |j }||_y)aConstructor. :param multi_valued_attributes: If this is set to None, the TreeBuilder will not turn any values for attributes like 'class' into lists. Setting this do a dictionary will customize this behavior; look at DEFAULT_CDATA_LIST_ATTRIBUTES for an example. Internally, these are called "CDATA list attributes", but that probably doesn't make sense to an end-user, so the argument name is `multi_valued_attributes`. :param preserve_whitespace_tags: A list of tags to treat the way 
 tags are treated in HTML. Tags in this list
         are immune from pretty-printing; their contents will always be
         output as-is.

        :param store_line_numbers: If the parser keeps track of the
         line numbers and positions of the original markup, that
         information will, by default, be stored in each corresponding
         `Tag` object. You can turn this off by passing
         store_line_numbers=False. If the parser you're using doesn't 
         keep track of this information, then setting store_line_numbers=True
         will do nothing.
        N)soupUSE_DEFAULTDEFAULT_CDATA_LIST_ATTRIBUTEScdata_list_attributes DEFAULT_PRESERVE_WHITESPACE_TAGSpreserve_whitespace_tagsTRACKS_LINE_NUMBERSstore_line_numbers)rmulti_valued_attributesr;r=s    rrzTreeBuilder.__init__ysq8	"d&6&66&*&H&H#%<"#t'7'77'+'L'L$(@%!1!11!%!9!9"4rc||_y)zThe BeautifulSoup object has been initialized and is now
        being associated with the TreeBuilder.

        :param soup: A BeautifulSoup object.
        N)r6)rr6s  rinitialize_soupzTreeBuilder.initialize_soups	rcy)zDo any work necessary to reset the underlying parser
        for a new document.

        By default, this does nothing.
        Nr3rs rresetzTreeBuilder.resets	
rc8|jy||jvS)aMight a tag with this name be an empty-element tag?

        The final markup may or may not actually present this tag as
        self-closing.

        For instance: an HTMLBuilder does not consider a 
 tag to be
        an empty-element tag (it's not in
        HTMLBuilder.empty_element_tags). This means an empty 
 tag
        will be presented as "
", not "
" or "
".

        The default implementation has no opinion about which tags are
        empty-element tags, so a tag will be presented as an
        empty-element tag if and only if it has no children.
        "" will become "", and "bar" will
        be left alone.

        :param tag_name: The name of a markup tag.
        T)empty_element_tags)rtag_names  rcan_be_empty_elementz TreeBuilder.can_be_empty_elements$&""*42222rct)zRun some incoming markup through some parsing process,
        populating the `BeautifulSoup` object in self.soup.

        This method is not implemented in TreeBuilder; it must be
        implemented in subclasses.

        :return: None.
        NotImplementedErrorrmarkups  rfeedzTreeBuilder.feeds
"##rc#K|dddfyw)aRun any preliminary steps necessary to make incoming markup
        acceptable to the parser.

        :param markup: Some markup -- probably a bytestring.
        :param user_specified_encoding: The user asked to try this encoding.
        :param document_declared_encoding: The markup itself claims to be
            in this encoding.
        :param exclude_encodings: The user asked _not_ to try any of
            these encodings.

        :yield: A series of 4-tuples:
         (markup, encoding, declared encoding,
          has undergone character replacement)

         Each 4-tuple represents a strategy for converting the
         document to Unicode and parsing it. Each strategy will be tried 
         in turn.

         By default, the only strategy is to parse the markup
         as-is. See `LXMLTreeBuilderForXML` and
         `HTMLParserTreeBuilder` for implementations that take into
         account the quirks of particular parsers.
        NFr3)rrKuser_specified_encodingdocument_declared_encodingexclude_encodingss     rprepare_markupzTreeBuilder.prepare_markups2dD%''s
c|S)aWrap an HTML fragment to make it look like a document.

        Different parsers do this differently. For instance, lxml
        introduces an empty  tag, and html5lib
        doesn't. Abstracting this away lets us write simple tests
        which run HTML fragments through the parser and compare the
        results against other HTML fragments.

        This method should not be used outside of tests.

        :param fragment: A string -- fragment of HTML.
        :return: A string -- a full HTML document.
        r3)rfragments  rtest_fragment_to_documentz%TreeBuilder.test_fragment_to_documents	rcy)a2Set up any substitutions that will need to be performed on 
        a `Tag` when it's output as a string.

        By default, this does nothing. See `HTMLTreeBuilder` for a
        case where this is used.

        :param tag: A `Tag`
        :return: Whether or not a substitution was performed.
        Fr3)rtags  rset_up_substitutionsz TreeBuilder.set_up_substitutionssrcj|s|S|jr|jjdg}|jj|jd}t|j	D]@}||vs|s
||vs||}t|trtj|}n|}|||<B|S)aWhen an attribute value is associated with a tag that can
        have multiple values for that attribute, convert the string
        value to a list of strings.

        Basically, replaces class="foo bar" with class=["foo", "bar"]

        NOTE: This method modifies its input in place.

        :param tag_name: The name of a tag.
        :param attrs: A dictionary containing the tag's attributes.
           Any appropriate attribute values will be modified in place.
        *N)	r9r'lowerrkeys
isinstancestrrfindall)rrEattrs	universaltag_specificattrvaluevaluess        r$_replace_cdata_list_attribute_valuesz0TreeBuilder._replace_cdata_list_attribute_values	sL%%2266sB?I5599 $(LUZZ\*
)9$$,:N"$KE!%-!1!9!9%!@"'"(E$K!
)"r)NNN)r/r0r1r2NAMEALTERNATE_NAMESris_xml	picklablerDr8r(r:objectr7r<rr@rBrFrLrQrTrWrer3rrr
r
bsD#DOH
FI
%'!'*u$(K /:*5$/%5N
3.	$>BJN(6 
$rr
cReZdZdZdZdZdZdZdZdZ	dZ
d	Zd
ZdZ
dZy
)r	zA Beautiful Soup treebuilder that listens for SAX events.

    This is not currently used for anything, but it demonstrates
    how a simple TreeBuilder would work.
    ctrrHrJs  rrLzSAXTreeBuilder.feed6s!##rcyrr3rs rclosezSAXTreeBuilder.close9rctdt|jD}|jj	||y)Nc30K|]\}}|d|fyw)Nr3).0keyrcs   r	z.SAXTreeBuilder.startElement..=sKec!fe_Ks)dictritemsr6handle_starttag)rnamer_s   rstartElementzSAXTreeBuilder.startElement<s1KtEKKM7JKK		!!$.rc:|jj|yr)r6
handle_endtag)rrys  r
endElementzSAXTreeBuilder.endElementAs		%rc(|j||yr)rz)rnsTuplenodeNamer_s    rstartElementNSzSAXTreeBuilder.startElementNSEs(E*rc&|j|yr)r})rrrs   rendElementNSzSAXTreeBuilder.endElementNSIs!rcyrr3)rprefix	nodeValues   rstartPrefixMappingz!SAXTreeBuilder.startPrefixMappingNsrcyrr3)rrs  rendPrefixMappingzSAXTreeBuilder.endPrefixMappingRs	
rc:|jj|yr)r6handle_data)rcontents  r
characterszSAXTreeBuilder.charactersWs		g&rcyrr3rs r
startDocumentzSAXTreeBuilder.startDocumentZrorcyrr3rs rendDocumentzSAXTreeBuilder.endDocument]rorN)r/r0r1r2rLrnrzr}rrrrrrrr3rrr	r	/s>$
/
&+"


'

rr	c
eZdZdZegdZegdZgdddgddgdgdgdgdgd	gdgd
gdgdgd
ZeddgZdZ	y)rz]This TreeBuilder knows facts about HTML.

    Such as which tags are empty-element tags.
    )areabasebrcolembedhrimginputkeygenlinkmenuitemmetaparamsourcetrackwbrbasefontbgsoundcommandframeimageisindexnextidspacer)#addressarticleaside
blockquotecanvasdddivdldtfieldset
figcaptionfigurefooterformh1h2h3h4h5h6headerrlimainnavnoscriptoloutputppresectiontabletfootulvideo)class	accesskeydropzonerelrevheaderszaccept-charsetarchivesizessandboxfor)rYartdthrrrjriconiframerrtextareac
|jdk7ry|jd}|jd}|jd}d}||}t||d<|duS|#|!|jdk(rt	||d<|duS)aReplace the declared encoding in a  tag with a placeholder,
        to be substituted when the tag is output to a string.

        An HTML document may come in to Beautiful Soup as one
        encoding, but exit in a different encoding, and the  tag
        needs to be changed to reflect this.

        :param tag: A `Tag`
        :return: Whether or not a substitution was performed.
        rFz
http-equivrcharsetNzcontent-type)ryr'rrZr)rrV
http_equivrr
meta_encodings      rrWz$HTMLTreeBuilder.set_up_substitutionss88vWW\*
'')$'')$
$M6w?C	NT)*
!j&<""$67w?C	NT)*rN)
r/r0r1r2r(rDblock_elementsr8r:rWr3rrrras
}~N1en%.{{{"#;;7%
!"(+E:+>'?$)+rrctjd}|jD]b}t||}t	|t
s t
||||jj||jj|dy)z9Copy TreeBuilders from the given module into this module.zbs4.builderN)
sysmodules__all__getattr
issubclassr
setattrappendbuilder_registryr")modulethis_moduleryobjs    rregister_treebuilders_fromrso++m,K7fd#c;'Ks+&&t,((11#67rc"eZdZdZfdZxZS)ParserRejectedMarkupzgAn Exception to be raised when the underlying parser simply
    refuses to parse the given markup.
    ct|tr&|}|jjdt	|}t
t||y)zzExplain why the parser rejected the given markup, either
        with a textual explanation or another exception.
        z: N)r\	Exception	__class__r/r]superrr)rmessage_or_exceptioners   rrzParserRejectedMarkup.__init__s?*I6$A/0{{/C/CSV#L 
"D23GHr)r/r0r1r2r
__classcell__)rs@rrrsIIrrrr)_htmlparser)	_html5lib)_lxml)__license__collectionsr	itertoolsrbs4.elementrrrrFAST
PERMISSIVESTRICTXMLHTMLHTML_5rjrrr
r	rrrrrrImportErrorrr3rrrs#


	
	?&?F'(K&KZ/
[/
dW+kW+r7I9I";'	y)	u%				s$;B
B$B! B!$B,+B,