rhj SrSSKJr SSKJrJr SSKrSSKrSSK r SSK J r SSK J r \R(aSSKJr SrS R%5r"S S \"S /S Q55r"S S\"S/SQ55r"SS\ 5r"SS5r"SS\ R05r\/r\S:XaSSK r \ R8"\5 gg)z* Classes for searching for Lyric objects. ) annotations) namedtuple OrderedDictN)Music21Exception)note) StreamTypez // zDel start end measure lyric text identifier absoluteStart absoluteEndc L\rSrSr%SrSrSSSSSS S S S S . rS\S'SrSr Sr g) IndexedLyric zR A Lyric that has been indexed to its attached element and position in a Stream. z)the element that the lyric is attached tozSuppose that the entire lyric for the stream were a single string: this is the index of the position in the string that this lyric starts at.zSuppose that the entire lyric for the stream were a single string: this is the index of the position in the string that this lyric ends at.zrThe measureNumber of the measure that the element is in in the stream. Same as .el.measureNumberz.The :class:`~music21.note.Lyric` object itselfz"The text of the lyric as a string.zThe identifier of the lyriczBthe position, not in the current identifier, but in all the lyricsz"the end position in all the lyrics elstartendmeasurelyrictext identifier absoluteStart absoluteEnddict[str, str] _DOC_ATTRcSUR<SUR<SUR<S3SUR<SUR<SUR <S3-SUR <S 3-$) NzIndexedLyric(el=z, start=z, end=, zmeasure=z, lyric=z, text= identifier=))rrrrrrrselfs O/home/james-whalen/.local/lib/python3.13/site-packages/music21/search/lyrics.py__repr__IndexedLyric.__repr__:sn"477+Xdjj^6$((UWXT\\,HTZZN'$))VXYZ2!45 6c [Vs/sHo!RU[X55PM nnUR"U6$s snf)z+ see docs for SortTuple for what this does ) _attrListgetgetattr __class__)rkeywordsattroutLists rmodifyIndexedLyric.modify?s=HQQyt<<gd&9:yQ~~w''Rs$>N) __name__ __module__ __qualname____firstlineno____doc__ __slots__r__annotations__r r+__static_attributes__r r"rr r sG I9%#>E87a?!I~ 6 (r"r r c@\rSrSr%SrSrSSSSSS S .rS \S 'S rSr g) SearchMatchHzD A lightweight object representing the match (if any) for a search. r z_ The measureNumber of the measure that the first matching lyric is in. z^ The measureNumber of the measure that the last matching lyric is in. a The text of the lyric that matched the search. For a plaintext search, this will be the same as the search term, but for a regular expression search this will be the text that matched the regular expression. zY A list of all lyric-containing elements that matched this text. zD A list of IndexedLyric objects that match. zd The identifier of (presumably all, but at least the first) lyric to match. mStartmEnd matchTextelsindicesrrrcSUR<SUR<S3SUR<SUR<S3-SUR<S3-$) NzSearchMatch(mStart=z, mEnd=rz matchText=z, els=z, indices=[...], rr)r9r:r;r<rrs rr SearchMatch.__repr__gsY%dkk_GDII=Kt~~0txxlBSTU2!45 6r"N) r-r.r/r0r1r2rr3r r4r r"rr6r6Hs?I)!I~26r"r6r8c\rSrSrSrg)LyricSearcherExceptionmr N)r-r.r/r0r4r r"rrArAmsr"rAc\rSrSrSrSSS.SSjjjr\SSj5r\SSj5rSSS jjr SSS jjr SS jr SSS jjr SS jr Srg) LyricSearcherqat An object that can find lyrics that match a certain regular expression and return relevant information about the match. Construct the LyricSearcher by passing in a Stream object (it can be a Score or Part or other nested item), and then call ".search()" on it. See :ref:`User's Guide, Chapter 28, Lyric Searching ` for full details. TODO: Bug that occasionally the previous note will be included; Search luca/gloria for "riam tuam." (From Gloriam tuam). For some reason, the whole "Gloria" is included. Does not occur if only "iam tuam." is searched. TODO: allow for all intermediate notes during a search to be found. includeIntermediateElements. TODO: allow for trailing melismas to also be included. TODO: Note that because of recursive searching w/ voices, there may be "phantom" lyrics found if a work contains multiple voices. N  wordSeparatorcTXlSUlSUlSUl/UlX lg)NF)streamincludeIntermediateElementsincludeTrailingMelisma _indexText _indexTuplesrH)rsrHs r__init__LyricSearcher.__init__s,'( +0(&+#$(02*r"cfURcUR5 UR=(d S$)z Returns the text that has been indexed (a la, :func:`~music21.text.assembleLyrics`): >>> p0 = corpus.parse('luca/gloria').parts[0] >>> ls = search.lyrics.LyricSearcher(p0) >>> ls.indexText[0:25] 'Et in terra pax hominibus' )rMindexrs r indexTextLyricSearcher.indexTexts& ?? " JJL$"$r"cTURcUR5 UR$N)rMrTrNrs r indexTuplesLyricSearcher.indexTupless! ?? " JJL   r"c  Uc URnOXl[5n[5n[5nUR5RGHHnURnU(dMUR nUGHnUR (dMURn X;a SX9'SXI'/X)'X9n XIn X)n [U 5n UR nU S;aX- n O)XRU-- n U [UR5- n XU '[X]U [U5-XxUU SS5 nU RU5 UR(d URn O=[R(aUR ceUR SRn XU 'GM GMK /nUR#5HnUR%U5 M SnSnSn/n UHnURU:waUnUS:waU[[&5- nURnUR)UR*U-UR,U-S9nUR.nU RU5 M Xl[&R3UR#55n XlU $)a A method that indexes the Stream's lyrics and returns the list of IndexedLyric objects. This does not actually need to be run, since calling .search() will call this if it hasn't already been called. >>> from pprint import pprint as pp >>> p0 = corpus.parse('luca/gloria').parts[0] >>> ls = search.lyrics.LyricSearcher(p0) >>> pp(ls.index()[0:5]) [IndexedLyric(el=, start=0, end=2, measure=1, lyric=, text='Et', identifier=1), IndexedLyric(el=, start=3, end=5, measure=2, lyric=, text='in', identifier=1), IndexedLyric(el=, start=6, end=9, measure=2, lyric=, text='ter', identifier=1), IndexedLyric(el=, start=9, end=11, measure=3, lyric=, text='ra', identifier=1), IndexedLyric(el=, start=12, end=15, measure=3, lyric=, text='pax', identifier=1)] * Changed in v6.7: indexed lyrics get an identifier. NrS)beginmiddleNr)rr)rJrrecursenoteslyrics measureNumberrrlenrHr append isCompositesyllabict TYPE_CHECKING componentsvaluesextendLINEBREAK_TOKENr+rrrrNjoinrM)rrOindexByIdentifieriTextByIdentifierlastSyllabicByIdentifiernlsmNumly lyIdentifieriText lastSyllabicrTposStarttxtilindexPreliminaryoneIdentifierIndexabsolutePosShiftlastIdentifierlastEndoneIndexnewIndexs rrTLyricSearcher.indexsn@ 9 AKFQm7B}>> import re >>> p0 = corpus.parse('luca/gloria').parts[0] >>> ls = search.lyrics.LyricSearcher(p0) >>> ls.search('pax') [SearchMatch(mStart=3, mEnd=3, matchText='pax', els=(,), indices=[...], identifier=1)] Search a regular expression that takes into account non-word characters such as commas >>> agnus = re.compile(r'agnus dei\W+filius patris', re.IGNORECASE) >>> sm = ls.search(agnus) >>> sm [SearchMatch(mStart=49, mEnd=55, matchText='Agnus Dei, Filius Patris', els=(,...), indices=[...], identifier=1)] >>> sm[0].mStart, sm[0].mEnd (49, 55) OMIT_FROM_DOCS Make sure that regexp characters are not interpreted as such in plaintext: This should only match Amen. >>> ls.search('en.') [SearchMatch(mStart=125, mEnd=125, matchText='en.', ...)] This should match 'ene', 'eni', and 'en.' >>> ls.search(re.compile('en.')) [SearchMatch(mStart=13, mEnd=13, matchText='ene', ...), SearchMatch(mStart=38, mEnd=38, matchText='ens', ...), SearchMatch(mStart=42, mEnd=42, matchText='eni', ...), SearchMatch(mStart=125, mEnd=125, matchText='en.', ...)] TfinditerFz3 is not a string or RE with the finditer() function) rJrNrT isinstancestrhasattrrA _reSearchrecompileescape)rtextOrRerO plainTexts rsearchLyricSearcher.searchsR 9 A KK t'8'8 JJqM h $ $I Xz * *I(*OPR R  >>"**RYYx-@"AB B>>(+ +r"cURH,nURUs=::aUR::dM&Us $ M. [SUS35e)z Finds an object in ._indexTuples by search position. Raises exception if no IndexedLyric for that position. Runs in O(n) time on number of lyrics. Would not be hard to do in O(log(n)) for very large lyrics Could not find position  in text)rNrrrA)rposis r_findObjInIndexByPos"LyricSearcher._findObjInIndexByPosLsJ""Aww#&&'#%'?uH%MNNr"c/nURH8nURU:dMURU::dM'URU5 M: U(d[ SUS35eU$)zI Finds a list of objects in ._indexTuples by search position (inclusive) rr)rNrrrdrA)rrxposEndr=rs r_findObjsInIndexByPos#LyricSearcher._findObjsInIndexByPos[s[""A}}x'AOOv,Eq!#(+CH:X)VW Wr"c /nURcU$URUR5HnUR5upEURS5nUR XES- 5nUSnUSn [ UR U R U[SU55UUSRS9n URU 5 M U$)Nrr^c38# UHoRv M g7frX)r).0 thisIndexs r *LyricSearcher._reSearch..s&MW ||Wsr8) rMrspangrouprr6rtuplerrd) rr locationsmabsoluteFoundPosabsoluteEndPosr;r= indexStartindexEndsms rrLyricSearcher._reSearch{s') ?? " DOO,A/0vvx ,  I001ATUCUVG Jr{HJ$6$6"*"2"2'0!&&MW&M!M%,(/ (=(= B   R - r")rMrNrKrLrJrHrX)rOzStreamType | NonerHr)returnr)rzlist[IndexedLyric])rlist[SearchMatch])rr )i?B)rz re.Patternrr)r-r.r/r0r1rPpropertyrUrYrTrrrrr4r r"rrDrDqs^.+#++ % %!! gR:,x O @r"rDc(\rSrSrSrSrSrSrg)Testict^^^SSKJn SSKJm SnURUSS9mTR 5R SR SnUUU4SjnU"5 SURSlS URS lU"5 S URSlS URS lU"5 g ) z4 This score uses a non-breaking space as an elision r converterru MusicXML Part G 4 1 1 quarter middle la   middle la MusicXMLformatct>TRRT5nTRURS5 g)Nula la)rarD assertEqualrU)rrrOrrs r runSearch0Test.testMultipleLyricsInNote..runSearchs+,,Q/B   R\\8 4r"r\rrsingleN) music21rrparseflattenr`rarirf)rrpartXMLrtrrOrs` @@rtestMultipleLyricsInNoteTest.testMultipleLyricsInNotes &" : OOGJO 7 YY[  q ! ( ( + 5  $+ a!$) a! $, a!$, a! r"c SSKJn SSKJn SnURUSS9nURR U5nUR URS5 URnUR [U5S5 [UR5R5nURUSRUSRS5 URUS RUS RS5 URUS RUSRS 5 URUS RUS RS 5 URUS RUS RS5 URS 5nUR [U5S 5 USn UR U RS 5 UR U R S 5 UR U R"US US 45 UR U R$S 5 UR [U R&5S 5 URU R&SRUS RS 5 URU R&S RUS RS5 [(R*"S5n URU 5nUR [U5S 5 USn UR U RS 5 UR U R S 5 UR U R,S5 UR U R$S 5 UR U R"US 45 US n UR U RS 5 UR U R S 5 UR U R,S5 UR U R$S 5 UR U R"US 45 URS5nUR [U5S 5 UR USRS 5 UR USR S 5 UR USR$S 5 g)Nrrra MusicXML Part G 4 2 1 half single hi single bye A 4 1 1 quarter begin there! begin Mi B 4 1 1 quarter end chael. rrzhi there! // bye Michael.rMichaelze[a-z]errzi t)rrrrrarDrrUrYrclistrr`assertIsrr9r:r<rr=rrr;) rrrrrOrrtuplesr`matchm0 e_with_letterm1s rtestMultipleVersesTest.testMultipleVersess%"= | OOGJO 7 ]] ( ( + 'BC Va(QYY[&&' fQioouQxq'9: fQioouQxq'9: fQioouQxq'9: fQioouQxq'9: fQioouQxq'9: )$ UQ' 1X A& !$ %(E!H!56 * RZZ!, bjjm))58??1+=> bjjm))58??1+=> 9-  -( UQ' 1X A& !$ t, * %(- 1X A& !$ t, * %(- %  UQ' q!, q* q,,a0r"cXSSKJn SSKJn SSKnSnUR USS9n[ S5HnSU-nUR RXWS 9nURS 5Hn U SU-U S -n URU 5n UR[U 5S 5 UR[U SR5S 5 URU SRSRU S5 URU SRS RU S 5 M M g) Nrrruq MuseScore 4.5.2 2025-06-22 钢琴, Track1 Pno. 钢琴 keyboard.piano 1 1 78.7402 0 2 0 F 4 G 3 2 1 quarter down single 长 E 3 1 1 eighth down begin single 亭 G 3 1 1 eighth down end C 4 2 1 quarter down single 外 2 1 quarter A 3 2 1 quarter down single 古 C 4 2 1 quarter down single 道 G 3 2 1 quarter down single 边 2 1 quarter light-heavy rrrrFrGu长亭外古道边rr) rrrmore_itertoolsrrangerarDpairwiserrcr<r) rrrrrrO lenWordSepwordSeprrpairkeywordrs rtestCustomSeparatorTest.testCustomSeparator<s%"fN OOGJO 7(JJ&G,,Q,FB&//0DEq'G+d1g5 '*  UQ/  U1X\\!2A6  qa!6!6Q@  qa!6!6Q@ F#r"r N)r-r.r/r0rrrr4r r"rrrs2hn1`vAr"r__main__)r1 __future__r collectionsrrrtypingrgunittestmusic21.exceptions21rrrrhmusic21.common.typesrrlsplitr$r r6rArDTestCaser _DOC_ORDERr-mainTestr r"rrs#/ 1??/ R X X Z $(:3$(P"6*]\^"6J - ^^H ]A8  ]AD _  z Tr"