=wgIdZddlZddlmZddlmZmZddlmZGddeZ Gdd eZ Gd d e Z Gd d e Z Gdde ZeZGdde ZGdde Zy)a This module contains "matcher" classes. Matchers deal with posting lists. The most basic matcher, which reads the list of postings for a term, will be provided by the backend implementation (for example, :class:`whoosh.filedb.filepostings.FilePostingReader`). The classes in this module provide additional functionality, such as combining the results of two matchers, or modifying the results of a matcher. You do not need to deal with the classes in this module unless you need to write your own Matcher implementation to provide some new functionality. These classes are not instantiated by the user. They are usually created by a :class:`~whoosh.query.Query` object's :meth:`~whoosh.query.Query.matcher()` method, which returns the appropriate matcher to implement the query (for example, the :class:`~whoosh.query.Or` query's :meth:`~whoosh.query.Or.matcher()` method returns a :py:class:`~whoosh.matching.UnionMatcher` object). Certain backends support "quality" optimizations. These backends have the ability to skip ahead if it knows the current block of postings can't contribute to the top N documents. If the matcher tree and backend support these optimizations, the matcher's :meth:`Matcher.supports_block_quality()` method will return ``True``. N)repeat)izipxrange)abstractmethodceZdZdZy) ReadTooFarzRaised when :meth:`~whoosh.matching.Matcher.next()` or :meth:`~whoosh.matching.Matcher.skip_to()` are called on an inactive matcher. N__name__ __module__ __qualname____doc__L/var/www/horilla/myenv/lib/python3.12/site-packages/whoosh/matching/mcore.pyrr=srrceZdZdZy)NoQualityAvailablezoRaised when quality methods are called on a matcher that does not support block quality optimizations. Nr rrrrrDsrrc.eZdZdZedZedZdZdZd#dZ dZ d Z d$d Z ed Z d Zd ZdZdZedZdZdZdZedZedZedZdZdZdZedZdZedZdZdZ dZ!d Z"d!Z#d"Z$y)%Matcherz!Base class for all matchers. ct)z}Returns True if this matcher is still "active", that is, it has not yet reached the end of the posting list. NotImplementedErrorselfs r is_activezMatcher.is_activePs "!rct)aReturns to the start of the posting list. Note that reset() may not do what you expect after you call :meth:`Matcher.replace()`, since this can mean calling reset() not on the original matcher, but on an optimized replacement. rrs rresetz Matcher.resetXs "!rcy)zReturns a ``("fieldname", "termtext")`` tuple for the term this matcher matches, or None if this matcher is not a term matcher. Nrrs rtermz Matcher.termcs rc#K|j|y|jD]}|jD]}|yw)z;Returns an iterator of term matchers in this tree. N)rchildren term_matchers)rcmms rr!zMatcher.term_matchersjsK 99; "Jmmo ))+AG sAANc#K|jsy||j}n||jk7ry|j}|0|jD]}|j |D]}|y|yw)zReturns an iterator of ``("fieldname", "termtext")`` tuples for the **currently matching** term matchers in this tree. N)ridrr matching_terms)rr%tcs rr&zMatcher.matching_termsus ~~  :B 4779_  IIK 9]]_ ))"-AG GsBBc6t|j SN)boolr rs ris_leafzMatcher.is_leafs (((rcgS)zUReturns an (possibly empty) list of the submatchers of this matcher. rrs rr zMatcher.childrens  rc|S)zReturns a possibly-simplified version of this matcher. For example, if one of the children of a UnionMatcher is no longer active, calling this method on the UnionMatcher will return the other child. rr minqualitys rreplacezMatcher.replaces  rct)z(Returns a copy of this matcher. rrs rcopyz Matcher.copy "!rcy)zsReturns the depth of the tree under this matcher, or 0 if this matcher does not have any children. rrrs rdepthz Matcher.depths rcy)zdReturns True if this matcher supports the use of ``quality`` and ``block_quality``. Frrs rsupports_block_qualityzMatcher.supports_block_qualitys rc,t|j)zReturns the maximum possible quality measurement for this matcher, according to the current weighting algorithm. Raises ``NoQualityAvailable`` if the matcher or weighting do not support quality measurements. r __class__rs r max_qualityzMatcher.max_quality!00rc,t|j)zReturns a quality measurement of the current block of postings, according to the current weighting algorithm. Raises ``NoQualityAvailable`` if the matcher or weighting do not support quality measurements. r:rs r block_qualityzMatcher.block_qualityr=rct)z/Returns the ID of the current posting. rrs rr%z Matcher.idr4rc#Kd}|}|jrP|j|j|dz }|dk(r|j}d}|jrOyyw)a<Returns a generator of all IDs in the matcher. What this method returns for a matcher that has already read some postings (whether it only yields the remaining postings or all postings from the beginning) is undefined, so it's best to only use this method on fresh matchers. r N)rr%nextr1rir#s rall_idszMatcher.all_idssZ  kkm$$&L FFH FABwIIK kkms A#A(&A(c#Kd}|}|jr`|j|jf|j|dz }|dk(r|j }d}|jr_yyw)aRReturns a generator of all (ID, encoded value) pairs in the matcher. What this method returns for a matcher that has already read some postings (whether it only yields the remaining postings or all postings from the beginning) is undefined, so it's best to only use this method on fresh matchers. rrBrCN)rr%valuerDr1rEs r all_itemszMatcher.all_itemssh  nn4461779% % FFH FABwIIK nns A3A86A8c#K|jrE|j|j|f|j|jrDyyw)aRReturns a generator of all (ID, decoded value) pairs in the matcher. What this method returns for a matcher that has already read some postings (whether it only yields the remaining postings or all postings from the beginning) is undefined, so it's best to only use this method on fresh matchers. N)rr%value_asrDrastypes ritems_aszMatcher.items_assAnn779dmmF34 4 IIKnns AAAct)z:Returns the encoded value of the current posting. rrs rrIz Matcher.valuer4rc2td|jz)zzReturns True if the field's format supports the named data type, for example 'frequency' or 'characters'. zsupports not implemented in %srr;rMs rsupportszMatcher.supportss ""B$(NN#34 4rc2td|jz)zGReturns the value(s) of the current posting as the given type. zvalue_as not implemented in %srRrMs rrLzMatcher.value_as s ""B$(NN#34 4rc *ddlm}|jdr0|jdDcgc]\}}}||||c}}}S|jdr%|jdDcgc] }|| c}St dcc}}}wcc}w)zReturns a list of :class:`~whoosh.query.spans.Span` objects for the matches in this document. Raises an exception if the field being searched does not store positions. rSpan characters startcharendchar positionszField does not support spans)whoosh.query.spansrWrSrL ExceptionrrWposrZr[s rspansz Matcher.spanss , == &37==3NPP/Y 7CP P ]]; ')-{)CD#DID D:; ; PEs B ,Bc|jrJ|j|kr6|j|jr|j|kr4yyyy)zjMoves this matcher to the first posting with an ID equal to or greater than the given ID. N)rr%rDrr%s rskip_tozMatcher.skip_to%sC nn4779r> IIKnn4779r>>rc@t|jj)zhMoves this matcher to the next block with greater than the given minimum quality value. rr;r r/s rskip_to_qualityzMatcher.skip_to_quality- "$.."9"9::rc@t|jj)z0Moves this matcher to the next posting. rfrs rrDz Matcher.next4rhrc$|jdS)z3Returns the weight of the current posting. weight)rLrs rrkzMatcher.weight;s}}X&&rc@t|jj)z2Returns the score of the current posting. rfrs rscorez Matcher.scoreArhrc0|jt|uSr*)r;typerothers r__eq__zMatcher.__eq__Hs~~e,,rc0t||juSr*)ror;rps r__lt__zMatcher.__lt__KsE{dnn,,rc&|j| Sr*)rrrps r__ne__zMatcher.__ne__Ns;;u%%%rcL|j|xs|j| Sr*)rtrrrps r__gt__zMatcher.__gt__Qs"KK&<$++e*<==rcJ|j|xs|j|Sr*)rrrtrps r__le__zMatcher.__le__T{{5!7T[[%77rcJ|j|xs|j|Sr*)rrrxrps r__ge__zMatcher.__ge__Wr{rr*r)%r r r r rrrrr!r&r,r r1r3r6r8r<r?r%rGrJrOrIrSrLrardrgrDrkrmrrrtrvrxrzr}rrrrrLs."""" *)"" 11"" && "" 4444< ;;; ' ;; --&>88rrc2eZdZddZdZdZdZdZdZy) ConstantScoreMatcherc||_yr*_score)rrms r__init__zConstantScoreMatcher.__init__^s  rcyNTrrs rr8z+ConstantScoreMatcher.supports_block_qualityarc|jSr*rrs rr<z ConstantScoreMatcher.max_qualityd {{rc|jSr*rrs rr?z"ConstantScoreMatcher.block_qualitygrrcD||jk\r|jyyr*)r go_inactiver/s rrgz$ConstantScoreMatcher.skip_to_qualityjs  $     %rc|jSr*rrs rrmzConstantScoreMatcher.scorenrrN)?) r r r rr8r<r?rgrmrrrrr]s rrcLeZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z y ) NullMatcherClassz4Matcher with no postings which is never active. c|Sr*rrs r__call__zNullMatcherClass.__call__x rcy)Nz rrs r__repr__zNullMatcherClass.__repr__{srcyrrrs rr8z'NullMatcherClass.supports_block_quality~rrcyNrrrs rr<zNullMatcherClass.max_qualityrcyrrrs rr?zNullMatcherClass.block_qualityrrcyrrr/s rrgz NullMatcherClass.skip_to_qualityrrcy)NFrrs rrzNullMatcherClass.is_activesrcyr*rrs rrzNullMatcherClass.resets rcgSr*rrs rrGzNullMatcherClass.all_idss rc|Sr*rrs rr3zNullMatcherClass.copyrrN)r r r r rrr8r<r?rgrrrGr3rrrrrts9 rrceZdZdZ ddZdZdZdZdZdZ d Z dd Z d Z d Z d ZdZdZdZdZdZdZdZdZdZdZdZdZdZy) ListMatcherz/Synthetic matcher backed by a list of IDs. Nc ||_||_||_||_||_||_||_||_| |_y)ak :param ids: a list of doc IDs. :param weights: a list of weights corresponding to the list of IDs. If this argument is not supplied, a list of 1.0 values is used. :param values: a list of encoded values corresponding to the list of IDs. :param format: a :class:`whoosh.formats.Format` object representing the format of the field. :param scorer: a :class:`whoosh.scoring.BaseScorer` object for scoring the postings. :param term: a ``("fieldname", "text")`` tuple, or None if this is not a term matcher. N) _ids_weights _all_weights_values_i_format_scorer_term _terminfo) ridsweightsvaluesformatscorerposition all_weightsrterminfos rrzListMatcher.__init__sD"  '    !rc4d|jjzS)Nz<%s>)r;r rs rrzListMatcher.__repr__s////rcF|jt|jkSr*)rlenrrs rrzListMatcher.is_activeswwTYY''rcd|_yrrrs rrzListMatcher.resets rc|jst||jkry|jt |j krs|j |j|krV|xjdz c_|jt |j kr|j |j|krTyyyyNrB)rrr%rrrrcs rrdzListMatcher.skip_tos~~   > ggDII&499TWW+=+B GGqLGggDII&499TWW+=+B&+B&rc|jSr*rrs rrzListMatcher.term zzrc |j|j|j|j|j|j |j |jSr*)r;rrrrrrrrs rr3zListMatcher.copysA~~dii "llDLL$''"//1 1rcx|js tS|r|j|kr tS|Sr*)r NullMatcherr<r/s rr1zListMatcher.replaces4~~= D,,.;= KrcV|jduxr|jjSr*)rr8rs rr8z"ListMatcher.supports_block_qualitys( D(:LL779 ;rcp|jr|jj|S|jSr*)rr?block_max_weightrs rr<zListMatcher.max_qualitys/ <<<<--d3 3((* *rc8|jj|Sr*)rr?rs rr?zListMatcher.block_qualitys||))$//rc|jt|jkr^|j|krK|xjdz c_|jt|jkr|j|krKy)NrBr)rrrr?r/s rrgzListMatcher.skip_to_qualitys\ggDII&4+=+=+?:+M GGqLGggDII&4+=+=+?:+Mrc4|j|jSr*)rrrs rr%zListMatcher.idsyy!!rc,t|jSr*)iterrrs rrGzListMatcher.all_idssDIIrc`|j}| td}t|j|S)N)rrrr)rrs rrJzListMatcher.all_itemss* >BZFDIIv&&rc"|jr|j|j}t|trXt |dkDsJt |dk(r|d}n|j j |}||j|j<|Sy)NrrBr)rr isinstancelistrrcombine)rvs rrIzListMatcher.valuesy << TWW%A!T"1vz!zq6Q;!A ,,Q/A() TWW%Hrcd|jj|}||jSr*)rdecoderrIrrNrs rrLzListMatcher.value_ass',,&&v.tzz|$$rc8|jj|Sr*)rrSrMs rrSzListMatcher.supportss||$$V,,rc.|xjdz c_yrrrs rrDzListMatcher.nexts 1 rc~|jr |jS|jr|j|jSyNr)rrrrs rrkzListMatcher.weights4   $$ $ ]]==) )rc6|jjSr*)r min_lengthrs rblock_min_lengthzListMatcher.block_min_length'~~((**rc6|jjSr*)r max_lengthrs rblock_max_lengthzListMatcher.block_max_length*rrc|jr |jS|jrt|jS|j|jj Syr)rrmaxr max_weightrs rrzListMatcher.block_max_weight-sM   $$ $ ]]t}}% % ^^ '>>,,. .rcp|jr|jj|S|jSr*)rrmrkrs rrmzListMatcher.score7s* <<<<%%d+ +;;= r)NNNNrNNNr~)r r r r rrrrrdrr3r1r8r<r?rgr%rGrJrIrLrSrDrkrrrrmrrrrrs?CAE"60(1 ;+0 "'0%-++!rrcHeZdZdZdZdZdZdZdZdZ dZ d Z d Z y ) LeafMatchercx|jjd|jd|jdS)N(z, ))r;r rrrs rrzLeafMatcher.__repr__Es+#~~66 #~~/1 1rc|jSr*rrs rrzLeafMatcher.termIrrc#K|jj|}|jD]\}}|||fywr*)rrrJ)rrNrr%rIs rrOzLeafMatcher.items_asLsC++%%f-) 'IBwu~& & 'sAAc8|jj|Sr*)rrSrMs rrSzLeafMatcher.supportsQs{{##F++rcd|jj|}||jSr*)rrrIrs rrLzLeafMatcher.value_asTs'++%%f-tzz|$$rc Lddlm}|jdr0|jdDcgc]\}}}||||c}}}S|jdr%|jdDcgc] }|| c}St d|j zcc}}}wcc}w)NrrVrXrYr\z%Field does not support positions (%r))r]rWrSrLr^rr_s rrazLeafMatcher.spansXs+ == &37==3NPP/Y 7CP P ]]; ')-{)CD#DID DC"iik*+ + PEs B,B!cR|jxr|jjSr*)rr8rs rr8z"LeafMatcher.supports_block_qualityds{{Ct{{AACCrc6|jjSr*)rr<rs rr<zLeafMatcher.max_qualitygs{{&&((rc8|jj|Sr*)rr?rs rr?zLeafMatcher.block_qualityjs{{((..rc8|jj|Sr*)rrmrs rrmzLeafMatcher.scorems{{  &&rN) r r r rrrOrSrLrar8r<r?rmrrrrr@s5 1' ,% +D)/'rr)r sys itertoolsr whoosh.compatrrrr^rrobjectrrrrrrrrrrs}80 &( L8fL8b7. w H `!'`!J.''.'r