lKjR ddlZddlZddlmZmZddlmZddlmZddl m Z ddl m Z m Z mZmZddlmZmZmZddlmZdd lmZdd lmZmZdd lmZdd lmZdd lm Z ddl!m"Z"m#Z#ddl$m%Z%m&Z&m'Z'm(Z(m)Z)e rddl*m+Z+ddl,m-Z-m.Z.ddlm/Z/edde0dzde0fdZ1dZ2de dzde fdZ3e&dGddZ4eGd d!Z5d"d#de6e7e7ffd$Z8d"d#de6e7e7ffd%Z9 d:d&d'd(ee0d)ed'dzfd*Z:d+ee0de0fd,Z;d&d'de0de e#zfd-Ze?d1d.d/de0d2e?e@dee4fd3ZAd.d/de0de4fd4ZBd5d6d"d#de0de5fd7ZCd8ede0de7e4fd9ZDy);N)IterableSequence)Enum) lru_cache)Path) TYPE_CHECKINGAny ForwardRefLiteral)defineevolvefield)resolve_annotated is_short_flag)_get_root_module_name%_iter_resolution_argument_collections)get_field_infos)Group) InlineText)SILENT SilentRich) SortHelperfrozenis_class_and_subclassresolve_callables slice_to_str)RenderableType)ArgumentArgumentCollection)App)maxsizedocformatc:ddl}|s|jdStj|}|j dd}|dj dd}t |dk(r|}n |dz|dz}|j|}|jr|jsJ|S)zUAddon to :func:`docstring_parser.parse` that supports multi-line `short_description`.rNz   ) docstring_parserparseinspectcleandocsplitreplacelenlong_descriptionshort_description)r$r%r+ cleaned_doc%short_description_and_maybe_remaindershortress c/Users/ahmed/devFolder/Ultron/claude-voice/.venv/lib/python3.12/site-packages/cyclopts/help/help.pydocstring_parser9 s %%b))""3'K,7,=,=fa,H) 2! 4 < CkkEKKN55c:u.3kkEKKNr ".  " .@@-?AGG-?@DL% % As A%C *C)rbrcrdrer rhrrDrUr listrrrGr`r|rrHr:r8rlrls`4 * ++ @(K %T2GT)_2B&&r:rlargument_collectionr cDgg}}|D]}|js|jj|jjfvr|j |O|jj sf|j r|j ||j |||fS)aCategorize keyword arguments by requirement status for usage string formatting. Parameters ---------- argument_collection : ArgumentCollection Collection of arguments to categorize. Returns ------- tuple[list, list] (required_keyword, optional_keyword) where: - required_keyword: Required keyword-only parameters - optional_keyword: Optional keyword-only parameters and VAR_KEYWORD )show field_infokind VAR_KEYWORDrwis_keyword_onlyrVrrVoptionalarguments r8_categorize_keyword_argumentsrsRhH'}}     # #(;(;(G(G'I I OOH %  0 0  ))( X r:cgg}}|D]}|js|jj|jjk(r0|jr|j |[|j |m|jj s|jr|j ||j |||fS)aCategorize positional arguments by requirement status for usage string formatting. Parameters ---------- argument_collection : ArgumentCollection Collection of arguments to categorize. Returns ------- tuple[list, list] (required_positional, optional_positional) where: - required_positional: Required positional and VAR_POSITIONAL parameters - optional_positional: Optional positional and VAR_POSITIONAL parameters )rrrVAR_POSITIONALrVrw is_positionalrs r8 _categorize_positional_argumentsrsRhH'}}     # #x':':'I'I I  ))  . .  ))( X r:appr! command_chainexecution_pathcvddlm}ddlm}g}|sPjrDj s8t tjdj}|dk(r t}|}njd}|j||j||D]}| hjjtfdDr|jdg} g} g} g} t!|dD]e\} }t#|\}}t%|\}}| j|| j|| j|| j|g| D]D}|j}||j&j)}|j|d |F| r|jd | D]}|j*j,|j*j.k(r>|jj1d j)}|j|d n|jj1d j)}|j|| r7td | D}|r|jdn|jd|d j3|dzdS)Nrr<) get_hint_namez __main__.pyc3dK|]'}|vxrj|dj)yw)T) recurse_metaN) _get_itemr).0rrhelp_version_flagss r8 zformat_usage..s6 a]`XY1& & S3===+N+S+S S]`s-0COMMANDF) fallback_appparse_docstringr*z [OPTIONS]r~z...c3vK|]1}|jj|jjk(3ywrC)rrr)rargs r8rzformat_usage..Cs.! LdSCNN  3>>#@#@ @Lds79z [ARGS...]z[ARGS]r)bold)style)r>r=cyclopts.annotationsrdefault_command_namersysargvnamerrwextend help_flags version_flagsanyrrrhintupperrrrlstripjoin)rrrr=rusagerapp_namermrequired_keyword_paramsoptional_keyword_paramsrequired_positional_argsoptional_positional_args_rrkwokwrposoposr param_name type_namearg_namehas_var_positionalrs` @r8 format_usagersx 2 E S00CHHQK %% = (*D88A; LL LL 'l!?3>>>C,=,=> a]` aa Y %'$&%'%'"GS%# 11DES56IJ d&&s+&&s+ ''- ''-#,]] !(--0668  |1YK01,  [!,    # #x':':'I'I I}}++C0668H LLH:S) *}}++C0668H LL " -  ! Ld!    LL % LL " $&f 55r:stringsc|sy|dg}|ddD]<}|djdr|j|)|jd|z>dj|S)zJJoins strings with a space, unless the previous string ended in a newline.r'rr(Nr)r*)endswithrwr)rresultss r8 _smart_joinrNsa aj\F QR[ ":  t $ MM!  MM#' "  776?r:cj|j}|stSt||}g}|jr|j |jdz|j r;|jr|j d|j |j dzt jt||dS)Nr)Tr%force_empty_end) helprr9r3rwr2r from_formatr)rr%raw_doc_stringparsed componentss r8 format_docr]sXXN  ^V 4FJ &22T9:   # #   d #&11D89  ! !+j"9&Z^ __r:rrc|j}|jr|js|yt|tt fry t t|S#t$rYywxYw)uTrue if ``argument`` is ``dict[str, StructuredType]`` eligible for help expansion. Covers pydantic, dataclass, attrs, TypedDict, NamedTuple via the shared ``get_field_infos`` dispatcher. Uses the same indicators as the parser's dict branch in ``Argument.__attrs_post_init__``: ``_accepts_keywords`` is set, ``_lookup`` is empty (no pre-built children — keys are dynamic), and ``_default`` is the value type with structured fields. Also matches when ``_default`` is a string/``ForwardRef`` — an unresolved self-reference from something like ``dict[str, "Node"]``. We can't walk into it, but we treat it as assumed-structured so the expansion still renders a ``.{NAME}`` layer before terminating. FT) _default_accepts_keywords_lookup isinstancergr rjr Exception)rr[s r8_is_dynamic_structured_dictrpsaG  & &x/?/?GDW'C,-OG,-- sA A A rxrxc #$Kddlm}ddlm}ddlm}|j }t|jtfd|jD}t|ttf}t||v} | s|s|s?t||} |r,td| j D} t#| | y| y|t|hz} |d |j$||j&|j( } |D]}|j*| d ||d f it-j.t-j0d}|j3dD]2}t5|rt7||| Ed{%t||4y7w)aWYield help entries for every leaf field of a ``dict[str, StructuredType]``. Reuses :meth:`ArgumentCollection._from_type_preview` so synthesized entries carry the full metadata (choices, defaults, env_var, required propagation, ``Parameter.help`` precedence, ``name_transform``) that the normal per-argument path produces. r)r ) FieldInfo) Parameterc3DK|]}|vst|r|ywrCr)ro negativess r8rz3_expand_structured_dict_for_help..s"f1!9:LUbcdUeQs   c3&K|] }|d yw).{NAME}NrH)rns r8rz3_expand_structured_dict_for_help..s"P?O*~%H?*: &1 ""PD! %%4%0D*40;D&xXXX&tV44 1"YsE2F5F6Fc |jjsJt|j}t }|Dcgc]}||vs|j |r|}}|j Btd|D|d}|jdj}||dk7r|g|}t |j}|Dcgc]}||vst|r|} }|Dcgc]}||vst|s|} }|Dcgc]}||vst|r|} }|Dcgc]}||vst|s|} }tj|jj|} |j}d}|jj r5|jj"rt%|jj"}d}t'|j(t*r|j(}n|j(r|j,j.}t1|j2t4r'|jj|j6}n`t'|tt$tt8frg}|D]}t'|t4r5|j;|jj|j6Ht'|t*r|j;d|dn|j;t+|t'|t$r2t=|dk(r d|dzd z}ndd j?|zd z}not'|trd d j?|zd z}nGdd j?|zdz}n/t'|t@r tC|}n|dk(rd}n t+|}tE|j(r|j)|}tGt%| t%| t%| t%| | |jHtK|j,jL||| Scc}wcc}wcc}wcc}wcc}w)zBuild a single ``HelpEntry`` for one ``Argument``. Extracted from ``create_parameter_help_panel`` so it can also be applied to synthetic preview arguments (see ``_expand_structured_dict_for_help``). Nc3DK|]}|jds|yw)z--N)r)rrs r8rz#_make_help_entry..sF11<<3EQs  rr~r%'r((z,)z, )[]{}r'z"") rIrJrKrLrUrVrXrYrZr[)'rnname_transformrrPrurvindexnextrrrrrrr get_choices show_env_varrZrfr show_defaultrgrr[rrrr frozensetrwr1rslicercallablerGrVrr)rr%optionsrxr label_sourcerrrrIrJrKrLhelp_descriptionrYrZr[ default_valformatted_itemsrzs r8rrs    , ,, ,8>>"GUD!G'QQd]488A;q'GG~~!FFPQ S &&s+113 wqz !*'*GH&&'I!(XAAY,>}UVGWaNX")U'QQi-?MRSDTq'OU!(TAAN=QRCSaNT")Q'QQ)^ a@Pq'OQ!--h.@.@.E.EfU""$GG&&8+=+=+E+E**223G(''-''   ))11  5((77 8H8HIG  dE3 %B C O#dD)#**8+=+=+L+LTYY+WXc*#**QtfA;7#**3t95 $+u-'1,!OA$66=G!DIIo$>>DGK. / ::S@ / ::S@  U +";/G B G+&G H)) *++K8G ^,o.^,o.$"" x22== >  qHYUTQsY P=P=P= Q QQ% Q/ Q;Q Q  Q Q % Q/ Q;Qgrouprc(ddlm}d|j|jr"t j |j|dn|d}t di|}gg}}|jdD]n}t|r|jt||*t||} |jjr|j| ^|j| p|jj||jj||S) Nrr<rnTr)r%rorUrrH)r>r=rrrrrlrrrrrrrrwrr) rrr%r=r_ help_panelentries_positional entries_kwrrs r8create_parameter_help_panelr"s  ::"--ejjY]^ V F$V$J%' '11t1< &x 0   >xP Q  62    , ,  % %e ,   e $=01j) r:apps_with_namesc g}|D]}|j}|js|j}gg}}|D]/}t|r|j |n|j |1t |j |} tt|t|tjt|j|j|| } | |vs|j | |S)a,Format command entries for help display. Parameters ---------- apps_with_names : Iterable[RegisteredCommand] Iterable of RegisteredCommand tuples. format : str Help text format. Returns ------- list[HelpEntry] List of formatted help entries. r)rIrJrUrW)rrrPrrwrrWrGrfrrr9rr3) r#r%rrregistered_commandrrP short_names long_namesrrWrs r8format_command_entriesr(>sG- $$xx "(("$bZ D(5d(;K  t $ARARSWAX%S\\37 ,!+."..sxx/P/b/bkqr     NN5 !'.( Nr:rC)Er-rcollections.abcrrenumr functoolsrpathlibrtypingrr r r attrsr r rrrcyclopts.argument.utilsr cyclopts.corerrrrcyclopts.grouprcyclopts.help.inline_textrcyclopts.help.silentrrcyclopts.utilsrrrrr rich.consolerrrr r!rgr9r?rDrGrlrfrrrrrrrjrrintrrr"r(rHr:r8r7s8 .('21V/ 03ee+>! 2tS6 #* 7&7&7&t6&6&6&r7KPUVZ\`V`Pa@ :N SXY]_cYcSd L.2K6 K6C=K6UOd*K6\ # 3 `E`3`: +B`&*:%; ?5?5 ?5 C. ?5 i ?5DNzN3N9Nb -  D$H$c$d9o$r: