j  UddlmZddlZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl m Z ddl mZddl mZddl mZejdZdZejjZejd eZejd eZejd eZejd eZejd eZejdeZejdeZejdeZejdeZdZ dZ!dZ"dZ#dZ$dGdZ%dZ&dZ'dZ(GddZ)Gdde)Z*Gdd e)Z+Gd!d"e)Z,Gd#d$e)Z-Gd%d&ej.e)Z/Gd'd(Z0Gd)d*e0Z1Gd+d,e0Z2Gd-d.e2Z3Gd/d0e2Z4Gd1d2e0Z5Gd3d4e5Z6Gd5d6e5Z7Gd7d8e7Z8Gd9d:Z9gZ:d;e;d<<Gd=d>e j<Z=Gd?d@e j<Z>dAZ?e@dBkreAejBdCkr e?dSe>ZCe=ZDeAejBdDksejBdCdEvrddl Z e jEe>dSejBdCdFkr!eFeDejBdDdSeGeCejBdCr#eFeCejBdCdSdSdS)H) annotationsN)reload)common) environment) exceptions21 configureTz Finale.*\.appz Sibelius\.appz Finale.*\.exez Sibelius\.exezFinale Reader\.appzMuseScore.*\.appz"Musescore.*\\bin\\MuseScore.*\.exez Dorico.*\.appz Dorico.*\.exez$https://www.music21.org/music21docs/zhttps://www.musescore.orgz'https://groups.google.com/g/music21listNc tj|r|}n|d}g}|r[|D]W}|dkr|d|dkr|d:|t j|t z }Xn|}d}t|D]\}}|dkrd}na|dkrt|dkrd|d}nA|dkrt|dkrd|d}n!|t|dz kr|d}n|d}|dkr-||zdkr$td} | tj |tj |dz }d S) z_ Display a message to the user, handling multiple lines as necessary and wrapping text   rz zPausing for page. promptHeaderN)r isListLikesplitappendtextwrapwrap LINE_WIDTH enumeratelenAnyKeyaskUsersysstdoutwriteflush) msg wrapLines linesPerPagelinespostsub lineCountilineds /Users/tedpeters/Documents/Projects/Claude Projects/Misc Tools/notename-sheets/.venv/lib/python3.11/site-packages/music21/configure.py writeToUserr+Gs   $ D  7 7Cbyy B C     c:666 7IT??4 2::DD !VVD A !>>>DD !VVD Q<<
) __class____name__rWrXs r*__repr__zDialogError.__repr__s"KT^%<KKKKKKr,rU)r] __module__ __qualname____doc__rYr_r1r,r*rSrSsFLLLLLr,rSc$eZdZdZdfd ZxZS)KeyInterruptErrorzI Subclass of DialogError that deals with Keyboard Interruptions. NcLt|dSNrVsuperrYrXrWr\s r*rYzKeyInterruptError.__init__$ S!!!!!r,rUr]r`rarbrY __classcell__r\s@r*rdrdG""""""""""r,rdc$eZdZdZdfd ZxZS)IncompleteInputzv Subclass of DialogError that runs when the user has provided incomplete input that cannot be understood. NcLt|dSrfrgris r*rYzIncompleteInput.__init__rjr,rUrkrms@r*rprpsG """"""""""r,rpc$eZdZdZdfd ZxZS)NoInputzf Subclass of DialogError for when the user has provided no input, and there is not a default. NcLt|dSrfrgris r*rYzNoInput.__init__rjr,rUrkrms@r*rsrsrnr,rsc$eZdZdZdfd ZxZS) BadConditionsz Subclass of DialogError for when the user's system does support the action of the dialog: something is missing or otherwise prohibits operation. NcLt|dSrfrgris r*rYzBadConditions.__init__rjr,rUrkrms@r*rvrvsG """"""""""r,rvceZdZdS)DialogExceptionN)r]r`rar1r,r*ryrysDr,ryceZdZdZddZdZdZdZdZdd Z dd Z dd Z d Z dZ dZdZdZddZddddZddZddZddZdS)DialogaG Model a dialog as a question and response. Have different subclasses for different types of questions. Store all in a Conversation, or multiple dialog passes. A `default`, if provided, is returned if the users provides no input and just enters return. The `tryAgain` option determines if, if a user provides incomplete or no response, and there is no default (for no response), whether the user is given another chance to provide valid input. The `promptHeader` is a string header that is placed in front of any common header for this dialog. NTcd|_d|_||}t|ts||_nd|_||_||_d|_gd|_ dS)N)windarwinnix) _result _resultPrior_parseUserInput isinstancerS_default _tryAgain _promptHeader _maxAttempts _platforms)rXdefaulttryAgainr defaultCookeds r*rYzDialog.__init__sx  ,,W55 -55 !)DMM!DM!)322r,c$t|dS)zB Write output to user. Call module-level function N)r+rXr s r* _writeToUserzDialog._writeToUsers Cr,c t}|S#t$rtcYSt$rt cYSwxYw)zF Collect from user; return None if an empty response. )inputKeyboardInterruptrd ExceptionrS)rXr$s r* _readFromUserzDialog._readFromUsersd  !77DK  ' ' '$&& & & & ! ! !==  !sAAAcp|}|j|d|j|_dS||_dS)a_ Add a message to the front of the stored prompt header. >>> d = configure.Dialog() >>> d.prependPromptHeader('test') >>> d._promptHeader 'test' >>> d = configure.Dialog(promptHeader='this is it') >>> d.prependPromptHeader('test') >>> d._promptHeader 'test this is it' Nrstriprrs r*prependPromptHeaderzDialog.prependPromptHeader'sGiikk   )$'!>!>$*!>D   !$D   r,cp|}|j|jd||_dS||_dS)a >>> d = configure.Dialog() >>> d.appendPromptHeader('test') >>> d._promptHeader 'test' >>> d = configure.Dialog(promptHeader='this is it') >>> d.appendPromptHeader('test') >>> d._promptHeader 'this is it test' Nrrrs r*appendPromptHeaderzDialog.appendPromptHeader;sGiikk   )$($6!>!>!>!>D   !$D   r,ct|dd}|||}t|trdS|S)as What to do if input is incomplete >>> prompt = configure.YesOrNo(default=True) >>> prompt._askTryAgain(force='yes') True >>> prompt._askTryAgain(force='n') False >>> prompt._askTryAgain(force='') # gets default True >>> prompt._askTryAgain(force='blah') # error gets False False Fz)Your input was not understood. Try Again?rrrforce)YesOrNor getResultrrSrXrrr)r$s r* _askTryAgainzDialog._askTryAgainNs_ Ge!L N N N  {{}} dK ( ( 5Kr,r c>|j|j}|ds|drd}nd}|jdr|dz }n%|jdr|dz }n|dz }|||}|S) aT Prepare the header, given a string. >>> from music21 import configure >>> d = configure.Dialog() >>> d._rawQueryPrepareHeader('test') 'test' >>> d = configure.Dialog(promptHeader='what are you doing?') >>> d._rawQueryPrepareHeader('test') 'what are you doing? test' N?.r :z r r)rrendswith)rXr headerdivs r*_rawQueryPrepareHeaderzDialog._rawQueryPrepareHeadergs   )'--//Fs## vs';'; !**622 v #,,T22 t s 'S'#''C r,c|jq|}|dr!d}|dd}|nd}||j}|d|d|d}|S)z6 Prepare the end of the query message Nrr z (default is )r)rrr_formatResultForUser)rXr rrs r*_rawQueryPrepareFooterzDialog._rawQueryPrepareFooters = $))++C||C   #2#h // >>G77w77777C r,cdS)E Return a multiline presentation of an introduction. Nr1r^s r*_rawIntroductionzDialog._rawIntroduction tr,cdS)B Return a multiline presentation of the question. Nr1r^s r* _rawQueryzDialog._rawQuery  r,c|S)z For various result options, we may need to at times convert the internal representation of the result into something else. For example, we might present the user with 'Yes' or 'No' but store the result as True or False. r1rXresults r*rzDialog._formatResultForUsers  r,c|S)z Translate string to desired output. Pass None through (as no input), convert '' to None, and pass all other outputs as IncompleteInput objects. r1rXraws r*rzDialog._parseUserInputs  r,cdS)z Evaluate the user's string entry after parsing; do not return None: either return a valid response, default if available, or IncompleteInput object. Nr1rs r*_evaluateUserInputzDialog._evaluateUserInput r,cdS)z Call this method immediately before calling askUser. Can be used for configuration getting additional information. Nr1rXrs r* _preAskUserzDialog._preAskUserrr,F) skipIntroc|}||s||||}|durt|_dSt |jD]}|}t|tr ||_dS|*||| }nt d|g|}t|tr ||_dS||}t|tt fr)||_|jr|rdSdS||_dSdS)z Ask the user, display the query. The force argument can be provided to test. Sets self._result; does not return a value. NrFz writeToUser:)rrrrvrrangerrrrSrrDrErdrrsrprr) rXrrintror$r'queryrawInput cookedInputs r*rzDialog.askUsers %%''  Y    e $ $ $e,, 5==(??DL Ft())/ / ANN$$E%-- $ }!!%(((--//''(?@@@  ($566 '  11(;;K +'ABB * >((**EE + _/ / r,c|jS)z Return the result, or None if not set. This may also do a processing routine that is part of the desired result. )rrXsimulates r*rzDialog.getResults |r,cdS)z4 does nothing; redefine in subclass Nr1rs r*_performActionzDialog._performAction rr,c|}t|jtr;td|j|ddgdS|r$td|jdS ||dS#t$rtdwxYw)z After getting a result, the query might require an action to be performed. If result is None, this will use whatever value is found in _result. If simulate is True, no action will be taken. z0performAction() called, but result is an error: zNo action taken.rz0performAction() called, but in simulation mode: rz(perform action raised a dialog exceptionN) rrrrSrDrErrry)rXrdummys r* performActionzDialog.performActions   dlK 0 0 R  # #Q4<QQ S S S   137 8 8 8 8 8  R  # #Q4<QQ S S S S S R##X#66666" R R R&&PQQQ  Rs B))CNTN)TN)r rU)TF)r]r`rarbrYrrrrrrrrrrrrrrrrrr1r,r*r{r{sr  33334 ! ! !%%%(%%%&28"           AuAAAAAH    RRRRRRr,r{c0eZdZdZdfd ZdZdZxZS)rz# Press any key to continue NFcPt|||dSNrrgrXrrrr\s r*rYzAnyKey.__init__3( 8,WWWWWr,c4d}||}|S)rzPress return to continue.)rrs r*rzAnyKey._rawQuery6s#*))#.. r,cdS)z% Always returns True Tr1rs r*rzAnyKey._parseUserInput@rr,)NFN)r]r`rarbrYrrrlrms@r*rr.skXXXXXXr,rc<eZdZdZd fd ZdZdZdZdZxZ S) raH Ask a yes or no question. >>> d = configure.YesOrNo(default=True) >>> d.askUser('yes') # force arg for testing >>> d.getResult() True >>> d = configure.YesOrNo(tryAgain=False) >>> d.askUser('junk') # force arg for testing >>> d.getResult() NTcPt|||dSrrgrs r*rYzYesOrNo.__init__Wrr,c>|durdS|durdStd|)a For various result options, we may need to at times convert the internal representation of the result into something else. For example, we might present the user with 'Yes' or 'No' but store the result as True or False. TYesFNoz&attempting to format result for user: )ryrs r*rzYesOrNo._formatResultForUserZs9 T>>5 u__4""S6"S"STT Tr,c^d}||}||}|S)a Return a multiline presentation of the question. >>> d = configure.YesOrNo(default=True) >>> d._rawQuery() 'Enter Yes or No (default is Yes): ' >>> d = configure.YesOrNo(default=False) >>> d._rawQuery() 'Enter Yes or No (default is No): ' >>> d = configure.YesOrNo(default=True, promptHeader='Would you like more time?') >>> d._rawQuery() 'Would you like more time? Enter Yes or No (default is Yes): ' zEnter Yes or No: )rrrs r*rzYesOrNo._rawQueryjs4"))#..))#.. r,c|tSt|}|}|}|dkrtS|dvrdS|dvrdSt |S)a Translate string to desired output. Pass None and '' (as no input), as NoInput objects, and pass all other outputs as IncompleteInput objects. >>> d = configure.YesOrNo() >>> d._parseUserInput('y') True >>> d._parseUserInput('') >>> d._parseUserInput('asdf') Nr yesy1trueT)non0falseF)rsstrrlowerrprs r*rzYesOrNo._parseUserInput~s{ ;99 #hhiikkiikk "9999  + + +4 - - -5s###r,cv||}t|tr|j|jS|S)aG Evaluate the user's string entry after parsing; do not return None: either return a valid response, default if available, IncompleteInput, NoInput objects. >>> d = configure.YesOrNo() >>> d._evaluateUserInput('y') True >>> d._evaluateUserInput('False') False >>> d._evaluateUserInput('') # there is no default, >>> d._evaluateUserInput('wer') # there is no default, >>> d = configure.YesOrNo('yes') >>> d._evaluateUserInput('') # there is a default True >>> d._evaluateUserInput('wbf') # there is a default >>> d = configure.YesOrNo('n') >>> d._evaluateUserInput('') # there is a default False >>> d._evaluateUserInput(None) # None is processed as NoInput False >>> d._evaluateUserInput('blah') # None is processed as NoInput rrrsrrXr rawParseds r*rzYesOrNo._evaluateUserInputs?<((-- i ) ) %}(}$r,r) r]r`rarbrYrrrrrlrms@r*rrHs  XXXXXXUUU ($$$:$$$$$$$r,rc0eZdZdZ dfd ZddZxZS) AskOpenInBrowserz Ask the user if the want to open a URL in a browser. >>> d = configure.AskOpenInBrowser('https://www.music21.org/') TNct|||||_| ||_dSd|jd}||dS)NrzOpen the following URL (z) in a web browser? )rhrY _urlTargetrr)rX urlTargetrrrpromptr r\s r*rYzAskOpenInBrowser.__init__si 8,WWW#  !'D   ST_SSSC  # #C ( ( ( ( (r,Fcx|}|durtj|jdS|durdSdS)] The action here is to open the stored URL in a browser, if the user agrees. TFN)r webbrowseropen_newrrXrrs r*rzAskOpenInBrowser._performActionsJ!! T>>   0 0 0 0 0 u__ D_r,TTNNr)r]r`rarbrYrrlrms@r*rrsc :>+/ ) ) ) ) ) )r,rc6eZdZdZ dfd ZdZd dZxZS) AskSendInstallationReportzZ Ask the user if they want to send a report regarding their system and usage. TNct||||i}||_d}||dS)NrzWould you like to send a pre-formatted email to music21 regarding your installation? Installation reports help us make music21 work better for you)rhrY_additionalEntriesr)rXrrradditionalEntriesr r\s r*rYz"AskSendInstallationReport.__init__sX 8,WWW  $ " "3] $$$$$r,cg}|d|d|d|dt}||jt |D]"}||d||#|d|t j|d|d|dtj}|dkrd |}nd |}d |}|S) NzYPlease send the following email; your return email address will never be used in any way.r zNThe following information on your installation will be used only for research.z // zpython version:zBelow, please provide a few words about what sorts of tasks or problems you plan to explore with music21. Any information on your background is also appreciated (e.g., amateur musician, computer programmer, professional music researcher). Thanks!r~z%0D%0Ar zGmailto:music21stats@gmail.com?subject=music21 Installation Report&body=) rrBupdaterrFrversionr getPlatformrI)rXbodyuserDatakeyplatformr s r* _getMailToStrz'AskSendInstallationReport._getMailToStrsk 5 6 6 6 B 6 7 7 7 B==/000(## 5 5C KK333HSM33 4 4 4 4 %&&& CK    B S T T T B%'' u  ==&&DD99T??DbZ^bb r,Fc|}|dur(tj|dSdS)rTN)rropenr rs r*rz(AskSendInstallationReport._performActionsE!! T>> OD..00 1 1 1 1 1 >r,rr)r]r`rarbrYr rrlrms@r*rrss/36: % % % % % %   D22222222r,rcVeZdZdZd fd Zd dZdZddZd dZd d Z d Z d Z xZ S)SelectFromLista General class to select values from a list. >>> d = configure.SelectFromList() # empty selection list >>> d.askUser('no') # results in bad condition >>> d.getResult() >>> d = configure.SelectFromList() # empty selection list >>> def validResults(force=None): ... return range(5) >>> d._getValidResults = validResults # provide alt function for testing >>> d.askUser(2) # results in bad condition >>> d.getResult() 2 NTcPt|||dSrrgrs r*rYzSelectFromList.__init__4rr,c||SgS)zg Return a list of valid results that are possible and should be displayed to the user. r1rs r*_getValidResultszSelectFromList._getValidResults7s  LIr,c|S)zV Reduce each complete file path to stub, or otherwise compact display r1rs r*rz#SelectFromList._formatResultForUserBs  r,ct|dd}|||}t|trdS|dvrt d|S)a What to do if the selection list is empty. Only return True or False: if we should continue or not. >>> prompt = configure.SelectFromList(default=True) >>> prompt._askFillEmptyList(force='yes') True >>> prompt._askFillEmptyList(force='n') False >>> prompt._askFillEmptyList(force='') # no default, returns False False >>> prompt._askFillEmptyList(force='blah') # error gets false False Fz'The selection list is empty. Try Again?rr)TFz>_askFillEmptyList(): sub-command returned non True/False value)rrrrrSryrs r*_askFillEmptyListz SelectFromList._askFillEmptyListHs G"!J L L L  {{}} dK ( ( 5=((%TVVVKr,cb|}|s||}|SdS)a Before we ask user, we need to run _askFillEmptyList list if the list is empty. >>> d = configure.SelectFromList() >>> d._preAskUser('no') # force for testing False >>> d._preAskUser('yes') # force for testing True >>> d._preAskUser('') # no default, returns False False >>> d._preAskUser('x') # bad input returns False False rT)rr)rXroptionsr$s r*rzSelectFromList._preAskUsergs='')) )))66DK4r,c2g}d}||}|stdS|D]7}||}|d|d||dz }8d}||}||}|d|gzS)a Return a multiline presentation of the question. >>> d = configure.SelectFromList() >>> d._rawQuery(['a', 'b', 'c']) ['[1] a', '[2] b', '[3] c', ' ', 'Choose a number from the preceding options: '] >>> d = configure.SelectFromList(default=1) >>> d._default 1 >>> d._rawQuery(['a', 'b', 'c']) ['[1] a', '[2] b', '[3] c', ' ', 'Choose a number from the preceding options (default is 1): '] rrzno options available[z] z,Choose a number from the preceding options: r)rrvrrrr)rXrheadr'rentryr%tails r*rzSelectFromList._rawQuery}s ''e'44 9 !788 8  E++E22C KKA ' ' ' FAA=**400**400sDk!!r,c|tS|dkrtS|dvrd}n= t|}n,#tttf$rt |cYSwxYw|S)z Convert all values to an integer, or return NoInput or IncompleteInput. Do not yet evaluate whether the number is valid in the context of the selection choices. >>> d = configure.SelectFromList() Nr rr)rsint ValueError TypeErrorZeroDivisionErrorrp)rXrr$s r*rzSelectFromList._parseUserInputs ;99  "9999  + + +DD ,3xx +<= , , ,&s+++++ , s=&A&%A&cv||}t|tr|j|jS|SrUrrs r*rz!SelectFromList._evaluateUserInputsA((--  i ) ) %}(}$r,rrUNN) r]r`rarbrYrrrrrrrrlrms@r*rr"s"XXXXXX     >,""""@0       r,rc@eZdZdZd fd ZdZd dZdZd d ZxZ S)AskAutoDownload5 General class to select values from a list. rTNcPt|||dSrrgrs r*rYzAskAutoDownload.__init__rr,c gdS)r)aThe BSD-licensed music21 software is distributed with a corpus of encoded compositions which are distributed with the permission of the encoders (and, where needed, the composers or arrangers) and where permitted under United States copyright law. Some encodings included in the corpus may not be used for commercial uses or have other restrictions: please see the licenses embedded in individual compositions or directories for more details.raNIn addition to the corpus distributed with music21, other pieces are not included in this distribution, but are indexed as links to other web sites where they can be downloaded (the "virtual corpus"). If you would like, music21 can help your computer automatically resolve these links and bring them to your hard drive for analysis. aTo the best of our knowledge, the music (if not the encodings) in the corpus are either out of copyright in the United States and/or are licensed for non-commercial use. These works, along with any works linked to in the virtual corpus, may or may not be free in your jurisdiction. If you believe this message to be in error regarding one or more works please contact Michael Cuthbert at michael.asato.cuthbert@gmail.comrzWould you like to:r1r^s r*rz AskAutoDownload._rawIntroductions r,c||SgdS)z, Just return number options N)zPAcknowledge these terms and allow music21 to aid in finding pieces in the corpusz4Acknowledge these terms and block the virtual corpusz}Do not agree to these terms and will not use music21 (agreeing to the terms of the corpus is mandatory for using the system).r1rs r*rz AskAutoDownload._getValidResultss#  L r,c||}t|tr|j|j}t|tr|Sd|cxkrdkrnn|St |S)z Evaluate the user's string entry after parsing; do not return None: either return a valid response, default if available, IncompleteInput, NoInput objects. Nr)rrrsrrSrprs r*rz"AskAutoDownload._evaluateUserInputs ((-- i ) ) *}(!M  i - -      Q      "9-- -r,Fc\|}|dvratt|dkrtjddn1|dkrtjddn|dkrt d|d vr.|d tjdd gd Sd S) z override base. )rr6r,r autoDownloadallowr6denyr,z6user selected an option that terminates configuration.)rr6zAuto Download set to: rN)rrrsetryrgetrs r*rzAskAutoDownload._performAction s!! Y   ;   {{8888177771%&^___ V     Y 8W8WYY[^_ ` ` ` ` `  r,)rTNrUr) r]r`rarbrYrrrrrlrms@r*r&r&sXXXXXX:    ....aaaaaaaar,r&cHeZdZdZdfd Zdddd ZddZddZdZxZ S)SelectFilePathr'NTcPt|||dSrrgrs r*rYzSelectFilePath.__init__'rr,z**/*globpath0rr$ list[str]r7ctj|}||D]<}|t|r"|t|=dS)a Uses comparisonFunction to see if a file in path0 matches the RE embedded in comparisonFunction and if so manipulate the list in post comparisonFunction = function (lambda function on path returning True/False) path0 = os-specific string post = list of matching results to fill glob = string to glob for (default ``**/*``, but ``**/*.exe`` on Windows and ``*`` on Mac). N)pathlibPathr7rr)rXcomparisonFunctionr8r$r7 path0_as_pathpath1s r*_getAppOSIndependentz#SelectFilePath._getAppOSIndependent*sl U++ "''-- ( (E!!#e**-- ( CJJ''' ( (r,returncg}dtjddfD]2}t|tsJ||||d3|S)z Provide a comparison function that returns True or False based on the file name. This looks at everything in Applications, as well as every directory in Applications z /Applicationsz~/ApplicationsF) returnPathlib*r6)r cleanpathrrr@)rXr=r$r8s r* _getDarwinAppzSelectFilePath._getDarwinApp<sm %v'78HX]'^'^'^_ Q QEeS)) ) ))  % %&8%C % P P P P r,cg}d}|D]C}|tjvrtj|}|dkr*||||dD|S)zb Provide a comparison function that returns True or False based on the file name. ) ProgramFileszProgramFiles(x86) ProgramW6432r z**/*.exer6)r<environr@)rXr=r$ environKeyspossibleEnvironKey environPaths r* _getWinAppzSelectFilePath._getWinAppGsr K "- ^ ^ !33*%78Kb    % %&8+tR\ % ] ] ] ] r,c6||}t|tr|j|j}t|tr|S|}d|cxkrt |krnn ||dz St|S)a Evaluate the user's string entry after parsing; do not return None: either return a valid response, default if available, IncompleteInput, NoInput objects. Here, we convert the user-selected number into a file path Nr)rrrsrrSrrrp)rXrrrs r*rz!SelectFilePath._evaluateUserInputXs((-- i ) ) *}(!M  i - -  '')) ) ) ) )S\\ ) ) ) ) )9q=) )"9-- -r,r)r8rr$r9r7r)rAr9) r]r`rarbrYr@rFrNrrlrms@r*r4r4"sXXXXXX *0(((((($    ".......r,r4cJeZdZdZd dZdZdZdZdZdd Z dd Z dd Z dS)SelectMusicXMLReaderzJ Select a MusicXML Reader by presenting a user a list of options. NTcTt||||ddg|_dS)Nrrr~)r4rYr)rXrrrs r*rYzSelectMusicXMLReader.__init__zs<(/)1-9  ; ; ; $U+r,c ddgS)rzDefining an XML Reader permits automatically opening music21-generated MusicXML in an editor for display and manipulation when calling the show() method. Setting this option is highly recommended. rr1r^s r*rz%SelectMusicXMLReader._rawIntroductions  O    r,cNd}d}d}d}d}||}|||z }|||z }|||z }|||z }g}|D]}||vr|||S)zP Get all possible MusicXML Reader paths on Darwin (i.e., macOS) c:t|duSrU) reFinaleAppsearchxs r*comparisonFinalezGSelectMusicXMLReader._getMusicXMLReaderDarwin..comparisonFinale%%a((4 4r,c:t|duSrU)reMuseScoreApprWrXs r*comparisonMuseScorezJSelectMusicXMLReader._getMusicXMLReaderDarwin..comparisonMuseScores!((++47 7r,c:t|duSrU)reFinaleReaderApprWrXs r*comparisonFinaleReaderzMSelectMusicXMLReader._getMusicXMLReaderDarwin..comparisonFinaleReaders$++A..d: :r,c:t|duSrU) reSibeliusApprWrXs r*comparisonSibeliuszISelectMusicXMLReader._getMusicXMLReaderDarwin..comparisonSibelius ''**$6 6r,c:t|duSrU) reDoricoApprWrXs r*comparisonDoricozGSelectMusicXMLReader._getMusicXMLReaderDarwin..comparisonDoricor[r,)rFr) rXrZr^rardrhresultsresone_paths r*_getMusicXMLReaderDarwinz-SelectMusicXMLReader._getMusicXMLReaderDarwins 5 5 5 8 8 8 ; ; ; 7 7 7 5 5 5$$%8994%%&67774%%&<===4%%&89994%%&6777 % %Hs"" 8$$$ r,cd}d}d}d}||}|||z }|||z }|||z }g}|D]}||vr|||S)zC Get all possible MusicXML Reader paths on Windows c:t|duSrU) reFinaleExerWrXs r*rZzDSelectMusicXMLReader._getMusicXMLReaderWin..comparisonFinaler[r,cBt|duod|vS)Nzcrash-reporter)reMuseScoreExerWrXs r*r^zGSelectMusicXMLReader._getMusicXMLReaderWin..comparisonMuseScores'!((++47U.comparisonSibeliusrer,c:t|duSrU) reDoricoExerWrXs r*rhzDSelectMusicXMLReader._getMusicXMLReaderWin..comparisonDoricor[r,)rNr)rXrZr^rdrhrirjrks r*_getMusicXMLReaderWinz*SelectMusicXMLReader._getMusicXMLReaderWins 5 5 5 V V V 7 7 7 5 5 5//"5664??#34444??#56664??#3444 % %Hs"" 8$$$ r,cgS)z@ Get all possible MusicXML Reader paths on Unix r1r^s r*_getMusicXMLReaderNixz*SelectMusicXMLReader._getMusicXMLReaderNixs  r,c||Stj}|dkr|}nJ|dkr|}n/|dkr|}n|}|S)z Return a list of valid results that are possible and should be displayed to the user. These will be processed by _formatResultForUser before usage. Nr~rr)rrrvrlrx)rXrr r$s r*rz%SelectMusicXMLReader._getValidResultss  L%'' u  --//DD  ! !0022DD   --//DD--//D r,ct}t|ddd}|||}|t |t rdS|durpt|jD][}tddd}|||}|durnt |t rn\|S)z\ If we do not have any musicxml readers, ask user if they want to download. TFz}No available MusicXML readers are found on your system. We recommend downloading and installing a reader before continuing. )rrrrrAre you ready to continue?r) urlMuseScorerrrrrrSrrr)rXrrrr)r$rs r*rz&SelectMusicXMLReader._askFillEmptyLists!  X  Y Y Y  {{}}  dK ( ( 5t||"4#455Eu-IKKKAIIEI***;;==Dt||#D+66Kr,Fc|}|nt|ts[ttt jd|t jd}|d|dgdSdSdS)rN musicxmlPathzMusicXML Reader set to: r)rrrSrrr1r2r)rXrr musicXmlNews r*rz#SelectMusicXMLReader._performActions!!  j&E&E  ;    ONF 3 3 3%/.99K   G+GGM N N N N N    r,rrUr$r) r]r`rarbrYrrlrvrxrrrr1r,r*rQrQus,,,,       D< *####J O O O O O Or,rQc:eZdZdZd dZdZdZdZdZd d Z dS) ConfigurationAssistantz: Class for managing numerous configuration tasks. Fcz||_tj|_g|_|dSrU) _simulaterr _platform_dialogs getDialogsrs r*rYzConfigurationAssistant.__init__"s8!+--  r,ctd}|j|td}|j|t d}|j|t t d}|j|t td}|j|td}|j|dS) NrrTzThe music21 discussion group provides a forum for asking questions and getting help. Would you like to see the music21 discussion list or sign up for updates?)rrzBWould you like to view the music21 documentation in a web browser?z0The music21 Configuration Assistant is complete.r) rQrrr&rrurlMusic21ListurlGettingStartedrrXr)s r*rz!ConfigurationAssistant.getDialogs*s  + + + Q D ) ) ) Q %d 3 3 3 Q $@ A A A Q 'W Y Y Y Q  R S S S Qr,cg}|d|d|d|dt|dS)NzWelcome to the music21 Configuration Assistant. You will be guided through a number of questions to install and set up music21. Simply pressing return at a prompt will select a default, if available.r zUYou may run this configuration again at a later time by running music21/configure.py.r)rr+rs r* _introductionz$ConfigurationAssistant._introductionEsu _ ` ` ` 2 8 9 9 9 3Cr,cdSrUr1r^s r* _conclusionz"ConfigurationAssistant._conclusionQs r,cg}|dtz|dt|dS)z Draw a line _rN)rrr+rs r*_hrzConfigurationAssistant._hrTsC 3#$$$ 3Cr,Nc|g}||t|jD]\}}|j|jvr|t ||kr ||}nd}|||} | |j #t$rYnwxYw| dS)z The forceList, if provided, is a list of string arguments passed in order to the included dialogs. Used for testing. Nrr) rrrrrrrrrrrryr)rX forceListr'r)r unused_posts r*runzConfigurationAssistant.run]s  I   dm,,  DAq~Q\11 HHJJJ9~~!!!!  IIEI " " "++--K 8888"     s2C CCrrU) r]r`rarbrYrrrrrr1r,r*rrs   6      r,rz list[type] _DOC_ORDERc2eZdZdZdZdZdZdZdZdS) TestUserInputcTttdt}|td|ttdtd}|td|ttdtd}|td|dS)Nzstarting: YesOrNo() getResult():zstarting: YesOrNo(default=True)Trz starting: YesOrNo(default=False)F)printrrrrs r* testYesOrNozTestUserInput.testYesOrNos  #$$$ II  nakkmm,,,  /000 D ! ! !  nakkmm,,,  0111 E " " "  nakkmm,,,,,r,cttdt}|td|dS)N starting: SelectMusicXMLReader()rrrQrrrs r*testSelectMusicXMLReaderz&TestUserInput.testSelectMusicXMLReadersP  0111 " "  nakkmm,,,,,r,cttdtd}|td|dS)Nz)starting: SelectMusicXMLReader(default=1)rrrrrs r*testSelectMusicXMLReaderDefaultz-TestUserInput.testSelectMusicXMLReaderDefaultsU  9:::  + + +  nakkmm,,,,,r,cttd}|td||dS)Nzhttps://www.music21.org/r)rrrrrrs r*testOpenInBrowserzTestUserInput.testOpenInBrowsersT  7 8 8  nakkmm,,, r,cttdt}|td||ttdt}dd}||_|td||dS)Nrrz,starting: SelectMusicXMLReader() w/o resultscgSrUr1rs r*getValidResultsz@TestUserInput.testSelectMusicXMLReader2..getValidResultsIr,rU)rrQrrrr)rXr)rs r*testSelectMusicXMLReader2z'TestUserInput.testSelectMusicXMLReader2s  0111 " "  nakkmm,,,   <=== " "    -  nakkmm,,, r,cltdtd}|dS)Nz"Running ConfigurationAssistant allTr)rrr)rX configAssts r*testConfigurationAssistantz(TestUserInput.testConfigurationAssistants7 2333+T::: r,N) r]r`rarrrrrrr1r,r*rrsn---&------*r,rc>eZdZdZdZdZdZdZdZdZ dZ d S) Testcddlm}|ddd}|d|t |d|d |t |d |d |t |d |d |t |d |ddd}|d|t |d|d |t |d |d |t |d|d |t |d dS)NrrTFr{rrFalserTruer blahz)z!)r8rrr assertEqualrrrXrr)s r*rzTest.testYesOrNos%%%%%%   dU+G  I I # Q[[]]++W555 # Q[[]]++V444 "  Q[[]]++V444 & Q[[]]++-XYYY   dU+G  I I # Q[[]]++W555 # Q[[]]++V444 "  Q[[]]++-PQQQ & Q[[]]++-XYYYYYr,ctddlm}|d}||jddS)Nrrrr)r8rrrrrs r*testSelectFromListzTest.testSelectFromListsH%%%%%%  $ $Q $ / / Q'''''r,cddlm}|}dd}||_|dd|}|||jdS)NrrcgSrUr1rs r*rz7Test.testSelectMusicXMLReaders..getValidResults%rr,rT)rrrU)r8rrQrrrassertIsInstancerv)rXrr)rr$s r*testSelectMusicXMLReaderszTest.testSelectMusicXMLReaders s%%%%%%  * * , ,    - t ,,,{{}} dI$;<<<<>EEE   | , , \222 ++,@AA4HHHHHr,c&td}dS)NTr)r)rX unused_cas r*rzTest.testConfigurationAssistant9s*D999 r,c"t}dSrU)rrXunused_ds r*testGetUserDatazTest.testGetUserData<s,..r,c"t}dSrU)r&rs r*testGetUserData2zTest.testGetUserData2Bs"$$r,c"t}dSrU)rrs r* testAnyKeyzTest.testAnyKeyHs88r,N) r]r`rarrrrrrrrr1r,r*rrsZZZ0((( = = = I I I:::/// %%% r,rcJt}|dSrU)rr)cas r*rrOs  ! !BFFHHHHHr,__main__rr6)alltestte)Tr )H __future__rr<r;rer=rr/runittestr importlibrr8rrr EnvironmentrD_DOC_IGNORE_MODULE_OR_PACKAGE RegexFlag IGNORECASEcompilerVrcrorsr`r]rqrgru urlMusic21r|rrrr+r2rBrQrSrdrprsrvMusic21Exceptionryr{rrrrrr&r4rQrr__annotations__TestCaserrrr]rargv testInstancermainTestgetattrr;r1r,r*rs#""""""   &{&{33 $ \ $ bj):66  +Z88 bj):66  +Z88 BJ4jAA/<<A:NNbj):66 bj):66 3 * ::  &,,,,^))) 84LLLLLLLL""""" """"""""k""""""""k""""""""K"""     l3[   @R@R@R@R@R@R@R@RH V4wwwwwfwwwvwD9292929292929292z\\\\\V\\\~^a^a^a^a^an^a^a^aBP.P.P.P.P.^P.P.P.feOeOeOeOeO>eOeOeOR^^^^^^^^v BBBBBH%BBBJHHHHH8 HHH\    z s38}} tvv ]__ 3sx==1    > > NNN G T " " " " "Xa[D $GGB $ $ & & & & & W\38A; / / 1 .GGL#(1+ . . 0 0 0 0 0)& 1 1r,