-Ph+dZddlZddlZddlmZddlmZddlmZm Z ddl m Z ddl m Z mZdd lmZmZmZdd ed e eedfd efd Zd ed efdZd ejfdZdde eedfd efdZdS)zThe CLI for numpydoc.N)Sequence)Path)ListUnion)get_doc_object)utilsvalidate_docstrings) ERROR_MSGS Validatorvalidate import_pathconfigreturnctttj|t |pgdS)z6Test numpydoc docstring generation for a given object.)rr)printrr _load_objdict)rrs L/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/numpydoc/cli.py render_objectrs< .,[99$v|QSBTBT U U UVVV 1cd}t|}|dD]/\}}|dz }td|||g0|S)z5Run numpydoc docstring validation for a given object.rerrorsr:)r rjoin)r exit_statusresultserr_codeerr_descs rvalidate_objectr saK{##G%h/;;(q  chh Xx899:::: rc tjdt}|d}d}|ddd }|d d |d d|dd|t|ddd }|jd d |jttj dg\}}tj |}dttj|dz D}dd|zdz} |dddtj} | dt$d d!"| dt$d#$| d%t$d&d'|rd(t'||z d)| d*nd+"| tj|S),zu Build an argument parser. Returns ------- argparse.ArgumentParser The argument parser. numpydoc)prog description subcommands)titlecd|d\}}}tj|}||fS)N=) partitionast literal_eval)skey_values r _parse_configz!get_parser.._parse_config+s3 C(( Q ''Ezrrenderz2Generate an expanded RST-version of the docstring.z(generate the RST docstring with numpydoc)r$helprze.g. numpy.ndarray)r2z-cz--configappendzbkey=val where val will be parsed by literal_eval, e.g. -c use_plots=True. Multiple -c can be used.)typeactionr2)funcr z=Validate an object's docstring against the numpydoc standard.z1validate the object's docstring and report errors.c4g|]}d|dt|S)z- : )r ).0checks r zget_parser..Js=  *U))j'))rchecksz  lintzIRun numpydoc validation on files with option to ignore individual checks.zAvalidate all docstrings in file(s) using the abstract syntax tree)r$r2formatter_classfiles+z&File(s) to run numpydoc validation on.)r4nargsr2aCPath to a directory containing a pyproject.toml or setup.cfg file. The hook will look for it in the root project directory. If both are present, only pyproject.toml will be used. Options must be placed under - [tool:numpydoc_validation] for setup.cfg files and - [tool.numpydoc_validation] for pyproject.toml files.)r4r2z--ignore*zCheck codes to ignore.z' Currently ignoring the following from r9z^Values provided here will be in addition to the above, unless an alternate config is provided.)argparseArgumentParser__doc__add_subparsers add_parser add_argument set_defaultsrr r find_project_rootr parse_configsetr keysrRawTextHelpFormatterstrrrun_hook) ap subparsersr0r1r project_root_from_cwd config_fileconfig_optionsignored_checksignored_checks_text lint_parsers r get_parserr\s  jg F F FB"""77J  " "H 7#F   ,@AAA   ;  ]+++$$S @%H H-.BCCCCH////).)@#)G)G&;(56KLLN**++nX.FFN!6;;~#>#>>E''_ P 5 (K c+S  I      "*q-..<qq@Sqqqq(*       "5">??? Irargvct}t||} |d}|di|S#t$r-|d|YdSwxYw)zCLI for numpydoc.r6)statusmessageN)r\vars parse_argspopKeyErrorexit format_help)r]rTargsr6s rmainrjws B  d## $ $D4xxt||d|| 444 q".."2"23333334sA3BB)N)rHrFr*collections.abcrpathlibrtypingrrdocscrape_sphinxrhooksr r r r r rRintrr rGr\rjrbrrrqsa $$$$$$,,,,,,--------5555555555  s E$s)T/,B c    UH+UUUUp 4 4uXc]D() 4S 4 4 4 4 4 4r