|h/dZddlmZddlmZejZej Zej ZGddejZe dk(rejyy)z!Tests for fire docstrings module.) docstrings) testutilscxeZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z d Zd ZdZdZdZdZdZy)DocstringsTestcnd}tj|}td}|j||y)NA simple one line docstring.summaryrparse DocstringInfo assertEqualself docstringdocstring_infoexpected_docstring_infos S/var/www/html/test/engine/venv/lib/python3.12/site-packages/fire/docstrings_test.pytest_one_line_simplez#DocstringsTest.test_one_line_simples82I%%i0N+. ,n=cnd}tj|}td}|j||y)Nz( A simple one line docstring. rr r rs rtest_one_line_simple_whitespacez.DocstringsTest.test_one_line_simple_whitespace%s<I %%i0N+. ,n=rcnd}tj|}td}|j||y)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/s>I %%i0N+  ,n=rcnd}tj|}td}|j||y)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<s>I %%i0N+; ,n=rcnd}tj|}td}|j||y)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_whitespaceIs>I %%i0N+; ,n=rcd}tj|}tdtddtddg}|j ||y) 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_onlyUsWI  %%i0N+' -? @ -? @  ,n=rcd}tj|}ttddg}|j ||y)Nz+ Args: args: arg_description r)arg_descriptionr#)r)r*rs r!test_google_format_arg_named_argsz0DocstringsTest.test_google_format_arg_named_argsfsII %%i0N+ -> ?   ,n=rc d}tj|}tddtdddtdd d gd }|j ||y) 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_returnsssl I %%i0N+$*  6 8  7 9 M  ,n=rc d}tj|}tddtdddtdd d g }|j ||y) 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_descriptionsh I %%i0N+$*  6 8 != >  ,n=rc d}tj|}tddtdddtdd d gd d }|j ||y)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_returnssn I %%i0N+$" e 6 8 f 6 8 :)  ,n=rc d}tj|}tddtdddtdd d gd }|j ||y) 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_returnsskI" %%i0N+$"  6 8  7 9 <  ,n=rc d}tj|}tddtdddtdd d g }|j ||y) 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_descriptionsh I %%i0N+$"  6 8 != >  ,n=rcpd}tj|}tdd}|j||y)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_docstringsAI %%i0N+$- ,n=rcjd}tj|}|jd|jy)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_lines5I %%i0NB#++-rc2d}tj|y)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%sIYrc\gd}dg}|j|tj|y)N)  foo rTrU)rr_strip_blank_lines)rlinesexpected_outputs rtest_strip_blank_linesz%DocstringsTest.test_strip_blank_lines/s) %E kO_j&C&CE&JKrc d}tj|}tddtdddtddd td d dg }|j ||y) 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_description5sn  I %%i0N+ e 7 9 e 4 6 f$ ?    ,n=rc d}tj|}tdtdddt ddd t d dd g }|j ||y) 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_kwargsOsnI %%i0N+$ e 6 8 6"8 : 6"8 :    ,n=rN)__name__ __module__ __qualname__rrrrrr,r/r=rArHrJrLrNrPrRrYr\r_rrrrs^>> > > >>" >>8>4>: >D>:>& - L >4>rr__main__N) __doc__firerrr r+r^ BaseTestCaserr`mainrcrrrisc(((     J>Y++J>Z  z)..r