rh3SrSSKJr SSKrSSKJr SSKJr SSKJr SSKJr SSKJ r \R"S 5r "S S \R5r /S QrS SS.rSSS.r1SkrSrSr"SS\R(5r"SS\ R,\5r"SS\R05r\S:XaSSKr\R6"\5 gg)z7 Object models of barlines, including repeat barlines. ) annotationsN)base) environment) exceptions21) expressions)repeatbarc\rSrSrSrg) BarExceptionN)__name__ __module__ __qualname____firstlineno____static_attributes__r E/home/james-whalen/.local/lib/python3.13/site-packages/music21/bar.pyr r srr ) regulardotteddashedheavydoublefinal heavy-light heavy-heavytickshortnonerr) light-light light-heavyr r!)rr>rrrrrcdUR5[;a[UR5$U$)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'5s) {{}**!%++-00 rcUcgUR5nU[;aU$U[;a [U$[SU35e)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. rzcannot process style: )r# barTypeList barTypeDictr r%s rstandardizeBarTyper+HsL } KKME  + 5!!3E7;<>> 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. )typepauselocationc Z>[TU]"S0UD6 SUlXlSUlX lg)Nr )super__init___typer0r1r2)selfr0r2keywords __class__s rr5Barline.__init__s1 $8$   ! rc SUR3$)Nztype=)r0r7s r _reprInternalBarline._reprInternalstyyk""rcUR$N)r6r<s r_getTypeBarline._getTypes zzrc$[U5Ulgr@)r+r6r7r&s r_setTypeBarline._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,[UR5$)aR 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'r0r<s rmusicXMLBarStyleBarline.musicXMLBarStyles&&dii00r)r6r2r1r0)NN)rrrr__doc__listr*keys validStylesclassSortOrderequalityAttributesr5r=rArEpropertyr0rIr __classcell__)r9s@rr-r-_sc>{'')*KN6!"#/ Hh  D"11rr-c\rSrSrSrS S SjjrSr\SSj5r\RSSj5r\SSj5r \ RSS j5r SS jr S r g)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} Nc [RRU5 US:XaSnOSn[R"U4SU0UD6 SUlSUlXlX lg)Nstartrrr0)r RepeatMarkr5r- _direction_times directiontimes)r7r[r\r8barTypes rr5Repeat.__init__ sZ""4(  #GG8G8x8$( $ # rcbSUR3nURbUSUR3- nU$)Nz direction=z times=)r[r\)r7msgs rr=Repeat._reprInternals74>>*+ :: ! WTZZL) )C rcJURc [S5eUR$)zx Get or set the direction of this Repeat barline. Can be start or end. TODO: show how changing direction changes type. z1_direction unexpectedly None after initialization)rYr r<s rr[Repeat.direction#s$ ?? "RS SrcUR5S;aFUR5UlURS:XaSUlgURS:XaSUlgg[SU35e)N)rWendrerrWrz cannot set repeat direction to: )r#rYr0r rDs rr[rc.s^ ;;=, ,#kkmDO%'# G+) ,!A%IJ JrcUR$)ac 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 )rZr<s rr\ Repeat.times9s,{{rcUcSUlg[U5nUS:a[SU35eURS:Xa [S5eX lg![a [SU<35ef=f)Nzcannot set repeat times to: rz3cannot set repeat times to a value less than zero: rWz)cannot set repeat times on a start Repeat)rZint ValueErrorr r[)r7r& candidates rr\rgQs =DK J 1}"I%Q~~("#NOO#K "25)< s AA(cRUURU3n[R"U5$)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') )rZrTextExpression)r7prefixpostfixr&s rgetTextExpressionRepeat.getTextExpressionhs+(4;;-y1))%00r)rYrZr[r\r0)rWN)r[strr\ int | None)returnrr)r&rr)rtrs)r&rsrtNone)x) rrrrrKr5r=rQr[setterr\rprr rrrTrTss6p KK. \\$$,1rrTc&\rSrSrSrSrSrSrg)Testi{c2SSKJn U"U[55 g)Nr) testCopyAll)music21.test.commonTestr|globals)r7r|s rtestCopyAndDeepcopyTest.testCopyAndDeepcopy|s7D')$rcSSKJn SSKJn SSKJn SSKJn UR 5n[ 5nXelUR5nURU5 UR5nURU5 URUSU5 URUSU5 URUSU5 UR5n URSU 5 URUSU 5 URUSU5 g)Nrstream)clef)note)metadata)music21rrrrMeasurerT leftBarlineBassClefappendNote assertEqualMetadatainsert) r7rrrrmbcnmds r testSortOrderTest.testSortOrders"  $ NN  H MMO  IIK   1q! 1q! 1q!    B 1r" 1q!rcSSKJn SSKJn SSKJn U"5nUR SUR 5 URU/5nURUSS9nURU5nUSnURURS5 g) Nr) converterr)r- StyleMixinpickle)fmtF) rrr music21.barr- assertNotInclassesStream freezeStrthawStrrhasStyleInformation) r7rrr-rsdatas2 thawedBarlines rtestFreezeThawTest.testFreezeThawsz%"' I qyy1 MM1# ""1("3   t $1  ::EBrr N)rrrrrrrrr rrrzrz{s%"2 Crrz__main__)rK __future__runittestrrrrrr Environment environLocalMusic21Exceptionr r)r*r$strongBarlineTypesr'r+ Music21Objectr-rXrTTestCaserzrmainTestr rrrs# &&u-  <00     P&=.e1d  e1jc1V  c1N+C8  +C\ z Tr