rh%SSKJr SSKrSSKrSSKrSSKrSSKrSSKrSSKrSSK r SSK r SSK J r SSK Jr SSK Jr SSK Jr \R""S5rSr\R(R*r\R,"S \5r\R,"S \5r\R,"S \5r\R,"S \5r\R,"S \5r\R,"S\5r\R,"S\5r\R,"S\5r\R,"S\5rSr Sr!Sr"Sr#Sr$SFSjr%Sr&Sr'Sr("SS5r)"SS\)5r*"SS\)5r+"S S!\)5r,"S"S#\)5r-"S$S%\R\\)5r/"S&S'5r0"S(S)\05r1"S*S+\05r2"S,S-\25r3"S.S/\25r4"S0S1\05r5"S2S3\55r6"S4S5\55r7"S6S7\75r8"S8S95r9/r:S:\;S;'"S<S=\ Rx5r="S>S?\ Rx5r>S@r?\@SA:Xa\A"\R5SB:Xa\?"5 g\>"5rC\="5rD\A"\R5SC:d\RSBSD;aSSK r \ R"\>5 g\RSBSE:Xa\F"\D\RSC5"5 g\G"\C\RSB5(a\F"\C\RSB5"5 ggg)G) 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[R"U5(aUnOURS5n/nU(aZUHSnUS:XaURS5 MUS:XaURS5 M5U[R "U[ 5- nMU OUnSn[U5HupxUS:XaSnOUUS:Xa[U5S:aSUS3nO9US:Xa[U5S:XaSUS3nOU[U5S- :aUS3nOUS3nUS:a!Xb-S:Xa[SS9n U R5 [RRU5 [RR5 US- nM g ) zW 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 K/home/james-whalen/.local/lib/python3.13/site-packages/music21/configure.py writeToUserr*HsQ  $ DCby B C  c:66IT? 2:D !VD A vS>D !VD QvQUnUnSn[RSU35 UbU$[[R"U55H)nXQ:XdM [R R X55n O Un[R RU5up6X2:XaU$M)zH Ascend up paths given a start; return when target file has been found. Nzat dir: ) environLocal printDebugsortedr;listdirpathjoinr)starttargetlastDirthisDirmatchfnjunks r)_crawlPathUpwardrPsGG E (7) 45    LG,-B| W1. g.     L r+c(\rSrSrSrSSjrSrSrg) DialogErrorz3 DialogError is a normal object, not an Exception. NcXlgNsrc)selfrWs r)__init__DialogError.__init__sr+cPSURRSURS3$)Nz) __class____name__rWrXs r)__repr__DialogError.__repr__s&$T^^%<%<$=RzKKr+rVrU)r^ __module__ __qualname____firstlineno____doc__rYr`__static_attributes__r0r+r)rRrRsLr+rRc0^\rSrSrSrSU4SjjrSrU=r$)KeyInterruptErrorzA Subclass of DialogError that deals with Keyboard Interruptions. c >[TU]US9 gNrVsuperrYrXrWr]s r)rYKeyInterruptError.__init__ S!r+r0rUr^rbrcrdrerYrf __classcell__r]s@r)rhrh""r+rhc0^\rSrSrSrSU4SjjrSrU=r$)IncompleteInputzj Subclass of DialogError that runs when the user has provided incomplete input that cannot be understood. c >[TU]US9 grkrlrns r)rYIncompleteInput.__init__rpr+r0rUrqrss@r)rvrvs ""r+rvc0^\rSrSrSrSU4SjjrSrU=r$)NoInputz^ Subclass of DialogError for when the user has provided no input, and there is not a default. c >[TU]US9 grkrlrns r)rYNoInput.__init__rpr+r0rUrqrss@r)r{r{rtr+r{c0^\rSrSrSrSU4SjjrSrU=r$) BadConditionsz Subclass of DialogError for when the user's system does support the action of the dialog: something is missing or otherwise prohibits operation. c >[TU]US9 grkrlrns r)rYBadConditions.__init__rpr+r0rUrqrss@r)rrs ""r+rc\rSrSrSrg)DialogExceptionr0N)r^rbrcrdrfr0r+r)rrsr+rc\rSrSrSrSSjrSrSrSrSr SS jr SS jr SS jr S r S rSrSrSrSSjrSSS.SjjrSSjrSSjrSSjrSrg)Dialoga# 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. NcSUlSUlURU5n[U[5(dX@lOSUlX lX0lSUl/SQUl g)N)windarwinnix) _result _resultPrior_parseUserInput isinstancerR_default _tryAgain _promptHeader _maxAttempts _platforms)rXdefaulttryAgainr defaultCookeds r)rYDialog.__init__s^  ,,W5 -55)M!DM!)3r+c[U5 g)z2 Write output to user. Call module-level function N)r*rXrs r) _writeToUserDialog._writeToUsers  Cr+cz[5nU$![a [5s$[a [ 5s$f=f)z6 Collect from user; return None if an empty response. )inputKeyboardInterruptrh ExceptionrR)rXr#s r) _readFromUserDialog._readFromUsers;  !7DK  '$& & !=  !s :::cxUR5nURbUSUR3UlgXlg)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' Nr striprrs r)prependPromptHeaderDialog.prependPromptHeader(s;iik    )$'5$*<*<)=!>D !$ r+cxUR5nURbURSU3UlgXlg)z >>> 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' Nr rrs r)appendPromptHeaderDialog.appendPromptHeader<s;iik    )$($6$6#7q!>D !$ r+c[USSS9nURUS9 UR5n[U[5(agU$)a 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 getResultrrRrXrrr(r#s r) _askTryAgainDialog._askTryAgainOsD Ge!L N  {{} dK ( (Kr+chURbURR5nURS5(dURS5(aSnOSnURRS5(aUS- nO+URRS5(aUS- nOUS- nUUU3nU$)a  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' ?.r :z r r )rrendswith)rXrheaderdivs r)_rawQueryPrepareHeaderDialog._rawQueryPrepareHeaderhs    )''--/Fs##vs';';!!**622v ##,,T22t s HSE#'C r+cURbfUR5nURS5(aSnUSSnUR5 OSnURUR5nUSUSUS3nU$)z& Prepare the end of the query message Nrr z (default is )r )rrr_formatResultForUser)rXrrrs r)_rawQueryPrepareFooterDialog._rawQueryPrepareFootersw == $))+C||C  #2h // >GEwiqQ7C r+cg)5 Return a multiline presentation of an introduction. Nr0r_s r)_rawIntroductionDialog._rawIntroductionr+cg)2 Return a multiline presentation of the question. Nr0r_s r) _rawQueryDialog._rawQuery r+cU$)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. r0rXresults r)rDialog._formatResultForUsers  r+cU$)z Translate string to desired output. Pass None through (as no input), convert '' to None, and pass all other outputs as IncompleteInput objects. r0rXraws r)rDialog._parseUserInputs  r+cg)z Evaluate the user's string entry after parsing; do not return None: either return a valid response, default if available, or IncompleteInput object. Nr0rs r)_evaluateUserInputDialog._evaluateUserInput r+cg)zt Call this method immediately before calling askUser. Can be used for configuration getting additional information. Nr0rXrs r) _preAskUserDialog._preAskUserrr+F) skipIntrocUR5nUbU(dURU5 URUS9nUSLa[5Ulg[ UR 5HnUR5n[U[5(aX`l gUc"URU5 UR5nO[RSU/5 Un[U[5(aXpl gURU5n[U[[ 45(a2XlUR"(aUR%5(aM g gXl g g)zz Ask the user, display the query. The force argument can be provided to test. Sets self._result; does not return a value. NrFz writeToUser:)rrrrrrangerrrrRrrCrDrhrr{rvrr) rXrrintror#r&queryrawInput cookedInputs r)rDialog.askUsers0 %%'  Y   e $e, 5=(?DL t(()ANN$E%--$ }!!%(--/''(?@  ($566'  11(;K +'ABB* >>((** + _*r+cUR$)zr Return the result, or None if not set. This may also do a processing routine that is part of the desired result. )rrXsimulates r)rDialog.getResults ||r+cg)z$ does nothing; redefine in subclass Nr0rs r)_performActionDialog._performAction rr+ctUR5n[UR[5(a6[R SUR35 UR SS/5 gU(a#[R SUR35 gURUS9 g![a [S5ef=f)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.r z0performAction() called, but in simulation mode: rz(perform action raised a dialog exceptionN) rrrrRrCrDrrr)rXrdummys r) performActionDialog.performActions  dllK 0 0  # #B4<<.Q S   137 8   # #B4<<.Q S R##X#6" R&&PQQ  Rs B!!B7)rrrrrrrNTN)TN)r rU)TF)r^rbrcrdrerYrrrrrrrrrrrrrrrrrrfr0r+r)rrsl 34 !%(%&28"    AuAH Rr+rc<^\rSrSrSrSU4SjjrSrSrSrU=r $)ri/z Press any key to continue c">[TU]XUS9 gNrrlrXrrrr]s r)rYAnyKey.__init__4 ,Wr+c,SnURU5nU$)rzPress return to continue.)rrs r)rAnyKey._rawQuery7s *))#. r+cg)z Always returns True Tr0rs r)rAnyKey._parseUserInputArr+r0)NFN) r^rbrcrdrerYrrrfrrrss@r)rr/sXr+rcH^\rSrSrSrS U4SjjrSrSrSrSr Sr U=r $) riIa  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() c">[TU]XUS9 grrlrs r)rYYesOrNo.__init__Xrr+c6USLagUSLag[SU35e)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. TYesFNoz&attempting to format result for user: )rrs r)rYesOrNo._formatResultForUser[s- T> u_"$J6("ST Tr+cNSnURU5nURU5nU$)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)rYesOrNo._rawQueryks."))#.))#. r+cUc [5$[U5nUR5nUR5nUS:Xa [5$US;agUS;ag[ U5$)aQ 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') r yesy1trueT)non0falseF)r{strrlowerrvrs r)rYesOrNo._parseUserInputsb ;9 #hiikiik "99  + + - -s##r+cURU5n[U[5(aURb UR$U$)a 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 rrr{rrXr rawParseds r)rYesOrNo._evaluateUserInputs;<((- i ) )}}(}}$r+r0r) r^rbrcrdrerYrrrrrfrrrss@r)rrIs( XU ($:$$r+rc>^\rSrSrSrSU4SjjrSSjrSrU=r$)AskOpenInBrowserizv Ask the user if the want to open a URL in a browser. >>> d = configure.AskOpenInBrowser('https://www.music21.org/') c>[TU]X#US9 XlUbXPlgSURS3nUR U5 g)NrzOpen the following URL (z) in a web browser? )rmrY _urlTargetrr)rX urlTargetrrrpromptrr]s r)rYAskOpenInBrowser.__init__sH ,W#  !' ,T__,==RSC  # #C (r+c|UR5nUSLa![R"UR5 gUSLagg)M The action here is to open the stored URL in a browser, if the user agrees. TFN)r webbrowseropen_newrrXrrs r)rAskOpenInBrowser._performActions8! T>    0 u_ r+)rrTTNNr) r^rbrcrdrerYrrfrrrss@r)rrs :>+/ )r+rcD^\rSrSrSrSU4SjjrSrSSjrSrU=r $) AskSendInstallationReportizN Ask the user if they want to send a report regarding their system and usage. c^>[TU]XUS9 Uc0nX@lSnURU5 g)NrzWould you like to send a pre-formatted email to music21 regarding your installation? Installation reports help us make music21 work better for you)rmrY_additionalEntriesr)rXrrradditionalEntriesrr]s r)rY"AskSendInstallationReport.__init__s= ,W  $ " "3] $r+c|/nURS5 URS5 URS5 URS5 [5nURUR5 [ U5HnURUSX#35 M URS5 UR[ R 5 URS5 URS5 URS5 [R"5nUS:XaSRU5nOS RU5nS U3nU$) 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!rz%0D%0Ar zGmailto:music21stats@gmail.com?subject=music21 Installation Report&body=) rrAupdater,rErversionr getPlatformrH)rXbodyuserDatakeyplatformrs r) _getMailToStr'AskSendInstallationReport._getMailToStrs  5 6 B 6 7 B=//0(#C KK3%tHM?3 4$ %& CKK  B S T B%%' u ==&D99T?DYZ^Y_b r+cxUR5nUSLa%[R"UR55 gg)r#TN)rr$openr7r&s r)r(AskSendInstallationReport._performActions1! T> OOD..0 1 r+)r,r(r) r^rbrcrdrerYr7rrfrrrss@r)r*r*s%/36: % D22r+r*cj^\rSrSrSrS U4SjjrS SjrSrSSjrS Sjr S Sjr S r S r S r U=r$)SelectFromListi#a 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 c">[TU]XUS9 grrlrs r)rYSelectFromList.__init__5rr+cUbU$/$)zW Return a list of valid results that are possible and should be displayed to the user. r0rs r)_getValidResultsSelectFromList._getValidResults8s  LIr+cU$)zF Reduce each complete file path to stub, or otherwise compact display r0rs r)r#SelectFromList._formatResultForUserCs  r+c[USSS9nURUS9 UR5n[U[5(agUS;a [ S5eU$)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)rrrrrRrrs r)_askFillEmptyList SelectFromList._askFillEmptyListIsa G"!J L  {{} dK ( (=(%TVVKr+cTUR5nU(dURUS9nU$g)aL 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)rArF)rXroptionsr#s r)rSelectFromList._preAskUserhs0''))))6DKr+c/nSnURUS9nU(d [S5$UH0nURU5nURSUSU35 US- nM2 SnUR U5nUR U5nUSU/-$)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 )rArrrrr)rXrheadr&rIentryr$tails r)rSelectFromList._rawQuery~s ''e'4 !78 8E++E2C KK!A3b ' FA >**40**40sDk!!r+cUc [5$US:Xa [5$US;aSnU$[U5nU$![[[4a [ U5s$f=f)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() r r r)r{int ValueError TypeErrorZeroDivisionErrorrv)rXrr#s r)rSelectFromList._parseUserInputsp ;9  "99  + +D  ,3x  +<= ,&s++ ,s 6 AAcURU5n[U[5(aURb UR$U$rUrrs r)r!SelectFromList._evaluateUserInputs=((-  i ) )}}(}}$r+r0rrUNN)r^rbrcrdrerYrArrFrrrrrfrrrss@r)r=r=#s7"X  >,"@0  r+r=cP^\rSrSrSrS U4SjjrSrS SjrSrS Sjr Sr U=r $) AskAutoDownloadi- General class to select values from a list. c">[TU]XUS9 grrlrs r)rYAskAutoDownload.__init__rr+c /SQ$)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.r aNIn 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.comr zWould you like to:r0r_s r)r AskAutoDownload._rawIntroductions  r+cUbU$/SQ$)z Just return number options )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).r0rs r)rA AskAutoDownload._getValidResultss  L r+cURU5n[U[5(aURb URn[U[5(aU$SUs=::aS::aU$ [ U5$)z Evaluate the user's string entry after parsing; do not return None: either return a valid response, default if available, IncompleteInput, NoInput objects. r)rrr{rrRrvrs r)r"AskAutoDownload._evaluateUserInputsp ((- i ) )}}(!MM  i - -  Q   #9- -r+cJUR5nUS;a\[[5 US:Xa[R"SS5 O/US:Xa[R"SS5 OUS:Xa [ S5eUS ;a+UR S [R "S53S /5 g g ) z override base. )rr5rdr autoDownloadallowr5denyrdz6user selected an option that terminates configuration.)rr5zAuto Download set to: r N)rrrsetrrgetr&s r)rAskAutoDownload._performAction s! Y  ; {8171%&^__ V    !7 8W7XY[^_ ` r+r0)rTNrUr) r^rbrcrdrerYrrArrrfrrrss@r)r[r[s)X: ..aar+r[c^^\rSrSrSrS U4SjjrSS.S SjjrS SjrS SjrS r S r U=r $)SelectFilePathi#r\c">[TU]XUS9 grrlrs r)rYSelectFilePath.__init__(rr+z**/*globc[R"U5nURU5H5nU"[U55(dMUR [U55 M7 g)ah 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)pathlibPathrrrr)rXcomparisonFunctionpath0r#rr path0_as_pathpath1s r)_getAppOSIndependent#SelectFilePath._getAppOSIndependent+sF U+ "''-E!#e*-- CJ'.r+c/nS[R"SSS94H+n[U[5(deUR XUSS9 M- U$)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*rq)r cleanpathrrrz)rXrvr#rws r) _getDarwinAppSelectFilePath._getDarwinApp=sX %v'7'78HX]'^_EeS)) ))  % %&8C % P` r+c/nSnUHEnU[R;aM[RUnUS:XaM4URXUSS9 MG U$)zR Provide a comparison function that returns True or False based on the file name. ) ProgramFileszProgramFiles(x86) ProgramW6432r z**/*.exerq)r;environrz)rXrvr# environKeyspossibleEnvironKey environPaths r) _getWinAppSelectFilePath._getWinAppHs` K "- !3**%78Kb   % %&8tR\ % ] #. r+c$URU5n[U[5(aURb URn[U[5(aU$UR 5nSUs=::a[ U5::a O OX2S- $[U5$)z 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 r)rrr{rrRrArrv)rXrrrIs r)r!SelectFilePath._evaluateUserInputYs((- i ) )}}(!MM  i - - '') )S\ )q=) )"9- -r+r0r)rwrr# list[str]rrr)returnr) r^rbrcrdrerYrzrrrrfrrrss@r)rnrn#s4X *0(#&($ "..r+rncX\rSrSrSrS SjrSrSrSrSr SS jr SS jr SS jr S r g)SelectMusicXMLReaderivzB Select a MusicXML Reader by presenting a user a list of options. NcB[RUUUUS9 SS/Ulg)Nrrr)rnrYr)rXrrrs r)rYSelectMusicXMLReader.__init__{s.(/)1-9  ; $U+r+c SS/$)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. r r0r_s r)r%SelectMusicXMLReader._rawIntroductions  O    r+c$SnSnSnSnSnURU5nX`RU5- nX`RU5- nX`RU5- nX`RU5- n/nUHnX;dM URU5 M U$)z@ Get all possible MusicXML Reader paths on Darwin (i.e., macOS) c0[RU5SL$rU) reFinaleAppsearchxs r)comparisonFinaleGSelectMusicXMLReader._getMusicXMLReaderDarwin..comparisonFinale%%a(4 4r+c0[RU5SL$rU)reMuseScoreApprrs r)comparisonMuseScoreJSelectMusicXMLReader._getMusicXMLReaderDarwin..comparisonMuseScores!((+47 7r+c0[RU5SL$rU)reFinaleReaderApprrs r)comparisonFinaleReaderMSelectMusicXMLReader._getMusicXMLReaderDarwin..comparisonFinaleReaders$++A.d: :r+c0[RU5SL$rU) reSibeliusApprrs r)comparisonSibeliusISelectMusicXMLReader._getMusicXMLReaderDarwin..comparisonSibelius ''*$6 6r+c0[RU5SL$rU) reDoricoApprrs r)comparisonDoricoGSelectMusicXMLReader._getMusicXMLReaderDarwin..comparisonDoricorr+)rr) rXrrrrrresultsresone_paths r)_getMusicXMLReaderDarwin-SelectMusicXMLReader._getMusicXMLReaderDarwins 5 8 ; 7 5$$%89%%&677%%&<==%%&899%%&677H" 8$  r+cSnSnSnSnURU5nXPRU5- nXPRU5- nXPRU5- n/nUHnXv;dM URU5 M U$)z3 Get all possible MusicXML Reader paths on Windows c0[RU5SL$rU) reFinaleExerrs r)rDSelectMusicXMLReader._getMusicXMLReaderWin..comparisonFinalerr+cH[RU5SL=(a SU;$)Nzcrash-reporter)reMuseScoreExerrs r)rGSelectMusicXMLReader._getMusicXMLReaderWin..comparisonMuseScores$!((+47U.comparisonSibeliusrr+c0[RU5SL$rU) reDoricoExerrs r)rDSelectMusicXMLReader._getMusicXMLReaderWin..comparisonDoricorr+)rr)rXrrrrrrrs r)_getMusicXMLReaderWin*SelectMusicXMLReader._getMusicXMLReaderWins 5 V 7 5//"56??#344??#566??#344H" 8$  r+c/$)z0 Get all possible MusicXML Reader paths on Unix r0r_s r)_getMusicXMLReaderNix*SelectMusicXMLReader._getMusicXMLReaderNixs  r+cUbU$[R"5nUS:XaUR5nU$US:XaUR5nU$US:XaUR 5nU$UR 5nU$)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. rrr)rr2rrr)rXrr6r#s r)rA%SelectMusicXMLReader._getValidResultss  L%%' u --/D  !002D   --/D --/D r+c[n[USSSS9nURUS9 UR5nUR 5 [ U[ 5(agUSLaf[UR5HMn[SSSS9nURUS9 UR5nUSLa U$[ U[ 5(dML U$ U$)zL 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) urlMuseScorerrrrrrRrrr)rXrrrr(r#rs r)rF&SelectMusicXMLReader._askFillEmptyLists!  X  Y  {{}  dK ( (t|"4#4#45Eu-IKAIIEI*;;=Dt|K$D+66K6Kr+cUR5nUbi[U[5(dS[[5 [R "SU5 [R "S5nURSU3S/5 ggg)r#N musicxmlPathzMusicXML Reader set to: r )rrrRrrrjrkr)rXrr musicXmlNews r)r#SelectMusicXMLReader._performActionsl!  j&E&E ;  OONF 3%//.9K   !9+GM N'F r+)rrrUrYr)r^rbrcrdrerYrrrrrArFrrfr0r+r)rrvs2,   D< *#J Or+rcD\rSrSrSrS SjrSrSrSrSr S S jr S r g) ConfigurationAssistantiz2 Class for managing numerous configuration tasks. crXl[R"5Ul/UlUR 5 grU) _simulaterr2 _platform_dialogs getDialogsrs r)rYConfigurationAssistant.__init__#s*!++-  r+c[SS9nURRU5 [SS9nURRU5 [ SS9nURRU5 [ [ SS9nURRU5 [ [SS9nURRU5 [SS9nURRU5 g) 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?)rr zBWould you like to view the music21 documentation in a web browser?z0The music21 Configuration Assistant is complete.r) rrrr[r*rurlMusic21ListurlGettingStartedrrXr(s r)r!ConfigurationAssistant.getDialogs+s  + Q D ) Q %d 3 Q $@ A Q 'W Y Q  R S Qr+c/nURS5 URS5 URS5 URS5 [U5 g)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) _introduction$ConfigurationAssistant._introductionFsK _ ` 2 8 9 3Cr+cgrUr0r_s r) _conclusion"ConfigurationAssistant._conclusionRs r+cp/nURS[-5 URS5 [U5 g)z Draw a line _r N)rrr*rs r)_hrConfigurationAssistant._hrUs- 3#$ 3Cr+NcUc/nUR5 UR5 [UR5Hup#URUR ;aM!UR5 [ U5U:aXnOSnURUS9 UR5nURURS9 M UR5 g![a  Mf=f)zv The forceList, if provided, is a list of string arguments passed in order to the included dialogs. Used for testing. Nrr) rrrrrrrrrrrrr)rX forceListr&r(r unused_posts r)runConfigurationAssistant.run^s  I   dmm,DA~~Q\\1 HHJ9~!!  IIEI "++-K 8-*  #  s"C CC)rrrrrU) r^rbrcrdrerYrrrrrrfr0r+r)rrs% 6  r+rz list[type] _DOC_ORDERc8\rSrSrSrSrSrSrSrSr Sr g ) TestUserInputic[5 [S5 [5nUR5 [SUR55 [5 [S5 [SS9nUR5 [SUR55 [5 [S5 [SS9nUR5 [SUR55 g)Nzstarting: YesOrNo() getResult():zstarting: YesOrNo(default=True)Trz starting: YesOrNo(default=False)F)printrrrrs r) testYesOrNoTestUserInput.testYesOrNos  #$ I  nakkm,  /0 D !  nakkm,  01 E "  nakkm,r+c[5 [S5 [5nUR5 [SUR55 g)N starting: SelectMusicXMLReader()rrrrrrs r)testSelectMusicXMLReader&TestUserInput.testSelectMusicXMLReaders1  01 "  nakkm,r+c[5 [S5 [SS9nUR5 [SUR55 g)Nz)starting: SelectMusicXMLReader(default=1)rrrrrs r)testSelectMusicXMLReaderDefault-TestUserInput.testSelectMusicXMLReaderDefaults3  9:  +  nakkm,r+c[5 [S5nUR5 [SUR55 UR 5 g)Nzhttps://www.music21.org/r)rrrrrrs r)testOpenInBrowserTestUserInput.testOpenInBrowsers5  7 8  nakkm, r+c~[5 [S5 [5nUR5 [SUR55 UR 5 [5 [S5 [5nSSjnX!lUR5 [SUR55 UR 5 g)Nrrz,starting: SelectMusicXMLReader() w/o resultsc/$rUr0rs r)getValidResults@TestUserInput.testSelectMusicXMLReader2..getValidResultsIr+rU)rrrrrrA)rXr(rs r)testSelectMusicXMLReader2'TestUserInput.testSelectMusicXMLReader2s  01 "  nakkm,   <= " -  nakkm, r+cL[S5 [SS9nUR5 g)Nz"Running ConfigurationAssistant allTr)rrr)rX configAssts r)testConfigurationAssistant(TestUserInput.testConfigurationAssistants 23+T: r+r0N) r^rbrcrdrrrrrr rfr0r+r)rrs -&--*r+rcD\rSrSrSrSrSrSrSrSr Sr S r S r g ) TesticSSKJn URSSSS9nURS5 UR [ UR 55S5 URS 5 UR [ UR 55S 5 URS 5 UR [ UR 55S 5 URS 5 UR [ UR 55S 5 URSSSS9nURS5 UR [ UR 55S5 URS 5 UR [ UR 55S 5 URS 5 UR [ UR 55S5 URS 5 UR [ UR 55S 5 g)NrrTFrrrFalser Truer blahz)z!)r7rrr assertEqualrrrXrr(s r)rTest.testYesOrNost%   dU+G  I # Q[[]+W5 # Q[[]+V4 "  Q[[]+V4 & Q[[]+-XY   dU+G  I # Q[[]+W5 # Q[[]+V4 "  Q[[]+-PQ & Q[[]+-XYr+cfSSKJn URSS9nURURS5 g)Nrrrr)r7rr=rrrs r)testSelectFromListTest.testSelectFromLists,%  $ $Q $ / Q'r+cSSKJn UR5nSSjnX2lUR SSS9 UR 5nUR XAR5 g)Nrrc/$rUr0rs r)r7Test.testSelectMusicXMLReaders..getValidResults&rr+rT)rrrU)r7rrrArrassertIsInstancer)rXrr(rr#s r)testSelectMusicXMLReadersTest.testSelectMusicXMLReaders!sO%  * * , - t ,{{} d$;$;E   | , \2 ++,@A4Hr+c[SS9ng)NTr)r)rX unused_cas r)r Test.testConfigurationAssistant:s *D9 r+c[5ngrU)r*rXunused_ds r)testGetUserDataTest.testGetUserData=s ,.r+c[5ngrU)r[r's r)testGetUserData2Test.testGetUserData2Cs "$r+c[5ngrU)rr's r) testAnyKeyTest.testAnyKeyIs 8r+r0N) r^rbrcrdrrrr!r r)r,r/rfr0r+r)r r s,Z0( = I:/ % r+r c8[5nUR5 grU)rr)cas r)rrPs  !BFFHr+__main__rr5)alltestte)T)H __future__rr;rtrer<rr.runittestr$ importlibrr7rrr EnvironmentrC_DOC_IGNORE_MODULE_OR_PACKAGE RegexFlag IGNORECASEcompilerrrrrrrrr urlMusic21rrrrr*r1rArPrRrhrvr{rMusic21Exceptionrrrrrr*r=r[rnrrr__annotations__TestCaserr rr^rargv testInstancer6mainTestgetattrr:r0r+r)rIs#   &&{3 $ \\ $ $ jj):6  +Z8 jj):6  +Z8 JJ4jA/<A:Njj):6 jj):6 3 * ::  &,^) 84LL" ""k""k""K" l33[ @R@RH V4wfwvwD9292z\V\~^an^aBP.^P.feO>eOR^^v JBH%%BJH8  H\  z 388} v _ sxx=1   >    T "XXa[D B $ & \388A; / / L#((1+ . 00'r+