+ CirJ^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#)) annotations) defaultdictN) AnyCallablecastDictIteratorIterableListOptionalSequenceTypeUnion) _deprecated) AttributeDictNavigableString PageElement ResultSetTag) _AtMostOneElement_AttributeValue_NullableStringMatchFunction _OneElement_PageElementMatchFunction _QueryResults_RawAttributeValues_RegularExpressionProtocol_StrainableAttribute_StrainableElement_StrainableString_StringMatchFunction_TagMatchFunctionc]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%)formats",/usr/lib/python3/dist-packages/bs4/filter.py __annotate__ElementFilter.__annotate__Is--'J-c WnR#)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&s&&r+__init__ElementFilter.__init__Is -r.cV^8dQhRR/#r(returnboolr))r*s"r+r,r-Ss ' 'T 'r.c $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. r0r1s&r+includes_everything!ElementFilter.includes_everythingRs&&&&r.cV^8dQhRR/#r5r))r*s"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)r9s&r+excludes_everything!ElementFilter.excludes_everythingasr.c$V^8dQhRRRRRR/#r(elementr _known_rulesr7r6r))r*s"r+r,r-qs!,,[,t,d,r.c V'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)r:r&r1rBrCs&&&r+matchElementFilter.matchqs5 8 8 8"""""7++r.c V^8dQhRRRR/#)r( generatorIterator[PageElement]r6zIterator[_OneElement]r))r*s"r+r,r-s11 51:O1r.c# "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)rCr)r:next StopIterationrFr)r1rIis&& r+filterElementFilter.filtersl  # # #  Oq::ad:33}a00 !!  s<A5A!A5 A#A5A5A5# A2.A51A22A5c V^8dQhRRRR/#)r(rIrJr6rr))r*s"r+r,r-s  3 8I r.c :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)rO)r1rIrFs&& r+findElementFilter.finds[[+EL,r.c$V^8dQhRRRRRR/#)r(rIrJlimitz Optional[int]r6rr))r*s"r+r,r-s$((.(7D( (r.c .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. )rOappendlenr)r1rIrVresultsrFs&&& r+find_allElementFilter.find_allsI[[+E NN5 ! S\U%:,''r.c(V^8dQhRRRRRRRR/# r(nsprefix Optional[str]namestrattrsOptional[_RawAttributeValues]r6r7r))r*s"r+r,r-s,  % -0 9V   r.c R#)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))r1r_rarcs&&&&r+allow_tag_creation ElementFilter.allow_tag_creationsr.c V^8dQhRRRR/#r(stringrbr6r7r))r*s"r+r,r-s  C D r.c R#)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)r1rjs&&r+allow_string_creation#ElementFilter.allow_string_creationsr.r0NF)__name__ __module__ __qualname____firstlineno____doc____annotations__r2propertyr:r>rFrOrSr[rfrm__static_attributes__r)r.r+r$r$,s_487- ' '  ,"1& (*   r.r$c]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. r`rj$Optional[_RegularExpressionProtocol]patternOptional[bool]presentexclude_everythingNc ,V^8dQhRRRRRRRRR R/#) r(rjzOptional[Union[str, bytes]]r|r{functionzOptional[Callable]r~r}rr))r*s"r+r,MatchRule.__annotate__s<!!+!6!% !  ! + !r.c \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)utf8NzREither 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.) isinstancebytesdecoderjrecompiler|rbrr~rrY ValueError)r1rjr|rr~rxvaluess&&&&&& r+r2MatchRule.__init__s  fe $ $]]6*F gu % %::gnnV&<=DL  % %::g.DL"L  "4kk4<< dNeNef f Af  v;! d  v;?m   s 4D??D?c V^8dQhRRRR/#)r(rjr`r6r}r))r*s"r+r,rs-Nr.c VP'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)rr~rjr|searchrls&&r+ _base_matchMatchRule._base_matchs  " " " <<4 % % <<5 T> ! ;; ";;&( ( << #~<<&&v.d: :r.c V^8dQhRRRR/#)r(rjr`r6r7r))r*s"r+r,r$s]tr.c VPV4pVeV#VPeVPV4'gR#R#)NFT)rr)r1rj _base_results&& r+matches_stringMatchRule.matches_string$s<''/  #  == $T]]6-B-Br.cV^8dQhRR/#r(r6rbr))r*s"r+r,r.svv#vr.c  \V4PpRV RVP RVP RVP RVP R2 #)< string=z pattern=z function=z present=>)typerqrjr|rr~)r1clss& r+__repr__MatchRule.__repr__.sN4j!!3%x }Idll^:dmm_\efjfrfresstuur.c V^8dQhRRRR/#)r(otherrr6r7r))r*s"r+r,r2s  C D r.c *\V\4;'d}VPVP8H;'d\VPVP8H;'d;VPVP8H;'dVP VP 8H#ro)rrzrjr|rr~)r1rs&&r+__eq__MatchRule.__eq__2s} ui ( . . u||+ . .  - . . / . .  -  r.)rrr|r~rj)NNNNN) rqrrrsrtrurvr2rrrrrxr)r.r+rzrzsB  11 && !FBv  r.rzc2]tRtRt$RtR]R&RRltRtR#) TagNameMatchRulei<z@A MatchRule implementing the rules for matches against tag name.zOptional[_TagMatchFunction]rc V^8dQhRRRR/#r(tagrr6r7r))r*s"r+r,TagNameMatchRule.__annotate__As  s t r.c VPVP4pVeV#\\VP4pV!V4'dR#R#)NTF)rrarr"r)r1r base_valuers&& r+ matches_tagTagNameMatchRule.matches_tagAsD%%chh/  ! )4==9 C==r.r)N)rqrrrsrtrurvrrxr)r.r+rr<sJ))  r.rc&]tRtRt$RtR]R&RtR#)AttributeValueMatchRuleiNzGA MatchRule implementing the rules for matches against attribute value.z&Optional[_NullableStringMatchFunction]rr)Nrqrrrsrtrurvrxr)r.r+rrNs Q44r.rc&]tRtRt$RtR]R&RtR#)StringMatchRuleiTzIA MatchRule implementing the rules for matches against a NavigableString.zOptional[_StringMatchFunction]rr)Nrr)r.r+rrTs S,,r.rcX]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_rulesNc(V^8dQhRRRRRRRR/#) r(razOptional[_StrainableElement]rcz)Optional[Dict[str, _StrainableAttribute]]rjOptional[_StrainableString]kwargsrr))r*s"r+r,SoupStrainer.__annotate__zs2;;*;9;, ; ' ;r.c xVfORV9dH\\\,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. stacklevelTr~classclass_F)rr r popwarningswarnDeprecationWarningrrr list_make_match_rulesrrrdictitemsrrXrr_SoupStrainer__string) r1rarcrjrattrdictattrvaluerule_objs &&&&, r+r2SoupStrainer.__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.cV^8dQhRR/#r5r))r*s"r+r,rsZZTZr.c VP'*;'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.) )rrrr9s&r+r: SoupStrainer.includes_everythings3 ??"YY4+<+<'<YYTEYEYAYYr.cV^8dQhRR/#r5r))r*s"r+r,rsTr.c rVP'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#5iror.0rs& r+ 3SoupStrainer.excludes_everything..s?->##->Fc38"TFqPxK R#5irorrs& r+rrs=_##_rc38"TFqPxK R#5irorrs& r+rrs9A''r)rrranyr)r1rulesets& r+r> SoupStrainer.excludes_everythings    4???d6J6J6J 3?T->->?333?T->->? ? ? 3=T__=333=T__= = =++224Gs99sss99995r.cV^8dQhRR/#r(r6rr))r*s"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.rrrrrr9s&r+rjSoupStrainer.strings%  w  }}r.cV^8dQhRR/#rr))r*s"r+r,rs1r.c T\P!R\^R7VP#)rzgAccess to deprecated property text. (Look at .string_rules instead) -- Deprecated since version 4.13.0.rrr9s&r+rSoupStrainer.texts%  u  }}r.cV^8dQhRR/#rr))r*s"r+r,rs}}#}r.c  RVPP RVP RVP RVP R2 #)rz name=z attrs=rr) __class__rqrrrr9s&r+rSoupStrainer.__repr__sD4>>**+6$//1B'$J^J^I__ghlhyhygzz{||r.c$V^8dQhRRRRRR/#)r(objz9Optional[Union[_StrainableElement, _StrainableAttribute]] rule_classzType[MatchRule]r6zIterator[MatchRule]r))r*s"r+r,rs(-.-. F-.$-.  -.r.c# "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)rjr)r)r|__iter__TrzIgnoring nested list z0 to avoid the possibility of infinite recursion.r) rrbrr7callablerhasattrrrr)rrrors&&& r+rSoupStrainer._make_match_ruless  ;  cC< ( (C( ( T " "S) ) c]]c* * 7 8 8S) ) S* % %!D99!!eS\22wq*7M7MMM/s2bc#$%==..q=AG>$CH- -s B-E0BEc V^8dQhRRRR/#rr))r*s"r+r,rsLLsLtLr.c VP'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)rrprefixrYrjrarrrrget_attribute_matchrmatches_any_string_rule) r1r prefixed_name name_matchesrulerrules attr_valuethis_attr_match_strs && r+rSoupStrainer.matches_tagsk(t';';';  DOO$)"))5DOOA.555  :::"zzl!CHH:6M ??? L##C(( MMMm.GDL_L_`mLnLn#'L(   //557KDt,J"33JFO"? 8    ::D|//55r.c$V^8dQhRRRRRR/#)r(rzOptional[_AttributeValue]rz!Iterable[AttributeValueMatchRule]r6r7r))r*s"r+r,rjs($$-$1$  $r.c a\V\4'dTpM\\V4.pRV3RllpV!V4pV'gF\ V4^8wd6\\ \,V4pRP V4pV!V.4pV#)c V^8dQhRRRR/#)r( attr_valueszSequence[Optional[str]]r6r7r))r*s"r+r,3SoupStrainer._attribute_match..__annotate__us  7N SW r.cb<SF'pVFpVPV4'gKR# K) R#)TF)r)r rrrs& r+_match_attribute_value_helperDSoupStrainer._attribute_match.._match_attribute_value_helperus0"-J**:66##.r. )rrrrbrYr join)r1rrr rrjoined_attr_values&&f r+rSoupStrainer._attribute_matchjs j$ ' '$KZ01K  8 D3{#3q#8x}k:K # 5 ;=Nrjrr classmethodrrrrfrmrrFrr&rrxr)r.r+rrZs6'&=='';zZZ*}-.-.^L\$L'R$ 4%x0:1: (#8$8r.r)/ __future__r collectionsrrtypingrrrrr r r r r rrrbs4._deprecationr bs4.elementrrrrr bs4._typingrrrrrrrrrrr r!r"objectr$rzrrrrr)r.r+r4s"#     ("dFdNf f Ry$5i5 -i- b8=b8r.