!z.DirectiveOptions.from_dict..es2-e-e-ecY\YbYbYdYd-eciikk-e-e-e,r9)attrsfieldsr&replacetypeboolsplit)clsr4kwargsfield option_namevalues r( from_dictzDirectiveOptions.from_dictQs\#&& / /E*,,S#66KzT!!')))-F5:&'' ,:!AAA0-e-eU[[QTEUEU-e-e-euz**.0uz**).F5:&s}}V}}r>cNtsiSddlm}t|jt |jt|ji}i}tj tD]S}|j dd}|j dvr|j}n ||j|j}|||<T|S)z9Generate Sphinx option_spec from DirectiveOptions fields.r) directivesrr6r7)SPHINX_AVAILABLEdocutils.parsers.rstrMrDflagintnonnegative_intstr unchangedr@rAr,r&rBgetrC)rM type_mapping option_specrHrI validators r(speczDirectiveOptions.specos  I333333 */ + %  \"233 1 1E*,,S#66Kz===&0 (,,UZ9MNN '0K $ $r>)__name__ __module__ __qualname____doc__r.rQ__annotations__r/listrSr0r1rDr2r3 classmethoddictrK staticmethodrrYr9r>r(r,r,Ds33M3!%Hd3i$%%%)-d3i$&---L$ ND   "d""");[:$sCx.\r>r, command_name command_pathcommands_filterr0cd||gz}|rP||vs||vrdStt|D])}d|d|dz}||vrdS*|Z||vs||vrdStt|D])}d|d|dz}||vrdS*|s||vrdSdSdS)aCheck if a command should be included in documentation. Parameters ---------- command_name : str The name of the command. command_path : list[str] The full path to the command (including parent commands). commands_filter : list[str] | None If specified, only include commands in this list. exclude_commands : list[str] | None If specified, exclude commands in this list. Returns ------- bool True if the command should be included. .FNrT)joinrangelen)rcrdrer0 full_pathi parent_paths r(_should_include_commandrns42677I + + +yr/rmct|g}i}|D]\}}t||||r|||<|S)aFilter commands based on inclusion/exclusion lists. Parameters ---------- commands : dict Dictionary mapping command names to App instances. commands_filter : Optional[List[str]] If specified, only include commands in this list. exclude_commands : Optional[List[str]] If specified, exclude commands in this list. parent_path : List[str] Path to the parent command for nested commands. Returns ------- dict Filtered commands dictionary. )itemsrn)r/rer0rmfilteredr&rs r(_filter_commandsrrsW0 H^^%%!! c "4oGW X X ! HTN Or>content skip_titlec`|}g}d}|t|kr||}|rj|dkrd|rP|dzt|kr:||dz}|rt|hdkr|dz }|dr|dz }|t|krl||rR||ddvrB|dz }|t|kr*||r||ddvB|t|kr||s|dz }g|||dz }|t|k|S)z3Process RST content to remove problematic elements.rr>"r6=^~r-z .. contents::z ) splitlinesrjr:setr!append)rsrtlines processedrlline next_lines r(_process_rst_contentrs    EI A c%jj..Qx  !q&&TZZ\\&a!ec%jj6H6Ha!e **,,I S^^/H/H/HHHQ ::<< " "? 3 3  FAc%jj..U1X^^%5%5.%(1+:N:NQc%jj..U1X^^%5%5.%(1+:N:N3u::~~eAhnn&6&6~Q  Q) c%jj.., r>r}state nodes.Nodec tsgSddlm}ddlm}g}d}|t |kr||}|dzt |kr||dz}|rhtd|DrN|j}|} | dd dd g|d <||j | z }g} |d z }|t |kr|dzt |kr||dznd } | rtd| Drn3| |||dz }|t |k| r | || d|| ||dkrg|dz }|t |kr||s|dz }g} |t |krq||drV| ||dd|dz }|t |kr||dV| rt|j} d| | _| |jd| | | |t |kr||s|dz };|rz|g} |dz }|t |kr |dzt |kr||dznd }|rtd|Drn||dkrn||sO| |||dz }|t |ks||sn5n | |||dz }|t |k |j}| || d||jr||jn|dz }|t |k|S)z$Create section nodes from RST lines.rr) StringListrc3"K|] }|dkV dSr6Nr9r;cs r( z(_create_section_nodes..s& = =ac = = = = = =r> r6z cyclopts-z cli-cyclopts-idstextr-c3"K|] }|dkV dSrr9rs r(rz(_create_section_nodes..%s&1W1Wq!s(1W1W1W1W1W1Wr>z::z N c3"K|] }|dkV dSrr9rs r(rz(_create_section_nodes..Vs&$A$A!Q#X$A$A$A$A$A$Ar>)rNdocutilsrdocutils.statemachinerrjr:allsectionlowerrBtitler| nested_parser! literal_blockrh rawsourceText paragraphchildrenextend)r}rrrresultrlrrr title_text content_linesnext_line_strippedliteral_contentrparas r(_create_section_nodesrs   000000 F A c%jj..Qx q53u::  a!e **,,I S = =9 = = === '%-//!ZZ\\ ","2"2"4"4"<">##t++Qx~~'' !((q222FACJJeAhnn.>.>'"((q222FA+c%jj..0#5?$$D   zz-88!T B B B} - dm,,, FA c%jj..B Mr>ceZdZdZdZdZdZdZe Z de dfdZ de d ede fd Zd e d ede dfd Zd e de dfdZdS)CycloptsDirectivez;Sphinx directive for documenting Cyclopts CLI applications.Frrr rctsgS|jd}t|j} |||}|||S#tttf$r"}| d|cYd}~Sd}~wt$r"}| d|cYd}~Sd}~wwxYw)z2Generate documentation nodes for the Cyclopts app.rz)Error generating Cyclopts documentation: NzUnexpected error: ) rN argumentsr,rKr4_generate_documentation _create_nodesrrr _error_node Exception)selfr opts rst_contentr%s r(runzCycloptsDirective.run~s InQ' ))$,77 >66{DIIK%%k488 8^Y7 U U U##$SPQ$S$STT T T T T T T > > >##$<$<$<== = = = = = = >s/+A##C:BC C$C;CCr rc ddlm}t|}|||j |j|j|j|j|jdS)z'Generate RST documentation for the app.r)generate_rst_docsT) recursiver2r.r3rer0 no_root_title) cyclopts.docs.rstrr)r1r2r.r3r/r0)rr rrrs r(rz)CycloptsDirective._generate_documentationsi777777+&&! ++.,!2 M!2    r>rc`tsgSt|d}t||jS)z'Create docutils nodes from RST content.F)rt)rNrrr)rrrr}s r(rzCycloptsDirective._create_nodess5 I$[UCCC%UDJ777r>messagectsgSddlm}trt||jd|j|gS)z,Create an error node with the given message.rrrr)rNrrloggererrorr)rrrs r(rzCycloptsDirective._error_nodesa I""""""  " LL ! ! ! BW = = =>>??r>N)rZr[r\r] has_contentrequired_argumentsoptional_argumentsfinal_argument_whitespacer,rYrWr_rrSrrrr9r>r(rrusEEK %"''))K>T,'>>>>  3 >N SV    $884D8lI[8888 @3 @4 += @ @ @ @ @ @r>rrrcRtr|dtddddS)z(Setup function for the Sphinx extension.rz1.0.0T)versionparallel_read_safeparallel_write_safe)rN add_directiver)rs r(setuprs99 *&7888"#  r>)N)F)#r]rtypingrrr@rrsphinx.applicationrsphinx.util.docutilsrrr sphinx.utilr getLoggerrZrrNrobjectrSr)definer,r_rDrnrarrrrrrr9r>r(rs/@@%%%%%%%% ))))))444444 ))))))######444444 W x ( (F   #tS#tU#t#t#t#tLdBBBBBBBBJ77s)7#Y%73i$& 7  7777|%)   #Y% 3i$& cT!      F#4DI>lcl3l4 ;Mllll^>@>@>@>@>@>@>@>@BxDcNs*A A)(A)