
    7 fk                       d Z ddlmZ ddlZddlZddlZddlZddlZddlZddl	Z	ddl
Z
ddlZddlmZ ddlmZmZmZ ddlmZ ddlmZ ddlZddlmZmZ dd	lmZ dd
lmZ ddlmZ ddlm Z m!Z!m"Z"m#Z# ddlm$Z$ ddl%m&Z&m'Z' ddl(m)Z) ddl*m+Z+m,Z, ddl-m.Z.m/Z/ ddl0m1Z1 ddl2m3Z3 erddl4m5Z5m6Z6 ddl7m8Z8 ddl9m:Z: ddl;m<Z<  e+j=        e>          Z? G d d          Z@ G d de          ZAdrd ZBdsdtd%ZC G d& d'          ZDdud*ZE G d+ d,          ZFdvd1ZG	 	 dwdxd=ZHdyd@ZIdzdBZJd{dCZKd|dFZL eM            dGdHd}dOZNd~dQZOddRddVZP	 	 	 	 	 dddbZQddeZR	 dddgZS	 dwddjZTddlZUdddoZVe>dpk    r eVejW        dqd                    dS dS )ax  Generates reST source files for autosummary.

Usable as a library or script to generate automatic RST source files for
items referred to in autosummary:: directives.

Each generated RST file contains a single auto*:: directive which
extracts the docstring of the referred item.

Example Makefile rule::

   generate:
           sphinx-autogen -o source/generated source/*.rst
    )annotationsN)path)TYPE_CHECKINGAny
NamedTuple)TemplateNotFound)SandboxedEnvironment)__display_version__package_dir)Builder)Config)import_module)ImportExceptionGroupget_documenterimport_by_nameimport_ivar_by_name)__)ModuleAnalyzerPycodeError)SphinxComponentRegistry)loggingrst)getallsafe_getattr)	ensuredir)SphinxTemplateLoader)SequenceSet)NullTranslations)Sphinx)
Documenterc                  "    e Zd ZdZddZdd	Zd
S )DummyApplicationz3Dummy Application class for sphinx-autogen command.
translatorr   returnNonec                   t                      | _        t                      | _        g | _        d| _        || _        d| _        d| _        d| _	        | j        
                    di dd            | j        
                    di dd            | j        
                    dddt                     | j                                         d S )	N/r   Fautosummary_contextTautosummary_filename_mapautosummary_ignore_module_allenv)r   configr   registry
messagelogsrcdirr$   	verbosity
_warncountwarningiserroraddboolinit_values)selfr$   s     U/var/www/equiseq/venv/lib/python3.11/site-packages/sphinx/ext/autosummary/generate.py__init__zDummyApplication.__init__@   s    hh/11%'$#-r4>>>2BdCCC7udKKK!!!!!    argsr   c                    d S N )r7   r;   s     r8   emit_firstresultz!DummyApplication.emit_firstresultO   s    r:   N)r$   r   r%   r&   )r;   r   r%   r&   )__name__
__module____qualname____doc__r9   r?   r>   r:   r8   r#   r#   =   sB        ==" " " "     r:   r#   c                  8    e Zd ZU ded<   ded<   ded<   ded<   dS )	AutosummaryEntrystrname
str | Noner   templater5   	recursiveN)r@   rA   rB   __annotations__r>   r:   r8   rE   rE   S   s7         IIIMMMOOOOOr:   rE   appr   r%   r&   c           	         ddl m}m}m}m}m}m}m}m}m	}	 |||||||||	g	}
|
D ]"}| j
                            |j        |           #d S )Nr   )	AttributeDocumenterClassDocumenterDataDocumenterDecoratorDocumenterExceptionDocumenterFunctionDocumenterMethodDocumenterModuleDocumenterPropertyDocumenter)sphinx.ext.autodocrN   rO   rP   rQ   rR   rS   rT   rU   rV   r.   add_documenterobjtype)rL   rN   rO   rP   rQ   rR   rS   rT   rU   rV   documenters
documenters               r8   setup_documentersr\   Z   s    
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 	/+>,02D+K
 " D D
##J$6
CCCCD Dr:   =titlerF   linec                \    d| v rd}t          |          | dz   |t          |           z  z   S )N
zCan only underline single lines)
ValueErrorlen)r^   r_   msgs      r8   
_underlinere   o   s6    u}}/oo4<$U+++r:   c                  "    e Zd ZdZddZddZdS )AutosummaryRendererzA helper class for rendering.rL   r    r%   r&   c                   t          |t                    rd}t          |          t          j                            t          ddd          g}t          |j        |j	        j
        |          }t          |          | _        t          j        | j        j        d<   t          j        | j        j        d<   t           | j        j        d<   |j        r;| j                            d	           | j                            |j                   d S d S )
Nz%Expected a Sphinx application object!extautosummary	templates)loaderescapee	underlinezjinja2.ext.i18n)
isinstancer   rb   osr   joinr   r   r0   r-   templates_pathr	   r,   r   rm   filtersre   r$   add_extensioninstall_gettext_translations)r7   rL   rd   system_templates_pathrl   s        r8   r9   zAutosummaryRenderer.__init__y   s    c7## 	"9CS//!!#k5-Q\!]!] ^%cj#*2K&;= = (v666%(Z" #
(2%> 	BH""#4555H11#.AAAAA	B 	Br:   template_namerF   contextdictc                   	 | j                             |          }nY# t          $ rL 	 | j                             d|z            }n*# t          $ r | j                             d          }Y nw xY wY nw xY w|                    |          S )zRender a template file.zautosummary/%s.rstzautosummary/base.rst)r,   get_templater   render)r7   rx   ry   rI   s       r8   r}   zAutosummaryRenderer.render   s    	Ix,,];;HH 	I 	I 	II8001E1UVV# I I I8001GHHI		I w'''s2    
A3AA3$A-*A3,A--A32A3N)rL   r    r%   r&   )rx   rF   ry   rz   r%   rF   )r@   rA   rB   rC   r9   r}   r>   r:   r8   rg   rg   v   sF        ''B B B B$( ( ( ( ( (r:   rg   rG   tuple[str | None, str]c                   |                      d          }t          |d          D ]\  }}	 d                    |d|                   }t          j        |           8# t
          $ rm |d|dz
           rDd                    |d|dz
                     d                    ||dz
  d                   fcY c S dd                    |          fcY c S t          $ r Y w xY w| dfS )a  Split full qualified name to a pair of modname and qualname.

    A qualname is an abbreviation for "Qualified name" introduced at PEP-3155
    (https://peps.python.org/pep-3155/).  It is a dotted path name
    from the module top-level.

    A "full" qualified name means a string containing both module name and
    qualified name.

    .. note:: This function actually imports the module to check its existence.
              Therefore you need to mock 3rd party modules if needed before
              calling this function.
    .   N )split	enumeraterr   	importlibr   ImportError
IndexError)rG   partsi_partmodnames        r8   _split_full_qualified_namer      s    JJsOOEeQ'' 
 
5		hhuRaRy))G#G,,,, 	- 	- 	-Va!eV} -xxfq1uf..q1uvv0G0GGGGGGGSXXe__,,,,,, 	 	 	D	 8Os   1AAC 9C 	C C c                  .    e Zd ZddZdd
ZddZddZdS )ModuleScannerrL   r   objr%   r&   c                "    || _         || _        d S r=   )rL   object)r7   rL   r   s      r8   r9   zModuleScanner.__init__   s    r:   rG   rF   valuec                B    t          | j        || j                  j        S r=   )r   rL   r   rY   )r7   rG   r   s      r8   get_object_typezModuleScanner.get_object_type   s    dht{;;CCr:   rY   r5   c                    	 | j                             d|||di           S # t          $ r6}t                              t          d          ||d           Y d }~dS d }~ww xY wNzautodoc-skip-memberFz\autosummary: failed to determine %r to be documented, the following exception was raised:
%srj   )type)rL   r?   	Exceptionloggerwarningr   )r7   rG   r   rY   excs        r8   
is_skippedzModuleScanner.is_skipped   s    	8,,-BG-15%E E E 	 	 	NN2 H I I=  : : : 55555		s   ! 
A!+AA!imported_members	list[str]c                   g }	 t          j        | j        j                  }|                                }n# t
          $ r i }Y nw xY wt          | j        | j        j                  D ]}	 t          | j        |          }n# t          $ r d }Y nw xY w|                     ||          }|                     |||          rY	 d|f|v rd}n:t          j        |          rd}n#t          |d          | j        j        k    rd}nd}n# t          $ r d}Y nw xY w| j        j        j         }	|s|du s|	r+dt!          | j                  v r|                    |           |S )Nr   FTrA   __all__)r   
for_moduler   r@   find_attr_docsr   
members_ofrL   r-   r   AttributeErrorr   r   inspectismoduler+   dirappend)
r7   r   membersanalyzer	attr_docsrG   r   rY   importedrespect_module_alls
             r8   scanzModuleScanner.scan   s   	%01EFFH //11II 	 	 	III	 t{DHO<< 	% 	%D$T[$77!    **477GtUG44 
!:**$HH%e,, %#HH!%66$+:NNN#HH$H! ! ! ! ! &*X_%R!R !% u$$& %+4DK8H8H+H+Ht$$$s4   27 AA+BBBADDDN)rL   r   r   r   r%   r&   )rG   rF   r   r   r%   rF   )rG   rF   r   r   rY   rF   r%   r5   )r   r5   r%   r   )r@   rA   rB   r9   r   r   r   r>   r:   r8   r   r      sh           D D D D   ) ) ) ) ) )r:   r   r   confr   Sequence[str]c                j    |j         rt          |           S t          |           pt          |           S )zGet the members of ``obj``, possibly ignoring the ``__all__`` module attribute

    Follows the ``conf.autosummary_ignore_module_all`` setting.)r+   r   r   )r   r   s     r8   r   r      s1    
 ) '3xxc{{&c#hh&r:   parentrI   rx   r   r5   rJ   ry   rz   r   rH   qualnamec                H    t          |||          }i }|                    |           |j        dk    rt          ||          }|                    |          |d<   |j        j         }|pdt          |          v o|}t          |||dh|          \  |d<   |d<   t          |||dh|          \  |d	<   |d
<   t          |||dh|          \  |d<   |d<   t           |d                   \  |d<   |d<   t          |d          }|r|r|d         |d
         z   |d         z   |d         z   }|rZdt          |          v rIt          |||dhd          \  }}||z  } fd|D             } fd|D             }t          |          }ng g }}d }t          || |          \  }}||z   |d<   ||z   |d<   n|j        dk    rt          |          |d<   t          t          |                    t          |j                                                  z
  |d<   t          |||dhdh          \  |d<   |d<   t          |||ddh          \  |d<   |d<   |	|
t!                     \  }	}
|j        dv r|
                    d d!          d"         |d<   |j        d#v r|
}n|
                    d d!          d$         } |d%<   |	|d<   |
|d&<   ||d'<   |j        |d(<   t%                     d)z  |d*<   |r|                    ||          S |                    |j        |          S )+Nmoduler   r   function)r   	functionsall_functionsclassclassesall_classes	exception
exceptionsall_exceptions
attributesall_attributes__path__Tc                     g | ]
}d z   |z   S r   r>   .0r   rG   s     r8   
<listcomp>z0generate_autosummary_content.<locals>.<listcomp>3  s"    #Y#Y#YWD3J$8#Y#Y#Yr:   c                     g | ]
}d z   |z   S r   r>   r   s     r8   r   z0generate_autosummary_content.<locals>.<listcomp>5  s"    NNNgTCZ')NNNr:   )skiprG   public_membersmodulesall_modulesinherited_membersmethodr9   )include_publicmethodsall_methods	attributeproperty)r   r   r   r   r   r   )r   fullnameobjnamerG   rY   r]   ro   )r   updaterY   r   r   r-   r+   r   _get_members_get_module_attrshasattrr   _get_modulesset__dict__keysr   rsplitrc   r}   )rG   r   r   rI   rx   r   rL   rJ   ry   r   r   docnsscannerr   	ispackager   imported_modulesall_imported_modulesr   r   r   	shortnames   `                      r8   generate_autosummary_contentr     s    c6
*
*CBIIg
{hS))%5669!$!II+]	SXX0E0\J\ c3?OPPP 	-;O, c3	<LMMM 	)9r-( c3@PQQQ 	/<"-. dByM22 	/<"-.C,,	 	C 	C ?#]#$%&' %&'  " 
&i3s88&;&; c3
TJJJ 7 "6,,#Y#Y#Y#YHX#Y#Y#Y NNNN9MNNN %!'9;R"6 !%#/$T?M$O $O $O G[,w6ByM 4{ BB}			C9CMMC 1 1 3 3444 	 c3
J<PPP 	)9r-( c3j(ABB 	/<"-. (*6t<<
{999ooc1--a07
{j  		OOC++B/	BzNBxLByMBvJKByM$ii#oB{O 0}b111s{B///r:   r    rY   c                    	 |                      d|||di           S # t          $ r6}t                              t	          d          ||d           Y d }~dS d }~ww xY wr   )r?   r   r   r   r   )rL   r   rG   rY   r   s        r8   _skip_memberr   a  s    ##$97D$'4 4 	4   r D E ES} 	 	6 	6 	6 uuuuu	s    
A+AAdict[str, Any]c                    t           j        j                            | d t                    }d |                                D             S )Nc                $    i | ]\  }}||j         S r>   )r   )r   rG   members      r8   
<dictcomp>z&_get_class_members.<locals>.<dictcomp>n  s     DDDLD&D&-DDDr:   )sphinxri   autodocget_class_membersr   items)r   r   s     r8   _get_class_membersr   l  s:    j 223lKKGDDGMMOODDDDr:   c                    i }t          || j                  D ]&}	 t          ||          ||<   # t          $ r Y #w xY w|S r=   )r   r-   r   r   )rL   r   r   rG   s       r8   _get_module_membersr   q  sa    G3
++  	(d33GDMM 	 	 	H	Ns   /
<<r   type[Documenter]c                p    | j         dk    rt          ||          S | j         dk    rt          |          S i S )Nr   r   )rY   r   r   )r   rL   r   s      r8   _get_all_membersr   {  s?    
{h"3,,,			!#&&&Ir:   T)r   r   typesset[str]r   Set[str]r   tuple[list[str], list[str]]c                  g }g }t          | ||          }|                                D ]\  }	}
t          ||
|          }|j        |v r|st	          |
dd           |j        k    rt          ||
|	|j                  }|du rW|du r+|                    |	           |                    |	           |                    |	           |	|v s|	                    d          s|                    |	           ||fS )NrA   TF_)	r   r   r   rY   getattrr@   r   r   
startswith)r   rL   r   r   r   r   r   publicall_membersrG   r   r[   skippeds                r8   r   r     s    EF"3S11K"((** , ,e#C44
&& ,75,==MM&sE49KLLd??%%LL&&&MM$''''LL&&&~--T__S5I5I-d+++5=r:   r   c                (   g g }}	 t          j        |           }|                                }|D ]N\  }}|dk    rC||v r?|                    |           |                    d          s|                    |           On# t
          $ r Y nw xY w||fS )z'Find module attributes with docstrings.r   r   )r   r   r   r   r   r   )rG   r   attrsr   r   r   	namespace	attr_names           r8   r   r     s    6E	!,T22++--	$- 	- 	- IyB9#7#7Y''' ++C00 -MM),,,		-
    5=s   A9B   
BB)r   r   r   Sequence[str] | Nonec                  g }g }t          j        | j                  D ]\  }}}||v r|dz   |z   }		 t          |	          }
|
rt	          |
d          r6n# t
          $ r Y nw xY w|                    |	           |||v r|                    |	           x|                    d          s|                    |	           ||fS )Nr   __sphinx_mock__r   )pkgutiliter_modulesr   r   r   r   r   r   )r   r   rG   r   r   r   r   r   _ispkgr   r   s              r8   r   r     s    EF%23<@@ ( (7Fd??#:'	"8,,F '&*;<<  	 	 	D	 	X%.((h'''%%c** (h'''5=s   !A
A"!A".rstFutf-8sourcesr   
output_dirstr | os.PathLike[str] | Nonesuffix	base_path	overwriteencodingc                   t          |           }t          |          dk    r|d d         dgz   |dd          z   }t                              t	          d          d                    |          z             |r*t                              t	          d          |z             fd| D             } t          |          }	t          |           }
g }|r|j        j	        }ni }t          t          |
          t          	          D ]}|j        |p#t          j                            |j                  }t          |           	 t!          |j                  \  }}}}|                    |d
z   d          }n# t&          $ r}	 t)          |j                  \  }}}}|                    |d
z   d          }n# t*          $ r}|j        r|j        |j        gz   }n|j        |gz   }t1          d |D                       }t                              t	          d          |j        d                    |                     Y d }~Y d }~Cd }~ww xY wY d }~nd }~ww xY wi }|r|                    |j        j                   t9          ||||	|j        |||j        |||          }t          j                            ||                    ||          |z             }t          j                             |          rtC          ||          5 }|"                                }d d d            n# 1 swxY w Y   ||k    r9|rTtC          |d|          5 }|#                    |           d d d            n# 1 swxY w Y   |$                    |           tC          |d|          5 }|#                    |           d d d            n# 1 swxY w Y   |$                    |           |rtK          ||||||           d S d S )N   
   z...iz,[autosummary] generating autosummary for: %sz, z[autosummary] writing to %sc                P    g | ]"}t           j                            |          #S r>   )rq   r   rr   )r   filenamer  s     r8   r   z-generate_autosummary_docs.<locals>.<listcomp>  s)    MMM27<<	844MMMr:   )keyr   r   c                B    h | ]}d t          |          j         d| S z* z: r   r@   r   rn   s     r8   	<setcomp>z,generate_autosummary_docs.<locals>.<setcomp>  s2    PPP;DGG$4;;;;PPPr:   z5[autosummary] failed to import %s.
Possible hints:
%sra   )r  w)r  r  r  r   rL   r  )&sortedrc   r   infor   rr   rg   find_autosummary_in_filesr-   r*   r   rF   r   rq   abspathr   r   rG   replacer   r   r   	__cause__r   listr   r   r)   r   rI   rJ   getisfileopenreadwriter   generate_autosummary_docs)r  r  r  r  r   rL   r  r  showed_sourcesrI   r   	new_filesfilename_mapentryr   rG   r   r   r   r   r   exc2r   errorsry   contentr  fold_contents      `                         r8   r.  r.    s     G__N
>R',w69MM
KKABB		.))* + + +  DB455
BCCCMMMMWMMM"3''H &g..E I
 z: E

,,, 2' 2': 8RW__UZ88$	)7
)C)C&D#vw||GcM266HH# 	 	 	-@-L-L*c67<<#r:: 	 	 	> 969nGW6WJJ!$4&!8JPPZPPPQQr"[\\$z499V+<+<> > >	 		  #% 	;NN3:9:::.tS&(EN/?eoW^/6B B 7<<l&6&6tT&B&BV&KLL7>>(## 	'h222 'affhh' ' ' ' ' ' ' ' ' ' ' ' ' ' ' +%% +(C(;;; %qGGG$$$% % % % % % % % % % % % % % %  ***hh777 !1   ! ! ! ! ! ! ! ! ! ! ! ! ! ! !X&&&&  7!)
)/93C,5	7 	7 	7 	7 	7 	77 7ss   2E>>
I	2F<;I<
IA=IIIIIL00L4	7L4	M99M=	 M=	-OO	O		filenameslist[AutosummaryEntry]c                    g }| D ]v}t          |dd          5 }|                                                                }|                    t	          ||                     ddd           n# 1 swxY w Y   w|S )z^Find out what items are documented in source/*.rst.

    See `find_autosummary_in_lines`.
    r  ignore)r  r4  r  N)r+  r,  
splitlinesextendfind_autosummary_in_lines)r8  
documentedr  r6  liness        r8   r$  r$  +  s    
 *,J S S(WX>>> 	S!FFHH''))E7QQQRRR	S 	S 	S 	S 	S 	S 	S 	S 	S 	S 	S 	S 	S 	S 	S s   AA00A4	7A4	r  c                   	 t          |           \  }}}}t          j        |                                          }t	          || |          S # t
          $ r Y nt          $ rN}d                    d |j        D                       }t          
                    d|  d|            Y d}~n.d}~wt          $ r t          
                    d|            Y nw xY wg S )znFind out what items are documented in the given object's docstring.

    See `find_autosummary_in_lines`.
    )r   r  ra   c                B    h | ]}d t          |          j         d| S r  r  r  s     r8   r   z0find_autosummary_in_docstring.<locals>.<setcomp>F  s2    QQQQ8a!188Q88QQQr:   zFailed to import z.
Possible hints:
Nz_Failed to import '%s'; the module executes module level statement and it might call sys.exit().)r   pydocgetdocr=  r?  r   r   rr   r   r   r   
SystemExit)	rG   r  	real_namer   r   r   rA  r   r4  s	            r8   find_autosummary_in_docstringrH  8  s&   H*8*>*>'	3S!!,,..(thOOOO    O O OQQ#.QQQRRM4MMVMMNNNNNNNN H H H ABF	H 	H 	H 	H 	HH Is%   AA 
C	C#AB,,(CCrA  r   c           	     b   t          j        d          }t          j        d          }t          j        d          }t          j        d          }t          j        d          }t          j        d          }t          j        d          }	g }
d}d	}d
}|}d}d
}| D ]}|r|                    |          }|rd} |                    |          }|rU|                    d          }|r=t          j                            t          j                            |          |          }|	                    |          }|r(|                    d                                          }|                                	                    d          r|                    |          }|r|                    d                                          }|	                    d          r
|dd	         }|r|	                    |dz             s| d| }|

                    t          ||||                     |                                r|	                    |dz             rd}|                    |          }|rd}|                    d          }d}d	}d
}|                    |          }|rM|                    d                                          }|
                    t          ||                     b|                    |          }|r|                    d          }|
S )a  Find out what items appear in autosummary:: directives in the
    given lines.

    Returns a list of (name, toctree, template) where *name* is a name
    of an object and *toctree* the :toctree: path of the corresponding
    autosummary directive (relative to the root of the file name), and
    *template* the value of the :template: option. *toctree* and
    *template* ``None`` if the directive does not have the
    corresponding options set.
    z^(\s*)\.\.\s+autosummary::\s*z.^\s*\.\.\s+automodule::\s*([A-Za-z0-9_.]+)\s*$z4^\s*\.\.\s+(current)?module::\s*([a-zA-Z0-9_.]+)\s*$z%^\s+(~?[_a-zA-Z][a-zA-Z0-9_.]*)\s*.*?z^\s+:recursive:\s*$z^\s+:toctree:\s*(.*?)\s*$z^\s+:template:\s*(.*?)\s*$FNr   Tr   :~r    r<     )recompilematchgrouprq   r   rr   dirnamestripr   r   rE   searchr>  rH  )rA  r   r  autosummary_reautomodule_re	module_reautosummary_item_rerecursive_arg_retoctree_arg_retemplate_arg_rer@  rJ   toctreerI   current_modulein_autosummarybase_indentr_   mrG   s                       r8   r?  r?  N  sV    Z @AANJ9; ;M
?A AI*%MNNz"899Z <==Nj!>??O)+JIGHNNK ; ; $	# &&t,,A  	$$T**A ''!** 4 gll27??8+D+D+24 4G%%d++A 771::++--zz||&&s++ #))$//A wwqzz''))??3'' $8D! 6~';<<6,55t55D!!"24(I"V"VWWW::<< 4??;3D#E#E "N  && 	!N''!**KIGH  && 	WWQZZ--//N;3 3 3 4 4 4OOD!! 	WWQZZN	 r:   argparse.ArgumentParserc            
        t          j        dt          d          t          d                    } |                     ddddt          z  	           |                     d
dt          d                     |                     ddddt          d                     |                     dddddt          d                     |                     ddddd t          d                     |                     ddd d!d"t          d#                     |                     d$d%d d&d"t          d'                     | S )(Nz#%(prog)s [OPTIONS] <SOURCE_FILE>...z:For more information, visit <https://www.sphinx-doc.org/>.a  
Generate ReStructuredText using autosummary directives.

sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates
the reStructuredText files from the autosummary directives contained in the
given input files.

The format of the autosummary directive is documented in the
``sphinx.ext.autosummary`` Python module and can be read using::

  pydoc sphinx.ext.autosummary
)usageepilogdescriptionz	--versionversionshow_versionz%%(prog)s %s)actiondestrf  source_file+z&source files to generate rST files for)nargshelpz-oz--output-dirstorer  z directory to place all output in)rh  ri  rm  z-sz--suffixr  r   z/default suffix for files (default: %(default)s))rh  ri  defaultrm  z-tz--templatesrk   z0custom template directory (default: %(default)s)z-iz--imported-members
store_truer   Fz0document imported members (default: %(default)s)z-az--respect-module-allr   zPdocument exactly the members in module __all__ attribute. (default: %(default)s))argparseArgumentParserr   add_argumentr
   )parsers    r8   
get_parserru    s   $3NOO     F  IN .1D D  F F F S HII  K K K nW) BCC  E E E jx % !/ 0 0  1 1 1 mG+ $ !/ 0 0  1 1 1 2</ !/ 0 0  1 1 1 4\15 !9 : :  ; ; ;
 Mr:   r>   argvc                  t          j        t           j        d           t          j                                          t          t          j                                                   }t          j        |t          j
        t          j                   t          |           t                                          | pt          j        dd                    }|j        r6|j        j                            t)          j        |j                             |j         |j        _        t1          |j        |j        d|j        z   |j        |           d S )Nr   r   r   )r   rL   )locale	setlocaleLC_ALLr   init_consoler#   get_translatorr   setupsysstdoutstderrr\   ru  
parse_argsrv  rk   r-   rs   r   r   r%  r   r+   r.  rj  r  r  r   )rv  rL   r;   s      r8   mainr    s   
V]B'''
M   
6=7799
:
:CM#sz3:...c<<""4#738ABB<88D~ G
!((dn)E)EFFF## J, d.!DK//3/D"%' ' ' ' ' 'r:   __main__r   )rL   r   r%   r&   )r]   )r^   rF   r_   rF   r%   rF   )rG   rF   r%   r~   )r   r   r   r   r%   r   )NN)rG   rF   r   r   r   r   rI   rg   rx   rF   r   r5   rL   r   rJ   r5   ry   rz   r   rH   r   rH   r%   rF   )
rL   r    r   r   rG   rF   rY   rF   r%   r5   )r   r   r%   r   )rL   r    r   r   r%   r   )r   r   rL   r    r   r   r%   r   )r   r   rL   r    r   r   r   r   r   r   r   r5   r%   r   )rG   rF   r   r   r%   r   )
r   r   r   r   rG   rF   r   r  r%   r   )Nr  NFNTr  )r  r   r  r  r  rF   r  r  r   r5   rL   r   r  r5   r  rF   r%   r&   )r8  r   r%   r9  r=   )rG   rF   r  rH   r%   r9  )rA  r   r   rH   r  rH   r%   r9  )r%   ra  )r>   )rv  r   r%   r&   )XrC   
__future__r   rq  r   r   rx  rq   r
  rD  rN  r~  r   typingr   r   r   jinja2r   jinja2.sandboxr	   sphinx.localer   r
   r   sphinx.buildersr   sphinx.configr   sphinx.ext.autodoc.importerr   sphinx.ext.autosummaryr   r   r   r   r   sphinx.pycoder   r   sphinx.registryr   sphinx.utilr   r   sphinx.util.inspectr   r   sphinx.util.osutilr   sphinx.util.templater   collections.abcr   r   gettextr   sphinx.applicationr    rW   r!   	getLoggerr@   r   r#   rE   r\   re   rg   r   r   r   r   r   r   r   r   	frozensetr   r   r   r.  r$  rH  r?  ru  r  rv  r>   r:   r8   <module>r     s%    # " " " " "        				   				 



       1 1 1 1 1 1 1 1 1 1 # # # # # # / / / / / /     3 3 3 3 3 3 3 3 # # # # # #             5 5 5 5 5 5                  5 5 5 5 5 5 5 5 3 3 3 3 3 3 $ $ $ $ $ $ $ $ 4 4 4 4 4 4 4 4 ( ( ( ( ( ( 5 5 5 5 5 5 .--------(((((())))))------		8	$	$       ,    z   D D D D*, , , , ,!( !( !( !( !( !( !( !(H   B; ; ; ; ; ; ; ;|' ' ' ' 8<8<Z0 Z0 Z0 Z0 Z0z   E E E E
       -6IKK"&     6   * 04     @ KO,2IMIMFMY7 Y7 Y7 Y7 Y7|
 
 
 
 '+    . IM] ] ] ] ]@+ + + +\' ' ' ' '* zD!"" r:   