rh0%SrSSKJr /SQrSSKJr SSKrSSKrSSKr SSK r SSK J r SSK J r SSK Jr SS K Jr SS K Jr SS KJr \ R&(a4SSKrSS K Jr SS K Jr SSK Jr SSK Jr SSK Jr SSK Jr SSK Jr SSK Jr \ R:"S5r\R>"S5r /SQr!\!Vs0sH oSUS_M snr"0r#S\$S'\RJ"S5r&\RJ"S5r'\RJ"S5r(\RJ"S5r)\RJ"S5r*\RJ"S5r+"S S!\RX5r-"S"S#\RX5r."S$S%\RX5r/"S&S'\R`\ RbRd5r3"S(S)\35r4"S*S+\35r5"S,S-\35r6"S.S/\35r7"S0S1\35r8"S2S3\35r9"S4S5\35r:"S6S7\35r;"S8S9\35r<"S:S;\35r="S<S=\35r>"S>S?\35r?"S@SA\35r@"SBSC\35rA"SDSE\35rB"SFSG\35rC"SHSI\35rD"SJSK\35rE"SLSM\E5rF"SNSO5rG"SPSQ\G5rHSXSRjrI"SSST\R`5rJ"SUSV\ R5rL\J\G\H/rM\NSW:XaSSK r \ R"\L5 ggs snf)Ya ABC is a music format that, while being able to encode all sorts of scores, is especially strong at representing monophonic music, and folk music in particular. Modules in the `music21.abcFormat` package deal with importing ABC into music21. Most people working with ABC data won't need to use this package. To convert ABC from a file or URL to a :class:`~music21.stream.Stream` use the :func:`~music21.converter.parse` function of the `converter` module: >>> #_DOCS_SHOW from music21 import * >>> #_DOCS_SHOW abcScore = converter.parse('/users/ariza/myScore.abc') For users who will be editing ABC extensively or need a way to have music21 output ABC (which it doesn't do natively), we suggest using the open source EasyABC package: https://easyabc.sourceforge.net . You can set it up as a MusicXML reader through: >>> #_DOCS_SHOW us = environment.UserSettings() >>> #_DOCS_SHOW us['musicxmlPath'] = '/Applications/EasyABC.app' or wherever you have downloaded EasyABC to (PC users might need: 'c:/program files (x86)/easyabc/easyabc.exe') (Thanks to Norman Schmidt for the heads-up) There is a two-step process in converting ABC files to music21 Streams. First this module reads in the text-based .abc file and converts all the information into ABCToken objects. Then the function :func:`music21.abcFormat.translate.abcToStreamScore` of the :ref:`moduleAbcFormatTranslate` module translates those Tokens into music21 objects. Music21 implements the entire v1.6 ABC standard (January 1997) found at https://abcnotation.com/standard/abc_v1.6.txt . The system aims to support the v2.1 ABC standard (December 2011) found at https://abcnotation.com/wiki/abc:standard:v2.1 but some parts (e.g. 4.10 Variant Endings) are not implemented. No support is yet given for the draft 2.2 standard. ) annotations) translate testFilesABCTokenExceptionABCHandlerExceptionABCFileExceptionABCToken ABCMetadataABCBar ABCTupletABCTie ABCSlurStart ABCParenStop ABCCrescStart ABCDimStart ABCStaccatoABCUpbow ABCDownbow ABCAccent ABCStraccent ABCTenuto ABCGraceStart ABCGraceStopABCBrokenRhythmMarkerABCNoteABCChord ABCHandler ABCHandlerBarmergeLeadingMetaDataABCFile)SequenceN)common)defaults) environment) exceptions21)prebase)rbarclefdurationdynamicskeymetertempospanner_T abcFormat)):|1zlight-heavy-repeat-end-first):|2zlight-heavy-repeat-end-second)|]z light-heavy)||z light-light)z[|z heavy-light)[1 regular-first)[2regular-second)|1r>)|2r@):|zlight-heavy-repeat-end)|:zheavy-light-repeat-start)::z heavy-heavy-repeat-bidirectional)|regular):dottedz3dict[tuple[str, str, str], tuple[str, bool | None]]_pitchTranslationCachez[A-Zw]:z [a-gA-Gz]z"[^"]*"z[.*?]z%abc-(\d+)\.(\d+)\.?(\d+)?z^%%([a-z\-]+)\s+(\S+)(.*)c\rSrSrSrg)rN__name__ __module__ __qualname____firstlineno____static_attributes__rNT/home/james-whalen/.local/lib/python3.13/site-packages/music21/abcFormat/__init__.pyrrrUrc\rSrSrSrg)rrNNrOrNrUrVrrrWrUrc\rSrSrSrg)rrNNrOrNrUrVrrrWrUrcP\rSrSrSrSrS S SjjrSr\S Sj5r Sr Sr Sr g ) r a ABC processing works with a multi-pass procedure. The first pass breaks the data stream into a list of ABCToken objects. ABCToken objects are specialized in subclasses. The multi-pass procedure is conducted by an ABCHandler object. The ABCHandler.tokenize() method breaks the data stream into ABCToken objects. The :meth:`~music21.abcFormat.ABCHandler.tokenProcess` method first calls the :meth:`~music21.abcFormat.ABCToken.preParse` method on each token, then does contextual adjustments to all tokens, then calls :meth:`~music21.abcFormat.ABCToken.parse` on all tokens. The source ABC string itself is stored in self.src. Because of how copying ABCTokens works, all tokens must have default parameters in their initializers srccXlgNr^)selfr_s rV__init__ABCToken.__init__srUc,[UR5$ra)reprr_rbs rV _reprInternalABCToken._reprInternalsDHH~rUc:SU;aURS5S$U$)a removes ABC-style comments from a string: >>> ao = abcFormat.ABCToken() >>> ao.stripComment('asdf') 'asdf' >>> ao.stripComment('asdf%234') 'asdf' >>> ao.stripComment('asdf % 234') 'asdf ' >>> ao.stripComment('[ceg]% this chord appears 50% more often than other chords do') '[ceg]' This is a static method, so it can also be called on the class itself: >>> abcFormat.ABCToken.stripComment('b1 % a b-flat actually') 'b1 ' * Changed in v6.2: made a staticmethod %r)split)strSrcs rV stripCommentABCToken.stripComments$, &=<<$Q' ' rUcg)ze Dummy method that is called before contextual adjustments. Designed to be subclassed or overridden. NrNrgs rVpreParseABCToken.preParses rUcg)z Dummy method that reads self.src and loads attributes. It is called after contextual adjustments. It is designed to be subclassed or overridden. NrNrgs rVparseABCToken.parses rUNr_str)rmryreturnry) rPrQrRrS__doc__ __slots__rcrh staticmethodrnrqrtrTrNrUrVr r s6"I2  rUr c^\rSrSrSrSrSSU4SjjjrSSjrSrSSjr SSjr SS jr SS jr SS jr SS jrSS jrSSjrSSjrSSjrSSjrSSjrSSjrS SjrS!SjrS"SjrS#SjrSrU=r$)$r a? Defines a token of metadata in ABC. >>> md = abcFormat.ABCMetadata('I:linebreak') >>> md.src 'I:linebreak' Has two attributes, `tag` and `data` which are strings. Initially both are set to '': >>> md.tag '' After calling `preParse()`, these are separated: >>> md.preParse() >>> md.tag 'I' >>> md.data 'linebreak' )tagdatac@>[TU]U5 SUlSUlgNrw)superrcrrrbr_ __class__s rVrcABCMetadata.__init__s  rUc[RUR5=n(aPUR5nUR UR5nUSUS- UlX2SR 5Ulgg)z Called before contextual adjustments and needs to have access to data. Divides a token into .tag (a single capital letter or w) and .data representations. >>> x = abcFormat.ABCMetadata('T:tagData') >>> x.preParse() >>> x.tag 'T' >>> x.data 'tagData' NrJ) reMetadataTagmatchr_endrnrstripr)rbrdivrms rVrqABCMetadata.preParsesh"''1 15 1))+C&&txx0FhsQw'DHt **,DI 2rUcgrarNrgs rVrtABCMetadata.parse s rUc&URS:Xagg)z2 Returns True if the tag is "L", False otherwise. LTFrrgs rVisDefaultNoteLengthABCMetadata.isDefaultNoteLength  88s?rUc&URS:Xagg)z Returns True if the tag is "X", False otherwise. >>> x = abcFormat.ABCMetadata('X:5') >>> x.preParse() >>> x.tag 'X' >>> x.isReferenceNumber() True XTFrrgs rVisReferenceNumberABCMetadata.isReferenceNumbers 88s?rUcfURS:Xa!URRS5(agg)aE Returns True if the tag is "I" for "Information" and the data is "abc-version", False otherwise. >>> x = abcFormat.ABCMetadata('I:abc-version 2.1') >>> x.preParse() >>> x.tag 'I' >>> x.isVersion() True >>> deer = abcFormat.ABCMetadata('I:abc-venison yummy') >>> deer.preParse() >>> deer.tag 'I' >>> deer.isVersion() False Iz abc-version TF)rr startswithrgs rV isVersionABCMetadata.isVersion$s)& 88s?tyy33NCCrUc&URS:Xagg)z< Returns True if the tag is "M" for meter, False otherwise. MTFrrgs rVisMeterABCMetadata.isMeter;rrUc&URS:Xagg)z< Returns True if the tag is "T" for title, False otherwise. TTFrrgs rVisTitleABCMetadata.isTitleCrrUc&URS:Xagg)z? Returns True if the tag is "C" for composer, False otherwise. CTFrrgs rV isComposerABCMetadata.isComposerKrrUc&URS:Xagg)z~ Returns True if the tag is "O" for origin, False otherwise. This value is set in the Metadata `localOfComposition` of field. OTFrrgs rVisOriginABCMetadata.isOriginSs 88s?rUc&URS:Xagg)z2 Returns True if the tag is "V", False otherwise. VTFrrgs rVisVoiceABCMetadata.isVoice\rrUc&URS:Xagg)z Returns True if the tag is "K", False otherwise. Note that in some cases a Key will encode clef information. (example from corpus: josquin/laDeplorationDeLaMorteDeJohannesOckeghem.abc) KTFrrgs rVisKeyABCMetadata.isKeyds 88s?rUc&URS:Xagg)z< Returns True if the tag is "Q" for tempo, False otherwise. QTFrrgs rVisTempoABCMetadata.isTempoorrUcUR5(d [S5eURR5S:XagURS:XaSupSnOURS:XaSupS nOURR S 5upE[ [ R"UR55S 5n[ [ R"UR55S 5nS nXU4$) a If there is a time signature representation available, get a numerator, denominator and an abbreviation symbol. To get a music21 :class:`~music21.meter.TimeSignature` object, use the :meth:`~music21.abcFormat.ABCMetadata.getTimeSignatureObject` method. >>> am = abcFormat.ABCMetadata('M:2/2') >>> am.preParse() >>> am.isMeter() True >>> am.getTimeSignatureParameters() (2, 2, 'normal') >>> am = abcFormat.ABCMetadata('M:C|') >>> am.preParse() >>> am.getTimeSignatureParameters() (2, 2, 'cut') >>> am = abcFormat.ABCMetadata('M: none') >>> am.preParse() >>> am.getTimeSignatureParameters() is None True >>> am = abcFormat.ABCMetadata('M: FREI4/4') >>> am.preParse() >>> am.getTimeSignatureParameters() (4, 4, 'normal') z/no time signature associated with this metadatanoneNr)rr"C|)rcut/rnormal) rrrlowerrlintr" getNumFromStrr)rbndsymbolnStrdStrs rVgetTimeSignatureParameters&ABCMetadata.getTimeSignatureParametersws:||~~#$UV V 99??  & YY# DAF YY$ DAF-JDF((6q9:AF((6q9:AFV|rUcUR5(d [S5eSSKJn UR 5nUcgUup4nUR "USU35$)aU Return a music21 :class:`~music21.meter.TimeSignature` object for this metadata tag, if isMeter is True, otherwise raise exception. >>> am = abcFormat.ABCMetadata('M:2/2') >>> am.preParse() >>> ts = am.getTimeSignatureObject() >>> ts >>> am = abcFormat.ABCMetadata('Q:40') >>> am.getTimeSignatureObject() Traceback (most recent call last): music21.abcFormat.ABCTokenException: no time signature associated with this non-metrical metadata. >>> am = abcFormat.ABCMetadata('M:none') >>> am.preParse() >>> ts = am.getTimeSignatureObject() >>> ts is None True z=no time signature associated with this non-metrical metadata.rr1Nr)rrmusic21r2r TimeSignature)rbr2 parameters numerator denominator unused_symbols rVgetTimeSignatureObject"ABCMetadata.getTimeSignatureObjectsa.||~~#OQ Q!446  4> 1IM&&)Ak]'CD DrUcrSSKJn UR5(d [S5e/SQnSnSn[ U[ SS9H^nXPR S [ U5R5:XdM.UR S [ U5nUR [ U5S n O [ U5S :aUS S :XaUSS -nS nUR5nUS:XaS nO5UR5nSHupURU5(dMU n O US:XaSnS nO US:XaSnS nUR"X65U4$)a Extract key signature parameters, returning the number of sharps and the mode. >>> am = abcFormat.ABCMetadata('K:Eb Lydian') >>> am.preParse() >>> am.getKeySignatureParameters() (-2, 'lydian') >>> am = abcFormat.ABCMetadata('K:APhry') >>> am.preParse() >>> am.getKeySignatureParameters() (-1, 'phrygian') >>> am = abcFormat.ABCMetadata('K:G Mixolydian') >>> am.preParse() >>> am.getKeySignatureParameters() (0, 'mixolydian') >>> am = abcFormat.ABCMetadata('K: Edor') >>> am.preParse() >>> am.getKeySignatureParameters() (2, 'dorian') >>> am = abcFormat.ABCMetadata('K: F') >>> am.preParse() >>> am.getKeySignatureParameters() (-1, 'major') >>> am = abcFormat.ABCMetadata('K:G') >>> am.preParse() >>> am.getKeySignatureParameters() (1, 'major') >>> am = abcFormat.ABCMetadata('K:Gm') >>> am.preParse() >>> am.getKeySignatureParameters() (-2, 'minor') >>> am = abcFormat.ABCMetadata('K:Hp') >>> am.preParse() >>> am.getKeySignatureParameters() (2, None) >>> am = abcFormat.ABCMetadata('K:G ionian') >>> am.preParse() >>> am.getKeySignatureParameters() (1, 'ionian') >>> am = abcFormat.ABCMetadata('K:G aeol') >>> am.preParse() >>> am.getKeySignatureParameters() (-2, 'aeolian') rr/z/no key signature associated with this metadata.)cgraebzf#zg#za#fbbebzd#abze#dbzc#gbcbhprrwT)r0reverseNrJr-major))dordorian)phrphrygian)lydlydian)mix mixolydian)majr)ionionian)aeoaeolian)mminorHPHpD) rr0rrsortedlenrrrr pitchToSharps) rbr0 keyNameMatchstandardKeyStr stringRemaintargetmode modeCandidatermodeStrs rVgetKeySignatureParameters%ABCMetadata.getKeySignatureParameterssPr zz||#$UV V  \sDAF>> am = abcFormat.ABCMetadata('K:G') >>> am.preParse() >>> ks = am.getKeySignatureObject() >>> ks >>> am = abcFormat.ABCMetadata('K:Gmin') >>> am.preParse() >>> ks = am.getKeySignatureObject() >>> ks >>> ks.sharps -2 Note that capitalization does not matter (http://abcnotation.com/wiki/abc:standard:v2.1#kkey) so this should still be minor. >>> am = abcFormat.ABCMetadata('K:GM') >>> am.preParse() >>> ks = am.getKeySignatureObject() >>> ks z.no key signature associated with this metadatarr/r)rrrr0r KeySignatureasKey)rbr0sharpsrkss rVgetKeySignatureObject!ABCMetadata.getKeySignatureObjectDs\Bzz||#$TU U557    f % : I88D> !rUc&UR5(d [S5eSSKJn SnSnSURR 5;aUR "5nSnX#4$SURR 5;aUR"5nSnX#4$) af Extract any clef parameters stored in the key metadata token. Assume that a clef definition suggests a transposition. Return both the Clef and the transposition. Returns a two-element tuple of clefObj and transposition in semitones >>> am = abcFormat.ABCMetadata('K:Eb Lydian bass') >>> am.preParse() >>> am.getClefObject() (, -24) zNno key signature associated with this metadata; needed for getting Clef Objectrr)Nz-8vaibassi)rrrr*rr Treble8vbClefBassClef)rbr*clefObjtransposeSemitoness rV getClefObjectABCMetadata.getClefObjectqszz||#`b b !"&! TYY__& &((*G!$  ** tyy( (mmoG!$ **rUcUR5(d [S5eSnSSKJn SnSUR;a/n/nSnURHPnUS:Xa U(dSnMUS:Xa U(aSnM%U(aUR U5 M?UR U5 MR SR U5R5nSR U5R5nOURR5nS n Sn U(aS U;aURS 5up[U 5n S n U RS 5HUn S U ;aU RS 5upO[RSU /5 SupU [U5[U5- S-- n MW O [U5n U(dU b#UR"U=(d SU S :waU OSU S9nU$)aI Extract any tempo parameters stored in a tempo metadata token. >>> am = abcFormat.ABCMetadata('Q: "Allegro" 1/4=120') >>> am.preParse() >>> am.getMetronomeMarkObject() >>> am = abcFormat.ABCMetadata('Q: 3/8=50 "Slowly"') >>> am.preParse() >>> am.getMetronomeMarkObject() >>> am = abcFormat.ABCMetadata('Q:1/2=120') >>> am.preParse() >>> am.getMetronomeMarkObject() >>> am = abcFormat.ABCMetadata('Q:1/4 3/8 1/4 3/8=40') >>> am.preParse() >>> am.getMetronomeMarkObject() >>> am = abcFormat.ABCMetadata('Q:90') >>> am.preParse() >>> am.getMetronomeMarkObject() z&no tempo associated with this metadataNrr3"FTrw= r*incorrectly encoded / unparsable duration:)1rr)textnumberreferent) rrrr4rappendjoinrrlfloat environLocal printDebug MetronomeMark)rbmmObjr4tempoStr tempoStrList nonTextListisOpencharnonTextrrdurs numberStrdurrrs rVgetMetronomeMarkObject"ABCMetadata.getMetronomeMarkObjects:||~~#$LM M! $)) LKF 3;v!F3;6"F ''-&&t,"ww|,224Hggk*002Giioo'G# g~")--"4y)::c?Ccz"yy~1$//1]_b0cd'qE!H!4 99H+w v)''X-=9?2v419;E rUcUR5(apSUR;a`URRS5up[UR 55nUS:XaSnO[UR 55nUS-U- $UR 5(a#UR 5nUcgUup4nX4- S:agg[SUR35e)a If there is a quarter length representation available, return it as a floating point value >>> am = abcFormat.ABCMetadata('L:1/2') >>> am.preParse() >>> am.getDefaultQuarterLength() 2.0 >>> am = abcFormat.ABCMetadata('L:1/8') >>> am.preParse() >>> am.getDefaultQuarterLength() 0.5 >>> am = abcFormat.ABCMetadata('M:C|') >>> am.preParse() >>> am.getDefaultQuarterLength() 0.5 If taking from meter, find the "fraction" and if < 0.75 use sixteenth notes. If >= 0.75 use eighth notes. >>> am = abcFormat.ABCMetadata('M:2/4') >>> am.preParse() >>> am.getDefaultQuarterLength() 0.25 >>> am = abcFormat.ABCMetadata('M:3/4') >>> am.preParse() >>> am.getDefaultQuarterLength() 0.5 >>> am = abcFormat.ABCMetadata('M:6/8') >>> am.preParse() >>> am.getDefaultQuarterLength() 0.5 Meter is only used for default length if there is no L: >>> x = 'L:1/4\nM:3/4\n\nf' >>> sc = converter.parse(x, format='abc') >>> sc.recurse().notes.first().duration.type 'quarter' rGr?g??z1no quarter length associated with this metadata: )rrrlrrrrr)rbrrrrrrs rVgetDefaultQuarterLength#ABCMetadata.getDefaultQuarterLengths`  # # % %#*:-JDDJJL!As{ %q519  \\^^88:J!", A-ut|#CDII;OQ QrU)rrrvrxrzNonerzbool)rzztuple[int, int, str] | None)rzmeter.TimeSignature | None)rzztuple[int, str | None])rzz(t.Union[key.Key, key.KeySignature, None])rzz#tuple[clef.Clef | None, int | None])rzztempo.MetronomeMark | None)rzr")rPrQrRrSr{r|rcrqrtrrrrrrrrrrrrrr rr0r6rT __classcell__rs@rVr r s* I -&  . 2h EDu=n+"Z+@PdIQIQrUr cb^\rSrSrSrSrU4SjrS SjrS SjrS Sjr S Sjr SS jr S r U=r $)r i/za An ABCBar token represents a barline, possibly with repeat information. Currently 4.10 Variant )barTypebarStyle repeatFormcN>[TU]U5 SUlSUlSUlgr)rrcr@rArBrs rVrcABCBar.__init__9s%   rUcURR5nU[;ag[UnURS5nSU;aSUlOSU;dSU;aSUlOSUl[ U5S:Xa USUlOL[ U5S :a=SU;aS UlSUlO(SU;aS UlSUlOUSS-US-Ul[ U5S :a US Ulgg) a Assign the bar-type based on the source string. >>> ab = abcFormat.ABCBar('|') >>> ab.parse() >>> ab >>> ab.barType 'barline' >>> ab.barStyle 'regular' >>> ab = abcFormat.ABCBar('||') >>> ab.parse() >>> ab.barType 'barline' >>> ab.barStyle 'light-light' >>> ab = abcFormat.ABCBar('|:') >>> ab.parse() >>> ab.barType 'repeat' >>> ab.barStyle 'heavy-light' >>> ab.repeatForm 'start' NrrepeatfirstsecondbarlinerJrrrG)r_r ABC_BARS_DICTrlr@rrArB)rb src_strip barTypeStringbarTypeComponentss rVrt ABCBar.parse?s<) M ) %i0 *//4 ( (#DL**..$DL%DL  !Q &-a0DM" #q (++ ) ").. ) "* 1! 4s :=Nq=Q Q   !A %/2DO &rUc&URS:Xagg)NrFTF)r@rgs rVisRepeatABCBar.isRepeats <<8 #rUcFURS:waURS:Xagg)z Return True if this is a regular, single, light bar line. >>> ab = abcFormat.ABCBar('|') >>> ab.parse() >>> ab.isRegular() True rFrGTF)r@rArgs rV isRegularABCBar.isRegulars! <<8 # (BrUcHURS:XagURS:Xagg)z Return a number if this defines a repeat bracket for an alternate ending otherwise returns False. >>> ab = abcFormat.ABCBar('[2') >>> ab.parse() >>> ab.isRepeat() False >>> ab.isRepeatBracket() 2 rGrJrHrF)rBrgs rVisRepeatBracketABCBar.isRepeatBrackets% ??g % __ (rUclSSKJn UR5(aTURS;aUR"URS9nU$[ R SUR3/5 SnU$URS:XaSnU$URS;aSnU$UR"UR5nU$) z Return a music21 bar object >>> ab = abcFormat.ABCBar('|:') >>> ab.parse() >>> barObject = ab.getBarObject() >>> barObject rr')rstart) directionz(found an unsupported repeatForm in ABC: NrG)rGrH) rr(rQrBRepeatr#r$rABarline)rbr(m21bars rV getBarObjectABCBar.getBarObjects ==??"22doo> ''??PQR ]]i 'F  __ 3 3F [[/F rU)rAr@rBr8r:)rzzint | t.Literal[False])rzzbar.Barline | None)rPrQrRrSr{r|rcrtrQrTrWr_rTr=r>s@rVr r /s46I C3J &rUr cX^\rSrSrSrSrSSU4SjjjrS S SjjrS SjrSr U=r $) r izo ABCTuplet tokens always precede the notes they describe. In ABCHandler.tokenProcess(), rhythms are adjusted. ) noteCountnumberNotesActualnumberNotesNormal tupletObjc\>[TU]U5 SUlSUlSUlSUlg)NrrJ)rrcrbrcrdrers rVrcABCTuplet.__init__s6 !')'(04rUcUcSnOURS:XaSnOSnURR5RS5nUSnSn[ U5S:aUSS:wa[ US5nUS:XaS upgOdUS :XaS upgOYUS :XaS upgONUS:XaSupgOCUS:XaSUpvO9US:XaSupgO.US:XaSUpvO$US:XaSupgOUS:XaSUpvO[ SU<35eUcUnX`lXPlg)a Cannot be called until local meter context is established. >>> at = abcFormat.ABCTuplet('(3') >>> at.updateRatio() >>> at.numberNotesActual, at.numberNotesNormal (3, 2) Generally a 5:n tuplet is 5 in the place of 2. >>> at = abcFormat.ABCTuplet('(5') >>> at.updateRatio() >>> at.numberNotesActual, at.numberNotesNormal (5, 2) Unless it's in a meter.TimeSignature compound (triple) context: >>> at = abcFormat.ABCTuplet('(5') >>> at.updateRatio(meter.TimeSignature('6/8')) >>> at.numberNotesActual, at.numberNotesNormal (5, 3) Six is 6:2, not 6:4! >>> at = abcFormat.ABCTuplet('(6') >>> at.updateRatio() >>> at.numberNotesActual, at.numberNotesNormal (6, 2) >>> at = abcFormat.ABCTuplet('(6:4') >>> at.updateRatio() >>> at.numberNotesActual, at.numberNotesNormal (6, 4) >>> at = abcFormat.ABCTuplet('(6::6') >>> at.updateRatio() >>> at.numberNotesActual, at.numberNotesNormal (6, 2) 2 is 2 in 3... >>> at = abcFormat.ABCTuplet('(2') >>> at.updateRatio() >>> at.numberNotesActual, at.numberNotesNormal (2, 3) Some other types: >>> for n in 1, 2, 3, 4, 5, 6, 7, 8, 9: ... at = abcFormat.ABCTuplet(f'({n}') ... at.updateRatio() ... print(at.numberNotesActual, at.numberNotesNormal) 1 1 2 3 3 2 4 3 5 2 6 2 7 2 8 3 9 2 Tuplets > 9 raise an exception: >>> at = abcFormat.ABCTuplet('(10') >>> at.updateRatio() Traceback (most recent call last): music21.abcFormat.ABCTokenException: cannot handle tuplet of form: '(10' NrrJrHrrJrwz(1rJrJz(2)rrJz(3)rJrz(4)rrJz(5z(6)rz(7z(8)rJz(9 zcannot handle tuplet of form: ) beatDivisionCountr_rrlrrrrcrd)rbtimeSignatureObj normalSwitch splitTuplet tupletNumber normalNotesrrs rV updateRatioABCTuplet.updateRatios7X  #L  / /1 4LLhhnn&,,S1 "1~ $ { q [^r%9k!n-K 4 DAq T !DAq T !DAq T !DAq T !lq T !DAq T !lq T !DAq T !lq#&D\DT$UV V  K!"!,rUcfURS:Xa [S5eSSKJn UR"URUR S9UlURR5RS5n[U5S:aUSS :wa[US5Ul g URUl g ) a Update the note count of notes that are affected by this tuplet. Can be set by p:q:r style tuplets. Also creates a tuplet object. >>> at = abcFormat.ABCTuplet('(6') >>> at.updateRatio() >>> at.updateNoteCount() >>> at.noteCount 6 >>> at.tupletObj >>> at = abcFormat.ABCTuplet('(6:4:12') >>> at.updateRatio() >>> at.updateNoteCount() >>> at.noteCount 12 >>> at.tupletObj >>> at = abcFormat.ABCTuplet('(6::18') >>> at.updateRatio() >>> at.updateNoteCount() >>> at.noteCount 18 rz-must set numberNotesActual with updateRatio()rr+)rcrdrHrJrrwN) rcrrr,Tupletrdrer_rrlrrrb)rbr,rrs rVupdateNoteCountABCTuplet.updateNoteCount[s8  ! !R '#$ST T %!"44"446 hhnn&,,S1 { q [^r%9 Q0DN!33DNrUrvrxra)rpr<rzr9r8) rPrQrRrSr{r|rcruryrTr=r>s@rVr r sD UI44$6:v-2v- v-p*4*4rUr c4^\rSrSrSrSrSU4SjjrSrU=r$)r iz Handles instances of ties '-' between notes in an ABC score. Ties are treated as an attribute of the note before the '-'; the note after is marked as the end of the tie. )noteObjc2>[TU]U5 SUlgra)rrcr|rs rVrcABCTie.__init__s  rUrv) rPrQrRrSr{r|rcrTr=r>s@rVr r s IrUr c>^\rSrSrSrSrSSU4SjjjrSrSrU=r $)rizu ABCSlurStart tokens always precede the notes in a slur. For nested slurs, each open parenthesis gets its own token. )slurObjc2>[TU]U5 SUlgra)rrcrrs rVrcABCSlurStart.__init__s *. rUc<SSKJn UR"5Ulg)z Creates a spanner object for each open paren associated with a slur; these slurs are filled with notes until end parens are read. rr5N)rr6Slurr)rbr6s rVfillSlurABCSlurStart.fillSlurs $||~ rUrvrx) rPrQrRrSr{r|rcrrTr=r>s@rVrrs#I//&&rUrc\rSrSrSrSrSrg)rizU A general parenthesis stop; comes at the end of a tuplet, slur, or dynamic marking. rNNrPrQrRrSr{r|rTrNrUrVrrIrUrcB^\rSrSrSrSrSSU4SjjjrSSjrSrU=r $) riz ABCCrescStart tokens always precede the notes in a crescendo. These tokens coincide with the string "!crescendo("; the closing string "!crescendo)" counts as an ABCParenStop. )crescObjc2>[TU]U5 SUlgra)rrcrrs rVrcABCCrescStart.__init__s 15 rUc<SSKJn UR"5UlgNrr-)rr. Crescendorrbr.s rV fillCrescABCCrescStart.fillCrescs$ **, rUrvrxr8) rPrQrRrSr{r|rcrrTr=r>s@rVrrs# I66--rUrc>^\rSrSrSrSrSSU4SjjjrSrSrU=r $)rizq ABCDimStart tokens always precede the notes in a diminuendo. They function identically to ABCCrescStart tokens. )dimObjc2>[TU]U5 SUlgra)rrcrrs rVrcABCDimStart.__init__s 04 rUc<SSKJn UR"5Ulgr)rr. Diminuendorrs rVfillDimABCDimStart.fillDims$))+ rUrvrx) rPrQrRrSr{r|rcrrTr=r>s@rVrrs#I55,,rUrc\rSrSrSrSrSrg)rizY ABCStaccato tokens "." precede a note or chord; they are a property of that note/chord. rNNrrNrUrVrrrrUrc\rSrSrSrSrSrg)rizV ABCUpbow tokens "u" precede a note or chord; they are a property of that note/chord. rNNrrNrUrVrrrrUrc\rSrSrSrSrSrg)rizX ABCDownbow tokens "v" precede a note or chord; they are a property of that note/chord. rNNrrNrUrVrrrrUrc\rSrSrSrSrSrg)rizz ABCAccent tokens "K" precede a note or chord; they are a property of that note/chord. These appear as ">" in the output. rNNrrNrUrVrr IrUrc\rSrSrSrSrSrg)riz} ABCStraccent tokens "k" precede a note or chord; they are a property of that note/chord. These appear as "^" in the output. rNNrrNrUrVrrrrUrc\rSrSrSrSrSrg)rizW ABCTenuto tokens "M" precede a note or chord; they are a property of that note/chord. rNNrrNrUrVrrrrUrc\rSrSrSrSrSrg)riz Grace note start rNNrrNrUrVrrIrUrc\rSrSrSrSrSrg)ri z Grace note end rNNrrNrUrVrr rrUrc>^\rSrSrSrSrSSU4SjjjrSrSrU=r $)riz( Marks that rhythm is broken with '>>>' )rc2>[TU]U5 SUlgr)rrcrrs rVrcABCBrokenRhythmMarker.__init__s  rUcBURR5Ulg)z Called before context adjustments: need to have access to data >>> brokenRhythm = abcFormat.ABCBrokenRhythmMarker('>>>') >>> brokenRhythm.preParse() >>> brokenRhythm.data '>>>' N)r_rrrgs rVrqABCBrokenRhythmMarker.preParsesHHNN$ rUrvrx) rPrQrRrSr{r|rcrqrTr=r>s@rVrrs#I % %rUrc^\rSrSrSrSrS S U4Sjjjr\S Sj5rS SSjjr S SSjjr SSSjjr S r U=r $)ri*a A model of an ABCNote. General usage requires multi-pass processing. After being tokenized, each ABCNote needs a number of attributes updates. Attributes to be updated after tokenizing, and based on the linear sequence of tokens: `inBar`, `inBeam` (not used), `inGrace`, `activeDefaultQuarterLength`, `brokenRhythmMarker`, and `activeKeySignature`. The `chordSymbols` list stores one or more chord symbols (ABC calls these guitar chords) associated with this note. This attribute is updated when parse() is called. )carriedAccidental chordSymbolsinBarinBeaminGraceactiveDefaultQuarterLengthbrokenRhythmMarkeractiveKeySignature activeTupletapplicableSpannerstie articulationsaccidentalDisplayStatusisRest pitchName quarterLengthc>[TU]U5 X l/UlSUlSUlSUlSUlSUlSUl SUl /Ul SUl /Ul SUlSUlSUlSUlg)NFr)rrcrrrrrrrrrrrrrrrr)rbr_rrs rVrcABCNote.__init__?s  '8(*!% !% "& 7;'8<:>37:<")+37$" $($'rUcSU;aJ[RU5n[[RU55SR 5nXUS4$/U4$)a[ Splits chord symbols from other string characteristics. Returns a 2-tuple of a list of chord symbols, and clean remaining chars Staticmethod: >>> an = abcFormat.ABCNote() >>> an._splitChordSymbols('"C"e2') (['"C"'], 'e2') >>> an._splitChordSymbols('b2') ([], 'b2') >>> abcFormat.ABCNote._splitChordSymbols('"D7""D"d2') (['"D7"', '"D"'], 'd2') rrN) reChordSymbolfindalllistfinditerr)rmris rV_splitChordSymbolsABCNote._splitChordSymbolspsY" &=(008L]++F34R8<<>A+ +v: rUc[RSU/5 [U5S:aUSS;aUSSnURSS5n[R U5SnUS :Xag UbUnO URn[UUR[U54$![ a [SU<35ef=f![a Of=fUR5(aS nOS nXQRS 5-nXQRS5- nSn[URS55HnUS- nM [URS55HnUS- nM [URS55HnUS- nM SnUR(a[URRS55HnUS- nM [URRS55HnUS- nM [URRS55HnUS- nM U(aU(a [S5eU(aSn OUS:waSn OUcSn OUR n U V s/sHoR"R%5PM Os sn fn n U V s/sHoR&R%5PM Os sn fn n UR%5U ;a!XR)UR%55nSn U(aUR+5UU3nOUR+5UU3nUUR[U54nX4[U'X4$)a Given a note or rest string without a chord symbol, return a music21 pitch string or None (if a rest), and the accidental display status. This value is paired with an accidental display status. Pitch alterations, and accidental display status, are adjusted if a key is declared in the Note. >>> an = abcFormat.ABCNote() >>> an.getPitchName('e2') ('E5', None) >>> an.getPitchName('C') ('C4', None) >>> an.getPitchName('B,,') ('B2', None) >>> an.getPitchName('C,') ('C3', None) >>> an.getPitchName('c') ('C5', None) >>> an.getPitchName("c'") ('C6', None) >>> an.getPitchName("c''") ('C7', None) >>> an.getPitchName("^g") ('G#5', True) >>> an.getPitchName("_g''") ('G-7', True) >>> an.getPitchName('=c') ('Cn5', True) If pitch is a rest (z) then the Pitch name is None: >>> an.getPitchName('z4') (None, None) Grace note: >>> an.getPitchName('{c}') ('C5', None) Given an active KeySignature object, the pitch name might change: >>> an.activeKeySignature = key.KeySignature(3) >>> an.getPitchName('c') ('C#5', False) Illegal pitch names raise an ABCHandlerException >>> an.getPitchName('x') Traceback (most recent call last): music21.abcFormat.ABCHandlerException: cannot find any pitch information in: 'x' z getPitchName:rJruTNrrwz&cannot find any pitch information in: zNNrjr,'_r^#rrz&Carried accidentals not rendered moot.TF)r#r$rreplace rePitchNamer IndexErrorrrrKrryKeyErrorislowercountrangealteredPitchessteprnameindexupper)rbrmforceKeySignaturerroctave accStringdummycarriedAccStringrrpalteredPitchStepsalteredPitchNamespStr _cacheKeys rV getPitchNameABCNote.getPitchNamesRv & 9: v;?vayD0ABZFR( [&&v.q1D 3;  (!2 !%!8!8  )6+/+A+A+./A+B+DE E [%(Nvj&YZ Z [    <<>>FF,,s##,,s## 6<<,-E  I.6<<,-E  I.6<<,-E  I.  ! !t55;;C@A C' Bt55;;C@A C' Bt55;;C@A C' B  %&NO O '+ # "_&* #  '&* # 0>>N9G HA H  H9G HA H  Hzz|00()@)@)NO&+ # jjl^$4#5fX>Djjl^I;vh7D   " " " # .2,Ky)..s*B:B6B36 CC#J#J2cUbUnO URnUc [S5e/nUH1nUR5(dUS:XdM URU5 M3 SR U5nUR 5nUS:XaUnGOWUS:XaUS-nGOJUS:XaUS-nGO=US:XaUS-nGO0UR S5(a!U[URS5S 5- nOURS5(a4[URSS S 9S R 55nS n X8-U - nOURS5S :Xa[RS U/5 S nOSU;alURS5up[R(a U ceU ce[U R 55n[U R 55n X8-U - nOU[U5-nURbbURupU S:XaSnO/U S:XaSnO&U S:XaSnOU S:XaSnOU S:XaSnO U S:XaSnOSnU S:Xa X~S -nU$U S:XaX~S -nU$)a Called with parse(), after context processing, to calculate duration >>> an = abcFormat.ABCNote() >>> an.activeDefaultQuarterLength = 0.5 >>> an.getQuarterLength('e2') 1.0 >>> an.getQuarterLength('G') 0.5 >>> an.getQuarterLength('=c/2') 0.25 >>> an.getQuarterLength('A3/2') 0.75 >>> an.getQuarterLength('A/') 0.25 >>> an.getQuarterLength('A//') 0.125 >>> an.getQuarterLength('A///') 0.0625 >>> an = abcFormat.ABCNote() >>> an.activeDefaultQuarterLength = 0.5 >>> an.brokenRhythmMarker = ('>', 'left') >>> an.getQuarterLength('A') 0.75 >>> an.brokenRhythmMarker = ('>', 'right') >>> an.getQuarterLength('A') 0.25 >>> an.brokenRhythmMarker = ('<<', 'left') >>> an.getQuarterLength('A') 0.125 >>> an.brokenRhythmMarker = ('<<', 'right') >>> an.getQuarterLength('A') 0.875 >>> an.brokenRhythmMarker = ('<<<', 'left') >>> an.getQuarterLength('A') 0.0625 >>> an.brokenRhythmMarker = ('<<<', 'right') >>> an.getQuarterLength('A') 0.9375 >>> an.getQuarterLength('A', forceDefaultQuarterLength=1.0) 1.875 z@cannot calculate quarter length without a default quarter lengthrrwr4z//r5z///?rJ)maxsplitrrr>)?r4<)r4rz>>)?r5z<<)r5rz>>>)?rz<<<)rrrileftright)rrisdigitr r!rrrrlendswithrr#r$t TYPE_CHECKINGr)rbrmforceDefaultQuarterLengthr numStrListrnumStrqlrrrrrr[modPairs rVgetQuarterLengthABCNote.getQuarterLength.stf % 0)B &)-)H)H & % -#RT T!# Ayy{{a3h!!!$$ R<+B s]+c1B t^+d2B u_+e3B   s # #+c&,,s2CA2F.GGB __S ! !FLLqL1!4::<=AA+/!3B \\# ! #  # #%QSY$Z [BF]c*JD''''''DJJL!ADJJL!A+/!3B,c&k9B  " " . $ 7 7 F}$3$4&4&5(5( F"aj  g%aj  rUcJURUR5uUlnURUUS9upEXEsUlUlURcSUl OSUl URUUS9Ul g![a! [ R SUS3/5 SnSnNjf=f)N)rz+Could not get pitch information from note: z , assuming CrFTr) rr_rrrr#warnrrrrr)rbrrnonChordSymStrpnaccDisps rVrt ABCNote.parses -1,C,CDHH,M)>  ++N>O,QKB8:44 >> !DKDK!22 &?3A#    L"0!1>@ ABG  sA77(B"!B")rrrrrrrrrrrrrrrr)rwrw)rry)rmryrzztuple[list[str], str]ra)rmryrzztuple[str | None, bool | None])rmryr float | Nonerzr"r)rrrzkey.KeySignature | Nonerzr9)rPrQrRrSr{r|rcr}rrrrtrTr=r>s@rVrr*s 0I /(/(b:a/a/ $ a/JBF@!$@4>@JO@H1537A#-A1A  AArUrc>^\rSrSrSrSSU4SjjjrSSjrSrU=r$) rizr A representation of an ABC Chord, which contains within its delimiters individual notes. A subclass of ABCNote. c2>[TU]U5 /Ulgra)rrc subTokensrs rVrcABCChord.__init__s )+rUcnURUR5uUlnURS5nX4S-SnUSUnUR USS9nUbUnO URn[5n U RU5 Sn U RHun [U [5(dMU RURUS 9 U R(aMGU (d U R n UR"R%U 5 Mw Xz-Ulg![a [ SURS35ef=f) a Handles the following types of chords: * Chord without length modifier: [ceg] * Chords with outer length modifier: [ceg]2, [ceg]/2 * Chords with inner length modifier: [c2e2g2], [c2eg] * Chords with inner and outer length modifier: [c2e2g2]/2, [c/2e/2g/2]2 ]zBad chord indicator: z: no closing bracket found.rJNg?rr)rr)rr_rr ValueErrorrrrrtokenizetokens isinstancerrtrrrrr ) rbrrrposouterLengthModifierStrtokenStrouter_lengthModifierrahinner_quarterLengthtokens rVrtABCChord.parsesN-1,C,CDHH,M)>  &&s+C"0a!9!!C( $445KOR 5 T  (!2 !%!8!8 \ HYYE%)) .2.M.M&8:<< +*/*=*='%%e,#,2Gk %'z1LM  s D$D4)rrrrvrxr) rPrQrRrSr{rcrtrTr=r>s@rVrrs  ,, GHGHrUrcj\rSrSrSr\R S4SSjjr\SSj5r \S Sj5r \S!Sj5r S"Sjr S#S jr \S$S j5rS r\S%S j5rS&S jrS'SjrS&SjrSrSrSrS(SjrSrSrS)Sjr\S*Sj5rS+SjrS,SjrS-SjrS.SjrSr g)/ri+a An ABCHandler is able to divide elements of a character stream into objects and handle store in a list, and passes global information to components Optionally, specify the (major, minor, patch) version of ABC to process-- e.g., (1.2.0). If not set, default ABC 1.3 parsing is performed. If lineBreaksDefinePhrases is True then new lines within music elements define new phrases. This is useful for parsing extra information from the Essen Folksong repertory * New in v6.3: lineBreaksDefinePhrases -- does not yet do anything FcXl0Ul/Ul/Ul/UlX lSUlSUlSUl[UR5Ul SUl g)Nrrrw) abcVersion abcDirectivesr  activeParensactiveSpannerslineBreaksDefinePhrasesr skipAheadrmrsrcLencurrentCollectStr)rbrrs rVrcABCHandler.__init__9s[,6-/&( ')57-D$ t{{+ !#rUc[U5S- nX:a[SUSU35eSnUS:aXS- nXnSnU[U5S- :aXS-nSnU[U5S- :aXS-nX4XV4$)a Find the local context of a string or iterable of objects beginning at a particular index. Returns a tuple of charPrev, charThis, charNext, charNextNext. Staticmethod >>> ah = abcFormat.ABCHandler() >>> ah._getLinearContext('12345', 0) (None, '1', '2', '3') >>> ah._getLinearContext('12345', 1) ('1', '2', '3', '4') >>> abcFormat.ABCHandler._getLinearContext('12345', 3) ('3', '4', '5', None) >>> abcFormat.ABCHandler._getLinearContext('12345', 4) ('4', '5', None, None) >>> abcFormat.ABCHandler._getLinearContext([32, None, 8, 11, 53], 4) (11, 53, None, None) >>> ah._getLinearContext([32, None, 8, 11, 53], 2) (None, 8, 11, 53) >>> ah._getLinearContext([32, None, 8, 11, 53], 0) (None, 32, None, 8) rJzbad index value z , max is Nrr)rr)sourcer lastIndexcPrevrcNext cNextNexts rV_getLinearContextABCHandler._getLinearContextIs:K!O =%(89YK&PQ Q q5q5ME I s6{Q q5ME s6{Q 1u I))rUcr[U5S- n[US-US-5HnXS:XdM Us $ US-$)an Return index of next line break after character i. Staticmethod >>> ah = abcFormat.ABCHandler() >>> inputString = 'de we\n wer bfg\n' >>> ah._getNextLineBreak(inputString, 0) 6 >>> inputString[0:6] 'de we' from last line break >>> abcFormat.ABCHandler._getNextLineBreak(inputString, 6) 15 >>> inputString[ah._getNextLineBreak(inputString, 0):] '\n wer bfg\n' rJ )rr)rmrr#js rV_getNextLineBreakABCHandler._getNextLineBreak~sE*K!O q1ui!m,AyD -1}rUc/nUS:Xa6UR[S55 UR[S55 U$US:Xa6UR[S55 UR[S55 U$US:Xa6UR[S55 UR[S55 U$US :Xa6UR[S55 UR[S55 U$US :Xa6UR[S55 UR[S55 U$UR[U55 U$) a Some single barline tokens are better replaced with two tokens. This method, given a token, returns a list of tokens. If there is no change necessary, the provided token will be returned within the list. A staticmethod. Call on the class itself. >>> abcFormat.ABCHandler.barlineTokenFilter('::') [, ] >>> abcFormat.ABCHandler.barlineTokenFilter('|2') [, ] >>> abcFormat.ABCHandler.barlineTokenFilter(':|1') [, ] If nothing matches, the original token is returned as an ABCBar object: >>> abcFormat.ABCHandler.barlineTokenFilter('hi') [] rErCrDrArFr=rBr?r9r:)r r )r barTokenss rVbarlineTokenFilterABCHandler.barlineTokenFilters*2#% D=   VD\ *   VD\ *&%d]   VC[ )   VD\ *d]   VC[ )   VD\ *e^   VD\ *   VD\ * e^   VD\ *   VD\ *   VE] +rUchSnURU:agSUR;aURS$g)z Determine how accidentals should 'carry through the measure.' >>> ah = abcFormat.ABCHandler(abcVersion=(1, 3, 0)) >>> ah._accidentalPropagation() 'not' >>> ah = abcFormat.ABCHandler(abcVersion=(2, 0, 0)) >>> ah._accidentalPropagation() 'pitch' )rrrnotzpropagate-accidentalspitch)rr)rb minVersions rV_accidentalPropagation!ABCHandler._accidentalPropagations; ??Z ' "d&8&8 8%%&=> >rUcj[RU5nU(aURU5Ulgg)a Search a line of text for a comment abc version number >>> ah = abcFormat.ABCHandler() >>> ah.abcVersion (1, 3, 0) >>> ah.parseHeaderForVersionInformation('%abc-2.3.2') >>> ah.abcVersion (2, 3, 2) Changed in v9: abcVersion defaults to (1, 3, 0) as documented. N) reAbcVersionsearchreturnAbcVersionFromMatchr)rb inputSearchverMatss rV parseHeaderForVersionInformation+ABCHandler.parseHeaderForVersionInformations.%%k2 "<>> import re >>> match = re.match(r'(\d+).(\d+).(\d+)', '2.3.4') >>> ah = abcFormat.ABCHandler() >>> ah.returnAbcVersionFromMatch(match) (2, 3, 4) >>> match = re.match(r'(\d+).(\d+).?(\d?)', '1.7') >>> ah.returnAbcVersionFromMatch(match) (1, 7, 0) rJrrJr)rgroup)r=abcMajorabcMinorabcPatchs rVr;$ABCHandler.returnAbcVersionFromMatchs\w}}Q'(w}}Q'( ==  7==+,HHH--rUczURURUR5URS-- UlURURURUR-S-n[R U5nU(a1UR S5nUR S5nX@RU'gg)a Processes the comment at self.pos in self.strSrc, setting self.skipAhead and self.abcDirectives for the directiveKey. >>> from textwrap import dedent >>> ah = abcFormat.ABCHandler() >>> data = dedent(""" ... Hello % this is a comment ... Bye ... """) >>> ah.strSrc = data >>> ah.pos = 6 >>> ah.processComment() >>> ah.skipAhead 19 >>> len(' this is a comment\n') 19 Directives get stored in the handler: >>> data = '%%abc-hello world' >>> ah = abcFormat.ABCHandler() >>> ah.strSrc = data >>> ah.pos = 0 >>> ah.processComment() >>> ah.abcDirectives {'abc-hello': 'world'} >>> ah.abcDirectives['abc-hello'] 'world' * Changed in v9: version is not parsed by this method. rJrN)r,rmrr reDirectiverrAr)rb commentLinedirectiveMatches directiveKeydirectiveValues rVprocessCommentABCHandler.processComment sF// KK XX\kk$((488dnn+Dq+HI &,,[9 +11!4L-33A6N/=  | , rUcUS:wagUcgUS:XagUS:XagUR5(aUR5(agg)a Returns True if this context describes the start of a metadata section, like A:something Metadata: capital letter, with next char as ':' and some following character >>> ah = abcFormat.ABCHandler >>> ah.startsMetadata('A', ':', 's') True lowercase w: is a special case for lyric defs >>> ah.startsMetadata('w', ':', 's') True Following char must be ":" >>> ah.startsMetadata('A', ' ', 's') False Pipe after colon indicates not metadata (bar info). For example need to not misinterpret repeat bars as metadata e.g. `dAG FED:|2 dAG FGA|` this is incorrect, but we can avoid it by looking for a leading pipe and returning False >>> ah.startsMetadata('A', ':', '|') False >>> ah.startsMetadata('A', ':', None) False rHFrFwT)isalphaisupper)rr%r&s rVstartsMetadataABCHandler.startsMetadata7sHL C<   #  #X YY[[QYY[[rUc[U5UlXlSUlSUlSUlSnSnSn0nSnSnURURS- :GaU=RS- slU=RUR - slSUlURURS- :ag UR URUR5nUuppU S:XaUR5 MURXU 5(aURURUR5n XRS-- UlURURU R5UlURR[UR55 GMjU R5(GdGU R5(Gd1U S;Ga*S n[![["55Hn["USn[U5S :Xa"U bU bX-U -U:Xa S UlS n OSM<M>M@U b$[U5S :XaX-U:Xa SUlS n O(Mg[U5S:XdMxU U:XdMSUlS n O US La~0nSnURUR -S-n URURU UlUR%UR5HnURRU5 M GMU S:XGarU GbnU R'5(GaXSUlURUR -S-n UR URU 5unnnnUS:XaU S- n U=R S- slUb/UR'5(aU S- n U=R S- slUR URU 5unnnnUS:XaLU S- n U=R S- slUb/UR'5(aU S- n U=R S- slURURU UlURR[)UR55 GM@U S;aURS-n XRS- :a?URU S;a,U S- n XRS- :aURU S;aM,URURU UlURR[+UR55 XRS-- UlGM U S:XGa[,[.[0[.S.nURS-n XRS-:aXR:aURU S:XaURURU S-U;aVUURURU S-nU"U 5nURRU5 XR- UlOURU U;a+U S- n URU U;aX`RU - nMWU(dMURU RI5(a+URU S#;aS nURU nU S- n MURU R'5(dURU S$;a,URU S%;aXpRU - nU S- n GM US:wa#X@RURU -UlSnOURURU UlURS&;aGOURRKS5(a5URSS';d URRMS(5(aGOURRKS)5(d@URRKS*5(d URRKS+5(aGO&[UR5S:aCURRKS,5(a#URSR'5(aOU(aUSRO5nSnURQ5nU(aUS-:XaXeU'O US.:XaXeU'SnO!US.:Xa UU;aUUnOUS-:Xa Xu;aXWn[SURUS/9nURRU5 O.URR[SUR55 XRS-- UlGMURURS- :aGMg g )0a Walk the abc string, creating ABC objects along the way. This may be called separately from process(), in the case that pre-/post-parse processing is not needed. >>> abch = abcFormat.ABCHandler() >>> abch.tokens [] >>> abch.tokenize('X: 1') >>> abch.tokens [] >>> abch = abcFormat.ABCHandler() >>> abch.tokenize('(6f') >>> abch.tokens [, ] >>> abch = abcFormat.ABCHandler() >>> abch.tokenize('(6:4f') >>> abch.tokens [, ] >>> abch = abcFormat.ABCHandler() >>> abch.tokenize('(6:4:2f') >>> abch.tokens [, ] >>> abch = abcFormat.ABCHandler() >>> abch.tokenize('(6::2f') >>> abch.tokens [, ] rrwrz.~^=_HLMOPSTuvz^=_rJrk)~(FrJNrTrVrHz<>!)z !crescendo(!z !crescendo)!z !diminuendo(!z !diminuendo)!)rr[r r.u{}vrkrz~^=_z ~wuvhHLTSNz,/,'z,')'rOr\r_v.hHvkukUrUr[rrraSsrruizu.rHyHxrrrrNorPlrRyrrxZ) r\r_r`rrr[rrrrOrbrsrarsrcrtrrr4)r)*rrrmrrrr'rLrRr,rr r r isspaceisalnumrABC_BARSr0rr rrrrrr rrrrrrrrrrPrrrr6r)rbrmaccidentalsAndDecorations accidentalsactiveChordSymbolaccidentalized accidentalabcPitchq unused_cPrevrr%r&r+ matchBarsbarIndexbarTokenArchetypetokenSubunused1 possibleColonqCharunused2rChar exclaimDict exclaimClass exclaimObjectfoundPitchAlpha pitchClassr propagationabcNotes rVr ABCHandler.tokenizejsB D&k  !#$4! )+ hhq( HHMH HH &HDNxx$++/)&&t{{DHH=A01 -LUCx##%""1Y77**4;;A!"hhl!3)-TXXa)@)F)F)H& "";t/E/E#FG99;;qyy{{q 7J! %c(m 4H)1(:1(=%,-2!-$-$9$%I $9=N$N-.DN(,I!%O%:. *4E0F!0K9(99-.DN(,I!:./14 11-.DN(,I!)!5*$%'N!#J4>>1A5A-1[[!-DD*$($;$;D+A+A+C+Ct{{ST~Y\G\FA++o4;;q>+A+A+C+Ct{{ST~Y\G\%*->TXXVWAX-XD*(*%-1[[!-DD* ""8D,B,B#CD!"hhl!3Cx "";q>2Cx ""8A;/Cx ""=#34Cx ""<?3Cx "":a=1Cx ""9Q<0Cx ""<?3Cx ""9Q<0yy{{a6k.#$))+"T!2T" H#!"JHHqL;;?*+t{{1~AZ/ZQ;;q>[8&++a.8J -$++a.2H2H2J2J"kk!nL@*.#';;q>Q Q//11T[[^v5M;;q>T1$ A6HQ $*->TXXVWAX-XD*(*%-1[[!-DD*)).88,,77<<11"5:TT"44==dCC,,77<<//::3??//::3??$001A500;;C@@003;;==&.qk&7&7&9J(*%"&"="="?K!&(27A84(G39C:6%' &'1jN6R0>z0J-(H49S0>0H-%d&<&UR9U5 UR;5 UnUR$R=S 5 [U[>5(auURA5 [BRD(aURFceUR&R=URF5 UR$R=S 5 O`[U[H5(aKUR$(a:UR$RK5nUS ;aUR&RK5 [U[L5(a/U(aURNS :XaSUl'OU(aSUl'Un[U[P5(aUn[U[R5(aUn [U[T5(aUn [U[V5(aUn [U[X5(aUn [U[Z5(aUn [U[\5(atUR_5 [BRD(aUR`ceUR&R=UR`5 UR$R=S5 [U[b5(atURe5 [BRD(aURfceUR&R=URf5 UR$R=S5 [U[h5(aUn[U[j5(aSn[U[*[l45(dGM Uc[oSSUSUSU3-5eX2l8XBl9UR&SSUl:Ub S Ul'SnUbURvR=S5 SnU bURvR=S5 Sn U bURvR=S5 Sn U bURvR=S5 Sn U bURvR=S5 Sn U bURvR=S5 Sn UbSUl<UcO9URzS:XaSnO&U=RzS-sl=UR|Ul?UnGM^ URHnUR5 M g)zh Process all token objects. First, calls preParse(), then does context assignments, then calls parse(). rr/Nrrrzbroken rhythm marker rVz,) not positioned between two notes or chordsrxr)rrrstopcontinuerZrrz>555##**5>>:!!((5%-- ?? <<333##**5<<8!!((6%//!&%..!%%'8!455 (-V#E7)E7)E7KL4A0+;(+/+>+>q+A( + &EI#'L!-''..z:%)N*''..w7"&K ,''..y9$(M+''..x8#'L".''..~>&*O".''..x8&*O!-$(EM"*$..!3&*O#--2-)8)B)BE& % m)r[[E KKM!rUc|URUSS5 /UlURU5 UR5 g)Nd)r>r r r)rbrms rVprocessABCHandler.process s5 --fTcl;  f rUc,[UR5$ra)rr rgs rV__len__ABCHandler.__len__ s4;;rUcbUR5nURUR-UlU$)a Return a new handler adding the tokens in both Contrived example appending two separate keys. Used in polyphonic metadata merge >>> abcStr = 'M:6/8\nL:1/8\nK:G\n' >>> ah1 = abcFormat.ABCHandler() >>> junk = ah1.process(abcStr) >>> len(ah1) 3 >>> abcStr = 'M:3/4\nL:1/4\nK:D\n' >>> ah2 = abcFormat.ABCHandler() >>> junk = ah2.process(abcStr) >>> len(ah2) 3 >>> ah3 = ah1 + ah2 >>> len(ah3) 6 >>> ah3.tokens[0] == ah1.tokens[0] True >>> ah3.tokens[3] == ah2.tokens[0] True )rr )rbotherrs rV__add__ABCHandler.__add__ s)<^^ KK%,,.  rUcUR(d [S5eSn[[UR55HMnURUn[ U[ 5(dM)UR 5(dM@US- nUS:dMM g g)a^ Return True if this token structure defines more than 1 reference number, usually implying multiple pieces encoded in one file. >>> abcStr = 'X:5\nM:6/8\nL:1/8\nK:G\nB3 A3 | G6 | B3 A3 | G6 ||' >>> ah = abcFormat.ABCHandler() >>> junk = ah.process(abcStr) >>> ah.definesReferenceNumbers() # only one returns False False >>> abcStr = 'X:5\nM:6/8\nL:1/8\nK:G\nB3 A3 | G6 | B3 A3 | G6 ||\n' >>> abcStr += 'X:6\nM:6/8\nL:1/8\nK:G\nB3 A3 | G6 | B3 A3 | G6 ||' >>> ah = abcFormat.ABCHandler() >>> junk = ah.process(abcStr) There are two tokens, so this returns True >>> ah.definesReferenceNumbers() True (must process tokens before calling splitrrJTF)r rrrr r rrbrrrs rVdefinesReferenceNumbers"ABCHandler.definesReferenceNumbers su.{{%&PQ Qs4;;'(AKKNE%--**,,QJEqy# )rUcBUR(d [S5e0n/n/nSn[UR5HupV[U[5(aLUR 5(a7UbX4l/n[ URS9n[UR5nXAU'UcURU5 M|URU5 M UbX4lU(d[ URS9US'UR5HnUSSUR-UlM U$)a Split tokens by reference numbers. Returns a dictionary of ABCHandler instances, where the reference number is used to access the music. If no reference numbers are defined, the tune is available under the dictionary entry None. >>> abcStr = 'X:5\nM:6/8\nL:1/8\nK:G\nB3 A3 | G6 | B3 A3 | G6 ||' >>> abcStr += 'X:6\nM:6/8\nL:1/8\nK:G\nB3 A3 | G6 | B3 A3 | G6 ||' >>> ah = abcFormat.ABCHandler() >>> junk = ah.process(abcStr) >>> len(ah) 28 >>> ahDict = ah.splitByReferenceNumber() >>> 5 in ahDict True >>> 6 in ahDict True >>> 7 in ahDict False Each entry is its own ABCHandler object. >>> ahDict[5] >>> len(ahDict[5].tokens) 14 Header information (except for comments) should be appended to all pieces. >>> from textwrap import dedent >>> abcEarly = dedent("""X:4 ... M:6/8 ... L:1/8 ... K:F ... I:abc-version 1.6 ... B=3 B3 | G6 | B3 A3 | G6 || ... """) >>> abcStrWHeader = '%abc-2.1\nO: Irish\n' + abcEarly + abcStr >>> ah = abcFormat.ABCHandler() >>> junk = ah.process(abcStrWHeader) >>> len(ah) 44 >>> ahDict = ah.splitByReferenceNumber() Did we get the origin header in each score? >>> ahDict[5].tokens[0] >>> ahDict[6].tokens[0] Before parsing all the tokens should have the 2.1 version: >>> ahDict[4].abcVersion (2, 1, 0) >>> ahDict[5].abcVersion (2, 1, 0) After parsing, the abcVersion should be set for score 4 and revert for score 5. >>> for f in ahDict: ... _ = abcFormat.translate.abcToStreamScore(ahDict[f]) >>> ahDict[4].abcVersion (1, 6, 0) >>> ahDict[5].abcVersion (2, 1, 0) rNr) r r enumerater r rrrrrr values) rbahDictprependToAllList activeTokenscurrentABCHandlerrrreferenceNumberthisABCHandlers rVsplitByReferenceNumber!ABCHandler.splitByReferenceNumber s P{{%&PQ Q-/  !$++.HA%--%2I2I2K2K$0/;,#%L$.$//$J!"%ejj/*;' ( ''.##E*/  ('3 $%AF4L$mmoN$4Q$7.:O:O$ON !. rUcUR(d [S5eURH=n[U[5(dMUR 5(dM1UR s $ g)z If tokens are processed, get the first reference number defined. >>> abcStr = 'X:5\nM:6/8\nL:1/8\nK:G\nB3 A3 | G6 | B3 A3 | G6 ||' >>> ah = abcFormat.ABCHandler() >>> junk = ah.process(abcStr) >>> ah.getReferenceNumber() '5' rN)r rr r rrrbrs rVgetReferenceNumberABCHandler.getReferenceNumberj sP{{%&PQ Q[[E%--**,, ::%!rUcUR(d [S5eSn[[UR55HMnURUn[ U[ 5(dM)UR 5(dM@US- nUS:dMM g g)aU Returns True if this token structure defines Measures in a normal Measure form. Otherwise False >>> abcStr = ('M:6/8\nL:1/8\nK:G\nV:1 name="Whistle" ' + ... 'snm="wh"\nB3 A3 | G6 | B3 A3 | G6 ||\nV:2 name="violin" ' + ... 'snm="v"\nBdB AcA | GAG D3 | BdB AcA | GAG D6 ||\nV:3 name="Bass" ' + ... 'snm="b" clef=bass\nD3 D3 | D6 | D3 D3 | D6 ||') >>> ah = abcFormat.ABCHandler() >>> junk = ah.process(abcStr) >>> ah.definesMeasures() True >>> abcStr = 'M:6/8\nL:1/8\nK:G\nB3 A3 G6 B3 A3 G6' >>> ah = abcFormat.ABCHandler() >>> junk = ah.process(abcStr) >>> ah.definesMeasures() False rrrJrTF)r rrrr r rTrs rVdefinesMeasuresABCHandler.definesMeasures~ su({{%&PQ Qs4;;'(AKKNE%((??$$QJEz#)rUctUR(d [S5eSn/n[[UR55HnURUn[ U[ 5(dM)UR 5(dM@UR(dMSURSR5(dMwURU5 US- nM /nUS::a4UR5nURUlURU5 U$/nURSUS/5 USn[S[U55HnX(n URX9/5 U nM URU[U5/5 UH9upUR5nURXUlURU5 M; U$)a Given a processed token list, look for voices. If voices exist, split into parts: common metadata, then next voice, next voice, etc. Each part is returned as a ABCHandler instance. >>> abcStr = ('M:6/8\nL:1/8\nK:G\nV:1 name="Whistle" ' + ... 'snm="wh"\nB3 A3 | G6 | B3 A3 | G6 ||\nV:2 name="violin" ' + ... 'snm="v"\nBdB AcA | GAG D3 | BdB AcA | GAG D6 ||\nV:3 name="Bass" ' + ... 'snm="b" clef=bass\nD3 D3 | D6 | D3 D3 | D6 ||') >>> ah = abcFormat.ABCHandler() >>> ah.process(abcStr) >>> tokenColls = ah.splitByVoice() >>> tokenColls[0] Common headers are first >>> [token.src for token in tokenColls[0].tokens] ['M:6/8', 'L:1/8', 'K:G'] Then each voice >>> [token.src for token in tokenColls[1].tokens] ['V:1 name="Whistle" snm="wh"', 'B3', 'A3', '|', 'G6', '|', 'B3', 'A3', '|', 'G6', '||'] >>> [token.src for token in tokenColls[2].tokens] ['V:2 name="violin" snm="v"', 'B', 'd', 'B', 'A', 'c', 'A', '|', 'G', 'A', 'G', 'D3', '|', 'B', 'd', 'B', 'A', 'c', 'A', '|', 'G', 'A', 'G', 'D6', '||'] >>> [token.src for token in tokenColls[3].tokens] ['V:3 name="Bass" snm="b" clef=bass', 'D3', 'D3', '|', 'D6', '|', 'D3', 'D3', '|', 'D6', '||'] Then later the metadata can be merged at the start of each voice: >>> mergedTokens = tokenColls[0] + tokenColls[1] >>> mergedTokens >>> [token.src for token in mergedTokens.tokens] ['M:6/8', 'L:1/8', 'K:G', 'V:1 name="Whistle" snm="wh"', 'B3', 'A3', '|', 'G6', '|', 'B3', 'A3', '|', 'G6', '||'] rrrJ) r rrrr r rrrr r) rb voiceCountrrr abcHandlersrpairsrsr+rrs rV splitByVoiceABCHandler.splitByVoice sxh{{%&PQ Q s4;;'(AKKNE%--==??zzzejjm&;&;&=&= 1 "a )  ?!B BI   r "&E LL!SV %AA1c#h'F aV$( LL!SY (^^% KK, ""2& rUc/nURSUS/5 USn[S[U55H'nXnXSS-:XaUnMURX5/5 UnM) X1:waURX1/5 U$)a& Staticmethod Given a list of indices of a list marking the position of each barline or implied barline, and the last valid index, return a list of two-element lists, each indicating the start and positions of a measure. Here's an easy case that makes this method look worthless: >>> AH = abcFormat.ABCHandler >>> AH._buildMeasureBoundaryIndices([8, 12, 16], 20) [[0, 8], [8, 12], [12, 16], [16, 20]] But in this case, we need to see that 12 and 13 don't represent different measures but probably represent an end and new barline (repeat bar), etc. >>> AH._buildMeasureBoundaryIndices([8, 12, 13, 16], 20) [[0, 8], [8, 12], [13, 16], [16, 20]] Here 115 is both the last barline and the last index, so there is no [115, 115] entry. >>> bi = [9, 10, 16, 23, 29, 36, 42, 49, 56, 61, 62, 64, 70, 77, 84, 90, 96, 103, 110, 115] >>> AH._buildMeasureBoundaryIndices(bi, 115) [[0, 9], [10, 16], [16, 23], [23, 29], [29, 36], [36, 42], [42, 49], [49, 56], [56, 61], [62, 64], [64, 70], [70, 77], [77, 84], [84, 90], [90, 96], [96, 103], [103, 110], [110, 115]] rrJ)r rr) positionListlastValidIndexrrrsr+s rV_buildMeasureBoundaryIndices'ABCHandler._buildMeasureBoundaryIndices sF aa)* Oq#l+,AAEz LL! A -  LL!, - rUcUR(d [S5e/nUR5nURU[ U5S- 5nUGHupE[ 5nUnUnURUn [ U [5(a/U n U RS:XaU RS:XaOXl US-nO/US:wa([ URU[5(aUS-nOU[ U5:a [ U5n OUn URU n [ U [5(a.U n U RS:XaU RS:XdXl US- nOl[ URU [5(aOI[ URU [[45(aU [ UR5S- :XdU S- nURXxS-UlU(dGMURU5 GM U$)a' Divide a token list by Measures, also defining start and end bars of each Measure. If a component does not have notes, leave as an empty bar. This is often done with leading metadata. Returns a list of ABCHandlerBar instances. The first usually defines only Metadata TODO: Test and examples rrJrFrrrZ)r rtokensToBarIndicesrrrr r r@rB leftBarTokenr rightBarTokenrrr )rbabcBarHandlers barIndicesmeasureIndicesrsrrrxClipyCliptokenAtX lbCandidate yTestIndextokenAtYTestIndex rbCandidates rVsplitByMeasureABCHandler.splitByMeasure4 s{{%&PQ Q,,. :::s4yST}U #DABEE{{1~H(F++&.  ''83'22e;&1OA aJt{{1~{CCA CI~ Y  $ J 7 +V44&7 #++x7'22g=(3$ADKK 3[AA!Z!87H:MNN$DKK(81(<<#Q E!)4BI  ! !" %Q#`rUcx/nSn[UR5Hup4URUS-n[U[5(aUR U5 M@[U[ 5(dMWUcM\[U[[45(dMyUR U5 M U$![a SnNf=f)z Return a list of indices indicating which tokens in self.tokens are bar lines or the last piece of metadata before a note or chord. NrJ) rr rr r r r rr)rbrrrrs rVrABCHandler.tokensToBarIndices s  !$++.HA  AE* %((!!!$UK00' ((;<<!!!$#/&!  sB** B98B9cUR(d [S5eSnURH%n[U[[45(dM US- nM' US:agg)aN If tokens are processed, return True if ABCNote or ABCChord classes are defined >>> abcStr = 'M:6/8\nL:1/8\nK:G\n' >>> ah1 = abcFormat.ABCHandler() >>> junk = ah1.process(abcStr) >>> ah1.hasNotes() False >>> abcStr = 'M:6/8\nL:1/8\nK:G\nc1D2' >>> ah2 = abcFormat.ABCHandler() >>> junk = ah2.process(abcStr) >>> ah2.hasNotes() True z"must process tokens before callingrrJTF)r rr rr)rbrrs rVhasNotesABCHandler.hasNotes sT"{{%&JK K[[E%'8!455 ! 19rUcUR(d [S5eURH=n[U[5(dMUR 5(dM1UR s $ g)zU Get the first title tag. Used for testing. Requires tokens to have been processed. rN)r rr r rrrs rVgetTitleABCHandler.getTitle sL {{%&PQ Q[[E%--==?? ::%!rU) rrrrrrrrrrmr N)rztuple[int, ...])r"z Sequence[_T]rrrzz*tuple[_T | None, _T, _T | None, _T | None])rmryrrrzr)rryrzz list[ABCBar])rzry)r<ryrzr9)r=zre.Matchrztuple[int, int, int])rryr% str | Noner&rrzr;)rmryrzr9r8)rzzdict[int | None, ABCHandler])rzzlist[ABCHandler])r list[int]rrrzzlist[list[int]])rzlist[ABCHandlerBar])rzrr:)rzr)!rPrQrRrSr{r#abcVersionDefaultrcr}r'r,r0r6r>r;rLrRr rrrrrrrrrrrrrrrTrNrUrVrr+sD 08/I/I).$,$ 1* 1*%I1*1*h4//h$F$..,+>\/&/"*//3//dBH zx  J!FiV(!F\|222 22hm^8: rUrc6^\rSrSrSrSU4SjjrSrSrU=r$)ri z| A Handler specialized for storing bars. All left and right bars are collected and assigned to their respective attributes. c>>[TU]5 SUlSUlgra)rrcrr)rbrs rVrcABCHandlerBar.__init__ s )-*.rUcUR5nURUR-UlSHn[X5n[X5nUcUcM!UbUc[X#U5 M5UcUb[X#U5 MIURUR:Xa[X#U5 Mq[ R SXT/5 [X#U5 M U$)Nrrz3cannot handle two non-None bars yet: got bNew, bOld)rr getattrsetattrr_r#r$)rbrrbarAttrbOldbNews rVrABCHandlerBar.__add__ s ^^ KK%,,. 8G4)D5*D| !dlT*$"2T*88txx'B.!++-b-1-9:B.'9* rUrr8) rPrQrRrSr{rcrrTr=r>s@rVrr s/rUrcSn/n[[U55H2nXR5(aUS- nM!URU5 M4 /nUS::a*[ 5nUHnXV- nM URU5 U$SnU[U5:aaX2;a3U[U5S- :wa!URXXS--5 US- nOURX5 US- nU[U5:aMaU$)z Given a list of ABCHandlerBar objects, return a list of ABCHandlerBar objects where leading metadata is merged, if possible, with the bar data following. This consolidates all metadata in bar-like entities. rrJr)rrrr r) barHandlersmCount metadataPosrmergedHandlersahbrbs rVrr sFK 3{# $ > " " $ $ aKF   q ! %N {oA HCc"  #k""A[)9A)=$=%%kn{q57I&IJQ%%kn5Q#k"" rUc\rSrSrSr\R 4S SjjrSSjrSr Sr Sr SS jr \ SS j5rSSS jjrS rg)r iB z ABC File or String access The abcVersion attribution optionally specifies the (major, minor, patch) version of ABC to process-- e.g., (2, 1, 0). If not set, default ABC 1.3 parsing is performed. c,XlSUlSUlgrrfilefilename)rbrs rVrcABCFile.__init__K s0:# *, rUcD[R"USS9UlXlg)z Open a file for reading zutf-8)encodingN)ioopenr r)rbrs rVr ABCFile.openP s GGHw7 ! rUcXlg)z Assign a file-like object, such as those provided by StringIO, as an open file object. >>> from io import StringIO >>> fileLikeOpen = StringIO() N)r )rbfileLikes rV openFileLikeABCFile.openFileLikeZ s  rUcgrrNrgs rVrhABCFile._reprInternald srUc8URR5 gra)r closergs rVr ABCFile.closeg s rUNcVURURR5U5$)z Read a file. Note that this calls readstr, which processes all tokens. If `number` is given, a work number will be extracted if possible. )readstrr read)rbrs rVr  ABCFile.readj s ||DIINN,f55rUc/nSnURS5GHnUR5RS5(a*URSS5R 5SU3:XaSnOUR5RS5(aSU(dL[ URSS5R 5RSS55nU[ U5:XaSnO-U(a&UR5RS5(a OU(dMURU5 GM U(d[SU35eSRU5nU$![ a NSf=f)an Extract the string data relating to a single reference number from a file that defines multiple songs or pieces. This method permits loading a single work from a collection/opus without parsing the entire file. Here is sample data that is not correct ABC but demonstrates the basic concept: >>> fileData = """ ... X:1 ... Hello ... X:2 ... Aloha ... X:3 ... Goodbye ... """ >>> file2 = abcFormat.ABCFile.extractReferenceNumber(fileData, 2) >>> print(file2) X:2 Aloha If the number does not exist, raises an ABCFileException: >>> abcFormat.ABCFile.extractReferenceNumber(fileData, 99) Traceback (most recent call last): music21.abcFormat.ABCFileException: cannot find requested reference number in source file: 99 If the same number is defined twice in one file (should not be) only the first data is returned. * Changed in v6.2: now a static method. Fr*zX:rrwTz7cannot find requested reference number in source file: ) rlrrrrstripr TypeErrorr rr!)rmrcollectgatherline forcedNumreferenceNumberss rVextractReferenceNumberABCFile.extractReferenceNumbers s9LLL&Dzz|&&t,,c21F1M1M1OUWX^W_S`1`((..v #DLLb$9$@$@$B$J$J4QS$T UI CK/!% DJJL33D99vt$''*"I&RT T 99W-!sA E E E cUbURX5n[URS9nUR[R:XaUR USS5 UR U5 U$)zF Read a string and process all Tokens. Returns a ABCHandler instance. Nrr)r*rrr#rr>r)rbrmrhandlers rVrABCFile.readstr sa  00@F8 ??h88 8  4 4VDS\ B rUr )rr)rzstr | pathlib.Pathra)rmryrrrzry)rmryrz int | Nonerzr)rPrQrRrSr{r#rrcrrrhrr r}r*rrTrNrUrVr r B sR;C:T:T- !6A A FrUr c\rSrSrSrSrSrSrSrSr Sr S r S r S r S rS rSrSrSrSrSrSrSrSrg)Testi c2SSKJn U"U[55 g)Nr) testCopyAll)music21.test.commonTestr2globals)rbr2s rVtestCopyAndDeepcopyTest.testCopyAndDeepcopy s7D')$rUc .SSKJn URSSS4URSSS4URSSS 4UR S S S 4UR S SS4URSSS44Hup#pE[5nURU5 URnUR[U5U5 SnSn UH;n [U [5(aU S- n M[U [5(dM6US- nM= URX5 URX5 M g)Nrri# rKr]rYrJ)music21.abcFormatr fyrareprisarn mysteryReel aleIsDear testPrimitivewilliamAndNancy morrisonsJigrr r  assertEqualrr rr) rbrtf countTokens noteTokens chordTokensr-r  countNotes countChordsrns rVtestTokenizationTest.testTokenization s/ $ $c3 2  " "Ca 0  #sB /  $ $c2q 1  & &R 3  # #S#q 1 ; 6Rj!lG   R ^^F   S[+ 6JKa**1$K7++!OJ    Z 4   [ 6-; rUcpSn[RU5R5nURUSUS5 URXSS5 Sn[RU5R5nURUSUS5 Sn[R U5nURU/SQ5 [ [RU55SR5nS nUR[R U5S S 5 S nUR[R U5S S 5 g)NzA: this is a testzA:z this is a testz+Q: this is a test % and a following commentzQ:z=d|"G"e2d B2d|"C"gfe "D7"d2d|"G"e2d B2d|"A7""C"gfe "D7""D"d2c|)"G""C""D7"rTz"A7"rUrVz"D"rz=d2rrzA3/2A) rrrrJrrrrr)rbr_postrs rVtestRe Test.testRe s!""3'++- UdT* U%67;""3'++- UdT*N$$S)  6 7 '', -b 1 5 5 7 ,,S1!4c: ,,S1!4c:rUcSSKJn URSSS4URSSS4URS S S 4UR S S S 4UR S SS44Hup#pE[5nURU5 UR5 URnUHn[U[5(dMURS:XaURURU5 MHURS:XaURURU5 MvURS:XdMURURU5 M M g)Nrr8 Fyrareprisarnz3/4Fz Mystery Reelrr3zAle is Dear, Thez4/4rz Kitchen GirlzWilliam and Nancyz6/8rrr)rCrrDrErF kitchGirlrHrr rr r r rrJr) rbrrK titleEncoded meterEncoded keyEncodedr-r rs rVtestTokenProcessMetadataTest.testTokenProcessMetadatas/ $ $ouc B  " "ND# >  "4eS C  .% =  & &(;UC H = 8R|!lG   R  "^^Fe[11yyC'((\Bc)((\Bc)((Z@ = rUcSSKJn URURURUR UR UR4H.n[5nURU5 UR5 M0 g)Nrr8) rCrrDrErFrGr^rHrr r)rbrrKr-s rVtestTokenProcessTest.testTokenProcesssl/  # #  ! !     # #     % %  B!lG   R  " rUc(SSKJn [5nUR"S5UlUR UR S5S5 SUlUR UR S5S5 UR UR S5S5 UR"S 5UlUR UR S 5S 5 SUlUR UR S 5S 5 UR UR S 5S5 g)Nrr/rJr)C#5F)C5Nz^c)rhTB)B-4F)B4N_B)rlT)rr0rrrrJr)rbr0ans rV testNoteParseTest.testNoteParse.s Y!$ 0 0 3 -~> $ -|< . > # 0 0 4 -~> $ -|< . >rUcSSKJn [5nURUR5 UR 5nSHupEnUcUR X4RS5 O(UR X4RRU5 Uc UR X4RS5 MsUR X4RRU5 M [5nURUR5 UR 5nSHupEnUcUR X4RS5 O(UR X4RRU5 Uc UR X4RS5 MsUR X4RRU5 M [5nURS5 UR 5nSHupEnUcUR X4RS5 O(UR X4RRU5 Uc UR X4RS5 MsUR X4RRU5 M g)Nrr8)rNN)rrDrF)rJrFrF)r=rC)rr?rF)rs)rJNrF)rr<NM:6/8 L:1/8 K:G c1D2)rs)rNN) rCrrr hectorTheHerorrJrr_r theBeggerBoy)rbrrahmrrprls rVtestSplitByMeasureTest.testSplitByMeasureBs/ \ 9**+!GA! y  !4!4d;  !4!4!8!8!<y  !5!5t<  !5!5!9!91=*\ 9))*!GA!y  !4!4d;  !4!4!8!8!<y  !5!5t<  !5!5!9!91=\ ,-!GA!y  !4!4d;  !4!4!8!8!<y  !5!5t<  !5!5!9!91=rUc@SSKJn [5nURUR5 UR 5nUR [U5S5 [U5nUR [U5S5 URUSR55 URUSR55 URUSR55 UR USRRS5 [5nURUR5 UR 5nUR [U5S5 [U5nUR [U5S5 URUSR55 URUSR55 URUSR55 UR USRRS 5 [5nURS 5 UR 5nUR [U5S 5 [U5nUR [U5S 5 URUSR55 g) Nrr8 rrtr< r;rurrJ)rCrrrrwrrJrr assertTruer assertFalserr_theAleWifesDaughter)rbrrrxrs rVtestMergeLeadingMetaDataTest.testMergeLeadingMetaDatas/\ 9))*! S2&-c2 ^,b1 q)2245 +4467 r*3356 +99==tD\ 9001! S2&-c2 ^,b1 q)2245 r*3356 r*3356 +99==tD\ ,-! S1%-c2 ^,a0 q)2245rUchSSKJn [5nURUR5 UR 5nUR [U5S5 UR [UR55S/5 UR [US5S5 UR USRSRS5 UR USR5S5 [5nURUR5 UR [U5S5 UR 5nUR [U5S5 UR [UR55S/5 UR USRSRS 5 UR [US5S5 [5nURUR5 UR [U5S 5 UR 5nUR [U5S 5 UR [[UR555/S Q5 UR US RSRS5 UR US R5S5 UR [US 5S5 UR USRSRS5 UR USR5S5 UR [US5S5 UR USRSRS5 UR USR5S5 UR [US5S5 g)Nrr8rJrjXzX:5zThe Begger Boy/zM:6/8rJ)rzX:168z168 The Castle Gate (HJ)YrzX:166z166 Valentine Jigg (Pe)CrzX:167z167 The Dublin Jig (HJ))rCrrrrwrrJrrkeysr r_rtestPrimitivePolyphonic valentineJiggr)rbrrahss rVtestSplitByReferenceNumberTest.testSplitByReferenceNumbers/\ 9))*'') S1% chhj)A3/ SVb) Qq)--u5 Q*,<= \ 9445 R"%'') S1% chhj)D62 T))!,00': SY, \ 9**+ R#&'') S1% SXXZ 01?C S+//9 S**,.KL SX+ S+//9 S**,.JK SX+ S+//9 S**,.LM SX+rUc^SSKJn URS5n[5nUR U5 UR S5nUR 5 UR[U5S5 [5nUR U5 UR S5nUR 5 UR[U5S5 URS5n[5nUR U5 UR S 5nUR 5 UR[U5S 5 g) Nr)corpuszessenFolksong/test0rjJrlTzessenFolksong/han1iSe) rrgetWorkr rr rrJr)rbrfpafrs rVtestExtractReferenceNumberTest.testExtractReferenceNumbers" ^^1 2 Y  WWQZ   R"% Y  WWQZ   R"% ^^0 1 Y  WWS\   R#&rUcSSKJn [5nURUR5 UR [ U5S5 g)Nrr8F)rCrrrslurTestrJrrbrrs rV testSlursTest.testSlurss2/ \ 9%%& R"%rUcSSKJn [5nURUR5 UR [ U5S5 g)Nrr8I)rCrrrtieTestrJrrs rVtestTies Test.testTiess2/ \ 9$$% R"%rUcSSKJn [5nURUR5 UR [ U5S5 URnSnUHn[U[5(dMUS- nM! UR US5 gNrr8r?rJ) rCrrr crescTestrJrr r rrbrrr rrs rV testCrescTest.testCrescsr/ \ 9&&' R"% E%//Q ArUcSSKJn [5nURUR5 UR [ U5S5 URnSnUHn[U[5(dMUS- nM! UR US5 gr) rCrrrdimTestrJrr r rrs rVtestDim Test.testDimsr/ \ 9$$% R"% E%--Q ArUcSSKJn [5nURUR5 UR [ U5S5 g)Nrr8P)rCrrr staccTestrJrrs rV testStaccatoTest.testStaccato2/ \ 9&&' R"%rUczSSKJn [5nURUR5 UR [ U5S5 URnSnSnUH;n[U[5(aUS- nM[U[5(dM6US- nM= UR US5 UR US5 g)Nrr8SrJr) rCrrrbowTestrJrr r rr)rbrrr upBowsdownBowsrs rVtestBow Test.testBow$s/ \ 9$$% R"%E%**! E:..A   # 1%rUcSSKJn SSKJn UR 5nUR UR 5 SR5nURVs/sHn[U5PM nnURXF5 UR[U5S5 URnSnSn Sn UHfn [XR5(aUS- nM$[XR5(aU S- n ME[XR5(dMaU S- n Mh URUS5 URU S5 URU S5 gs snf)Nrr8)r8a VrJr)rCrrr8rraccTest splitlinesr ryrJrr rrr) rbrr8r tokensCorrectrstokensReceivedr rr+r`rs rVtestAcc Test.testAcc4s&/%  ! ! # 9$$%VlJLm n+-))4)Q#a&)4 7 R"%   E%!4!455QE#9#9::QE#6#677Q  A A A#5sEcSSKJn [5nURUR5 UR [ U5S5 g)Nrr8U)rCrrr graceTestrJrrs rV testGraceTest.testGracerrUcSSKJn [5nURUR5 UR [ U5S5 g)Nrr8i)rCrrr guineapigTestrJrrs rV testGuineaPigTest.testGuineaPigs2/ \ 9**+ R#&rUrNN)rPrQrRrSr5rQrYrbrerpryrrrrrrrrrrrrrTrNrUrVr0r0 sg%76;4A4# ?(?>B16f+,Z'.& &  & & n`& 'rUr0__main__)rrrzr)Pr{ __future__r__all__collections.abcr!rretypingrunittestrr"r#r$r%r&rCrrpathlibr(r*r,r.r0r2r4r6TypeVarr7 Environmentr#rwrKrK__annotations__compilerrrreChordr9rGMusic21ExceptionrrrProtoM21ObjectobjectsEqualSlottedObjectMixinr r r r r rrrrrrrrrrrrrrrrrrr TestCaser0 _DOC_ORDERrPmainTest)rs0rVrs"F# %  '??  YYt_&&{3  "&..X1qtX. MOIN  9% jj%  9% **W zz78 jj56  55  ,77  |44 B w%%v~~'M'MB JT Q(T QnYXYxz4z4~ X &8&(8-H-" ,( , (x8H8%H%,dAhdAT SHwSHn}}@.(J(V'XDg$$DPd'8  d'Rz= 1  z TIz/s9K"