`iJ dZddlZddlZddlmZmZddlmZm Z ej dgdde de d dfd Z ej d gd de d e de ded df dZej dgdde d eje deje deded df dZd%dZd%dZd%dZd%dZd%dZd%dZd%dZd%dZej dgdde de d dfdZej dd gde de d dfd!Zej dd"gde de d dfd#Zd%d$ZdS)&z*Tests for epydoc-style docstring routines.N) ParseErrorRenderingStylecomposeparsezsource, expected))N) NShort descriptionr z Short description r z Short description r sourceexpectedreturncbt|}|j|ksJ|jJ|jrJdS)zTest parsing short description.N)rshort_descriptionlong_descriptionmeta)rr docstrings v/home/jaya/work/projects/VOICE-AGENT/VIET/agent-env/lib/python3.11/site-packages/docstring_parser/tests/test_epydoc.pytest_short_descriptionr sFf I  &( 2 2 2 2  % - - -~ z?source, expected_short_desc, expected_long_desc, expected_blank))#Short description Long descriptionr Long descriptionT)I Short description Long description r rT)a Short description Long description Second line r Long description Second lineT)"Short description Long descriptionr rF)H Short description Long description r rF)$ Short description Long description r rF)` 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)rr"r#r$rs rtest_long_descriptionr'sbLf I  &*= = = = =  %); ; ; ; ;  2n D D D D~ rzdsource, expected_short_desc, expected_long_desc, expected_blank_short_desc, expected_blank_long_desc))B Short description @meta: asd r NFF)_ Short description Long description @meta: asd r rFF)u Short description First line Second line @meta: asd r First line Second lineFF)v Short description First line Second line @meta: asd r r+TF)w Short description First line Second line @meta: asd r r+TT)$ @meta: asd NNFFexpected_blank_short_descexpected_blank_long_descct|}|j|ksJ|j|ksJ|j|ksJ|j|ksJt |jdksJdS)z2Test parsing newlines around description sections.N)rrrr&blank_after_long_descriptionlenr)rr"r#r/r0rs rtest_meta_newlinesr5isff I  &*= = = = =  %); ; ; ; ;  26O O O O O  15M M M M M y~  ! # # # # # #rctd}|jdksJt|jdksJ|jdjdgksJ|jdjdksJdS)z*Test parsing multiline meta documentation.ze Short description @meta: asd 1 2 3 r r2rr asd 1 2 3Nrrr4rargs descriptionrs 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 rmeta1r7r2meta2herpmeta3derpNr8r;s rtest_multiple_metarEs   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 r2r)reneduerabeasdNr8r;s rtest_meta_with_argsrKs I  &*= = = = = y~  ! # # # # >!  !%C%C%C C C C C >!  (E 1 1 1 1 1 1rctd}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|jdjdksJdS)zTest parsing params.r ra Short description @param name: description 1 @param priority: description 2 @type priority: int @param sender: description 3 @type sender: str? @param message: description 4, defaults to 'hello' @type message: str? @param multiline: long description 5, defaults to 'bye' @type multiline: str? nameNz description 1r2priorityintz description 2rBsenderstrz description 3r>messagez"description 4, defaults to 'hello'z'hello' multilinez%long description 5, defaults to 'bye'z'bye')rr4paramsarg_name type_namer:default is_optionalr;s r test_paramsr[s)**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 1 1rcVtd}|jJtd}|jJ|jjJ|jjdksJ|jjrJtd}|jJ|jjdksJ|jjdksJ|jjrJdS)zTest parsing returns.# Short description Nz@ Short description @return: description r:zT Short description @return: description @rtype: int rPrreturnsrXr: is_generatorr;s r test_returnsra3s I   $ $ $ I   ( ( (   & . . .   (M 9 9 9 9 --- - I   ( ( (   &% / / / /   (M 9 9 9 9 --- ---rcVtd}|jJtd}|jJ|jjJ|jjdksJ|jjsJtd}|jJ|jjdksJ|jjdksJ|jjsJdS)zTest parsing yields.r]Nz? Short description @yield: description r:zS Short description @yield: description @ytype: int rPr^r;s r test_yieldsrcTs I   $ $ $ I   ( ( (   & . . .   (M 9 9 9 9   ))) ) I   ( ( (   &% / / / /   (M 9 9 9 9   ))) )))rctd}t|jdksJtd}t|jdksJ|jdjJ|jdjdksJtd}t|jdksJ|jdjdksJ|jdjdksJdS) zTest parsing raises.r]rz? Short description @raise: description r2Nr:zJ Short description @raise ValueError: description ValueError)rr4raisesrXr:r;s r test_raisesrgus  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)pytestrfrrrrtest_broken_metarls z " " c  z " """  !!!""""""""""""""" z " "!!    !!!!!!!!!!!!!!! z " "11 /000111111111111111 sB6::A66A:=A:B66B:=B:C66C:=C:))rr)r rr r r )rr)rr)rz/Short description Long description Second line)rr)rr)r r)r!z.Short description Long description Second line)r(zShort description @meta: asd)r)z-Short description Long description @meta: asd)r*z7Short description First line Second line @meta: asd)r,z8Short description First line Second line @meta: asd)r-z9Short description First line Second line @meta: asd)r.z @meta: asd)z} Short description @meta: asd 1 2 3 z3Short description @meta: asd 1 2 3)z Short description @meta1: asd 1 2 3 @meta2: herp @meta3: derp zNShort description @meta1: asd 1 2 3 @meta2: herp @meta3: derp)zP Short description @meta ene due rabe: asd z*Short description @meta ene due rabe: asd) Short description @param name: description 1 @param priority: description 2 @type priority: int @param sender: description 3 @type sender: str? @type message: str? @param message: description 4, defaults to 'hello' @type multiline: str? @param multiline: long description 5, defaults to 'bye' a)Short description @param name: description 1 @type priority: int @param priority: description 2 @type sender: str? @param sender: description 3 @type message: str? @param message: description 4, defaults to 'hello' @type multiline: str? @param multiline: long description 5, defaults to 'bye')zK Short description @raise: description z%Short description @raise: description)zV Short description @raise ValueError: description z0Short description @raise ValueError: descriptioncJtt||ksJdS)zTest compose in default mode.Nrrrs r test_composerps*P 5== ! !X - - - - - -r)rma=Short description @param name: description 1 @type priority: int @param priority: description 2 @type sender: str? @param sender: description 3 @type message: str? @param message: description 4, defaults to 'hello' @type multiline: str? @param multiline: long description 5, defaults to 'bye'cbtt|tj|ksJdS)zTest compose in clean mode.rendering_styleN)rrrCLEANros rtest_compose_cleanrups?R f ~/CDDD       r)rmaMShort description @param name: description 1 @type priority: int @param priority: description 2 @type sender: str? @param sender: description 3 @type message: str? @param message: description 4, defaults to 'hello' @type multiline: str? @param multiline: long description 5, defaults to 'bye'cbtt|tj|ksJdS)zTest compose in expanded mode.rrN)rrrEXPANDEDros rtest_compose_expandedrxs?Z f ~/FGGG       rcRd}t|}t||ksJdS)z=Test abbreviated docstring with only return type information.z!Short description. @rtype: floatN)rr)stringrs rtest_short_rtyper{s1 2Ff I 9   ' ' ' ' ' 'r)rN)__doc__typingTrjdocstring_parser.commonrrdocstring_parser.epydocrrmark parametrizerRrboolr'Optionalr5r<rErKr[rarcrgrlrprurxr{rkrrrs00 >>>>>>>>22222222  3#$  E;;;>>~          >>~ :FFFJJV $  $C $ 3 $ $ $ # $  $ $ $WJJV $ ????$33330 2 2 2 232323232l....B****B<<<<<$BBBEEL......MEEL.  "%%LscdM%%L$ &))T#U))T((((((r