`i[;xdZddlZddlZddlmZmZddlmZm Z ej dgdde de d dfd Z ej d gd de d e de ded df dZej dgdde d eje deje dededeje d dfdZd&dZd&dZd&dZd&dZd&dZd&dZd&dZd&dZd&dZej d ejd!fejd!fejd"fgd#ede d dfd$Zd&d%ZdS)'z(Tests for ReST-style docstring routines.N) ParseErrorRenderingStyle)composeparsezsource, expected))N) N)Short descriptionr )z Short description r )z Short description r sourceexpectedreturnc|t|}|j|ksJ|j|ksJ|jJ|jrJdS)zTest parsing short description.N)rshort_description descriptionlong_descriptionmeta)r r docstrings t/home/jaya/work/projects/VOICE-AGENT/VIET/agent-env/lib/python3.11/site-packages/docstring_parser/tests/test_rest.pytest_short_descriptionr sZf I  &( 2 2 2 2  H , , , ,  % - - -~ z?source, expected_short_desc, expected_long_desc, expected_blank))z#Short description Long descriptionr Long descriptionT)zI Short description Long description r rT)za Short description Long description Second line r Long description Second lineT)"Short description Long descriptionr rF)zH Short description Long description r rF)z$ Short description Long description r rF)z` Short description Long description Second line r rFexpected_short_descexpected_long_descexpected_blankct|}|j|ksJ|j|ksJ|j|ksJ|jrJdS)zTest parsing long description.N)rrrblank_after_short_descriptionr)r rrrrs rtest_long_descriptionrsbLf I  &*= = = = =  %); ; ; ; ;  2n D D D D~ rzxsource, expected_short_desc, expected_long_desc, expected_blank_short_desc, expected_blank_long_desc, expected_full_desc))zB Short description :meta: asd r NFFr )z_ Short description Long description :meta: asd r rFFr)zu Short description First line Second line :meta: asd r First line Second lineFFz,Short description First line Second line)zv Short description First line Second line :meta: asd r rTF-Short description First line Second line)zw Short description First line Second line :meta: asd r rTTr )z$ :meta: asd NNFFNexpected_blank_short_descexpected_blank_long_descexpected_full_descct|}|j|ksJ|j|ksJ|j|ksJ|j|ksJ|j|ksJt |jdksJdS)z2Test parsing newlines around description sections.N)rrrrblank_after_long_descriptionrlenr)r rrr!r"r#rs rtest_meta_newlinesr(jsvf I  &*= = = = =  %); ; ; ; ;  26O O O O O  15M M M M M  $6 6 6 6 6 y~  ! # # # # # #rctd}|jdksJt|jdksJ|jdjdgksJ|jdjdksJdS)z*Test parsing multiline meta documentation.ze Short description :meta: asd 1 2 3 r r%rr asd 1 2 3Nrrr'rargsrrs r$test_meta_with_multiline_descriptionr.s   I  &*= = = = = y~  ! # # # # >!  !fX - - - - >!  (,> > > > > > >rctd}|jdksJt|jdksJ|jdjdgksJ|jdjdksJ|jdjdgksJ|jdjd ksJ|jd jd gksJ|jd jd ksJd S)zTest parsing multiple meta.z Short description :meta1: asd 1 2 3 :meta2: herp :meta3: derp r rmeta1r*r%meta2herpmeta3derpNr+r-s rtest_multiple_metar7s   I  &*= = = = = y~  ! # # # # >!  !gY . . . . >!  (,> > > > > >!  !gY . . . . >!  (F 2 2 2 2 >!  !gY . . . . >!  (F 2 2 2 2 2 2rctd}|jdksJt|jdksJ|jdjgdksJ|jdjdksJdS)z,Test parsing meta with additional arguments.zD Short description :meta ene due rabe: asd r r%r)reneduerabeasdNr+r-s rtest_meta_with_argsr=s I  &*= = = = = y~  ! # # # # >!  !%C%C%C C C C C >!  (E 1 1 1 1 1 1rcDtd}t|jdksJtd}t|jdksJ|jdjdksJ|jdjJ|jdjdksJ|jdjJ|jdjrJ|jdjd ksJ|jdjd ksJ|jdjd ksJ|jdjrJ|jdjJ|jd jd ksJ|jd jdksJ|jd jdksJ|jd jsJ|jd jJ|jdjdksJ|jdjdksJ|jdjdksJ|jdjsJ|jdjdksJ|jdjdksJ|jdjdksJ|jdjdksJ|jdjsJ|jdjdksJtd}t|jd ksJ|jdjdksJ|jdjd ksJ|jdjdksJ|jdjJ|jdjrJdS)zTest parsing params.r ra) Short description :param name: description 1 :param int priority: description 2 :param str? sender: description 3 :param str? message: description 4, defaults to 'hello' :param str? multiline: long description 5, defaults to 'bye' nameNz description 1r%priorityintz description 2r4senderstrz description 3r0messagez"description 4, defaults to 'hello'z'hello' multilinez%long description 5, defaults to 'bye'z'bye'z} Short description :param a: description a :type a: int :param int b: description b az description a)rr'paramsarg_name type_namerdefault is_optionalr-s r test_paramsrNs)**I y A % % % %   I y A % % % %  A  '6 1 1 1 1  A  ( 0 0 0  A  *o = = = =  A  & . . ."... .  A  ': 5 5 5 5  A  (E 1 1 1 1  A  *o = = = ="... .  A  & . . .  A  '8 3 3 3 3  A  (E 1 1 1 1  A  *o = = = =  A  *** *  A  & . . .  A  '9 4 4 4 4  A  (E 1 1 1 1'+OOOOO  A  *** *  A  &) 3 3 3 3  A  '; 6 6 6 6  A  (E 1 1 1 1' 3 4 4 4 4  A  *** *  A  &' 1 1 1 1 I y A % % % %  A  '3 . . . .  A  (E 1 1 1 1  A  *o = = = =  A  & . . ."... ...rctd}|jJ|jJt|jdksJtd}|jJ|jjJ|jjdksJ|jjrJ|j|jgksJtd}|jJ|jjdksJ|jjdksJ|jjrJ|j|jgksJtd}|jJ|jjdksJ|jjdksJ|jjrJ|j|jgksJdS) zTest parsing returns.# Short description NrzA Short description :returns: description rzE Short description :returns int: description rBzU Short description :returns: description :rtype: int rreturns many_returnsr'rKr is_generatorr-s r test_returnsrUIs I   $ $ $  ! - - - y% & &! + + + + I   ( ( (   & . . .   (M 9 9 9 9 --- -  !i&7%8 8 8 8 8 I   ( ( (   &% / / / /   (M 9 9 9 9 --- -  !i&7%8 8 8 8 8 I   ( ( (   &% / / / /   (M 9 9 9 9 --- -  !i&7%8 8 8 8 8 8 8rctd}|jJ|jJt|jdksJtd}|jJ|jjJ|jjdksJ|jjsJ|jJt|jdksJ|jd|jksJtd}|jJ|jjdksJ|jjdksJ|jjsJ|jJt|jdksJ|jd|jksJdS) zTest parsing yields.rPNrz@ Short description :yields: description rr%zD Short description :yields int: description rBrQr-s r test_yieldsrWzs I   $ $ $  ! - - - y% & &! + + + + I   ( ( (   & . . .   (M 9 9 9 9   ))) )  ! - - - y% & &! + + + +  !! $ (9 9 9 9 9 I   ( ( (   &% / / / /   (M 9 9 9 9   ))) )  ! - - - y% & &! + + + +  !! $ (9 9 9 9 9 9 9rctd}t|jdksJtd}t|jdksJ|jdjJ|jdjdksJtd}t|jdksJ|jdjdksJ|jdjdksJdS) zTest parsing raises.rPrz@ Short description :raises: description r%NrzK Short description :raises ValueError: description ValueError)rr'raisesrKrr-s r test_raisesr[s  I y A % % % % I y A % % % %  A  ( 0 0 0  A  *m ; ; ; ; I y A % % % %  A  (L 8 8 8 8  A  *m ; ; ; ; ; ;rc$tjt5tddddn #1swxYwYtjt5tddddn #1swxYwYtjt5tddddn #1swxYwYtjt5tddddn #1swxYwYtddS)zTest parsing broken meta.:Nz:param herp derpz:param: invalidz:param with too many args: descz:sthstrange: desc)pytestrZrrrrtest_broken_metar`s z " " c  z " """  !!!""""""""""""""" z " "!!    !!!!!!!!!!!!!!! z " "11 /000111111111111111 sB6::A66A:=A:B66B:=B:C66C:=C:ctd}|jJ|jjdksJ|jjdksJtd}|jJ|jjJ|jjdksJdS)zTest parsing deprecation notes.z1:deprecation: 1.1.0 this function will be removedNz1.1.0zthis function will be removedz+:deprecation: this function will be removed)r deprecationversionrr-s rtest_deprecationrdsIJJI  , , ,  (G 3 3 3 3  ,0O O O O OCDDI  , , ,  ( 0 0 0  ,0O O O O O O Orzrendering_style, expectedzShort description. Long description. :param int foo: a description :param int bar: another description :returns float: a returnzShort description. Long description. :param foo: a description :type foo: int :param bar: another description :type bar: int :returns: a return :rtype: floatrendering_stylecRtd}t|||ksJdS)z Test composez Short description. Long description. :param int foo: a description :param int bar: another description :return float: a return reN)rr)rer rs r test_composerhs?X   I 9o > > >( J J J J J Jrcnd}t|}tj}t|||ksJdS)z=Test abbreviated docstring with only return type information.z!Short description. :rtype: floatrgN)rrEXPANDEDr)stringrres rtest_short_rtyperls> 2Ff I$-O 9o > > >& H H H H H Hr)r N) __doc__typingTr^docstring_parser.commonrrdocstring_parser.restrrmark parametrizerDrboolrOptionalr(r.r7r=rNrUrWr[r`rdCOMPACTCLEANrjrhrlr_rrrxs<.. >>>>>>>>00000000  3#$  E;;;>>~          >>~ LLL QQd$ $C$ 3$ $ $ # $  3 $ $$$eQQd$$????$33330 2 2 2 2?/?/?/?/D.9.9.9.9b%:%:%:%:P<<<<<$ P P P P  " '    '   #  +%((RK.KCKDKKKS((RK"IIIIIIr