rh0SrSSKJr SSKJr SSKrSSKrSSKrSSKr SSK r SSK J r SSK J r SSK Jr SSKJr SS K Jr \ R$(aSS KJr \R*"S 5r"S S 5r"SS\5r"SS\5r"SS\5r"SS\5r"SS\5r"SS\5r"SS\5r"SS\5r"SS\5r "S S!\5r!"S"S#\5r""S$S%\5r#"S&S'\5r$"S(S)\5r%"S*S+\5r&"S,S-\5r'"S.S/\5r("S0S1\5r)"S2S3\5r*"S4S5\5r+"S6S7\ RX5r-"S8S9\ RX5r.\/S::XaSSK r \ R`"\-5 gg);z SubConverters parse or display a single format. Each subConverter should inherit from the base SubConverter object and have at least a parseData method that sets self.stream. ) annotations)IOBaseN)common)defaults) environment)SubConverterExceptionstream)Iterablezconverter.subConvertersc\rSrSr%SrSrS\S'SrS\S'SrS \S 'Sr S \S 'Sr S \S 'Sr S \S '0r S\S'Sr S\S'SrS\S'SrS\S'S'SjrS(S)SjjrS(S*SjjrSrSr\"\\SS9rS+SjrS,S-SjjrS.S/S jjrS0S1S!jjrS0S2S"jjrS.S3S#jjrS4S$jrS0S5S%jjrS&rg)6 SubConverter.a Class wrapper for parsing data or outputting data. All other Converter types should inherit from this and have ways of dealing with various data formats. Attributes that should be set:: readBinary = True or False (default False) registerFormats = tuple of formats that can be handled; eg: ('musicxml',) registerShowFormats = tuple of format calls that can be handled in .show() and .write() registerInputExtensions = tuple of input extensions that should be handled in converter registerOutputExtensions = tuple of output extensions that can be written. Order matters: the first will be used in calls to .write() canBePickled = True or False (default True; does not do anything yet) codecWrite = True or False (default False) if encodings need to be used to write stringEncoding = string (default 'utf-8'). If codecWrite is True, this specifies what encoding to use Fbool readBinaryT canBePickledztuple[str, ...]registerFormatsregisterShowFormatsregisterInputExtensionsregisterOutputExtensionszdict[str, str]!registerOutputSubformatExtensionsNzstr | pathlib.Path | None launchKey codecWriteutf-8strstringEncodingc D[R"5UlXlgN)r Score_streamkeywordsselfr!s Y/home/james-whalen/.local/lib/python3.13/site-packages/music21/converter/subConverters.py__init__SubConverter.__init__Ps=C\\^ *2 c[e)z Called when a string (or binary) data is encountered. This method MUST be implemented to do anything in parsing. Return self.stream in the end NotImplementedError)r# dataStringnumbers r$ parseDataSubConverter.parseDataUs "!r'c TURSLa5SSKn[XR5S9nUR 5nSSS5 O%[US5nUR 5nSSS5 UR WU5 UR $!,(df  N,=f!,(df  N==f)z Called when a file is encountered. If all that needs to be done is loading the file and putting the data into parseData then there is no need to implement this method. Just set self.readBinary to True | False. FrNencodingrb)rlocaleopengetpreferredencodingreadr-r )r#filePathr,r!r3f dataStreams r$ parseFileSubConverter.parseFile`s ??e # h)D)D)FG1VVX HGh%VVX & z6*{{HG&%sBB B B'cUR$rr r#s r$ _getStreamSubConverter._getStreamvs ||r'cXlgrr=)r# newStreams r$ _setStreamSubConverter._setStreamys r'zi Returns or sets the stream in the converter. Must be defined for subConverter to work. )docc g)z return bool on whether the *system* is equipped to show in this format. Default True. Might be False if, say a Lilypond converter is used and Lilypond is not installed. Trr"s r$checkShowAbilitySubConverter.checkShowAbilitysr'cbUc!UR(aURSnOUc [S5eUcZUb [UnOMURbURn[UnO*[R U5n[R U5n[ R"5nSnUcZUS:XaS[U54nSnOUS:Xa$U(aS U[U54nOS [U54nO[S US 3S -S U<S3-5eUS;a#U(aXC[U54nO\U[U54nONUS:Xa:U(aS S[U5U[U54nO'S S[U5[U54nO[SU35e[R"USUS9 g![an [S5U eSn A ff=f)a Opens the appropriate viewer for the file generated by .write() app is the path to an application to launch. Specify it and/or a launchKey. launchKey is the specific key in .music21rc (such as graphicsPath), etc. to search for the application. If it's not specified then there might be a default one for the converter in self.launchKey. If it can't find it there then environLocal.formatToApp(fmt) will be used. Not needed for formats for which .show() just prints to the console. NrzBlaunch: fmt can only be None if there is a registered show format.FwinstartTdarwinr4z0Cannot find a valid application path for format z. z,Specify this in your Environment by calling zenvironment.set(z, '/path/to/application'))rJnixz-azCannot launch files on )checkshellzBMost issues with show() can be resolved by calling configure.run()) r ValueError environLocalr formatToKey formatToAppr getPlatformrr subprocessrunFileNotFoundError) r#r7fmtoptionsapprplatformrOcmdes r$launchSubConverter.launchs" ;433**1-C [ab b ;$"9-+ NN "9-(44S9 "..s3**, ;5 H .X%!7CM:C!3x=1C+Fse2NDE( 5NOP  'S]3CM*  !tSXwH FtSXs8}='*A((LM M  NN3e5 9  'T  s<F F. F))F.c NUR"X4SU0UD6nURXbUS9 g)z Write the data, then show the generated data, using `.launch()` or printing to a console. Some simple formats that do not need launching, may skip .launch() and simply return the output. subformatsrXrZNwriter^r#objrXrZrar!returnedFilePaths r$showSubConverter.shows. ::cR:RR $3 7r'cURnU(d [S5eUSnUR(a6U(a/SRU5nX@R;aURUnSU-$)z Given a default format or subformats, give the file extension it should have: >>> c = converter.subConverters.ConverterMidi() >>> c.getExtensionForSubformats() '.mid' zRThis subConverter cannot show or write: no output extensions are registered for itr.)rrrjoin)r#ra extensionsextjoinedSubformatss r$getExtensionForSubformats&SubConverter.getExtensionForSubformatssr22 '?@ @m  1 1j"xx 3 #I#II<<=MNSyr'cPURU5n[RUSS9nU$)ac Return a temporary file with an extension appropriate for the format. >>> c = corpus.parse('bwv66.6') >>> lpConverter = converter.subConverters.ConverterLilypond() >>> tf = str(lpConverter.getTemporaryFile(subformats=['png'])) >>> tf.endswith('.png') True >>> import os #_DOCS_HIDE >>> os.remove(tf) #_DOCS_HIDE * Changed in v6: returns pathlib.Path T returnPathlib)rprQ getTempFile)r#rarnfps r$getTemporaryFileSubConverter.getTemporaryFiles.,,Z8  % %c % > r'c B[U5nUR"X640UD6nU$)zO Calls .writeDataStream on the repr of obj, and returns the fp returned by it. )reprwriteDataStreamr#rfrXrvrar!dataStrs r$rdSubConverter.writes's)  ! !" : : r'c UcUR5nURSLaSnOSnURSLa'[U[5(aUR S5n[U[[R45(aY[R"USS9n[UUUR(a UROSS9nUR!U5 SSS5 U$UR!U5 UR5 [R"S 5$![ a/ SUl[U[5(aUR5 Nf=f!,(df  U$=f) zl Writes the data stream to `fp` or to a temporary file and returns the Path object of the filename written. NFwwbrTrsmoder1)rwrr isinstancebytesdecodeUnicodeDecodeErrorrcloserpathlibPathr cleanpathr4rrd)r#rvr}r! writeFlagsr8s r$r{SubConverter.writeDataStreams$ :&&(B ??e #JJ ??e # 7E(B(B !..1 b3 - . .!!"D9Bb%6:oot224  I HHW  HHJ<<# #'& "&b&))HHJ   Is DE6E  E  Ec UR"U4X#S.UD6nURSLaSnOSn[UUUR(a UROSS9nUR 5nSSS5 UR SS9 W$!,(df  N=f) zr Write the object out in the given format and then read it back in and return the object (str or bytes) returned. )rXraFrr2NrT) missing_ok)rdrr4rrr6unlink) r#rfrXrar!rv readFlagsr8outs r$toDataSubConverter.toDataCsZZ H Hx H ??e #II " 26//4..t&&(C  T " s A<< B )r rr!)returnNoner)r, int | Noner7str | pathlib.Pathr,r)rr)NrNN)r7 pathlib.PathrYrrZ str | NoneNr)rXrrr)r)ra Iterable[str]rr)rarrr)rfzmusic21.base.Music21ObjectrXrrv"str | pathlib.Path | IOBase | Nonerar)rvrr} str | bytesrr)rXrrarrr) __name__ __module__ __qualname____firstlineno____doc__r__annotations__rrrrrrrrrr%r-r:r?rCpropertyr rGr^rhrprwrdr{r__static_attributes__rr'r$r r .s*JL$')O_)+--/1_102o28:%~:'+I$+J!NC!3 "&*,",!j*3  F  # H%HH H\  88 8$**26*, -  / ( &$8&$!*&$(4&$X%' "   r'r c2\rSrSrSrSrSrSS0rS SjrSr g) ConverterIPythoni\z Meta-subConverter for displaying image data in a Notebook using either png (via MuseScore or LilyPond) or directly via Vexflow/music21j, or MIDI using music21j. )ipythonjupyterrlilypondlyNc NSSKJn SSKJn U(a USnUSSn OSn/n U (dS/n UR U5n US;aUR "U4U UU S .UD6 gUS :XaD[ R(a[U [5(deUR"U4U UU S .UD6 gg) a show a specialized for Jupyter Notebook using the appropriate subformat. For MusicXML runs it through MuseScore and returns the PNG data. (use multipageWidget to get an experimental interactive page display). For MIDI: loads a music21j-powered MIDI player in to the Notebook. r) Converter) convertersNmusicxmlpng)rxmlrlily) subConverterrXramidi) music21.converterrmusic21.ipython21rgetSubConverterFromFormatshowImageThroughMuseScoret TYPE_CHECKINGr ConverterMididisplayMusic21jMIDI) r#rfrXrZrar!rip21_converters helperFormathelperSubformatshelperSubConverters r$rhConverterIPython.showfs 0C %a=L)!"~ %L!  %w &@@N B B  5 5 / +     V #!"4mDDDD  / / / +     $r'r) rrrrrrrrrhrrr'r$rr\s$ -O!)3T(:%*r'rcV\rSrSrSrSrSrSSSS.rS rSS S .SSjjjr SSjr S r g )ConverterLilypondiz Convert to Lilypond and from there usually to png, pdf, or svg. Note: that the proper format for displaying Lilypond in Jupyter notebook in v9 is ipython.lily.png and not lily.ipython.png )rr)rrpdfsvgrrr)rrrTNrF)coloredVariantsc *SSKJn URR5nXXlUR U5 SU;aUR U5n U $SU;aURU5n U $SU;aURU5n U $URSUS9n U $)Nr)rrrrz.ly)rnrv) music21r translateLilypondConverterrloadFromMusic21Object createPDF createPNG createSVG writeLyFile) r#rfrXrvrarr!rconvconvertedFilePaths r$rdConverterLilypond.writes !~~//1. ""3' J  $r 2 ! j $r 2  ! j $r 2 ! !% 0 0Ur 0 B   r'c U(dS/nUR"X4SU0UD6nUb U(aUSnOSn[RU5nURXgX8S9 g)z Call .write (write out the lilypond (.ly) file; convert to .png/.pdf, etc.) then launch the appropriate viewer for .png/.pdf (graphicsPath) or .svg (vectorPath) rraNr)rXrZr)rdrQrRr^) r#rfrXrZrar!rg outFormatrs r$rhConverterLilypond.shows` J::cR:RR  !j"1 II!,,Y7  $ Rr'r)rr) rrrrrrrrrrdrhrrr'r$rrsS +O:050502)4%J  ! ', ! $ !.Sr'rcJ^\rSrSrSrSrSrSU4SjjrSSjrSr U=r $) ConverterBrailleibrailletxtTrc >[R"5(d[TU] "X4SUS.UD6 gSSKJn UR RU5n[U5 g)N)rZrarr) rrunningInNotebooksuperrhrrrobjectToBrailleprint) r#rfrXrZrar!rr} __class__s r$rhConverterBraille.showsL'')) GL Ot Oh O '''77>> s = corpus.parse('bwv66.6') >>> s.measures(1, 4).show('textline') "{0.0} / {0.0} ..." )textlinerNrc HUR5nURX65 U$r) _reprTextLiner{r|s r$rdConverterTextLine.write!s###% R) r'c "UR5$r)rrs r$rhConverterTextLine.show&s  ""r'rrrr'r$rrs$O' #r'rc\\rSrSrSrSrSrSrSSS.SS jjjrS r SS jr SS jr S r g)ConverterVolpianoi*a Reads or writes volpiano (Chant encoding). Normally, just use 'converter' and .show()/.write() >>> p = converter.parse('volpiano: 1---c-d-ef----4') >>> p.show('text') {0.0} {0.0} {0.0} {1.0} {2.0} {3.0} {4.0} > {4.0} >>> p.show('volpiano') 1---c-d-ef----4 volpiano)rvp)rrNFbreaksToLayoutc 8SSKJn URXS9Ulg)Nrr r)rrtoPartr )r#r+r,rr!rs r$r-ConverterVolpiano.parseDataAs %oojoP r'c SSKJn UR(aUnO&[R"5nUR U5 UR U5$)z. Get the raw data, for storing as a variable. rr )rrisStreamr Streamappend fromStream)r#rfr!rss r$ getDataStrConverterVolpiano.getDataStrLs: % <<A A HHSM""1%%r'c NUR"U40UD6nURX65 U$r)rr{r|s r$rdConverterVolpiano.writeYs(//#22 R) r'c <[UR"U40UD65 gr)rrrs r$rhConverterVolpiano.show^s dooc.X./r'r r)r,rrrr) rrrrrrrrr-rrdrhrrr'r$r r *sU$$O0,   Q % Q Q  Q & 0r'r c \rSrSrSrSrSrSrg)ConverterScalaib)scala)sclrN)rrrrrrrrrr'r$r"r"bs O&'r'r"cT^\rSrSrSrSrSrU4SjrS SjrS S Sjjr Sr U=r $) ConverterHumdrumiizR Simple class wrapper for parsing Humdrum data provided in a file or in a string. )humdrum)krnc 4>[TU]"S0UD6 SUlgrrr%datar#r!rs r$r%ConverterHumdrum.__init__p $8$ r'cSSKJn U"U5nUR5 X@lURRUlUR$)a  Open Humdrum data from a string -- calls :meth:`~music21.humdrum.spineParser.HumdrumDataCollection.parse()`. >>> humData = ('**kern\n*M2/4\n=1\n24r\n24g#\n24f#\n24e\n24c#\n' + ... '24f\n24r\n24dn\n24e-\n24gn\n24e-\n24dn\n*-') >>> c = converter.subConverters.ConverterHumdrum() >>> s = c.parseData(humData) >>> c.stream.show('text') {0.0} {0.0} {0.0} {0.0} {0.0} {0.0} {0.1667} {0.3333} {0.5} {0.6667} {0.8333} {1.0} {1.1667} {1.3333} {1.5} {1.6667} {1.8333} r)HumdrumDataCollection)music21.humdrum.spineParserr0parser+r )r# humdrumStringr,r0hdfs r$r-ConverterHumdrum.parseDatavs;8 F#M2  ii&& yyr'c SSKJn U"U5nUR5 XPlURRUlUR$)zd Open Humdrum data from a file path. Calls humdrum.parseFile on filepath. Number is ignored here. r) HumdrumFile)r1r7 parseFilenamer+r )r#r7r,r!r7hfs r$r:ConverterHumdrum.parseFiles? <  "  ii&& yyr'r+r rr7pathlib.Path | strr,r) rrrrrrrr%r-r:rrrs@r$r&r&is?#O& "L&*,"r'r&c>^\rSrSrSrSrSrU4SjrSSjrSr U=r $) ConverterTinyNotationizl Simple class wrapper for parsing TinyNotation data provided in a file or in a string. Input only for now. ) tinynotation)tntxtr@c 4>[TU]"S0UD6 SUlgrr*r,s r$r%ConverterTinyNotation.__init__r.r'c[U[5(aUnO [S5eSSKJn UR "U40UR D6R5RUlg)a Open TinyNotation data from a string >>> tnData = "3/4 E4 r f# g=lastG trip{b-8 a g} c" >>> c = converter.subConverters.ConverterTinyNotation() >>> s = c.parseData(tnData) >>> c.stream.show('text') {0.0} {0.0} {0.0} {0.0} {1.0} {2.0} {3.0} {0.0} {1.0} {1.3333} {1.6667} {2.0} {2.5} zWTinyNotation no longer supports two-element calls; put the time signature in the streamr) tinyNotationN) rrrrrErr!r2r )r#tnDatar,tnStrrEs r$r-ConverterTinyNotation.parseDatasW. fc " "E'"# # )",,UDdmmDJJLSS r'r;r) rrrrrrrr%r-rrrs@r$r?r?s& (O7 TTr'r?c<\rSrSrSrSrSrSrS S SjjrSr g) ConverterNoteworthyia Simple class wrapper for parsing NoteworthyComposer data provided in a file or in a string. Gets data with the file format .nwctxt Users should not need this routine. The basic format is converter.parse('file.nwctxt') >>> nwcTranslatePath = common.getSourceFilePath() / 'noteworthy' #_DOCS_HIDE >>> paertPath = nwcTranslatePath / 'Part_OWeisheit.nwctxt' #_DOCS_HIDE >>> #_DOCS_SHOW paertPath = converter.parse(r'd:/desktop/arvo_part_o_weisheit.nwctxt') >>> paertStream = converter.parse(paertPath) >>> len(paertStream.parts) 4 For developers: see the documentation for :meth:`parseData` and :meth:`parseFile` to see the low-level usage. )noteworthytext)nwctxtcXSSKJn UR5RU5Ulg)a Open Noteworthy data from a string or list >>> nwcData = ('!NoteWorthyComposer(2.0)\n|AddStaff\n|Clef|' + ... 'Type:Treble\n|Note|Dur:Whole|Pos:1^') >>> c = converter.subConverters.ConverterNoteworthy() >>> c.parseData(nwcData) >>> c.stream.show('text') {0.0} {0.0} {0.0} {0.0} rrN)music21.noteworthyrNoteworthyTranslator parseStringr )r#nwcDatanoteworthyTranslates r$r-ConverterNoteworthy.parseDatas# H)>>@LLWU r'Nc XSSKJn UR5RU5Ulg)a Open Noteworthy data (as nwctxt) from a file path. >>> nwcTranslatePath = common.getSourceFilePath() / 'noteworthy' #_DOCS_HIDE >>> filePath = nwcTranslatePath / 'Part_OWeisheit.nwctxt' #_DOCS_HIDE >>> #_DOCS_SHOW paertPath = converter.parse('d:/desktop/arvo_part_o_weisheit.nwctxt') >>> c = converter.subConverters.ConverterNoteworthy() >>> c.parseFile(filePath) >>> #_DOCS_SHOW c.stream.show() rrNN)rOrrPr:r )r#r7r,r!rSs r$r:ConverterNoteworthy.parseFile s# H)>>@JJ8T r'r rr< rrrrrrrr-r:rrr'r$rJrJs=&*O)V(&*U,U"UUr'rJc@\rSrSrSrSrSrSrSrS S Sjjr S r g) ConverterNoteworthyBinaryiz Simple class wrapper for parsing NoteworthyComposer binary data provided in a file or in a string. Gets data with the file format .nwc Users should not need this routine. Call converter.parse directly T) noteworthy)nwccXSSKJn UR5RU5UlgNr)binaryTranslate)rOr^ NWCConverterrQr )r#rRnoteworthyBinarys r$r-#ConverterNoteworthyBinary.parseData-s J&335AA'J r'Nc XSSKJn UR5RU5Ulgr])rOr^r_r:r )r#r7r,r!r`s r$r:#ConverterNoteworthyBinary.parseFile1s# K&335??I r'r rr<) rrrrrrrrr-r:rrr'r$rYrYsBJ%O'K &*J,J"JJr'rYc\rSrSrSrSrSrSrSSS.rSSS jjr SSS jjr SS jr SS S S.SSjjjr SSjr Srg )ConverterMusicXMLi:z~ Converter for MusicXML using the 2015 ElementTree system. Users should not need this Object. Call converter.parse directly )rr)rmxlr)rrrfrr)rrNc~SSKJn UR5nXlUR 5 UR Ulg)z# Open MusicXML data from a string. rxmlToM21N)music21.musicxmlriMusicXMLImporterxmlText parseXMLTextr )r# xmlStringr,rics r$r-ConverterMusicXML.parseDataGs/ .  % % '  hh r'c SSKJn SSKJn UR 5nUR U5nUR 5(a'UR5nXlUR5 OURU5 URRRc;[RR!U5upXRRl URUl g)z Open from a file path; check to see if there is a pickled version available and up to date; if so, open that, otherwise open source. r converterrhN)rrsrjrirkArchiveManager isArchivegetDatarlrmreadFiler metadata movementNameospathsplit) r#r7r,r!rsriroarcharchDatajunkfns r$r:ConverterMusicXML.parseFileRs &-  % % '''1 >>  ||~H I NN  JJx  88   ) ) 1ww}}X.HD-/HH   *hh r'c x[U[5(d[US35eUnUcUR5nO[R "USS9nUR (aUR S:XaURS5nSn[XV5nURU5 SSS5 U$!,(df  U$=f)a Writes `dataStr` which must be bytes to `fp`. Adds `.musicxml` suffix to `fp` if it does not already contain some suffix. * Changed in v7: returns a pathlib.Path OMIT_FROM_DOCS >>> import os >>> from music21.converter.subConverters import ConverterMusicXML >>> fp = 'noSuffix' >>> sub = ConverterMusicXML() >>> outFp = sub.writeDataStream(fp, b'') >>> str(outFp).endswith('.musicxml') True >>> os.remove(outFp) >>> fp = 'other.suffix' >>> outFp = sub.writeDataStream(fp, b'') >>> str(outFp).endswith('.suffix') True >>> os.remove(outFp) z& must be bytes to write to this formatNTrs.mxl .musicxmlr) rrrPrwrrsuffix with_suffixr4rd)r#rvr}r! dataBytesfpPathrr8s r$r{!ConverterMusicXML.writeDataStreamss8'5))y(NOP P  :**,F%%b=F}}  7'' 4F & % GGI & & % s B** B9T) makeNotationcompressc dSSKJnJn [Rn [R n UcDU(a"[ U5RS5(aSnOURS5(aSnOSnSU;aS[lS[lS n U RU5n X]l U R5n UnUb9U(a2[ U5n[RRU5SnUS -nURX5nSU;aU [lU [lSU;dS U;a8[ [ S 5RS 5(dSSKJn U"UU40UD6nU$U(aCUR'USSSS9 UR)S5n[*R,R/USS9nU$UnU$)aS Write to a .musicxml file. Set `makeNotation=False` to prevent fixing up the notation, and where possible, to prevent making additional deepcopies. (This option cannot be used if `obj` is not a :class:`~music21.stream.Score`.) `makeNotation=True` generally solves common notation issues, whereas `makeNotation=False` is intended for advanced users facing special cases where speed is a priority or making notation reverses user choices. Set `compress=True` to immediately compress the output to a .mxl file. Set to True automatically if format='mxl' or if `fp` is given and ends with `.mxl` r) archiveToolsm21ToXmlrTrfFrrr'rrmusescoreDirectPNGPathz/skip)runThroughMuseScore)deleteOriginalsilentstrictMxlCheckrs)rjrrrtitleauthorrendswith startswithGeneralObjectExporterrr2rzr{splitextr{rQmusic21.converter.museScorer compressXMLrr pathToolsr)r#rfrXrvrarrr!rrsavedDefaultTitlesavedDefaultAuthorrgeneralExporterwriteDataStreamFpfpStr noExtFpStrxmlFproutFp filenameOuts r$rdConverterMusicXML.writes* <$NN%__  c"g&&v..&&  J HN HO "88='3$#))+  >jGE))%03J *[ 8 "223DP J .HN0HO j EZ$7L)ABCNNwWW G'zFXFE   $ $U48,049 % ; ++F3K$$..{$.OE E r'c pUR"X4SU0UD6nSU;aSnOSU;aSnURXbUS9 g)z# Override to do something with png rarrrbNrcres r$rhConverterMusicXML.showsH ::cR:RR J C j C $3 7r'r r)rnrr)r}rrrr)rfzmusic21.Music21Objectrz bool | None)rrrrrrrrrr-r:r{rdrhrrr'r$rere:s *O890505)+% &*,"B.!*.(4.f H  $(H(H"HT 8r'rec\rSrSrSrSrSrSrSr\ SSj5r SS S .SS jjjr SS S .SS jjjr SS S S.SSjjjr Srg)rizB Simple class wrapper for parsing MIDI and sending MIDI data out. T)r)midr)rcjSUR;a#URS(aURS$g)Nr1r)r!r>s r$r1ConverterMidi.encodings+  &4==+D==, ,r'Nrr0cSSKJn URR5VVs0sHupVUS;dM XV_M nnnUR"U4SU=(d UR 0UD6Ulgs snnf)a Get MIDI data from a binary string representation. Calls midi.translate.midiStringToStream. Keywords to control quantization: `quantizePost` controls whether to quantize the output. (Default: True) `quarterLengthDivisors` allows for overriding the default quantization units in defaults.quantizationQuarterLengthDivisors. (Default: (4, 3)). If encoding is not provided use the encoding of the Converter (default "utf-8") rrNr0r1N) music21.midirr!itemsmidiStringToStreamr1r )r#strDatar,r1 midiTranslatekvr!s r$r-ConverterMidi.parseData st <%)]]%8%8%:/%:TQ -AD%:/#66  .   /s A+A+c SSKJn URR5VVs0sHupgUS;dM Xg_M nnnUR"U4UR U=(d UR S.UD6 gs snnf)a Get MIDI data from a file path. Calls midi.translate.midiFilePathToStream. Keywords to control quantization: `quantizePost` controls whether to quantize the output. (Default: True) `quarterLengthDivisors` allows for overriding the default quantization units in defaults.quantizationQuarterLengthDivisors. (Default: (4, 3)). If encoding is not provided use the encoding of the Converter (default "utf-8") rrNr0)inputM21r1N)rrr!rmidiFilePathToStreamr r1)r#r7r,r1r!rrrs r$r:ConverterMidi.parseFile!sw& <%)]]%8%8%:/%:TQ -AD%:/**  [[.   /s A1A1F addStartDelayr1c SSKJn UcUR5nURXU=(d URS9n U R US5 U R 5 U R5 U$)NrrNrr)rrrwmusic21ObjectToMidiFiler1r4rdr) r#rfrXrvrarr1r!rmfs r$rdConverterMidi.write>sc < :&&(B  2 23MDK    0 0[[ Ir'c DSSKJn UR5nURU5 UR US9nUR 5 UR 5(a URRUUS9Ul gURRX`R5 g)aB Get ABC data from a file path. If more than one work is defined in the ABC data, a :class:`~music21.stream.Opus` object will be returned; otherwise, a :class:`~music21.stream.Score` is returned. If `number` is provided, and this ABC file defines multiple works with an X: tag, just the specified work will be returned. rrrN) rrrr4r6rrrrr r)r#r7r,r!rrrs r$r:ConverterABC.parseFileps &     WWFW+     - - / /$--==jEK>MDK    0 0[[ Ir'r rr<rWrr'r$rrTs= O&J*&*J,J"JJr'rcN\rSrSrSrSrSrSrS SjrS S Sjjr S S jr S r g)ConverterRomanTextizC Simple class wrapper for parsing roman text harmonic definitions. ) romantextrntext)rntxtrrrtxt)rNcSSKJn SSKJn UR5nUR U5nUR 5(aUR U5UlgURX`R5 gNr) rtObjectsrN) music21.romanTextrrRTFilerdefinesMovementsromanTextToStreamOpusr romanTextToStreamScore)r#rr,rromanTextTranslatertf rtHandlers r$r-ConverterRomanText.parseDatasW/E KK(  % % ' ',BB9MDK  5 5i Mr'c SSKJn SSKJn UR5nUR U5 UR 5nUR 5 URXpR5 gr) rrrrr4r6rrr )r#r7r,r!rrrrs r$r:ConverterRomanText.parseFilesJ 0E  HHJ  11)[[Ir'c SSKJn UcUR5n[US5(dL[ USSS9nUR U5R HnURUS-5 M SSS5 U$UR U5R HnURUS-5 M U$!,(df  U$=f) zN Writes 'RomanText' files (using the extension .rntxt) from a music21.stream. r) writeRomanNrdrrr0 )rrrwhasattrr4RnWriter combinedListrd) r#rfrXrvrar!r text_fileentrys r$rdConverterRomanText.writes 1 :&&(Br7##b#0I'005BBEOOEDL1C1 $,,S1>>&? 10 s 7B// B>r rr<r) rrrrrrrrr-r:rdrrr'r$rrsB.OF) N&* J, J" Jr'rc@\rSrSrSrSrSrSS SjjrSS SjjrSr g) ConverterClercqTemperleyiz\ Wrapper for parsing harmonic definitions in Trevor de Clercq and David Temperley's format. )cttxtharclercqTemperleyNc\SSKJn URU5nUR5Ulg)Nr)r)rrCTSongrr )r#rr,rctSongs r$r-"ConverterClercqTemperley.parseDatas"5 ''0mmo r'c &URU5 gr)r-)r#r7r,r!s r$r:"ConverterClercqTemperley.parseFiles x r'r r)rr)r7r=rWrr'r$rrs0:OA&!,!!r'rc@\rSrSrSrSrSrS SjrS S SjjrSr g) ConverterCapellaizX Simple class wrapper for parsing Capella .capx XML files. See capella/fromCapellaXML. )capella)capxNcSSKJn UR5nURU5 UR UR R 5nURU5nX`lg)z^ parse a data stream of uncompressed capella xml N.B. for web parsing, it gets more complex. rfromCapellaXMLN) music21.capellarCapellaImporterrmsystemScoreFromScoremainDomdocumentElementpartScoreFromSystemScorer )r#rr,rciscoreObj partScores r$r-ConverterCapella.parseDatasP 3  + + -  **2::+E+EF//9  r'c \SSKJn UR5nURU5Ulg)z Parse a Capella file rrN)rrr scoreFromFiler )r#r7r,r!rrs r$r:ConverterCapella.parseFiles' 3  + + -&&x0 r'r rrrWrr'r$rrs8#O'  &* 1, 1" 1 1r'rc@\rSrSrSrSrSrS SjrS S SjjrSr g) ConverterMuseDataiz, Simple class wrapper for parsing MuseData. musedata)mdrzipNcSSKJn SSKJn [ U[ 5(aU/nOUnUR 5nUHnURU5 M URX`R5 g)z, Get musedata from a string representation. rrrNN) rrmusic21.musedatarrr MuseDataWork addStringmuseDataWorkToStreamScorer )r#rr,musedataModulemusedataTranslate strDataListmdw strDataInners r$r-ConverterMuseData.parseDatas[ 7C gs # #")K!K))+'L MM, '( 33CEr'c [U[R5(d[R"U5nOUnSSKJn SSKJn SSKJn UR5nURU5n URS:XdU R5(a(U RSS9Hn URU 5 M OrUR5(a"URU5n U R!5n O!["R$"U5(dU/n OUn U Hn UR'U 5 M UR)XR*5 g) z( parse fp (a pathlib.Path()) and number rrrrrNz.zipr) dataFormatN)rrrrrsrrrrrtrrurvris_dirMuseDataDirectorygetPathsr isListLikeaddFilerr )r#r7r,r!rvrsrrrrpartStrmddfpListfpInners r$r:ConverterMuseData.parseFiles(GLL11h'BB%6C))+  % %b ) 99 ",,..:::< g&=yy{{$66r:&&r**! G$" 33CEr'rrrrWrr'r$rrs=$O7F*&*+F,+F"+F+Fr'rcb\rSrSrSrSrSrS S SjjrS S SjjrSr SSjr SS jr S r g) ConverterMEIiCz} Converter for MEI. You must use an ".mei" file extension for MEI files because music21 will parse ".xml" files as MusicXML. meiNcSSKJn URS5(aUSSnURU5R 5UlUR $)z Convert a string with an MEI document into its corresponding music21 elements. * dataString: The string with XML to convert. * number: Unused in this class. Default is ``None``. Returns the music21 objects corresponding to the MEI file. rr,zmei:N)rr-rMeiToM21ConverterrVr )r#r+r,r-s r$r-ConverterMEI.parseDataNsH   ( (#ABJ++J7;;= {{r'c 8[USSS9nUR5nSSS5 URWU5 UR$!,(df  N,=f![a: [USSS9nUR5nSSS5 M`!,(df  No=ff=f)a Convert a file with an MEI document into its corresponding music21 elements. * filePath: Full pathname to the file containing MEI data as a string or Path. * number: Unused in this class. Default is ``None``. Returns the music21 objects corresponding to the MEI file. rtrr0Nzutf-16)r4r6rr-r )r#r7r,r!r8r9s r$r:ConverterMEI.parseFile`s~" &hw71VVX 8 z6*{{87! &hx8AVVX 9888 &sE AAA AAAB*B;B B BBc g)z$ MEI export is not yet implemented. Frr"s r$rGConverterMEI.checkShowAbility|sr'c [S5eNz"MEI export is not yet implemented.r)rs r$rhConverterMEI.show!"FGGr'c [S5er8r))r#rfrXrvrar!s r$rdConverterMEI.writer:r'r r)r+rr stream.Stream)r7rr,rrr=r) rrrrrrrr-r:rGrhrdrrr'r$r+r+CsPO& * "  8H Hr'r+cJ\rSrSrSrSrSrSrSrSr Sr S r S r S r g ) TesticSSKJn UR5n[R"5nUR U5 UR S5ng)NrnotetextLine)rrBNoter rrrh)r#rBnrunused_xs r$testSimpleTextShowTest.testSimpleTextShows4 IIK MMO  66*%r'cSSKJn URS5n[5nUR S5 UR S5 SSS5 g!,(df  g=f)z$ When the string starts with "mei:" rmockmusic21.mei.MeiToM21Converterzmei: z NunittestrKpatchr+r-assert_called_once_withr#rKmockConv testConverters r$testImportMei1Test.testImportMei1sG " ZZ7 8H(NM  # #$C D  , ,-H I9 8 8 -A AcSSKJn URS5n[5nUR S5 UR S5 SSS5 g!,(df  g=f)z+ When the string doesn't start with "mei:" rrJrLzNrMrQs r$testImportMei2Test.testImportMei2sG " ZZ7 8H(NM  # #$> ?  , ,-G H9 8 8rVcSSKJn URS5n[R"5S- S- S- n[ 5nUR U5 URSUR5 SSS5 g!,(df  g=f) z When the file uses UTF-16 encoding rather than UTF-8 (which happens if it was exported from the "sibmei" plug-in for Sibelius). rrJrLr-testznotes_in_utf16.meirN rNrKrOrgetSourceFilePathr+r: assertEqual call_countr#rKrRtestPathrSs r$testImportMei3Test.testImportMei3sk " ZZ7 8H//1E9FBEYYH(NM  # #H -   Q 3 3 4 9 8 8 AA77 BcSSKJn URS5n[R"5S- S- S- n[ 5nUR U5 URSUR5 SSS5 g!,(df  g=f) z[ For the sake of completeness, this is the same as testImportMei3() but with a UTF-8 file. rrJrLr-r[znotes_in_utf8.meirNr\r`s r$testImportMei4Test.testImportMei4sk " ZZ7 8H//1E9FBEXXH(NM  # #H -   Q 3 3 4 9 8 8rdc SSKJn SSKJn UR UR 5nUR S5nUR[U5RS5US35 UR US9 UR[5 [USS S 9nURS 5 SSS5 SSS5 [5nUR USS 9nUR[5 [USS S 9nURS 5 SSS5 SSS5 [R "U5 [R "U5 g!,(df  N=f!,(df  N=f!,(df  Ne=f!,(df  Nn=f) Nrrr) testPrimitiverfrz does not end with .mxl)rvrrr0)rfrX)rrsrjrir-multiDigitEndingrd assertTruerr assertRaisesrr4r6rerzremove)r#rsrirmxlPathr8rmxlPath2s r$ testWriteMXLTest.testWriteMXLs%2    > > ?''%. G --f5'BY7Z[ 7   1 2gsW5r 63 !"::!:/   1 2hg6!r 73 ' (653 2763 2sH EE(E' E53E$E5 E E E!$ E2 .E55 Fc>SSKJn SSKJn SSKJn [ R "URSS95n[ R "5n[ R"XE/5n[ R"U5nUR[UR5S5 UR[UR5S5 UR5nURU5n UR[U RR!5R#[ R 5SR5S5 UR[U RR!5R#[ R 5SR5S5 UR%U5 URSS 9 SSS5 UR'S S 9SnURSS 9n URU 5n UR[U RR!5R#[ R 5SR5S 5 UR[U RR!5R#[ R 5SR5S5 UR%U5 URSS 9 SSS5 X4Hn [(R*"U 5 M g!,(df  GNE=f!,(df  NA=f) NrrrrA)MusicXMLExportExceptiong@) quarterLengthrF)rT)recurse)rrsrBmusic21.musicxml.xmlObjectsrtr MeasurerDPartrr^lennotesrdr2partsfirstgetElementsByClassrmsplitAtDurationsrzrn) r#rsrBrtm1m2prout1round_trip_backout2rs r$testWriteMusicXMLMakeNotation"Test.testWriteMusicXMLMakeNotationsS% G ^^DIICI8 9 ^^  KK ! LLO RXX* RXX*wwy#//$/  %%++-@@PQRSYY Z\] _  %%++-@@PQRSYY Z\] _  6 7 GGG '8   t  ,Q /wwEw*#//$/  %%++-@@PQRSYY Z\] _  %%++-@@PQRSYY Z\] _  6 7 GGG '8) rrsr2rdr4assertInr6rzrn)r#rsrrr8s r$testBrailleKeywordsTest.testBrailleKeywords sb% OO7 8ggitg, #sW - MMDaffh O. #. -s !A33 BcSSKnSSKJn SSKJn UR S5nUR USS9nU"5nURSU5 URUR5RU55 g)Nr)StringIOrrz= Time Signature: 3/4 m1 C: I romanText)format) textwrapiorrrsdedentr2rdrlgetvaluer)r#rrrsrr text_streams r$testWriteRomanTextTest.testWriteRomanTextsg%!   OOE+O 6j   [)  ,,.77>?r'rN)rrrrrGrTrXrbrfrqrrrrrr'r$r?r?s3&JI 5 52)V @r'r?c*\rSrSrSrSrSrSrSrg) TestExternali"TcvSSKJn URS5nUR(aUR5 gg)Nr)corpuszbwv66.6)rrr2rh)r#rros r$ testXMLShowTestExternal.testXMLShow%s(" LL # 99 FFH r'cSSKJn UR5nSURl[ R "5nURU5 UR(a,URS5 [URS55 gg)NrrAwholezlily.png) rrBrDdurationtyper rrrhrrd)r#rBrErs r$testWriteLilypondTestExternal.testWriteLilypond+sZ IIK!  MMO  99 FF:  !''*% & r'cSSKJn SSKJn URRnUR U5nUR (a,UR S5 [URS55 gg)z? tests whether show() works for music that is 10-99 pages long r)omrrrz musicxml.pngN) rrrs correctorsK525groundTruthFilePathr2rhrrd)r#rrsK525s r$testMultiPageXMlShow1"TestExternal.testMultiPageXMlShow15sP %~~55t$ 99 IIn % $**^, - r'rN) rrrrrhrrrrrr'r$rr"s D ' .r'r__main__)1r __future__rrrrzrrUtypingrrNrrrrmusic21.exceptions21rr rcollections.abcr EnvironmentrQr rrrrrrr r"r&r?rJrYrerrrrrrr+TestCaser?rrmainTestrr'r$rs #  6??(&&'@A kk\ 4|4n5S 5Sp!|!H|&)L)&# #*50 50p(\(C|CP-TL-T`;U,;U|J J6|8 |8@VLVt:J<:Jz22j!|!(1|1BEF EFPIH<IH^N@8  N@`.8$$.\ z Tr'