rh-SrSSKJr SSKrSSKrSSKrSSKrSSKrSSKrSSK J r J r S/r SS\R\R-4SjrSSjr\R""S 5rSSS jjrSSS jjrS r\S :Xa\"5 gg)z The testRunner module contains the all important "mainTest" function that runs tests in a given module. Except for the one instance of "defaultImports", everything here can run on any system, not just music21. ) annotationsN)parenthesesMatchParenthesesMatchmusic21Fc [R"5nUSLa+[[S5RR 5nOUc0nUHn[ R"U5(dM [USS5nUcM2UHSnXxn URXXS5n U R(dM-[R"U US9n URU 5 MU M g)a> takes a suite, such as a doctest.DocTestSuite and the list of variables in a module and adds from those classes that have a _DOC_ATTR dictionary (which documents the properties in the class) any doctests to the suite. >>> import doctest >>> s1 = doctest.DocTestSuite(chord) >>> s1TestsBefore = len(s1._tests) >>> before = set(s1._tests) >>> allLocals = [getattr(chord, x) for x in dir(chord)] >>> test.testRunner.addDocAttrTestsToSuite(s1, allLocals) >>> s1TestsAfter = len(s1._tests) >>> s1TestsAfter - s1TestsBefore 4 >>> lastTest = s1._tests[-1] >>> lastTest client () FrN _DOC_ATTR) optionflags) doctest DocTestParser __import__defaultImports__dict__copyinspectisclassgetattr get_doctestexamples DocTestCaseaddTest) suitemoduleVariableLists outerFilenameglobsr dtplvkdocattrdockey documentationdtdtcs Q/home/james-whalen/.local/lib/python3.13/site-packages/music21/test/testRunner.pyaddDocAttrTestsToSuiter##s4    !C ~>!,-66;;= "$$ #{D1 ? F#OMvaPB;;%%b2=(C MM#  #c[R"5S:Hn[RSS:nUHn[ US5(dMUR nUR Hjn[URS5UlU(a[URS5UlU(dMIURRSS5UlMl M g ) z Fix doctests so that addresses are sanitized, WindowsPath is okay on windows and OrderedDicts pass on Python 3.12. In the past this fixed other differences among Python versions. In the future, it will again! Windows _dt_testz0x...... PosixPath WindowsPathN) platformsystemsys version_infohasattrr)rstripAddresseswantfix312OrderedDictreplace) doctestSuitewindows isPython312r!r examples r" fixDoctestsr:WsOO%2G""1%+KsJ''  \\{{G)',,@GL0uE w&||33KO # r$z0x[0-9A-Fa-f]+c,[RX5$)a Function that changes all memory addresses (pointers) in the given textString with (replacement). This is useful for testing that a function gives an expected result even if the result contains references to memory locations. So for instance: >>> stripA = test.testRunner.stripAddresses >>> stripA('{0.0} ') '{0.0} ' while this is left alone: >>> stripA('{0.0} I>') '{0.0} I>' For doctests, can strip to '...' to make it work fine with doctest.ELLIPSIS >>> stripA('{0.0} ', '0x...') '{0.0} ' )ADDRESSsub) textString replacements r"r2r2rs* ;;{ //r$c NSU;aU$[USSS9n/nSnUHRnURXUR[S5- 5 URSU-S-5 URS-nMT URXS5 S R U5$![ a Us$f=f) a Function that fixes the OrderedDicts to work on Python 3.12 and above. (eventually when 3.12 is the norm, this should be replaced to neuter the doctests for 3.10/3.11 instead. Or just wait until 3.12 is the minimum version?) >>> fix312 = test.testRunner.fix312OrderedDict >>> fix312('OrderedDict([(0, 1), (1, 2), (2, 3)])') 'OrderedDict({...})' while this is left alone: >>> fix312('{0: 1, 1: 2, 2: 3}', 'nope!') '{0: 1, 1: 2, 2: 3}' zOrderedDict([(z)]))opencloserz OrderedDict({z})N)rappendstartlenendjoin ValueError)r>r?matchesoutlastms r"r4r4sz) ":4DERA JJzqww5E1F'FG H JJ4t; <5519D :e$%wws| sB B B$#B$cL Sn[URSS55nU(a3[R[R-[R -nO![R[R-nSnSU;dHS[ R;d4S[ R;d [URSS55(aSnOSnU(a[R"5nOSU;d4S[ R;d [URSS55(aO[H&n[U5RR5nM( SU;d4S[ R;d [URSS55(a4UR[R "5S S R"5 [R$"S UUS 9nS n SU;d4S[ R;d [URSS55(aSn Sn S[ R;dTS[ R;d@[URSS55(d [URSS55(aSn SnSn [+[ R5S:Xa:[ RS R-5n U S;a[ RS n [URSS55(aURSS5n S[ R;d&SU;d [URSS55(a/nUGHcn[/U[05(aMU SLa4[R2R5U5Hn[)SU35 M U bU"5n[7U5HsnUR-5U R-5:XdLUR-5SU R-5-:Xd'UR-5SU R-5-:XdMqUn O [9UU 5(a3[)SU 35 UR;5 [=UU 5"5 Sn OD[)SU S35 [R2R?U5nURAU5 GMf U(dj[R "5n[+U5S :aUS nOUS nUS nUS n[CURDRG55n[IUUUXT5 USLa9[KU5 [RL"5nU Ul'URQU5ngg![&a1n [)S SU 3-5 [R"5nSn A GNSn A ff=f)a% Takes as its arguments modules (or a string 'noDocTest' or 'verbose') and runs all of these modules through a unittest suite Unless 'noDocTest' is passed as a module, a docTest is also performed on `__main__`, hence the name "mainTest". If 'moduleRelative' (a string) is passed as a module, then global variables are preserved. Run example (put at end of your modules): :: import unittest class Test(unittest.TestCase): def testHello(self): hello = 'Hello' self.assertEqual('Hello', hello) import music21 if __name__ == '__main__': music21.mainTest(Test) This module tries to fix up some differences between python2 and python3 so that the same doctests can work. These differences can now be removed, but I cannot remember what they are! TfailFastN noDocTest nodoctestFmoduleRelativeimportPlusRelativer'r__main__)rr z8Problem in docstrings [usually a missing r value before z the quotes:] verboselistdisplay)rXrYrVrRrunTest onlyDocTestzUnit Test Method: testxtestzRunning Named Test Method: z"Could not find named test method: z, running all tests))boolgetr ELLIPSISNORMALIZE_WHITESPACEREPORT_ONLY_FIRST_FAILUREr/argvunittest TestSuiter r rrupdaterstack f_globals DocTestSuiterJprintrGlower isinstancestrdefaultTestLoadergetTestCaseNamesdirr1setUprloadTestsFromTestCaseaddTestsrXf_localsvaluesr#r:TextTestRunner verbosityrun) testClasseskeywords runAllTestsrPr r skipDoctests1diverw displayNames runThisTestargttNametObjnames2stacksouterFrameTuple outerFramerlocalVariablesrunnerunused_testResults r"mainTestrs>KHLLT23H   ** +// 0    ** +  E{"chh&chh&HLLe455      !  +#sxx/ %5u=>> $"2//446%$ 3+sxx7HLL)=uEFF W]]_Q/2<<= &%%'BI[ CHH$HLLE233 L#((CHH$HLLE233HLL/00  K 388}hhqk! A A((1+K HLLE *++ll9e4  ! +HLL677 !S!!t#%77HHKE.ug67L&sID (9(9(;;"jjlv 8I8I8K/KL"jjlw9J9J9L/LM&*  & 4--7 }EFJJLD+.0"'K>{mK^_`++AA!DB KKO38  v;?$QiO$QiO$Q' '* j1188:;r>=%UdB((*$"JJrN Q & L#B4() *##%B &sU(( V#2&VV#rU)r6zdoctest._DocTestSuitereturnNone)r<)rrm)r*)__doc__ __future__rr rr-rer/rdmusic21.common.stringToolsrrr r`rar#r:compiler<r2r4r__name__r$r"rs # I*.!&&//!(!=!= > 1hP0 **% &00D^+B z Jr$