o i@sdZddlmZddlmZddlmZddlmZm Z m Z ddl m Z ddl mZddlmZdd lmZd d Ze ed Zejed dd ddddddedeedBededfdee dBededfdedef ddZdS)z1Generate documentation for Cyclopts applications.)Path) Annotated)app)FORMAT_ALIASES DocFormatnormalize_format)Group)load_app_from_script) Parameter)UNSETc Cs|d}|d}|jture|jturtd|jr!t|jds%td|jj}|s1td|d}|s"--format" must be specified when output path is not provided.suffixzB"--output" must be a valid file path when format is not specified.zOutput file must have an extension to infer format (e.g., .md, .html, .rst). Please specify "--format" explicitly or add an extension to the output file..zwInvalid file extension. Output file must have a valid extension after the period. Please specify "--format" explicitly.cSs"g|] }t|dkrd|qS)r )len).0extrW/var/www/html/karishye-ai-python/venv/lib/python3.10/site-packages/cyclopts/cli/docs.py 1s"z+_format_group_validator..z+Cannot infer format from output extension "z". Supported extensions: z, z'. Please specify "--format" explicitly.) getvaluer ValueErrorhasattrr lowerlstriprkeysjoinsortedset)argument_collection format_arg output_argr suffix_keyinferred_formatsupported_extensionsrrr_format_group_validators6        r%) validator)negative)default_parameterNF)formatinclude_hidden heading_levelscriptoutputz-o)aliasgroupr+z-fr,r-cCsR|durtdt|}t|\}}|j|||d}|r#||dSt|dS)aGenerate documentation for a Cyclopts application. Parameters ---------- script : str Python script path, optionally with ``':app_object'`` notation to specify the App object. If not specified, will search for App objects in the script's global namespace. output : Optional[Path] Output file path. If not specified, prints to stdout. format : Optional[DocFormat] Output format for documentation. If not specified, inferred from output file extension. include_hidden : bool Include hidden commands in documentation. heading_level : int Starting heading level for markdown format. NzMust specify format.) output_formatr,r-)rrr generate_docs write_textprint)r.r/r+r,r-app_obj_ docs_contentrrrr3>s  r3)N)__doc__pathlibrtypingr cyclopts.clircyclopts.docs.typesrrrcyclopts.grouprcyclopts.loaderr cyclopts.parameterr cyclopts.utilsr r% format_groupcommandstrboolintr3rrrrs@        )