+ 2ircsJ^RIHt^RIHt^RIt^RIHtHtHtH t H t H t H t H t HtHtHt^RIt^RIHt^RIHtHtHtHtHt^RIHtHtHtHtHtH t H!t!H"t"H#t#H$t$H%t%H&t&H't'!RR ](4t)!R R ](4t*!R R ]*4t+!RR]*4t,!RR]*4t-!RR])4t.R#)i) annotations) defaultdictN) AnyCallablecastDictIteratorIterableListOptionalSequenceTypeUnion) _deprecated) AttributeDictNavigableString PageElement ResultSetTag) _AtMostOneElement_AttributeValue_NullableStringMatchFunction _OneElement_PageElementMatchFunction _QueryResults_RawAttributeValues_RegularExpressionProtocol_StrainableAttribute_StrainableElement_StrainableString_StringMatchFunction_TagMatchFunctioncs]tRt^,t$RtR]R&RRRllt]RRl4t]R R l4t RR R llt R Rlt RRlt RRRllt RRltRRltRtR#) ElementFiltera`ElementFilter` encapsulates the logic necessary to decide: 1. whether a `PageElement` (a `Tag` or a `NavigableString`) matches a user-specified query. 2. whether a given sequence of markup found during initial parsing should be turned into a `PageElement` at all, or simply discarded. The base class is the simplest `ElementFilter`. By default, it matches everything and allows all markup to become `PageElement` objects. You can make it more selective by passing in a user-defined match function, or defining a subclass. Most users of Beautiful Soup will never need to use `ElementFilter`, or its more capable subclass `SoupStrainer`. Instead, they will use methods like :py:meth:`Tag.find`, which will convert their arguments into `SoupStrainer` objects and run them against the tree. However, if you find yourself wanting to treat the arguments to Beautiful Soup's find_*() methods as first-class objects, those objects will be `SoupStrainer` objects. You can create them yourself and then make use of functions like `ElementFilter.filter()`. #Optional[_PageElementMatchFunction]match_functionNcV^8dQhRR/#)r"r!Zformat"//usr/lib/python3.14/site-packages/bs4/filter.py __annotate__ElementFilter.__annotate__Is--'J-c sWnR#)zPass in a match function to easily customize the behavior of `ElementFilter.match` without needing to subclass. :param match_function: A function that takes a `PageElement` and returns `True` if that `PageElement` matches some criteria. Nr")selfr"&&r(__init__ZElementFilter.__init__Is -r+cr#r$returnboolr%r&r'r(r)r*Ss ' 'T 'r+c s$VP'*#)aDoes this `ElementFilter` obviously include everything? If so, the filter process can be made much faster. The `ElementFilter` might turn out to include everything even if this returns `False`, but it won't include everything in an obvious way. The base `ElementFilter` implementation includes things based on the match function, so includes_everything is only true if there is no match function. r,r-&r(includes_everythingZ!ElementFilter.includes_everythingRs&&&&r+cr#r0r%r&r'r(r)r*bs  T r+c R#)aDoes this `ElementFilter` obviously exclude everything? If so, Beautiful Soup will issue a warning if you try to use it when parsing a document. The `ElementFilter` might turn out to exclude everything even if this returns `False`, but it won't exclude everything in an obvious way. The base `ElementFilter` implementation excludes things based on a match function we can't inspect, so excludes_everything is always false. Fr%r3r4r(excludes_everythingZ!ElementFilter.excludes_everythingasr+c$V^8dQhRRRRRR/#r$elementr _known_rulesr2r1r%r&r'r(r)r*qs!,,[,t,d,r+c sV'gVP'dR#VP'gR#VPV4#)a=Does the given PageElement match the rules set down by this ElementFilter? The base implementation delegates to the function passed in to the constructor. :param _known_rules: Defined for compatibility with SoupStrainer._match(). Used more for consistency than because we need the performance optimization. T)r5r"r-r:r;&&&r(matchZElementFilter.matchqs5 8 8 8"""""7++r+c V^8dQhRRRR/#)r$ generatorIterator[PageElement]r1zIterator[_OneElement]r%r&r'r(r)r*s11 51:O1r+c# s"VP'd TRjxL \V4pT'gKTPTRR7'gK2\ RT4xKBLF \dR#i;i5i)zThe most generic search method offered by Beautiful Soup. Acts like Python's built-in `filter`, using `ElementFilter.match` as the filtering function. NT)r;r)r5ZnextZ StopIterationr>r)r-r@Zi&& r(filterZElementFilter.filtersl  # # #  Oq::ad:33}a00 !!  s<A5A!A5 A#A5A5A5# A2.A51A22A5cr?)r$r@rAr1rr%r&r'r(r)r*s  3 8I r+c s:VPV4FpVu# R#)aA lower-level equivalent of :py:meth:`Tag.find`. You can pass in your own generator for iterating over `PageElement` objects. The first one that matches this `ElementFilter` will be returned. :param generator: A way of iterating over `PageElement` objects. N)rC)r-r@r>rBr(findZElementFilter.finds[[+EL,r+c$V^8dQhRRRRRR/#)r$r@rAlimitz Optional[int]r1rr%r&r'r(r)r*s$((.(7D( (r+c s.pVPV4F,pVPV4VfK\V4V8gK,M \W4#)acA lower-level equivalent of :py:meth:`Tag.find_all`. You can pass in your own generator for iterating over `PageElement` objects. Only elements that match this `ElementFilter` will be returned in the :py:class:`ResultSet`. :param generator: A way of iterating over `PageElement` objects. :param limit: Stop looking after finding this many results. )rCappendlenr)r-r@rFZresultsr>&&& r(find_allZElementFilter.find_allsI[[+E NN5 ! S\U%:,''r+c(V^8dQhRRRRRRRR/# r$nsprefix Optional[str]namestrattrsOptional[_RawAttributeValues]r1r2r%r&r'r(r)r*s,  % -0 9V   r+c r6)a*Based on the name and attributes of a tag, see whether this `ElementFilter` will allow a `Tag` object to even be created. By default, all tags are parsed. To change this, subclass `ElementFilter`. :param name: The name of the prospective tag. :param attrs: The attributes of the prospective tag. Tr%)r-rMrOrQs&&&&r(allow_tag_creationZ ElementFilter.allow_tag_creationsr+cr?r$stringrPr1r2r%r&r'r(r)r*s  C D r+c r6)a;Based on the content of a string, see whether this `ElementFilter` will allow a `NavigableString` object based on this string to be added to the parse tree. By default, all strings are processed into `NavigableString` objects. To change this, subclass `ElementFilter`. :param str: The string under consideration. Tr%r-rUr.r(allow_string_creationZ#ElementFilter.allow_string_creationsr+r,NF)__name__ __module__ __qualname____firstlineno____doc____annotations__r/propertyr5r7r>rCrDrJrSrW__static_attributes__r%r+r(r r ,s_487- ' '  ,"1& (*   r+r cs]tRt^t$RtR]R&R]R&R]R&R]R&RR R lltR R ltRRltRRlt RRlt Rt R #) MatchRulezuEach MatchRule encapsulates the logic behind a single argument passed in to one of the Beautiful Soup find* methods. rNrU$Optional[_RegularExpressionProtocol]patternOptional[bool]presentexclude_everythingNc s,V^8dQhRRRRRRRRR R/#) r$rUzOptional[Union[str, bytes]]rdrcfunctionzOptional[Callable]rfrergr%r&r'r(r)MatchRule.__annotate__s<!!+!6!% !  ! + !r+c s\V\4'dVPR4pWn\V\4'd,\P !VPR44VnM8\V\4'd\P !V4VnMW nW0nW@n WPn VPVP VPVPVP3Uu.uF pVfK VNK pp\V4^8Xd \R4h\V4^8d \R4hR#uupi)Zutf8NzREither string, pattern, function, present, or exclude_everything must be provided.z[At most one of string, pattern, function, present, and exclude_everything must be provided.) isinstancebytesZdecoderUreZcompilerdrPrhrfrgrHZ ValueError)r-rUrdrhrfrgxvaluess&&&&&& r(r/ZMatchRule.__init__s  fe $ $]]6*F gu % %::gnnV&<=DL  % %::g.DL"L  "4kk4<< dNeNef f Af  v;! d  v;?m   s 4D??D?cr?)r$rUrNr1rer%r&r'r(r)ris-Nr+c sVP'dR#VPRJdVRJ#VPRJdVRJ#VPeVPV8H#VPe$VfR#VPP V4RJ#R#)zRun the 'cheap' portion of a match, trying to get an answer without calling a potentially expensive custom function. :return: True or False if we have a (positive or negative) match; None if we need to keep trying. FTN)rgrfrUrdsearchrVr.r( _base_matchZMatchRule._base_matchs  " " " <<4 % % <<5 T> ! ;; ";;&( ( << #~<<&&v.d: :r+cr?)r$rUrNr1r2r%r&r'r(r)ri$s]tr+c sVPV4pVeV#VPeVPV4'gR#R#)NFT)rprh)r-rUZ _base_resultrBr(matches_stringZMatchRule.matches_string$s<''/  #  == $T]]6-B-Br+cr#r$r1rPr%r&r'r(r)ri.svv#vr+c  s\V4PpRV RVP RVP RVP RVP R2 #)< string=z pattern=z function=z present=>)ZtyperZrUrdrhrf)r-cls& r(__repr__ZMatchRule.__repr__.sN4j!!3%x }Idll^:dmm_\efjfrfresstuur+cr?)r$otherrr1r2r%r&r'r(r)ri2s  C D r+c s*\V\4;'d}VPVP8H;'d\VPVP8H;'d;VPVP8H;'dVP VP 8H#rX)rjrbrUrdrhrf)r-ryr.r(__eq__ZMatchRule.__eq__2s} ui ( . . u||+ . .  - . . / . .  -  r+)rgrhrdrfrU)NNNNN) rZr[r\r]r^r_r/rprqrxrzrar%r+r(rbrbsB  11 && !FBv  r+rbcs2]tRtRt$RtR]R&RRltRtR#) TagNameMatchRulei<z@A MatchRule implementing the rules for matches against tag name.zOptional[_TagMatchFunction]rhcr?r$tagrr1r2r%r&r'r(r)ZTagNameMatchRule.__annotate__As  s t r+c sVPVP4pVeV#\\VP4pV!V4'dR#R#)NTF)rprOrrrh)r-r}Z base_valuerhs&& r( matches_tagZTagNameMatchRule.matches_tagAsD%%chh/  ! )4==9 C==r+r%N)rZr[r\r]r^r_r~rar%r+r(r{r{<sJ))  r+r{c&]tRtRt$RtR]R&RtR#)AttributeValueMatchRuleiNzGA MatchRule implementing the rules for matches against attribute value.z&Optional[_NullableStringMatchFunction]rhr%NrZr[r\r]r^r_rar%r+r(rrNs Q44r+rcr)StringMatchRuleiTzIA MatchRule implementing the rules for matches against a NavigableString.zOptional[_StringMatchFunction]rhr%Nrr%r+r(rrTs S,,r+rcsX]tRtRt$RtR]R&R]R&R]R&R,R R llt]R R l4t]RRl4t ]RRl4t ]RRl4t RRlt ] RRl4tRRltRRltRRltRRltR R!ltR-R"R#llt]!R$R%4R&R'l4t]!R(R%4R)R*l4tR+tR #). SoupStraineriZaThe `ElementFilter` subclass used internally by Beautiful Soup. A `SoupStrainer` encapsulates the logic necessary to perform the kind of matches supported by methods such as :py:meth:`Tag.find`. `SoupStrainer` objects are primarily created internally, but you can create one yourself and pass it in as ``parse_only`` to the `BeautifulSoup` constructor, to parse a subset of a large document. Internally, `SoupStrainer` objects work by converting the constructor arguments into `MatchRule` objects. Incoming tags/markup are matched against those rules. :param name: One or more restrictions on the tags found in a document. :param attrs: A dictionary that maps attribute names to restrictions on tags that use those attributes. :param string: One or more restrictions on the strings found in a document. :param kwargs: A dictionary that maps attribute names to restrictions on tags that use those attributes. These restrictions are additive to any specified in ``attrs``. zList[TagNameMatchRule] name_rulesz(Dict[str, List[AttributeValueMatchRule]]attribute_ruleszList[StringMatchRule] string_rulesNcrK) r$rOzOptional[_StrainableElement]rQz)Optional[Dict[str, _StrainableAttribute]]rUOptional[_StrainableString]kwargsrr%r&r'r(r)SoupStrainer.__annotate__zs2;;*;9;, ; ' ;r+c sxVfORV9dH\\\,VPR44p\P !R\ ^R7Vf,V'g$V'gV'g\RR7.VnM=\\\,\VPV\444Vn\\4Vn Vf/p\V\4'gRV/pW$3F}pVP!4FfwrgVR8XdWTJdRpVfRpVPV\"4F3pVPV,P%\\"V44K5 Kh K \\\&,\VPV\&444VnW0nR#) NtextznAs of version 4.11.0, the 'text' argument to the SoupStrainer constructor is deprecated. Use 'string' instead.Z stacklevelTrfZclassZclass_F)rr rZpopwarningswarnDeprecationWarningr{rrlist_make_match_rulesrrrjZdictitemsrrGrr_SoupStrainer__string) r-rOrQrUrZattrdictattrZvalueZrule_objs &&&&, r(r/ZSoupStrainer.__init__zsi >f.(#45vzz&7IJF MMA"  <fV 0=>DO"%&T-C-CDJZ-[(\DO +40 =E%&&e$E H'~~/ 8#(: #D=!E $ 6 6u>U VH((.554h?!W 0&"!  !4(>(>v(W#X  r+cr#r0r%r&r'r(r)rsZZTZr+c sVP'*;'d+VP'*;'dVP'*#)zCheck whether the provided rules will obviously include everything. (They might include everything even if this returns `False`, but not in an obvious way.) )rrrr3r4r(r5Z SoupStrainer.includes_everythings3 ??"YY4+<+<'<YYTEYEYAYYr+cr#r0r%r&r'r(r)rsTr+c srVP'd'VP'gVP'dR#\;QJd&RVP4F 'gK RM RM!RVP44'dR#\;QJd&RVP4F 'gK RM RM!RVP44'dR#VPP 4F@p\;QJdRV4F 'gK RM RM !RV44'gK?R# R#)zCheck whether the provided rules will obviously exclude everything. (They might exclude everything even if this returns `False`, but not in an obvious way.) Tc38"TFqPxK R#5irXrgZ.0rmrwr( 3SoupStrainer.excludes_everything..s?->##->Fc3rrXrrrwr(rrs=_##_rc3rrXrrrwr(rrs9A''r)rrrZanyrn)r-Zrulesetrwr(r7Z SoupStrainer.excludes_everythings    4???d6J6J6J 3?T->->?333?T->->? ? ? 3=T__=333=T__= = =++224Gs99sss99995r+cr#r$r1rr%r&r'r(r)rs3r+c T\P!R\^R7VP#):meta private:ziAccess to deprecated property string. (Look at .string_rules instead) -- Deprecated since version 4.13.0.rrrrrr3r4r(rUZSoupStrainer.strings%  w  }}r+cr#rr%r&r'r(r)rs1r+c r)rzgAccess to deprecated property text. (Look at .string_rules instead) -- Deprecated since version 4.13.0.rrr3r4r(rZSoupStrainer.texts%  u  }}r+cr#rrr%r&r'r(r)rs}}#}r+c  sRVPP RVP RVP RVP R2 #)rsz name=z attrs=rtru)Z __class__rZrrrr3r4r(rxZSoupStrainer.__repr__sD4>>**+6$//1B'$J^J^I__ghlhyhygzz{||r+crE)r$objz9Optional[Union[_StrainableElement, _StrainableAttribute]] rule_classzType[MatchRule]r1zIterator[MatchRule]r%r&r'r(r)rs(-.-. F-.$-.  -.r+c# s"VfR#\V\\34'dV!VR7xR#\V\4'dV!VR7xR#\ V4'dV!VR7xR#\V\ 4'dV!VR7xR#\ VR4'dV'g V!RR7xVFvp\V\\34'g<\ VR4'd*\P!R V R 2^R 7V!RR7xKZVPW24FpVxK Kx R#V!\V4R7xR#5i) zConvert a vaguely-specific 'object' into one or more well-defined `MatchRule` objects. :param obj: Some kind of object that corresponds to one or more matching rules. :param rule_class: Create instances of this `MatchRule` subclass. N)rUr)rh)rdZ__iter__TrzIgnoring nested list z0 to avoid the possibility of infinite recursion.r) rjrPrkr2ZcallablerZhasattrrrr)rvrrZormrIr(rZSoupStrainer._make_match_ruless  ;  cC< ( (C( ( T " "S) ) c]]c* * 7 8 8S) ) S* % %!D99!!eS\22wq*7M7MMM/s2bc#$%==..q=AG>$CH- -s B-E0BEcr?r|r%r&r'r(r)rsLLsLtLr+c sVP'gVP'gR#VP'gh\VP4^8XdNVP^,Pe/VP VP^,P8wdR#RpVP'dVP RVP 2pVP'dlRpVPFOpVP V4'g4VP'dK.VfK4VPV4'gKMRpM V'gR#VPP4F3wrVVPVR4pVPWv4pV'dK2R# VP'd,VPp V fR#VPV 4'gR#R#)aDo the rules of this `SoupStrainer` trigger a match against the given `Tag`? If the `SoupStrainer` has any `TagNameMatchRule`, at least one must match the `Tag` or its `Tag.name`. If there are any `AttributeValueMatchRule` for a given attribute, at least one of them must match the attribute value. If there are any `StringMatchRule`, at least one must match, but a `SoupStrainer` that *only* contains `StringMatchRule` cannot match a `Tag`, only a `NavigableString`. FN:T)rrZprefixrHrUrOr~rhrqrget_attribute_matchrmatches_any_string_rule) r-r} prefixed_nameZ name_matchesrulerrules attr_valuethis_attr_matchZ_strs && r(r~ZSoupStrainer.matches_tagsk(t';';';  DOO$)"))5DOOA.555  :::"zzl!CHH:6M ??? L##C(( MMMm.GDL_L_`mLnLn#'L(   //557KDt,J"33JFO"? 8    ::D|//55r+crE)r$rzOptional[_AttributeValue]rz!Iterable[AttributeValueMatchRule]r1r2r%r&r'r(r)rjs($$-$1$  $r+c sa\V\4'dTpM\\V4.pRV3RllpV!V4pV'gF\ V4^8wd6\\ \,V4pRP V4pV!V.4pV#)cr?)r$ attr_valueszSequence[Optional[str]]r1r2r%r&r'r(r)Z3SoupStrainer._attribute_match..__annotate__us  7N SW r+csb<SF'pVFpVPV4'gKR# K) R#)TF)rq)rrrrs& r(_match_attribute_value_helperZDSoupStrainer._attribute_match.._match_attribute_value_helperus0"-J**:66##.r+Z )rjrrrPrHr Zjoin)r-rrrrrZjoined_attr_values&&f r(rZSoupStrainer._attribute_matchjs j$ ' '$KZ01K  8 D3{#3q#8x}k:K # 5 ;=NZSoupStrainer.matchsp 8 8 8 gs # ###G, ,'?33334#7#7#7//8 8r+rSz4.13.0crE)r$rOrPrQrRr1r2r%r&r'r(r)rs"::s:+H:T:r+c s(VPRW4#)zGA less elegant version of `allow_tag_creation`. Deprecated as of 4.13.0N)rS)r-rOrQr=r( search_tagZSoupStrainer.search_tags &&tT99r+r>cr?)r$r:rr1zOptional[PageElement]r%r&r'r(r)rs88k8.C8r+c s8VPV4'dV#R#)zLA less elegant version of match(). Deprecated as of 4.13.0. :meta private: N)r>)r-r:r.r(roZSoupStrainer.searchs **W--w747r+)Z__stringrrr)NNNrY)rZr[r\r]r^r_r/r`r5r7rUrrxZ classmethodrr~rrSrWrr>r rrorar%r+r(rrZs6'&=='';zZZ*}-.-.^L\$L'R$ 4%x0:1: (#8$8r+r)/Z __future__rZ collectionsrrlZtypingrrrrrrrr r r r rZbs4._deprecationr Z bs4.elementrrrrrZ bs4._typingrrrrrrrrrrrrrZobjectr rbr{rrrr%r+r(rs"#     ("dFdNf f Ry$5i5 -i- b8=b8r+