j3|dZddlmZddlZddlmZddlmZddlmZddlmZddlm Z ej d Z Gd d ej Z gd Zd ddZdddZhdZdZdZGddejZGdde jeZGddejZedkrddlZejedSdS)z7 Object models of barlines, including repeat barlines. ) annotationsN)base) environment) exceptions21) expressions)repeatbarceZdZdS) BarExceptionN)__name__ __module__ __qualname__/Users/tedpeters/Documents/Projects/Claude Projects/Misc Tools/notename-sheets/.venv/lib/python3.11/site-packages/music21/bar.pyr r sDrr ) regulardotteddashedheavydoublefinal heavy-light heavy-heavytickshortnonerr) light-light light-heavyrr)rr>rrrrrcz|tvrt|S|S)a Convert a music21 barline name into the musicxml name -- essentially just changes the names of 'double' and 'final' to 'light-light' and 'light-heavy' Does not do error checking to make sure it's a valid name, since setting the style on a Barline object already does that. >>> bar.typeToMusicXMLBarStyle('final') 'light-heavy' >>> bar.typeToMusicXMLBarStyle('regular') 'regular' )lowerreverseBarTypeDictvalues rtypeToMusicXMLBarStyler$4s0 {{}}***!%++--00 rc|dS|}|tvr|S|tvr t|Std|)z Standardizes bar type names. converts all names to lower case, None to 'regular', and 'light-light' to 'double' and 'light-heavy' to 'final', raises an error for unknown styles. Nrzcannot process style: )r barTypeList barTypeDictr r"s rstandardizeBarTyper(GsZ }y KKMME  +  5!!;E;;<<>> bl = bar.Barline('double') >>> bl The type can also just be set via a keyword of "type". Or if no type is specified, a regular barline is returned. Location can also be explicitly stored, but it's not needed except for musicxml translation: >>> bl2 = bar.Barline(type='dashed') >>> bl2 >>> bl3 = bar.Barline() >>> bl3 >>> bl4 = bar.Barline(type='final', location='right') >>> bl4 >>> bl4.type 'final' Note that the barline type 'ticked' only is displayed correctly in Finale and Finale Notepad. N.B. for backwards compatibility reasons, currently Bar objects do not use the style.Style class since the phrase "style" was already used. )typepauselocationNc rtjdi|d|_||_d|_||_dS)Nr)super__init___typer,r-r.)selfr,r.keywords __class__s rr1zBarline.__init__sF $$8$$$   ! rcd|jS)Nztype=)r,r3s r _reprInternalzBarline._reprInternals"ty"""rc|jSN)r2r7s r_getTypezBarline._getTypes zrc.t||_dSr:)r(r2r3r#s r_setTypezBarline._setTypes'.. ra+ Get and set the Barline type property. >>> b = bar.Barline() >>> b.type = 'tick' >>> b.type 'tick' Synonyms are given for some types, based on musicxml styles: >>> b.type = 'light-light' >>> b.type 'double' )docc*t|jS)a returns the musicxml style for the bar. most are the same as `.type` but "double" and "final" are different. >>> b = bar.Barline('tick') >>> b.musicXMLBarStyle() 'tick' >>> b.type = 'double' >>> b.musicXMLBarStyle() 'light-light' >>> b.type = 'final' >>> b.musicXMLBarStyle() 'light-heavy' * Changed in v5.7: was a property before. )r$r,r7s rmusicXMLBarStylezBarline.musicXMLBarStyles&&di000r)NN)r r r__doc__listr'keys validStylesclassSortOrderequalityAttributesr1r8r;r>propertyr,rA __classcell__)r5s@rr*r*^s>${''))**KN6!!!!!!"###/// 8Hh    D"1111111rr*ceZdZdZdddZd Zedd Zejdd ZeddZ e jddZ ddZ dS)Repeata A Repeat barline. The `direction` parameter can be one of `start` or `end`. An `end` followed by a `start` should be encoded as two `bar.Repeat` signs. >>> rep = bar.Repeat(direction='end', times=3) >>> rep To apply a repeat barline assign it to either the `.leftBarline` or `.rightBarline` attribute of a measure. >>> m = stream.Measure() >>> m.leftBarline = bar.Repeat(direction='start') >>> m.rightBarline = bar.Repeat(direction='end') >>> m.insert(0.0, meter.TimeSignature('4/4')) >>> m.repeatAppend(note.Note('D--5'), 4) >>> p = stream.Part() >>> p.insert(0.0, m) >>> p.show('text') {0.0} {0.0} {0.0} {0.0} {1.0} {2.0} {3.0} {4.0} The method :meth:`~music21.stream.Part.expandRepeats` on a :class:`~music21.stream.Part` object expands the repeats, but does not update measure numbers >>> q = p.expandRepeats() >>> q.show('text') {0.0} {0.0} {0.0} {0.0} {1.0} {2.0} {3.0} {4.0} {4.0} {0.0} {0.0} {0.0} {1.0} {2.0} {3.0} {4.0} startN directionstrtimes int | Nonec tj||dkrd}nd}tj|fd|i|d|_d|_||_||_dS)NrLrrr,)r RepeatMarkr1r* _direction_timesrMrO)r3rMrOr4barTypes rr1zRepeat.__init__ sp""4(((   #GGG88G8x888$( $ # rcBd|j}|j |d|jz }|S)Nz direction=z times=)rMrO)r3msgs rr8zRepeat._reprInternals3+4>++ : ! )TZ)) )C rreturnc<|jtd|jS)z Get or set the direction of this Repeat barline. Can be start or end. TODO: show how changing direction changes type. Nz1_direction unexpectedly None after initialization)rSr r7s rrMzRepeat.direction"s# ? "RSS Srr#c|dvrC||_|jdkr d|_dS|jdkr d|_dSdStd|)N)rLendr[rrLrz cannot set repeat direction to: )r rSr,r r=s rrMzRepeat.direction-sv ;;==, , ,#kkmmDO%''# G++) ,+I%IIJJ Jrc|jS)a Get or set the "times" property of this barline. This defines how many times the repeat happens. A standard repeat repeats 2 times; values equal to or greater than 0 are permitted. A repeat of 0 skips the repeated passage. >>> lb = bar.Repeat(direction='start') >>> rb = bar.Repeat(direction='end') Only end expressions can have times: >>> lb.times = 3 Traceback (most recent call last): music21.bar.BarException: cannot set repeat times on a start Repeat >>> rb.times = 3 >>> rb.times = -3 Traceback (most recent call last): music21.bar.BarException: cannot set repeat times to a value less than zero: -3 )rTr7s rrOz Repeat.times8s ,{rNonec| d|_dS t|}n #t$rtd|wxYw|dkrtd||jdkrtd||_dS)Nzcannot set repeat times to: rz3cannot set repeat times to a value less than zero: rLz)cannot set repeat times on a start Repeat)rTint ValueErrorr rM)r3r# candidates rrOz Repeat.timesPs =DKKK JJ    "<5<<  1}}"Q%QQ~(("#NOOO#DKKKs:xcD||j|}tj|S)a Return a configured :class:`~music21.expressions.TextExpressions` object describing the repeat times. Append this to the stream for annotation of repeat times. >>> rb = bar.Repeat(direction='end') >>> rb.times = 3 >>> rb.getTextExpression() >>> rb.getTextExpression(prefix='repeat ', postfix=' times') )rTrTextExpression)r3prefixpostfixr#s rgetTextExpressionzRepeat.getTextExpressiongs,14;111)%000r)rLN)rMrNrOrP)rXrN)r#rN)rXrP)r#rPrXr])rbrc) r r rrBr1r8rHrMsetterrOrhrrrrKrKs66p     XKKKKX. \$$$\$,111111rrKc eZdZdZdZdZdS)TestcBddlm}||tdS)Nr) testCopyAll)music21.test.commonTestrmglobals)r3rms rtestCopyAndDeepcopyzTest.testCopyAndDeepcopy{s0777777 D'))$$$$$rcddlm}ddlm}ddlm}ddlm}|}t }||_|}| || }| || |d|| |d|| |d|| } | d| | |d| | |d|dS)Nrstream)clef)note)metadata)music21rsrtrurvMeasurerK leftBarlineBassClefappendNote assertEqualMetadatainsert) r3rsrtrurvmbcnmds r testSortOrderzTest.testSortOrdersO""""""            $$$$$$ NN   HH MMOO  IIKK   1q!!! 1q!!! 1q!!!    B 1r""" 1q!!!!!rc>ddlm}ddlm}ddlm}|}|d|j||g}||d}| |}|d}| |j ddS) Nr) converterrr)r* StyleMixinpickle)fmtF) ryrrs music21.barr* assertNotInclassesStream freezeStrthawStrrhasStyleInformation) r3rrsr*rsdatas2 thawedBarlines rtestFreezeThawzTest.testFreezeThaws%%%%%%""""""'''''' GII qy111 MM1#  ""1("33   t $ $1  :EBBBBBrN)r r rrprrrrrrkrkzsF%%%"""2 C C C C Crrk__main__)rB __future__runittestryrrrrr Environment environLocalMusic21Exceptionr r&r'r!strongBarlineTypesr$r( Music21Objectr*rRrKTestCaserkr mainTestrrrrs#""""" &{&u--      <0       POO&===.e1e1e1e1e1d e1e1e1jc1c1c1c1c1V c1c1c1N+C+C+C+C+C8 +C+C+C\ zNNNGTr