jQdZddlmZddlmZddlZddlZddlZddlZ ddl Z ddl m Z ddl m Z ddl mZddlmZdd l mZe jrdd lmZejd ZGd d ZGddeZGddeZGddeZGddeZGddeZGddeZGddeZGddeZGddeZ Gd d!eZ!Gd"d#eZ"Gd$d%eZ#Gd&d'eZ$Gd(d)eZ%Gd*d+eZ&Gd,d-eZ'Gd.d/eZ(Gd0d1eZ)Gd2d3eZ*Gd4d5eZ+Gd6d7e j,Z-Gd8d9e j,Z.e/d:krddl Z e j0e-dSdS);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)SubConverterException)stream)Iterablezconverter.subConverterscDeZdZUdZdZded<dZded<dZded <dZded <dZ ded <dZ ded <iZ d ed<dZ ded<dZ ded<dZded<d:dZd;dd#Z d?d@d)Z dAdBd,ZdCdDd/ZdCdEd0Z dAdFd5ZdGd8Z dCdHd9ZdS)I SubConvertera 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-8strstringEncodingreturnNonec Dtj|_||_dSN)r Score_streamkeywordsselfr!s /Users/tedpeters/Documents/Projects/Claude Projects/Misc Tools/notename-sheets/.venv/lib/python3.11/site-packages/music21/converter/subConverters.py__init__zSubConverter.__init__Ns=C\^^ *2 number int | Nonect)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# dataStringr's r$ parseDatazSubConverter.parseDataSs "!r&filePathstr | pathlib.Pathc n|jdurTddl}t||5}|}dddn #1swxYwYntSXXwH FtSXXs8}}='(L((L(LMM M  N3e5 9 9 9 9 9 9    'T  sF(( G2GGrY t.Any | Nonec X|j||fd|i|}||||dS)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. subformatsrYrHNwriter]r#objrYrHr`r!returnedFilePaths r$showzSubConverter.showsD&4:c3RR:RRR $#3 77777r&r` Iterable[str]c|j}|std|d}|jr-|r+d|}||jvr |j|}d|zS)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#r` extensionsextjoinedSubformatss r$getExtensionForSubformatsz&SubConverter.getExtensionForSubformatss2  @'?@@ @m  1 Oj O"xx 33 4#III<=MNSyr&ch||}t|d}|S)a 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)rorR getTempFile)r#r`rmfps r$getTemporaryFilezSubConverter.getTemporaryFiles4,,Z88  % %c % > > r&remusic21.base.Music21Objectrt"str | pathlib.Path | IOBase | Nonec Bt|}|j||fi|}|S)z_ Calls .writeDataStream on the repr of obj, and returns the fp returned by it. )reprwriteDataStreamr#rerYrtr`r!dataStrs r$rczSubConverter.write s0s)) !T !"g : : : : r&r| str | bytesc ||}|jdurd}nd}|jdurlt|trW |d}n@#t $r3d|_t|tr|YnwxYwt|ttj fretj |d}t|||jr|jnd5}||dddn #1swxYwY|S|||tj d S) z Writes the data stream to `fp` or to a temporary file and returns the Path object of the filename written. NFwwbrTrqmoder2rE)rurr isinstancebytesdecodeUnicodeDecodeErrorrcloserpathlibPathr cleanpathr5rrc)r#rtr|r! writeFlagsr8s r$rzzSubConverter.writeDataStreams :&&((B ?e # #JJJ ?e # # 7E(B(B # !..11%   "&b&))HHJJJ   b3 - . . $!"D999Bb%6:oOt224 !    ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! I HHW    HHJJJ<## #s$A:BB1DDDc |j|f||d|}|jdurd}nd}t|||jr|jnd5}|}dddn #1swxYwY|d|S) z Write the object out in the given format and then read it back in and return the object (str or bytes) returned. )rYr`Frr3NrT) missing_ok)rcrr5rrr7unlink) r#rerYr`r!rt readFlagsr8outs r$toDatazSubConverter.toDataAsTZ H H Hx H H ?e # #III " 26/K4..t &&((C                 T """ sA!!A%(A%)rrr)r'r(r.r/r'r()rr )NrENN)r.rFrGrrHrINr)rYrIrr^)r)r`rhrr)r`rhrrF)rervrYrIrtrwr`rh)rtrwr|r}rrF)rYrIr`rhrr})__name__ __module__ __qualname____doc__r__annotations__rrrrrrrrrr%r-r:r>rApropertyr rDr]rgrorurcrzrrr&r$r r -sB(JL')O))))+-----/111110222228:%::::'+I++++J!N!!!!3333 """""&*,!!!Xj*3    F     # HHHHH\  88888$**26*,     &$&$&$&$X%' r&r c,eZdZdZdZdZddiZd d d ZdS) ConverterIPythonz 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. )ipythonjupyterrlilypondlyNrt.Anyc *ddlm}ddlm}|r|d}|dd} nd}g} | sdg} ||} |dvr|j|f| || d |dS|d kr5t jrt| tsJ|j |f| || d |SdS) 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) subConverterrYr`midi) music21.converterrmusic21.ipython21rgetSubConverterFromFormatshowImageThroughMuseScoret TYPE_CHECKINGr ConverterMididisplayMusic21jMIDI) r#rerYrHr`r!rip21_converters helperFormathelperSubformatshelperSubConverters r$rgzConverterIPython.showds/ 0/////CCCCCC  "%a=L)!""~  %L!  ' %w &@@NN B B B 5O 5 / +        4 V # # E!"4mDDDDD6?6/ +    $ #r&r)rr)rrrrrrrrgrr&r$rrZsO -O!)3T(:%+++++++r&rcFeZdZdZdZdZddddZdZ dd d ddZddZ d S)ConverterLilypondz 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)rrpdfsvgrrrE)rrrTNrF)coloredVariantsrr c Fddlm}|j}||_||d|vr||} nKd|vr||} n1d|vr||} n| d|} | S)Nr)rrrrz.ly)rmrt) music21r translateLilypondConverterrloadFromMusic21Object createPDF createPNG createSVG writeLyFile) r#rerYrtr`rr!rconvconvertedFilePaths r$rczConverterLilypond.writes !     ~//11. ""3''' J   $r 2 2   j $r 2 2   j $r 2 2   $ 0 0Ur 0 B B   r&c |sdg}|j||fd|i|}| |r |d}nd}t|}|||||dS)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) rr`Nr)rYrHr)rcrRrSr]) r#rerYrHr`r!rf outFormatrs r$rgzConverterLilypond.shows  !J%4:c3RR:RRR  !j !"1 III!,,Y77  $) RRRRRr&r)rr ) rrrrrrrrrcrgrr&r$rrs +O:050502)4)4%J  ! ', !!!!!!.SSSSSSr&rc<eZdZdZdZdZ dfd Z ddZxZS) ConverterBraillebrailletxtTNrc tjs tj||fd|d|dSddlm}|j|}t|dS)N)rHr`rr) rrunningInNotebooksuperrgrrrobjectToBrailleprint) r#rerYrHr`r!rr| __class__s r$rgzConverterBraille.showsz'))  EGGLc Ot O Oh O O O O O ' ' ' ' ' ''77<>> s = corpus.parse('bwv66.6') >>> s.measures(1, 4).show('textline') "{0.0} / {0.0} ..." )textlinerNrc Z|}||||Sr) _reprTextLinerzr{s r$rczConverterTextLine.write s.##%% R))) r&c *|Sr)rrs r$rgzConverterTextLine.show%s  """r&rrrr&r$rrsS$O' ######r&rcFeZdZdZdZdZdZ ddddd Zd ZddZ ddZ dS)ConverterVolpianoaW 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)rrNFbreaksToLayoutr'r(rr c Jddlm}||||_dS)Nrrr)rrtoPartr )r#r,r'rr!rs r$r-zConverterVolpiano.parseData@s1 %$$$$$oojoPP r&c ddlm}|jr|}n(tj}||||S)z> Get the raw data, for storing as a variable. rr)rrisStreamr Streamappend fromStream)r#rer!rss r$ getDataStrzConverterVolpiano.getDataStrKsU %$$$$$ < AA A HHSMMM""1%%%r&rc N|j|fi|}||||Sr)rrzr{s r$rczConverterVolpiano.writeXs6!$/#2222 R))) r&c <t|j|fi|dSr)rrrs r$rgzConverterVolpiano.show]s* odoc..X../////r&r)r'r(rr r) rrrrrrrr-rrcrgrr&r$rr)s$$O0,   Q % Q Q Q Q Q Q & & & 000000r&rceZdZdZdZdZdS)ConverterScala)scala)sclN)rrrrrrrr&r$rras! O&'r&rc>eZdZdZdZdZfdZd dZ d d d ZxZ S)ConverterHumdrumzZ Simple class wrapper for parsing Humdrum data provided in a file or in a string. )humdrum)krnc Htjdi|d|_dSrrr%datar#r!rs r$r%zConverterHumdrum.__init__o+$$8$$$ r&Ncddlm}||}|||_|jj|_|jS)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.spineParserrparserr )r# humdrumStringr'rhdfs r$r-zConverterHumdrum.parseDatausO8 FEEEEE##M22  i& yr&r.pathlib.Path | strr'r(c ddlm}||}|||_|jj|_|jS)z Open Humdrum data from a file path. Calls humdrum.parseFile on filepath. Number is ignored here. r) HumdrumFile)rr parseFilenamerr )r#r.r'r!rhfs r$r:zConverterHumdrum.parseFilesT <;;;;; [ " "  i& yr&rr.rr'r() rrrrrrr%r-r:rrs@r$r r hs#O& """"L&*r&r c2eZdZdZdZdZfdZddZxZS)ConverterTinyNotationz| Simple class wrapper for parsing TinyNotation data provided in a file or in a string. Input only for now. ) tinynotation)tntxtr c Htjdi|d|_dSrrrs r$r%zConverterTinyNotation.__init__rr&Nct|tr|}ntdddlm}|j|fi|jj|_dS)aA 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) rrrrr$rr!rr )r#tnDatar'tnStrr$s r$r-zConverterTinyNotation.parseDatasy. fc " " #EE'"## # )(((((,l,UDDdmDDJJLLS r&r) rrrrrrr%r-rrs@r$rrsk (O7 TTTTTTTTr&rc,eZdZdZdZdZdZ d d d ZdS) ConverterNoteworthya 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)nwctxtcjddlm}|||_dS)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-zConverterNoteworthy.parseDatas< HGGGGG)>>@@LLWUU r&Nr.rr'r(c jddlm}|||_dS)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() rr,N)r-rr.r:r )r#r.r'r!r1s r$r:zConverterNoteworthy.parseFile s< HGGGGG)>>@@JJ8TT r&rrrrrrrrr-r:rr&r$r(r(sb$*O)VVV(&*UUUUUUUr&r(c0eZdZdZdZdZdZdZ d d d ZdS)ConverterNoteworthyBinaryz 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)nwccjddlm}|||_dSNr)binaryTranslate)r-r: NWCConverterr/r )r#r0noteworthyBinarys r$r-z#ConverterNoteworthyBinary.parseData+s9JJJJJJ&3355AA'JJ r&Nr.rr'r(c jddlm}|||_dSr9)r-r:r;r:r )r#r.r'r!r<s r$r:z#ConverterNoteworthyBinary.parseFile/s< KJJJJJ&3355??II r&rr) rrrrrrrr-r:rr&r$r5r5sgJ%O'KKK &*JJJJJJJr&r5cdeZdZdZdZdZdZdddZdd d Z dd!dZ d"dZ d#dddd$dZ d#dZ dS)%ConverterMusicXMLz Converter for MusicXML using the 2015 ElementTree system. Users should not need this Object. Call converter.parse directly )rr)rmxlr)rrr@rr)rrN xmlStringrcddlm}|}||_||j|_dS)z3 Open MusicXML data from a string. rxmlToM21N)music21.musicxmlrDMusicXMLImporterxmlText parseXMLTextr )r#rAr'rDcs r$r-zConverterMusicXML.parseDataEsK .-----  % % ' '  h r&r.r/r'r(c ddlm}ddlm}|}||}|r0|}||_| n| ||j j j 3tj|\} } | |j j _ |j |_ dS)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 converterrCN)rrLrErDrFArchiveManager isArchivegetDatarGrHreadFiler metadata movementNameospathsplit) r#r.r'r!rLrDrIarcharchDatajunkfns r$r:zConverterMusicXML.parseFilePs &%%%%%------  % % ' '''11 >>   !||~~H AI NN     JJx  8  ) 1w}}X..HD"-/AH  *h r&r|r}rrFc ~t|tst|d|}||}nt j|d}|jr |jdkr|d}d}t||5}| |dddn #1swxYwY|S)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 formatNTrq.mxl .musicxmlr) rrrQrurrsuffix with_suffixr5rc)r#rtr|r! dataBytesfpPathrr8s r$rzz!ConverterMusicXML.writeDataStreamqs 8'5)) QOOOPP P  :**,,FF%b===F} 5  7 7'' 44F &* % %  GGI                   sB22B69B6rT) makeNotationcompressremusic21.Music21Objectrb bool | Nonec ~ddlm}m} tj} tj} |A|r%t |drd}n|drd}nd}d|vrd t_d t_d } | |} || _ | } |}|;|r9t |}tj |d}|d z}||| }d|vr| t_| t_d|vsd |vr>t t d dsddlm}|||fi|}nT|rP||ddd|d}t*j|d}n|}|S)a 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) archiveToolsm21ToXmlNr[Tr@FrrEr&r\rmusescoreDirectPNGPathz/skip)runThroughMuseScore)deleteOriginalsilentstrictMxlCheckrq)rErfrgrtitleauthorrendswith startswithGeneralObjectExporterrarrSrTsplitextrzrRmusic21.converter.museScoreri compressXMLr^r pathToolsr)r#rerYrtr`rarbr!rfrgsavedDefaultTitlesavedDefaultAuthorr_generalExporterwriteDataStreamFpfpStr noExtFpStrxmlFprioutFp filenameOuts r$rczConverterMusicXML.writes * <;;;;;;;$N%_   !c"gg&&v.. !&& !  J  HN HO "88=='3$#))++  >j>GGE))%003J *[ 8 "223DiPP J  .HN0HO j EZ$7$7L)ABCCNNwWW%8 G G G G G G''zFFXFFEE    $ $U48,049 % ; ; ; ++F33K$..{$.OOEEE r&c r|j||fd|i|}d|vrd}nd|vrd}||||dS)z3 Override to do something with png r`rrraNrbrds r$rgzConverterMusicXML.showsf&4:c3RR:RRR J  CC j C $#3 77777r&r)rArr)r|r}rrFr)rercrbrd) rrrrrrrrr-r:rzrcrgrr&r$r?r?8s *O890505)+)+%     &*B....f H  $(HHHHHHT 8 8 8 8 8 8r&r?cteZdZdZdZdZdZdZeddZ dd d dd Z dd d ddZ dddd dddZ d S) rzJ Simple class wrapper for parsing MIDI and sending MIDI data out. T)r)midr)rrrcLd|jvr|jdr |jdSdS)Nr2r)r!r=s r$r2zConverterMidi.encodings-  & &4=+D &=, ,wr&NrEr1r2cddlm}d|jD}|j|fd|p|ji||_dS)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") rr,c"i|] \}}|dv || Sr1r.0kvs r$ z+ConverterMidi.parseData..2///TQ --q---r&r2N) music21.midirr!itemsmidiStringToStreamr2r )r#strDatar'r2 midiTranslater!s r$r-zConverterMidi.parseDatas| <;;;;;//T]%8%8%:%:///6m6   .    r&r.rr'r(c ddlm}d|jD}|j|f|j|p|jd|dS)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") rr,c"i|] \}}|dv || Srrrs r$rz+ConverterMidi.parseFile..3rr&)inputM21r2N)rrr!rmidiFilePathToStreamr r2)r#r.r'r2r!rs r$r:zConverterMidi.parseFiles& <;;;;;//T]%8%8%:%:///* *  [.        r&rF addStartDelay addEndDelayr2rr rc ddlm} ||}| ||||p|j} | |d| | |S)Nrr,rr)rrrumusic21ObjectToMidiFiler2r5rcr) r#rerYrtr`rrr2r!rmfs r$rczConverterMidi.write<s <;;;;; :&&((B  2 23m?JMMDKKK   0 0T[ I I I I Ir&r.rr'r(c fddlm}|}||||}||r#|j|||_ dS|j ||j dS)ar 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) rrrr5r7rrrrr r)r#r.r'r!rrrs r$r:zConverterABC.parseFileps &%%%%%     WWFW++     - - / / J$-==jEK>MMDKKK   0 0T[ I I I I Ir&rrr3rr&r$rrTsh O&JJJJ*&*JJJJJJJr&rc:eZdZdZdZdZdZddZ ddd Zdd Z dS)ConverterRomanTextzK Simple class wrapper for parsing roman text harmonic definitions. ) romantextrntext)rntxtrrrtxt)rNcddlm}ddlm}|}||}|r|||_dS|||jdSNr) rtObjectsr,) music21.romanTextrrRTFilerdefinesMovementsromanTextToStreamOpusr romanTextToStreamScore)r#rr'rromanTextTranslatertf rtHandlers r$r-zConverterRomanText.parseDatas//////EEEEEE  KK((  % % ' ' N,BB9MMDKKK  5 5i M M M M Mr&r.rr'r(c ddlm}ddlm}|}|||}||||jdSr) rrrrr5r7rrr )r#r.r'r!rrrrs r$r:zConverterRomanText.parseFiles 0/////EEEEEE   HHJJ  11)T[IIIIIr&rc ddlm}||}t|dsat |dd5}||jD]}||dz dddn #1swxYwYn5||jD]}||dz|S) z^ Writes 'RomanText' files (using the extension .rntxt) from a music21.stream. r) writeRomanNrcrrr1 )rrruhasattrr5RnWriter combinedListrc) r#rerYrtr`r!r text_fileentrys r$rczConverterRomanText.writes$ 100000 :&&((Br7## 'b#000 2I'0055B22EOOEDL11112 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 $,,S11> ' '&&&& s6BB Brrr) rrrrrrrr-r:rcrr&r$rrs.OF) N N N N&* J J J J Jr&rc0eZdZdZdZdZd d dZ d d d ZdS) ConverterClercqTemperleyzh Wrapper for parsing harmonic definitions in Trevor de Clercq and David Temperley's format. )cttxtharclercqTemperleyNrr/cnddlm}||}||_dS)Nr)r)rrCTSongrr )r#rr'rctSongs r$r-z"ConverterClercqTemperley.parseDatas:555555 ''00mmoo r&r.rc 0||dSr)r-)r#r.r'r!s r$r:z"ConverterClercqTemperley.parseFiles x     r&r)rr/)r.rr3rr&r$rrsb:OA&&&&&!!!!!!!r&rc.eZdZdZdZdZd dZ d d d ZdS) ConverterCapellaz` Simple class wrapper for parsing Capella .capx XML files. See capella/fromCapellaXML. )capella)capxNcddlm}|}||||jj}||}||_dS)zv parse a data stream of uncompressed capella xml N.B. for web parsing, it gets more complex. rfromCapellaXMLN) music21.capellarCapellaImporterrHsystemScoreFromScoremainDomdocumentElementpartScoreFromSystemScorer )r#rr'rciscoreObj partScores r$r-zConverterCapella.parseDataso 322222  + + - -    **2:+EFF//99  r&r.r/r'r(c nddlm}|}|||_dS)z& Parse a Capella file rrN)rrr scoreFromFiler )r#r.r'r!rrs r$r:zConverterCapella.parseFiles@ 322222  + + - -&&x00 r&rrr3rr&r$rrs]#O'     &* 1 1 1 1 1 1 1r&rc.eZdZdZdZdZd dZ d d d ZdS) ConverterMuseDataz4 Simple class wrapper for parsing MuseData. musedata)mdrzipNcddlm}ddlm}t |t r|g}n|}|}|D]}|||||j dS)z< Get musedata from a string representation. rrr,N) rrmusic21.musedatarrr MuseDataWork addStringmuseDataWorkToStreamScorer )r#rr'musedataModulemusedataTranslate strDataListmdw strDataInners r$r-zConverterMuseData.parseDatas 766666CCCCCC gs # # "")KK!K))++' ( (L MM, ' ' ' '33CEEEEEr&r.r/r'r(c t|tjstj|}n|}ddlm}ddlm}ddlm}|}| |} |j dks| r/| dD]} | | nr|r*||} | } nt#j|s|g} n|} | D]} || |||jdS) z8 parse fp (a pathlib.Path()) and number rrKrr,z.zipr) dataFormatN)rrrrrLrrrrrMr]rNrOris_dirMuseDataDirectorygetPathsr isListLikeaddFilerr )r#r.r'r!rtrLrrrrpartStrmddfpListfpInners r$r:zConverterMuseData.parseFilesv(GL11 h''BBB%%%%%%666666CCCCCC))++  % %b ) ) 9  ",,.. :::<< ' ' g&&&& 'yy{{ $66r::&r** ! % % G$$$$ 33CEEEEEr&rrr3rr&r$rrsh$O7FFFF*&*+F+F+F+F+F+F+Fr&rcFeZdZdZdZdZdddZ ddd ZdZddZ ddZ dS) ConverterMEIz Converter for MEI. You must use an ".mei" file extension for MEI files because music21 will parse ".xml" files as MusicXML. meiNr,rr stream.Streamcddlm}|dr |dd}|||_|jS)a 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. rrzmei:N)rrrpMeiToM21ConverterrWr )r#r,r'rs r$r-zConverterMEI.parseDataNsb    ( ( (#ABBJ++J77;;== {r&r.r/r'r(c X t|dd5}|}dddn #1swxYwYnN#t$rAt|dd5}|}dddn #1swxYwYYnwxYw||||jS)a8 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. rtrr1Nzutf-16)r5r7rr-r )r#r.r'r!r8r9s r$r:zConverterMEI.parseFile`s+" &hw777 &1VVXX  & & & & & & & & & & & & & & &! & & &hx888 &AVVXX  & & & & & & & & & & & & & & & & z6***{sPA5 A9A9AB A>2 B >B B B B  B c dS)z4 MEI export is not yet implemented. Frr"s r$rDzConverterMEI.checkShowAbility|s ur&rc  tdNz"MEI export is not yet implemented.r*rs r$rgzConverterMEI.show!"FGGGr&c  tdrr*)r#rerYrtr`r!s r$rczConverterMEI.writerr&r)r,rrr)r.r/r'r(rrr) rrrrrrr-r:rDrgrcrr&r$rrCsO& * 8HHHH HHHHHHr&rcDeZdZdZdZdZdZdZdZdZ dZ d Z d S) Testcddlm}|}tj}|||d}dS)NrnotetextLine)rr Noter rrrg)r#r nrunused_xs r$testSimpleTextShowzTest.testSimpleTextShowsP      IIKK MOO  66*%%r&cddlm}|d5}t}|d|dddddS#1swxYwYdS)z4 When the string starts with "mei:" rmockmusic21.mei.MeiToM21Converterzmei: z Nunittestrpatchrr-assert_called_once_withr#rmockConv testConverters r$testImportMei1zTest.testImportMei1s "!!!!! ZZ7 8 8 JH(NNM  # #$C D D D  , ,-H I I I J J J J J J J J J J J J J J J J J J9A""A&)A&cddlm}|d5}t}|d|dddddS#1swxYwYdS)z; When the string doesn't start with "mei:" rrrzNrrs r$testImportMei2zTest.testImportMei2s "!!!!! ZZ7 8 8 IH(NNM  # #$> ? ? ?  , ,-G H H H I I I I I I I I I I I I I I I I I Irc"ddlm}|d5}tjdz dz dz }t }|||d|jddddS#1swxYwYdS) 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). rrrrtestznotes_in_utf16.meirN rrrrgetSourceFilePathrr: assertEqual call_countr#rrtestPathrs r$testImportMei3zTest.testImportMei3s "!!!!! ZZ7 8 8 5H/11E9FBEYYH(NNM  # #H - - -   Q 3 4 4 4  5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5ABB Bc"ddlm}|d5}tjdz dz dz }t }|||d|jddddS#1swxYwYdS) zk For the sake of completeness, this is the same as testImportMei3() but with a UTF-8 file. rrrrr#znotes_in_utf8.meirNr$r(s r$testImportMei4zTest.testImportMei4s "!!!!! ZZ7 8 8 5H/11E9FBEXXH(NNM  # #H - - -   Q 3 4 4 4  5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5r+cxddlm}ddlm}||j}|d}|t| d|d||| t5t|dd 5}| d dddn #1swxYwYdddn #1swxYwYt}||d }| t5t|dd 5}| d dddn #1swxYwYdddn #1swxYwYtj|tj|dS) NrrK) testPrimitiver@r[z does not end with .mxl)rtrrr1)rerY)rrLrEr/r-multiDigitEndingrc assertTruerro assertRaisesrr5r7r?rSremove)r#rLr/rmxlPathr8rmxlPath2s r$ testWriteMXLzTest.testWriteMXLs%%%%%%222222    > ? ?''%.. G --f55'7Z7Z7Z[[[ 7   1 2 2  gsW555 r                                !""::!://   1 2 2  hg666 !r                                ' (sl%C18C C1C C1!C "C11C58C5;FE0$ F0E4 4F7E4 8FF F cddlm}ddlm}ddlm}t j|d}t j}t j||g}t j |}| t|j d| t|j d| }||} | t| jt jdj d| t| jt jdj d||5| d dddn #1swxYwY|d d}| d } || } | t| jt jdj d | t| jt jdj d||5| d dddn #1swxYwY|| fD]} t)j| dS) NrrKr )MusicXMLExportExceptiong@) quarterLengthrF)raT)recurse)rrLr music21.musicxml.xmlObjectsr9r MeasurerPartrr&lennotesrcrpartsfirstgetElementsByClassr3splitAtDurationsrSr4) r#rLr r9m1m2prout1round_trip_backout2rs r$testWriteMusicXMLMakeNotationz"Test.testWriteMusicXMLMakeNotations%%%%%%      GGGGGG ^DIICI88 9 9 ^   KR ! ! LOO RX*** RX***wwyy#//$//  %++--@@PPQRSY Z Z\] _ _ _  %++--@@PPQRSY Z Z\] _ _ _  6 7 7 ( ( GGG ' ' ' ( ( ( ( ( ( ( ( ( ( ( ( ( ( (   t  , ,Q /wwEw**#//$//  %++--@@PPQRSY Z Z\] _ _ _  %++--@@PPQRSY Z Z\] _ _ _  6 7 7 ( ( GGG ' ' ' ( ( ( ( ( ( ( ( ( ( ( ( ( ( ($<  C IcNNNN  s$ G--G14G1L;;L?L?c6ddlm}|d}|dd}t |dd 5}|d |dddn #1swxYwYtj|dS) NrrKztinyNotation: c1 d1 e1 f1rT)debugrrr1z() rrLrrcr5assertInr7rSr4)r#rLrHrr8s r$testBrailleKeywordszTest.testBrailleKeywords s%%%%%% OO7 8 8ggitg,, #sW - - - P MMDaffhh O O O P P P P P P P P P P P P P P P #s)A::A>A>c2ddl}ddlm}ddlm}|d}||d}|}|d||| |dS)Nr)StringIOrKz= Time Signature: 3/4 m1 C: I romanText)format) textwrapiorRrrLdedentrrcr2getvaluero)r#rUrRrLrr text_streams r$testWriteRomanTextzTest.testWriteRomanTexts%%%%%%!    OOE+O 6 6hjj   [)))  ,,..77>>?????r&N) rrrrrr!r*r-r7rLrPrZrr&r$r r s&&&JJJIII 5 5 5 5 5 52)))V @ @ @ @ @r&r c$eZdZdZdZdZdZdS) TestExternalTcvddlm}|d}|jr|dSdS)Nr)corpuszbwv66.6)rr^rrg)r#r^rIs r$ testXMLShowzTestExternal.testXMLShow%sJ"""""" LL # # 9  FFHHHHH  r&c"ddlm}|}d|j_t j}|||jr9|dt| ddSdS)Nrr wholezlily.png) rr rdurationtyper rrrgrrc)r#r rrs r$testWriteLilypondzTestExternal.testWriteLilypond+s      IIKK!  MOO  9 ' FF:    !''*%% & & & & & ' 'r&cddlm}ddlm}|jj}||}|jr9|dt|ddSdS)zO tests whether show() works for music that is 10-99 pages long r)omrrKz musicxml.pngN) rrfrL correctorsK525groundTruthFilePathrrgrrc)r#rfrLK525s r$testMultiPageXMlShow1z"TestExternal.testMultiPageXMlShow15s %%%%%%~5t$$ 9 . IIn % % % $**^,, - - - - - . .r&N)rrrrgr_rdrjrr&r$r\r\"sF D ''' . . . . .r&r\__main__)1r __future__rrVrrSrrVtypingrrrrrrmusic21.exceptions21rr rcollections.abcr EnvironmentrRr rrrrrrrrr rr(r5r?rrrrrrrTestCaser r\rmainTestrr&r$rss #"""""  666666?)((((((&{&'@AA jjjjjjjjZ 55555|555p5S5S5S5S5S 5S5S5Sp!!!!!|!!!H|&)))))L)))&##### ###*5050505050 505050p(((((\(((CCCCC|CCCP-T-T-T-T-TL-T-T-T`:U:U:U:U:U,:U:U:UzJJJJJ JJJ6|8|8|8|8|8 |8|8|8@XXXXXLXXXx:J:J:J:J:J<:J:J:Jz22222222j!!!!!|!!!(11111|111BEFEFEFEFEF EFEFEFPIHIHIHIHIH<IHIHIH^N@N@N@N@N@8 N@N@N@`.....8$...\ zNNNGTr&