k7iSrSSKJr SSKJr SSKJr SSKJrJ r J r SSK J r SSK Jr SSKJr SS KJr S r\ "\S 9r\R*"\"S S 9S9SSSSS.S\S\\S-\"S\S94S\\ S-\"S\S94S\S\4 Sjjj5rg)z1Generate documentation for Cyclopts applications.)Path) Annotated)app)FORMAT_ALIASES DocFormatnormalize_format)Group)load_app_from_script) Parameter)UNSETc URS5nURS5nUR[LGa:UR[La [S5eUR(a[ URS5(d [S5eURR R 5nU(d [S5eURS5nU(d [S5e[R"U5nUcl[R"5Vs/sHn[U5S ::dMSU3PM nn[S US S R[[U555S 35eXQlggs snf)Nz--formatz--outputz>"--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.z+Cannot infer format from output extension "z". Supported extensions: z, z'. Please specify "--format" explicitly.)getvaluer ValueErrorhasattrrlowerlstriprkeyslenjoinsortedset)argument_collection format_arg output_argr suffix_keyinferred_formatextsupported_extensionss K/home/james-whalen/.local/lib/python3.13/site-packages/cyclopts/cli/docs.py_format_group_validatorr$sh$((4J$((4J5   u $]^ ^wz/?/?'J'Jab b!!((..0_  ]]3' 8  ),,Z8  "9G9L9L9N#`9N#RUVYRZ^_R_IauI9N #`=fXF))-6#>R:S3T)U(VW89  +E!6$as E2, E2) validator)negative)default_parameterNF)formatinclude_hidden heading_levelscriptoutputz-o)aliasgroupr*z-fr+r,cUc [S5e[U5n[U5upVURUUUS9nU(aUR U5 g[ U5 g)adGenerate 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_contents r#r3r3>sd<~/00 f %F%f-JG((%#)L ,' l)N)__doc__pathlibrtypingr cyclopts.clircyclopts.docs.typesrrrcyclopts.groupr cyclopts.loaderr cyclopts.parameterr cyclopts.utilsr r$ format_groupcommandstrboolintr3r9r#rIs7 !0( &+R67 y"56QU*  * * dTk94|#LL M* DL1 3  ***7*r9