+ WBipRt^RIt^RIHt^RIHtHt^RIHtH t ^RI H t ^RI H t^RIHt^RIHt^R IHt!R R ]P*4t]R 8Xd^R IHt]!4R#R#)zp Tests the doxypypy filter. These tests may all be executed by running tox from the root level of the project. N) Namespace)linesepsep)basenamesplitext)parse)open) version_info)mark) AstWalkerca]tRt^toRtRt]!RRRRR^RRRRR7 tR],R ],.t ]P!R R .4t R R RRRRRRR./R RRRRRRRR./R RRRRRR.R^O/R RRRRRR.R_O/R RRRRRR.R`O/R R RRRR!R.RaO/.t R R"RRRR#R.RbO/R R$RRRR%R.RcO/R R&RRRR'R.RdO/.t R R(RRRR)R.ReO/R R*RRRR+R.RfO/.tR R,RRRR-R.RgO/R R.RRRR/R.RhO/.tR R0RRRR1R.RiO/R R2RRRR3R.RjO/R R4RRRR5R.RkO/R R6RRRR7R.RlO/.tR8tR9tR:tR;tR<tR=tR>tR?tR@tRAtRBtRCtRDtREtRFtRGt ]!RmRHl4t"RnRIlt#RJt$]%PL!]'Ro8RKRL7RM4t(RNt)ROt*RPt+RQt,RRt-RSt.RTt/RUt0RVt1RWt2RXt3]%PL!]'Ro8RYRL7RZ4t4]%PL!]'Ro8RYRL7R[4t5]%PL!]'Ro8RYRL7R\4t6R]t7Vt8R#)p TestDoxypypyz Define our doxypypy tests. NTFdummyzdummy.py autobriefautocodedebugfullPathNamespacetopLevelNamespace tablengthfilenameobject_respect equalIndentkeepDecoratorsz*print('testing: one, two, three, & four') zprint('is five.') z)print('testing: one, two, three, & four')zprint('is five.')nameonelinefunctionvisitorvisit_FunctionDef inputCodezCdef testFunctionOneLine(): """Here is the brief."""expectedOutputzC## @brief Here is the brief. # @namespace dummy.testFunctionOneLinezdef testFunctionOneLine(): onelineclassvisit_ClassDefzHclass testClassOneLine(object): """Here is the brief."""z@## @brief Here is the brief. # @namespace dummy.testClassOneLinezclass testClassOneLine(): basicfunctionzdef testFunctionBrief(): """Here is the brief. Here is the body. Unlike the brief it has multiple lines.""" basicclasszclass testClassBrief(object): """Here is the brief. Here is the body. Unlike the brief it has multiple lines."""basicfunctionnobriefz}def testFunctionNoBrief(): """Here is the body. It's not a brief as it has multiple lines."""basicclassnobriefzclass testClassNoBrief(object): """Here is the body. It's not a brief as it has multiple lines."""oneargzdef testFunctionArg(arg): """Here is the brief. Args: arg -- a test argument.""" multipleargszdef testFunctionArgs(arg1, arg2, arg3): """Here is the brief. Arguments: arg1: a test argument. arg2: another test argument. arg3: yet another test argument."""multiplelineargsaSdef testFunctionArgsMulti( arg1, arg2, arg3 ): """Here is the brief. Arguments: arg1: a test argument. arg2: another test argument. arg3: yet another test argument."""oneattrzclass testClassAttr(object): """Here is the brief. Attributes: attr -- a test attribute.""" multipleattrszclass testClassArgs(object): """Here is the brief. Attributes: attr1: a test attribute. attr2: another test attribute. attr3: yet another test attribute."""returnszxdef testFunctionReturns(): """Here is the brief. Returns: Good stuff."""yieldszvdef testFunctionYields(): """Here is the brief. Yields: Good stuff.""" oneraiseszdef testFunctionRaisesOne(): """Here is the brief. Raises: MyException: bang bang a boom."""multipleraiseszdef testFunctionRaisesMultiple(): """Here is the brief. Raises: MyException1 -- bang bang a boom. MyException2 -- crash. MyException3 -- splatter."""oneraisesclasszclass testClassRaisesOne(object): """Here is the brief. Raises: MyException: bang bang a boom."""multipleraisesclasszclass testClassRaisesMultiple(object): """Here is the brief. Raises: MyException1 -- bang bang a boom. MyException2 -- crash. MyException3 -- splatter.""" c \PVn\\PVP4VnR#)z6 Sets up a temporary AST for use with our unit tests. N)r _TestDoxypypy__Optionsoptionsr _TestDoxypypy__dummySrc dummyWalkerselfs&@/usr/lib/python3.14/site-packages/doxypypy/test/test_doxypypy.pysetUpTestDoxypypy.setUp:s*$-- $\%<% R #) z Test the stripOutAnds method. zThis and that.z This that.z This & that.zThis, that, & more.zThis, that, more.zThis and that & etc.zThis that etc.zHandy.zThis, that, &c.N)items assertEqualr6 _stripOutAndsr8 testPairspairs& r9test_stripOutAndsTestDoxypypy.test_stripOutAndsAsh l L !#6 "$4 h 0  OO%D   T--;;DGDd1g N&r<c  0RRRR\,R,R3R R\,R,R3R R\,R,R3/pVP4F;pVPVPP!V^,!V^,4K= R#) z" Test the endCodeIfNeeded method. Fduz # @endcodetri kvarkvinN)unuF)rGT)rHT)zkvin T)rr>r?r6_endCodeIfNeededrAs& r9test_endCodeIfNeeded!TestDoxypypy.test_endCodeIfNeededPs N <'1D8%@ !7*!De L !7&!@% H  OO%D   T-->>QH!!W &&r<c  .R ORRP\4R.3.R ORRP\4R.3RR.RP\4R.3.R ORRRRP\4R.3.pVF[wr#R .pVPPV4p\ V4FwrgVP WrV34K VP W#4K] R #)z0 Tests the checkIfCode method on the code side. This is prose, not code.>>> print("Now we have code.")z...{0}# @code{0}z(Traceback: frobnotz failure{0}# @code{0}z%This is prose, not code.{0}# @code{0}This is still prose, not code.(Another line of prose to really be sure.z&Ditto again, still prose.{0}# @code{0}FN)rO...rP)rOzTraceback: frobnotz failurerP)rOrQrRzDitto again, still prose.rPformatrr6 _checkIfCode enumeratesendr?)r8rB testLines outputLinesinCodeBlockObj codeCheckerlineNumlines& r9test_checkIfCodeTestDoxypypy.test_checkIfCode^s  /&--g64  />EEgN4 /4<BB7K4 /4><CCGL4 ;, Z'0 "I#WN**77GK!*9!5   $7!;<"6   Y 4 '0r<c  RR.RP\4R.3RR.RP\4R.3RR.RP\4R.3.RORR R P\4R.3.RORR R R R P\4R.3.pVF[wr#R .pVPPV4p\ V4FwrgVP WrV34K VP W#4K] R #)z1 Tests the checkIfCode method on the prose side. rSrOz...{0}# @endcode{0}zTraceback: frobnotz errorz)Traceback: frobnotz error{0}# @endcode{0}z>>> print("Code.")z">>> print("Code."){0}# @endcode{0}>>> myVar = 23>>> print(myVar)z{0}# @endcode{0}>>> myVar += 5TN)rbrcrO)rbrcrdrcrerOrT)r8rBrYrZr[ proseCheckerr]r^s& r9test_checkIfProseTestDoxypypy.test_checkIfProses>.*009.  0.@FFwO. ).9??H.  %&&--g6.  %&$&&--g6. K6 n'0 "I"VN++88HL!*9!5 !!4G"<="6   Y 4 '0r<c  RRRRRRRRRRR R/pVP4F<pVPVPPV^,4V^,4K> R#) z" Test the checkMemberName method. publicN _protected protected_stillProtected_ __privateprivate__stillPrivate___notPrivate__)r>r?r6_checkMemberNamerAs& r9test_checkMemberName!TestDoxypypy.test_checkMemberNamesh d +   y d  OO%D   T-->>tAwG!!W &&r<c bVPVPPR.4RR.4R#)z" Test the getFullPathName method. N)oneclass)rmodule)r?r6_getFullPathNamer7s&r9test_getFullPathName!TestDoxypypy.test_getFullPathNames3 )):: ##% ))224%88 :r<c `VPPpVFpVR,R,VPn\VR,PVP4VP4p\ VR,4p\ WCR,4!VP^,4VPUu.uF"qfP\VP4NK$ upVPR&VPVPVR,4K W PnR#uupi)z8 Compare docstring parsing for a list of code snippets. r.pyrr:NNNrN) r4rr split!_TestDoxypypy__linesep_for_sourcergetattrbodylinesreplacerr?)r8sampleSnippets options_name snippetTest testWalkerfuncAstr^s&& r9snippetComparisonTestDoxypypy.snippetComparisons||,, )K$/$7%$?DLL !";{#;#A#A$B[B[#\#'<<1JK 45G JI 6 7 Q Hakaqaq"raqY]<<9R9R#Saq"rJ  Q    Z--{;K/L M*!- #ss:(D+c DVP\P4R#)z0 Tests the proper handling of basic docstrings. N)rr _TestDoxypypy__sampleBasicsr7s&r9test_sampleBasicsTestDoxypypy.test_sampleBasics |::;r<c DVP\P4R#)z@ Tests the proper handling of arguments in function docstrings. N)rr _TestDoxypypy__sampleArgsr7s&r9test_sampleArgsTestDoxypypy.test_sampleArgss |889r<c DVP\P4R#)z> Tests the proper handling of attributes in class docstrings. N)rr _TestDoxypypy__sampleAttrsr7s&r9test_sampleAttrsTestDoxypypy.test_sampleAttrss |99:r<c DVP\P4R#)zI Tests the proper handling of returns and yields in function docstrings. N)rr _TestDoxypypy__sampleReturnsr7s&r9test_sampleReturnsTestDoxypypy.test_sampleReturns s |;;F  " u. ""$$r<c \\V44^,pVP\R4pV'g\R\ RRRVV^VRVRR7 3R\ RRRVV^VRVRR7 3R\ RRRVR^VRVRR7 3R \ RRRVR^VRVRR7 33pMR \ RRRVR^VRVRR7 33pVFpVP V^,VR 7p\V4^,V^,,R ,p \ V 4p V P4p V P4\P!R V 44p VPVP\4V P\44K R#)z~ Compare the results against expectations. Read and process the input file and compare its output against the gold standard. .z.outTFrz.outncz.outnnNz.outbarez.outeqrrc3B"TFpVP4xK R#5i)N)rstrip).0r^s& r9 :TestDoxypypy.compareAgainstGoldStandard..s 'E3C4(,{{}}3Cs) rrrrrrrrrrjoinr?r) r8rrrinFilenameBasertrialsr4output goldFilenamegoldFilegoldContentLines goldContents &&&& r9compareAgainstGoldStandard'TestDoxypypy.compareAgainstGoldStandard?s"(:"67:*223<"!&7&4'#( +#(  9""&7&4'#( +#(  9"!&7&*'#( +#(  i#"&7&*'#( +#(  K1Ff )"!&7&*'#' +#( #  FG**71:*IF#J/2WQZ?%GLL)H'113  NN ",,'E3C'EEK   V]]73[5G5G5P Qr<c ,RpVPV4R#)z- Test the basic example included in PEP 257. zdoxypypy/test/sample_pep.pyNrr8 sampleNames& r9test_pepProcessingTestDoxypypy.test_pepProcessings3  '' 3r<zdifferent behavior for Python 2)reasonc ,RpVPV4R#)zP Test an example with different combinations of public, protected, and private. zdoxypypy/test/sample_privacy.pyNrrs& r9test_privacyProcessing#TestDoxypypy.test_privacyProcessings 7  '' 3r<c ,RpVPV4R#)z5 Test the examples in the Google Python Style Guide. zdoxypypy/test/sample_google.pyNrrs& r9test_googleProcessing"TestDoxypypy.test_googleProcessings6  '' 3r<c ,RpVPV4R#)z Test raw docstrings. z$doxypypy/test/sample_rawdocstring.pyNrrs& r9test_rawdocstringProcessing(TestDoxypypy.test_rawdocstringProcessings<  '' 3r<c ,RpVPV4R#)z# Test arbitrary sections handling. z doxypypy/test/sample_sections.pyNrrs& r9test_sectionsProcessing$TestDoxypypy.test_sectionsProcessings8  '' 3r<c ,RpVPV4R#)z3 Test the basic example used in the doxypypy docs. z"doxypypy/test/sample_docexample.pyNrrs& r9test_docExampleProcessing&TestDoxypypy.test_docExampleProcessing:  '' 3r<c ,RpVPV4R#)z- Test an example with ZOPE style interfaces. z"doxypypy/test/sample_interfaces.pyNrrs& r9test_interfaceProcessing%TestDoxypypy.test_interfaceProcessingrr<c ,RpVPV4R#)z; Test a basic example inspired by the Commodore one-liner. zdoxypypy/test/sample_maze.pyNrrs& r9 test_mazeTestDoxypypy.test_mazes4  '' 3r<c 0RpVPVRR7R#)z' Test a trivial UTF-8 file with a BOM. zdoxypypy/test/sample_utf8bom.pyz UTF-8-SIGrNrrs& r9 test_utf8_bomTestDoxypypy.test_utf8_boms7  '' ['Ir<c 0RpVPVRR7R#)z+ Test a trivial UTF-16-BE file with a BOM. z"doxypypy/test/sample_utf16bebom.pyUTF-16rNrrs& r9test_utf16be_bomTestDoxypypy.test_utf16be_bom:  '' X'Fr<c 0RpVPVRR7R#)z+ Test a trivial UTF-16-LE file with a BOM. z"doxypypy/test/sample_utf16lebom.pyrrNrrs& r9test_utf16le_bomTestDoxypypy.test_utf16le_bomrr<c 0RpVPVRR7R#)z+ Test a trivial UTF-32-BE file with a BOM. z"doxypypy/test/sample_utf32bebom.pyUTF-32rNrrs& r9test_utf32be_bomTestDoxypypy.test_utf32be_bomrr<c 0RpVPVRR7R#)z+ Test a trivial UTF-32-LE file with a BOM. z"doxypypy/test/sample_utf32lebom.pyrrNrrs& r9test_utf32le_bomTestDoxypypy.test_utf32le_bomrr<znot supported in Python 2c ,RpVPV4R#)z# Test the examples for rst styles. "doxypypy/test/sample_rstexample.pyNrrs& r9test_rstProcessingTestDoxypypy.test_rstProcessings :  '' 3r<c 0RpVPVRR7R#)z7 Test the examples with rst and indentation reduction. rT)rNrrs& r9test_indentProcessing"TestDoxypypy.test_indentProcessings :  '' 'Er<c ,RpVPV4R#)z5 Test the examples with async functions and methods. zdoxypypy/test/sample_async.pyNrrs& r9test_asyncProcessing!TestDoxypypy.test_asyncProcessings 5  '' 3r<)r6r4)## @brief Here is the brief.#3# Here is the body. Unlike the briefzL# it has multiple lines. # @namespace dummy.testFunctionBriefzdef testFunctionBrief():)rrrzI# it has multiple lines. # @namespace dummy.testClassBriefzclass testClassBrief():)'##Here is the body. It's not a brief aszN# it has multiple lines. # @namespace dummy.testFunctionNoBriefzdef testFunctionNoBrief():)rzK# it has multiple lines. # @namespace dummy.testClassNoBriefzclass testClassNoBrief():)rrzA# @param arg a test argument. # @namespace dummy.testFunctionArgzdef testFunctionArg(arg):)rr# @param arg1 a test argument.%# @param arg2 another test argument.zM# @param arg3 yet another test argument. # @namespace dummy.testFunctionArgsz'def testFunctionArgs(arg1, arg2, arg3):) rrrrzR# @param arg3 yet another test argument. # @namespace dummy.testFunctionArgsMultizdef testFunctionArgsMulti(z arg1,z arg2,z arg3z ):)rz"# # @namespace dummy.testClassAttrzclass testClassAttr():z' ## @property attr # a test attribute.)rz"# # @namespace dummy.testClassArgszclass testClassArgs():z( ## @property attr1 # a test attribute.z. ## @property attr2 # another test attribute.z2 ## @property attr3 # yet another test attribute.)r # @returnzC# Good stuff. # @namespace dummy.testFunctionReturnszdef testFunctionReturns():)rrzB# Good stuff. # @namespace dummy.testFunctionYieldszdef testFunctionYields():)rrzT# @exception MyException bang bang a boom. # @namespace dummy.testFunctionRaisesOnezdef testFunctionRaisesOne():)rr,# @exception MyException1 bang bang a boom.!# @exception MyException2 crash.zR# @exception MyException3 splatter. # @namespace dummy.testFunctionRaisesMultiplez!def testFunctionRaisesMultiple():)rrzQ# @exception MyException bang bang a boom. # @namespace dummy.testClassRaisesOnezclass testClassRaisesOne():)rrrrzO# @exception MyException3 splatter. # @namespace dummy.testClassRaisesMultiplez class testClassRaisesMultiple():)r)rF))9__name__ __module__ __qualname____firstlineno____doc__maxDiffrr3rr5rr~rrrrrrr:rDrLr_rgrsrzrrrrrrrr staticmethodrrrr skipifr rrrrrrrrrrrrrrr__static_attributes____classdictcell__) __classdict__s@r9r r s`G!! I 5w>'J!3' % * , V,  N ' , S+  O * -  L ' -  * * -   ' ' -  yHNV H * .   N * 7  $ & *  7   ?9Lx I ' 0   O ' 9   MF I * "   H * "  O> K * 5   $ * 0  $ $ ' 5   ) ' 0  Y>N~L O &65p@5D& B:: -< : ; = < %%$TRl4 [[&/PQ4R4444444JGGGG [[&/JK4L4 [[&/JKFLF [[&/JK4L4r<r __main__)main)r unittestargparserosrros.pathrrastrcodecsrrsysr pytestr doxypypyr TestCaser r rr<r9r!sU &% q 48$$q 4h z Fr<