`j/dZddlmZddlmZejZejZejZGddejZe dkrej dSdS)z!Tests for fire docstrings module.) docstrings) testutilsczeZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z d Zd ZdZdZdZdZdZdS)DocstringsTestc~d}tj|}td}|||dS)NA simple one line docstring.summaryrparse DocstringInfo assertEqualself docstringdocstring_infoexpected_docstring_infos X/home/jworkman/hermes-web-chat/venv/lib/python3.11/site-packages/fire/docstrings_test.pytest_one_line_simplez#DocstringsTest.test_one_line_simplesN2I%i00N+. ,n=====c~d}tj|}td}|||dS)Nz( A simple one line docstring. rr r rs rtest_one_line_simple_whitespacez.DocstringsTest.test_one_line_simple_whitespace%sRI %i00N+. ,n=====rc~d}tj|}td}|||dS)NzA one line docstring that is both a little too verbose and a little too long so it keeps going well beyond a reasonable length for a one-liner. zA one line docstring that is both a little too verbose and a little too long so it keeps going well beyond a reasonable length for a one-liner.r r rs rtest_one_line_too_longz%DocstringsTest.test_one_line_too_long/sTI %i00N+  ,n=====rc~d}tj|}td}|||dS)NztA one line docstring that is both a little too verbose and a little too long so it runs onto a second line. kA one line docstring that is both a little too verbose and a little too long so it runs onto a second line.r r rs rtest_one_line_runs_overz&DocstringsTest.test_one_line_runs_over<sTI %i00N+; ,n=====rc~d}tj|}td}|||dS)Nz} A one line docstring that is both a little too verbose and a little too long so it runs onto a second line. rr r rs r"test_one_line_runs_over_whitespacez1DocstringsTest.test_one_line_runs_over_whitespaceIsTI %i00N+; ,n=====rcd}tj|}tdtddtddg}|||dS) Nz_One line description. Args: arg1: arg1_description arg2: arg2_description zOne line description.arg1arg1_descriptionname descriptionarg2arg2_descriptionr argsrr r ArgInforrs rtest_google_format_args_onlyz+DocstringsTest.test_google_format_args_onlyUsyI  %i00N+' -? @ @ @ -? @ @ @  ,n=====rcd}tj|}ttddg}|||dS)Nz+ Args: args: arg_description r)arg_descriptionr#)r)r*rs r!test_google_format_arg_named_argsz0DocstringsTest.test_google_format_arg_named_argsfseI %i00N+ -> ? ? ?   ,n=====rc d}tj|}tddtdddtdd d gd }|||dS) Na*Docstring summary. This is a longer description of the docstring. It spans multiple lines, as is allowed. Args: param1 (int): The first parameter. param2 (str): The second parameter. Returns: bool: The return value. True for success, False otherwise. Docstring summary.VThis is a longer description of the docstring. It spans multiple lines, as is allowed.param1intThe first parameter.r$typer%param2strThe second parameter.z:bool: The return value. True for success, False otherwise.r r%r)returnsr*rs r)test_google_format_typed_args_and_returnsz8DocstringsTest.test_google_format_typed_args_and_returnsss I %i00N+$*  6 8 8 8  7 9 9 9 M    ,n=====rc d}tj|}tddtdddtdd d g }|||dS) NaDocstring summary. This is a longer description of the docstring. It spans multiple lines, as is allowed. Args: param1 (int): The first parameter. param2 (str): The second parameter. This has a lot of text, enough to cover two lines. r1r2r3r4r5r6r8r9HThe second parameter. This has a lot of text, enough to cover two lines.r r%r)r*rs r,test_google_format_multiline_arg_descriptionz;DocstringsTest.test_google_format_multiline_arg_descriptions I %i00N+$*  6 8 8 8 != > > >    ,n=====rc d}tj|}tddtdddtdd d gd d }|||dS)NaDDocstring summary. This is a longer description of the docstring. It spans across multiple lines. :param arg1: Description of arg1. :type arg1: str. :param arg2: Description of arg2. :type arg2: bool. :returns: int -- description of the return value. :raises: AttributeError, KeyError r1NThis is a longer description of the docstring. It spans across multiple lines.r!r9Description of arg1.r6r&boolDescription of arg2.z'int -- description of the return value.zAttributeError, KeyError)r r%r)r<raisesr*rs r&test_rst_format_typed_args_and_returnsz5DocstringsTest.test_rst_format_typed_args_and_returnss I %i00N+$" e 6 8 8 8 f 6 8 8 8 :)    ,n=====rc d}tj|}tddtdddtdd d gd }|||dS) Na:Docstring summary. This is a longer description of the docstring. It spans across multiple lines. Parameters ---------- param1 : int The first parameter. param2 : str The second parameter. Returns ------- bool True if successful, False otherwise. r1rCr3r4r5r6r8r9r:z)bool True if successful, False otherwise.r;r*rs r(test_numpy_format_typed_args_and_returnsz7DocstringsTest.test_numpy_format_typed_args_and_returnssI" %i00N+$"  6 8 8 8  7 9 9 9 <    ,n=====rc d}tj|}tddtdddtdd d g }|||dS) Na&Docstring summary. This is a longer description of the docstring. It spans across multiple lines. Parameters ---------- param1 : int The first parameter. param2 : str The second parameter. This has a lot of text, enough to cover two lines. r1rCr3r4r5r6r8r9r?r@r*rs r+test_numpy_format_multiline_arg_descriptionz:DocstringsTest.test_numpy_format_multiline_arg_descriptions I %i00N+$"  6 8 8 8 != > > >    ,n=====rcd}tj|}tdd}|||dS)NzDocstring summary. This is the first section of a docstring description. This is the second section of a docstring description. This docstring description has just two sections. r1zThis is the first section of a docstring description. This is the second section of a docstring description. This docstring description has just two sections.)r r%r rs rtest_multisection_docstringz*DocstringsTest.test_multisection_docstringsWI %i00N+$- ,n=====rchd}tj|}|d|jdS)NztInspired by requests HTTPAdapter docstring. :param x: Simple param. Usage: >>> import requests z+Inspired by requests HTTPAdapter docstring.)rr rr )rrrs r)test_google_section_with_blank_first_linez8DocstringsTest.test_google_section_with_blank_first_linesFI %i00NB#+-----rc2d}tj|dS)NzDocstring summary. args: raises :: : pathological docstrings should not fail, and ideally should behave reasonably. )rr )rrs rtest_ill_formed_docstringz(DocstringsTest.test_ill_formed_docstring%s"IYrcdgd}dg}||tj|dS)N)  foo rTrU)rr_strip_blank_lines)rlinesexpected_outputs rtest_strip_blank_linesz%DocstringsTest.test_strip_blank_lines/s; % % %E kO_j&CE&J&JKKKKKrc d}tj|}tddtdddtddd td d dg }|||dS) Nz Greets name. Arguments --------- name : str name, default : World arg2 : int arg2, default:None arg3 : bool z Greets name.r$r9zname, default : Worldr6r&r4zarg2, default:Nonearg3rEr@r*rs rtest_numpy_colon_in_descriptionz.DocstringsTest.test_numpy_colon_in_description5s  I %i00N+ e 7 9 9 9 e 4 6 6 6 f$ ? ? ?      ,n=====rc d}tj|}tdtdddt ddd t d dd g }|||dS) NzDocstring summary. :param arg1: Description of arg1. :type arg1: str. :key arg2: Description of arg2. :type arg2: bool. :key arg3: Description of arg3. :type arg3: str. r1r!r9rDr6r&rErFr[zDescription of arg3.r()rr r r+ KwargInforrs r%test_rst_format_typed_args_and_kwargsz4DocstringsTest.test_rst_format_typed_args_and_kwargsOsI %i00N+$ e 6 8 8 8 6"8 : : : 6"8 : : :      ,n=====rN)__name__ __module__ __qualname__rrrrrr,r/r=rArHrJrLrNrPrRrYr\r_rrrrs&>>>>>> > > > > > > > > >>>>" > > >>>>8>>>4>>>: > > >D>>>:>>>& - - -   LLL >>>4>>>>>rr__main__N) __doc__firerrr r+r^ BaseTestCaserr`mainrcrrris('(    J>J>J>J>J>Y+J>J>J>Z  z).r