o ia(@sndZddlZddlmZmZmZddlmZddlm Z er.ddl m Z m Z ddl mZmZGdd d ZdS) z)reStructuredText documentation formatter.N) TYPE_CHECKINGAnyOptional) extract_text)make_rst_section_header)ConsoleConsoleOptions) HelpEntry HelpPanelc@seZdZdZ  d"dedefddZd#d d Zdefd d Z de dde ddddd fddZ de dde ddd fddZ de dde ddd fddZde dde ddedd fddZde dde ddedd fd d!Zd S)$ RstFormatterareStructuredText documentation formatter. Parameters ---------- heading_level : int Starting heading level for panels (default: 2). include_hidden : bool Include hidden commands/parameters in documentation (default: False). F heading_levelinclude_hiddencCs||_||_t|_dSN)r rioStringIO_output)selfr rrb/var/www/html/karishye-ai-python/venv/lib/python3.10/site-packages/cyclopts/help/formatters/rst.py__init__szRstFormatter.__init__returnNcCst|_dS)z!Reset the internal output buffer.N)rrrrrrrreset#szRstFormatter.resetcCs |jS)zGet the accumulated RST output. Returns ------- str The RST documentation string. )rgetvaluerrrr get_output's zRstFormatter.get_outputconsoleroptionsrpanelr cCs|jsdS|jr t|j|}dt||j}|j|d|jr4t|j|}|r4|j|d|j dkrA| |j|n |j dkrM| |j||jddS)a]Format and render a help panel as RST. Parameters ---------- console : Optional[Console] Console for rendering (used for extracting plain text). options : Optional[ConsoleOptions] Console rendering options (unused for RST). panel : HelpPanel Help panel to render. N  command parameter) entriestitlerjoinrr rwrite descriptionformat_format_command_panel_format_parameter_panel)rrrr title_textheader desc_textrrr__call__1s    zRstFormatter.__call__r#r c Cs|D]\}g}|jr||j|jr||j|r^|d}|jd|dt|jdo|z5RstFormatter._format_command_panel..r r N) namesextendshortsrr&hasattrr'r1r2__name__rr%split) rr#rentryr@ primary_namepreserve_rst_markupdescr-rrrr)Ys(     z"RstFormatter._format_command_panelcCs|D]k}g}|jr||j|jr||j|rn|jo-|jduo-tdd|D }|rFdd|D}|r?|dn|d}nd|}|j d|d g}t |j d okt |j j d okd |j j j jv} t|j || d } | r{|| g} |r|jr| dn |jr|s| d|jrddd|jD} | d| |jdurt|j|dd } |jr dt|jvr d}d}|D]}|dr|}q|dr|s|}q| dkr|r| d|dn'| dkr|r| d|dn| d| dn | d| d|jr,ddd|jD}| d||r^ddd|ddD}|j d|| rW|j dd| d|j d q| rn|j dd| d qdS)!zFormat parameter entries as RST. Parameters ---------- entries : list[HelpEntry] Parameter entries to format. console : Optional[Console] Console for text extraction. Ncss|]}|dVqdS)-N startswithr;nrrrr=sz7RstFormatter._format_parameter_panel..cSsg|] }|ds|qS)rJrKrMrrr sz8RstFormatter._format_parameter_panel..rz, r/r0r1r2r3r4z **Required**cs|] }d|dVqdSr/Nr)r;crrrr=z Choices: Fboolz--no-z--truez Default: ``falsecsrPrQr)r;errrr=rSzEnvironment variable: r6csr7rr8r:rrrr=r>rr?z []r )r@rArBrequireddefaultanyupperr%rr&rCr'r1r2rDrappendchoicestypestrrLlowerenv_varrE)rr#rrFr@ is_positionalpositional_namesname_str desc_partsrHrImetadata choices_str default_str positive_flag negative_flagnameenv_strr-rrrr*sz   $           z$RstFormatter._format_parameter_panelusagecCsZ|r)t||}|r+|jd|dD] }|jd|dq|jddSdSdS)a-Render the usage line as RST. Parameters ---------- console : Optional[Console] Console for text extraction. options : Optional[ConsoleOptions] Console rendering options (unused). usage : Any The usage line content. z:: rr?N)rrr&rE)rrrrn usage_textr<rrr render_usages  zRstFormatter.render_usager'cCs0|rt||}|r|j|ddSdSdS)a5Render the description as RST. Parameters ---------- console : Optional[Console] Console for text extraction. options : Optional[ConsoleOptions] Console rendering options (unused). description : Any The description content. r N)rrr&)rrrr'r-rrrrender_descriptions  zRstFormatter.render_description)r F)rN)rD __module__ __qualname____doc__intrTrrr`rrr.listr)r*rrprqrrrrr sP    (&c r )rtrtypingrrrcyclopts._markupr cyclopts.help.formatters._sharedr rich.consolerr cyclopts.helpr r r rrrrs