3jk-dZddlmZddlZddlZddlZddlZddlZddlZddl m Z m Z dgZ ddejejzfdZddZej"d Zddd Zddd Zd Zed k(reyy)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 tj}|s+ttdjj }n|i}|D]~}t j|st|dd}|)|D]Q}||} |j| |||d} | js*tj| |} |j| Sy)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 () rN _DOC_ATTR) optionflags) doctest DocTestParser __import__defaultImports__dict__copyinspectisclassgetattr get_doctestexamples DocTestCaseaddTest) suitemoduleVariableLists outerFilenameglobsr dtplvkdocattrdockey documentationdtdtcs D/DATA/.local/lib/python3.12/site-packages/music21/test/testRunner.pyaddDocAttrTestsToSuiter#"s4    !C >!,-66;;= "$ #{D1 ? F#FOMv}aPB;;%%b2=(C MM#  #cxtjdk(}tjddk\}|D]}t |ds|j }|j D]^}t|jd|_|rt|jd|_|s>|jjdd|_`y ) 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:VsOO%2G""1%+KsJ'  \\{{G)',,@GL0uE &||33KO # r$z0x[0-9A-Fa-f]+c.tj||S)a7 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"r2r2qs* ;;{J //r$c Nd|vr|S t|dd}g}d}|D]R}|j|||jtdz |jd|zdz|jdz}T|j||dd j |S#t $r|cYSwxYw) 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.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 JJz$qww5E1F'FG H JJ4t; <5519D :de$%wws| sB B B$#B$c\ d}t|jdd}|r3tjtjztj z}n!tjtjz}d}d|vs?dt jvs-dt jvst|jddrd}nd}|rtj}nd|vs-dt jvst|jddrntD]%}t|jj}'d|vs-dt jvst|jddr3|jtj d d j" tj$d || }d } d|vs-dt jvst|jddrd} d} dt jvsHdt jvs6t|jddst|jddrd} d}d} t+t jdk(r8t jd j-} | dvrt jd } t|jddr|jdd} dt jvsd|vst|jddrg}|D]L}t/|t0r| r2tj2j5|D]}t)d|| |}t7|D]o}|j-| j-k(sI|j-d| j-zk(s%|j-d| j-zk(sm|} nt9|| r3t)d| |j;t=|| d}nBt)d| dtj2j?|}|jA|O|sitj }t+|d kDr|d }n|d }|d }|d }tC|jDjG}tI||||||r8tK|tjL}| |_'|jQ|}yy#t&$r-} t)d | tj}Yd} ~ td} ~ wwxYw)at 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 zEProblem in docstrings [usually a missing r value before 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&HLLe45      !  +#sxx/ %5u=> $"2//446%$ 3+sxx7HLL)=uEF W]]_Q/2<<= &%%'BI[ CHH$HLLE23 L#((CHH$HLLE23HLL/0  K 388}hhqk! A A((1+K HLLE *+ll9e4  ! +HLL67 !S!%77HHKE.ug67L&sID (9(9(;;"jjlv 8I8I8K/KL"jjlw9J9J9L/LM&*  & 4-7 }EFJJL.GD+.0"'K>{mK^_`++AA!DB KKO38  v;?$QiO$QiO$Q' '* j1188:;r>=%UB((*$"JJrN O & YZ\Y]^ _##%B &sS55 T+>"T&&T+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$