o i.@sdZddlZddlmZmZmZmZmZmZddl m Z er.ddl m Z m Z ddlmZmZdedefd d ZGd d d ZdS) z!Markdown documentation formatter.N) TYPE_CHECKINGAnyOptionalUnionget_args get_origin) extract_text)ConsoleConsoleOptions) HelpEntry HelpPaneltype_objreturncCsd|durdSt|tr3|}|dddd}|dd}d|vr1||dd|d }|S|St|}|drB|d d }t|}|tur~t|}t |d krnt d|vrn|dt durf|d n|d}t |Sdd|D}dd |d S|rt|}t |dt|}|rdd|D}|dd |d S|St|dr|jS|dd}|S)alFormat a type object into a readable string. Parameters ---------- type_obj : Any Type object to format. Returns ------- str Formatted type name. Examples -------- >>> _format_type_name(str) 'str' >>> _format_type_name(Optional[int]) 'int' >>> _format_type_name(list[str]) 'list[str]' Nzztyping.z Optional[[]rcSg|]}t|qS_format_type_name.0argrrg/var/www/html/karishye-ai-python/venv/lib/python3.10/site-packages/cyclopts/help/formatters/markdown.py Fz%_format_type_name..zUnion[, __name__cSrrrrrrrrMr) isinstancestrreplaceindexrindex startswithrrrlentyperjoingetattrhasattrr!)r type_strinneroriginargsnon_noneformatted_args origin_namerrrrs@       rc@seZdZdZ   d$dededefdd Zd%d d Zd efddZ de dde dddd d fddZ de dde dd d fddZ de dde dd d fddZde dde dded d fdd Zde dde dd!ed d fd"d#Zd S)&MarkdownFormatteraMarkdown documentation formatter. Parameters ---------- heading_level : int Starting heading level for panels (default: 2). E.g., 2 produces "## Commands", 3 produces "### Commands". table_style : str Style for parameter/command tables: "table" or "list" (default: "table"). include_hidden : bool Include hidden commands/parameters in documentation (default: False). rtableF heading_level table_styleinclude_hiddencCs ||_||_||_t|_dS)N)r6r7r8ioStringIO_output)selfr6r7r8rrr__init__iszMarkdownFormatter.__init__rNcCst|_dS)z!Reset the internal output buffer.N)r9r:r;r<rrrresettszMarkdownFormatter.resetcCs |jS)zGet the accumulated markdown output. Returns ------- str The markdown documentation string. )r;getvaluer>rrr get_outputxs zMarkdownFormatter.get_outputconsoler optionsr panelr cCs|jsdS|jrt|j|}d|j}|j|d|d|jr3t|j|}|r3|j|d|jdkr@||j|n |jdkrL| |j||jddS)agFormat and render a help panel as markdown. Parameters ---------- console : Optional[Console] Console for rendering (used for extracting plain text). options : Optional[ConsoleOptions] Console rendering options (unused for markdown). panel : HelpPanel Help panel to render. N#  command parameter ) entriestitlerr6r;write descriptionformat_format_command_panel_format_parameter_panel)r<rBrCrD title_textheading desc_textrrr__call__s     zMarkdownFormatter.__call__rKr cCs|D]A}g}|jr||j|jr||j|rC|d}t|j|}|r3|jd|d|n |jd|d|jdqdS)zFormat command entries as markdown. Parameters ---------- entries : list[HelpEntry] Command entries to format. console : Optional[Console] Console for text extraction. r* ``: z`:rJN)namesextendshortsrrNr;rM)r<rKrBentryrX primary_namedescrrrrPs     z'MarkdownFormatter._format_command_panelcCsp|D]2}g}|jr||j|jr||j|r5|jo#|jdu}|r.rrcss&|]}|do|d VqdS)r^--Nr_r`rrr s$z.cSs$g|]}|dr|ds|qS)r^rcr_r`rrrrs$cSsg|] }|dr|qS)rcr_r`rrrrrbr rVrWFTz choices: zenv: boolz--no-rctruez default: falsez **[required]**z *[z]*rJ)rXrYrZrequireddefaultupperr(anyr*r;rMrrNchoicesappendenv_varr)rr'lower)r<rKrBr[rX is_positionalpositional_namesname_str short_opts long_optsr] is_requiredmetadata choices_strenv_str default_str positive_flag negative_flagnameitemrrrrQsv                 z)MarkdownFormatter._format_parameter_panelusagecCs2|rt||}|r|jd|ddSdSdS)a2Render the usage line as markdown. Parameters ---------- console : Optional[Console] Console for text extraction. options : Optional[ConsoleOptions] Console rendering options (unused). usage : Any The usage line content. z``` z ``` Nrr;rM)r<rBrCr~ usage_textrrr render_usage-s  zMarkdownFormatter.render_usagerNcCs0|rt||}|r|j|ddSdSdS)a:Render the description as markdown. Parameters ---------- console : Optional[Console] Console for text extraction. options : Optional[ConsoleOptions] Console rendering options (unused). description : Any The description content. rGNr)r<rBrCrNrTrrrrender_descriptionCs  z$MarkdownFormatter.render_description)rr5F)rN)r! __module__ __qualname____doc__intr#rer=r?rArrUlistrPrQrrrrrrrr4[sV   (d r4)rr9typingrrrrrrcyclopts._markupr rich.consoler r cyclopts.helpr r r#rr4rrrrs  M