U
    ڲg                     @   sJ  d Z ddlZddlmZ ddlmZ ddlmZ ddlm	Z	 ddl
mZ ddlmZ zddlZddlZddlZW n ek
r   d	ZY nX d
Zdd Zdd Zd+ddZddddddZdd Zd,ddZe rejjjde e D ]\ZZ eee  qedZ!edZ"edZ#dd  Z$d!d" Z%d#d$ Z&d%d& Z'd'd( Z(d)d* Z)dS )-zBMisc. utility functions/classes for admin documentation generator.    N)HeaderParseError)HeaderParser)cleandoc)reverse)_lazy_re_compile)	mark_safeFTc                 C   sD   t | dr"| j}|j d|j S | j}t| d| jj}|d | S )N
view_class.__qualname__)hasattrr   
__module__r
   getattr	__class____name__)Z	view_funcklassmod_nameZ	view_name r   B/tmp/pip-unpacked-wheel-a78qhiua/django/contrib/admindocs/utils.pyget_view_name   s    
r   c                 C   s   | sddi fS t | } td| }|d }t|dkr@d}i }nzt }z||d }W n* tk
r   i }d|dd }Y n8X t|	 }|rd|dd }nd|dd }|||fS )zN
    Parse out the parts of a docstring.  Return (title, body, metadata).
     z\n{2,}r      z

N)
r   resplitlenr   parsestrr   joindictitems)Z	docstringpartstitlebodymetadataparserr   r   r   parse_docstring   s&    
r$   c                 C   sR   dd|t ddddd}|o&d| }d}tjj||  |d	d
|d}t|d S )z<
    Convert the string from reST to an XHTML fragment.
    T   zdjango-admindocs-docroot/F)Zdoctitle_xformZinitial_header_leveldefault_reference_context	link_baseZraw_enabledZfile_insertion_enabledz<%s>z7
.. default-role:: cmsreference

%s

.. default-role::
Nhtml)source_pathZdestination_pathZwriter_nameZsettings_overridesfragment)r   rstripdocutilscoreZpublish_partsr   )textr'   Zthing_being_parsedZ	overridessourcer   r   r   r   	parse_rst;   s"    r1   z%s/models/%s/z%s/views/%s/z%s/templates/%s/z%s/filters/#%sz%s/tags/#%s)modelviewtemplatefiltertagc                    s.   | dk d fdd	}t jjj| | d S )N)r4   r3   c                    sJ   |d kri }t jj||fd|jjj r,|n| f i|}|gg fS NZrefuri)r-   nodes	referencedocumentsettingsr(   lower)namerawtextr/   linenoinlineroptionscontentnodeZis_case_sensitiveurlbaser   r   _rolek   s    
z$create_reference_role.<locals>._role)NN)r-   parsersrstrolesregister_canonical_role)ZrolenamerE   rF   r   rD   r   create_reference_roleg   s    rK   c           	      C   sP   |d kri }|j jj}tjj||fdt| |j jj| f i|}|gg fS r7   )	r:   r;   r'   r-   r8   r9   ROLESr(   r<   )	r=   r>   r/   r?   r@   rA   rB   contextrC   r   r   r   default_reference_role   s     

rN   Zcmsreferencez\(\?P(<\w+>)z\(z\(\?\:c                 C   s   t ddd | S )z1Remove unescaped metacharacters from the pattern.z/((?:^|(?<!\\))(?:\\\\)*)(\\?)([?*+^$]|\\[bBAZ])c                 S   s    | d r| d | d  S | d S )N   r   r%   r   )mr   r   r   <lambda>       z(replace_metacharacters.<locals>.<lambda>)r   subpatternr   r   r   replace_metacharacters   s
    rV   c                 C   sx   d\}}t ||d  D ]Z\}}|dkr:|dkr:|d7 }n|dkrR|dkrR|d8 }|}|dkr| || d f  S qd S )N)r   N(\r   )r   )	enumerate)startendrU   Zunmatched_open_bracketsZ	prev_charidxvalr   r   r   _get_group_start_end   s    
r_   c                 c   s\   d }| | D ]H}t|d|d|  }r|\}}|rB||ksF|sR|||fV  |}qd S )Nr   )finditerr_   r[   r\   )rU   Zgroup_matcherprev_endmatchindicesr[   r\   r   r   r   _find_groups   s    rd   c                    s6    fddt  tD }|D ]\}} || q S )a  
    Find named groups in `pattern` and replace them with the group name. E.g.,
    1. ^(?P<a>\w+)/b/(\w+)$ ==> ^<a>/b/(\w+)$
    2. ^(?P<a>\w+)/b/(?P<c>\w+)/$ ==> ^<a>/b/<c>/$
    3. ^(?P<a>\w+)/b/(\w+) ==> ^<a>/b/(\w+)
    4. ^(?P<a>\w+)/b/(?P<c>\w+) ==> ^<a>/b/<c>
    c                    s&   g | ]\}}} || |d  fqS )r   r   ).0r[   r\   rb   rT   r   r   
<listcomp>   s   z(replace_named_groups.<locals>.<listcomp>)rd   named_group_matcherreplace)rU   Zgroup_pattern_and_nameZgroup_patternZ
group_namer   rT   r   replace_named_groups   s    
ri   c                 C   sZ   d\}}t | tD ]6\}}}|r0|| || 7 }|| d| d 7 }|}q|| |d  S )a)  
    Find unnamed groups in `pattern` and replace them with '<var>'. E.g.,
    1. ^(?P<a>\w+)/b/(\w+)$ ==> ^(?P<a>\w+)/b/<var>$
    2. ^(?P<a>\w+)/b/((x|y)\w+)$ ==> ^(?P<a>\w+)/b/<var>$
    3. ^(?P<a>\w+)/b/(\w+) ==> ^(?P<a>\w+)/b/<var>
    4. ^(?P<a>\w+)/b/((x|y)\w+) ==> ^(?P<a>\w+)/b/<var>
    r   NNz<var>)rd   unnamed_group_matcher)rU   final_patternra   r[   r\   _r   r   r   replace_unnamed_groups   s    rn   c                 C   sF   t | t}d\}}|D ]\}}}|| || 7 }|}q|| |d  S )z
    Find non-capturing groups in the given `pattern` and remove them, e.g.
    1. (?P<a>\w+)/b/(?:\w+)c(?:\w+) => (?P<a>\\w+)/b/c
    2. ^(?:\w+(?:\w+))a => ^a
    3. ^a(?:\w+)/b(?:\w+) => ^a/b
    rj   N)rd   non_capturing_group_matcher)rU   Zgroup_start_end_indicesrl   ra   r[   r\   rm   r   r   r   remove_non_capturing_groups   s    
rp   )N)NN)*__doc__r   Zemail.errorsr   email.parserr   inspectr   Zdjango.urlsr   Zdjango.utils.regex_helperr   Zdjango.utils.safestringr   Zdocutils.corer-   Zdocutils.nodesZdocutils.parsers.rst.rolesImportErrorZdocutils_is_availabler   r$   r1   rL   rK   rN   rG   rH   rI   rJ   r   r=   rE   rg   rk   ro   rV   r_   rd   ri   rn   rp   r   r   r   r   <module>   sV   
	
$	   

 	
