3
W­E^ë@  ã               @   s¶  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 d dlmZ d d	lmZm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 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* ddlm+Z+ d5Z,G dd„ de*ƒZ-G dd„ de-ƒZ.G dd„ de-ƒZ/G d d!„ d!e-ƒZ0G d"d#„ d#e-ƒZ1G d$d%„ d%e-ƒZ2G d&d'„ d'e-ƒZ3G d(d)„ d)e-ƒZ4G d*d+„ d+e-ƒZ5d,d-„ Z6d.d/„ Z7d6d1d2„Z8d3d4„ Z9dS )7é    N)Úimport_module)ÚPath)Úapps)Úsettings)Úadmin)Ústaff_member_required)Úutils)Úreplace_named_groupsÚreplace_unnamed_groups)ÚImproperlyConfiguredÚViewDoesNotExist)Úmodels)ÚHttp404)ÚEngine)Úget_mod_funcÚget_resolverÚget_urlconf)Úmethod_decorator)Úfunc_accepts_kwargsÚfunc_accepts_var_argsÚget_func_full_argsÚmethod_has_no_args)Úgettext)ÚTemplateViewé   )Úget_view_nameÚ_Úadd_ÚdeleteÚsaveÚset_c                   s4   e Zd ZdZeeƒ‡ fdd„ƒZ‡ fdd„Z‡  ZS )ÚBaseAdminDocsViewz(
    Base view for admindocs views.
    c                s2   t jsd| _| jtjj|ƒƒS tƒ j|f|ž|ŽS )Nzadmin_doc/missing_docutils.html)	r   Zdocutils_is_availableÚtemplate_nameZrender_to_responser   ÚsiteÚeach_contextÚsuperÚdispatch)ÚselfÚrequestÚargsÚkwargs)Ú	__class__© ú@/tmp/pip-build-78s3knkw/Django/django/contrib/admindocs/views.pyr&   $   s    zBaseAdminDocsView.dispatchc                s   t ƒ jf |tjj| jƒ–ŽS )N)r%   Úget_context_datar   r#   r$   r(   )r'   r*   )r+   r,   r-   r.   ,   s    z"BaseAdminDocsView.get_context_data)	Ú__name__Ú
__module__Ú__qualname__Ú__doc__r   r   r&   r.   Ú__classcell__r,   r,   )r+   r-   r!       s   r!   c               @   s   e Zd ZdZdS )ÚBookmarkletsViewzadmin_doc/bookmarklets.htmlN)r/   r0   r1   r"   r,   r,   r,   r-   r4   3   s   r4   c                   s    e Zd ZdZ‡ fdd„Z‡  ZS )ÚTemplateTagIndexViewz!admin_doc/template_tag_index.htmlc                s  g }yt jƒ }W n tk
r$   Y näX t|jjƒ ƒ}dd„ |jD ƒ}xÂ|| D ]¶\}}x¬|jjƒ D ]ž\}}	tj	|	j
ƒ\}
}}|
o”tj|
dtdƒ| ƒ}
|o®tj|dtdƒ| ƒ}x*|D ]"}tj|| dtdƒ| ƒ||< q¶W |jdƒd	 }|j||
|||dœƒ qbW qNW tƒ jf |d|i–ŽS )
Nc             S   s   g | ]}d |f‘qS )Ú r,   )Ú.0Úlibr,   r,   r-   ú
<listcomp>C   s    z9TemplateTagIndexView.get_context_data.<locals>.<listcomp>Útagztag:Ú.r   )ÚnameÚtitleÚbodyÚmetaÚlibraryÚtagséÿÿÿÿ)r   Úget_defaultr   ÚsortedÚtemplate_librariesÚitemsÚtemplate_builtinsrA   r   Úparse_docstringr2   Ú	parse_rstr   ÚsplitÚappendr%   r.   )r'   r*   rA   ÚengineÚapp_libsÚbuiltin_libsÚmodule_namer@   Ztag_nameZtag_funcr=   r>   ÚmetadataÚkeyÚtag_library)r+   r,   r-   r.   :   s,    
"z%TemplateTagIndexView.get_context_data)r/   r0   r1   r"   r.   r3   r,   r,   )r+   r-   r5   7   s   r5   c                   s    e Zd ZdZ‡ fdd„Z‡  ZS )ÚTemplateFilterIndexViewz$admin_doc/template_filter_index.htmlc                s  g }yt jƒ }W n tk
r$   Y näX t|jjƒ ƒ}dd„ |jD ƒ}xÂ|| D ]¶\}}x¬|jjƒ D ]ž\}}	tj	|	j
ƒ\}
}}|
o”tj|
dtdƒ| ƒ}
|o®tj|dtdƒ| ƒ}x*|D ]"}tj|| dtdƒ| ƒ||< q¶W |jdƒd	 }|j||
|||dœƒ qbW qNW tƒ jf |d|i–ŽS )
Nc             S   s   g | ]}d |f‘qS )r6   r,   )r7   r8   r,   r,   r-   r9   b   s    z<TemplateFilterIndexView.get_context_data.<locals>.<listcomp>Úfilterzfilter:r;   r   )r<   r=   r>   r?   r@   ÚfiltersrB   )r   rC   r   rD   rE   rF   rG   rU   r   rH   r2   rI   r   rJ   rK   r%   r.   )r'   r*   rU   rL   rM   rN   rO   r@   Zfilter_nameZfilter_funcr=   r>   rP   rQ   rR   )r+   r,   r-   r.   Y   s,    
"z(TemplateFilterIndexView.get_context_data)r/   r0   r1   r"   r.   r3   r,   r,   )r+   r-   rS   V   s   rS   c                   s    e Zd ZdZ‡ fdd„Z‡  ZS )ÚViewIndexViewzadmin_doc/view_index.htmlc       	         s„   g }t tjƒ}t|jƒ}xT|D ]L\}}}}|jt|ƒt|ƒdj|pDg |rN|gpPg  ƒdj|p^g ƒ|dœƒ qW t	ƒ j
f |d|i–ŽS )Nú:)Z	full_nameÚurlZurl_nameÚ	namespacer<   Úviews)r   r   ZROOT_URLCONFÚextract_views_from_urlpatternsÚurlpatternsrK   r   Úsimplify_regexÚjoinr%   r.   )	r'   r*   rZ   ÚurlconfZview_functionsÚfuncÚregexrY   r<   )r+   r,   r-   r.   x   s    

zViewIndexView.get_context_data)r/   r0   r1   r"   r.   r3   r,   r,   )r+   r-   rV   u   s   rV   c                   s,   e Zd ZdZedd„ ƒZ‡ fdd„Z‡  ZS )ÚViewDetailViewzadmin_doc/view_detail.htmlc             C   sd   t ƒ }t|ƒj| ƒr`t| ƒ\}}ytt|ƒ|ƒS  tk
r^   t|ƒ\}}ttt|ƒ|ƒ|ƒS X d S )N)r   r   Z_is_callbackr   Úgetattrr   ÚImportError)Úviewr_   Úmodr`   Úklassr,   r,   r-   Ú_get_view_funcŠ   s    zViewDetailView._get_view_funcc                s®   | j d }| j|ƒ}|d kr t‚tj|jƒ\}}}|oJtj|dtdƒ| ƒ}|odtj|dtdƒ| ƒ}x*|D ]"}tj|| dtdƒ| ƒ||< qlW tƒ j	f |||||dœ–ŽS )Nre   zview:Úmodel)r<   Úsummaryr>   r?   )
r*   rh   r   r   rH   r2   rI   r   r%   r.   )r'   r*   re   Z	view_funcr=   r>   rP   rQ   )r+   r,   r-   r.   ›   s    


"zViewDetailView.get_context_data)r/   r0   r1   r"   Ústaticmethodrh   r.   r3   r,   r,   )r+   r-   rb   ‡   s   rb   c                   s    e Zd ZdZ‡ fdd„Z‡  ZS )ÚModelIndexViewzadmin_doc/model_index.htmlc                s(   dd„ t jƒ D ƒ}tƒ jf |d|i–ŽS )Nc             S   s   g | ]
}|j ‘qS r,   )Ú_meta)r7   Úmr,   r,   r-   r9   ²   s    z3ModelIndexView.get_context_data.<locals>.<listcomp>r   )r   Z
get_modelsr%   r.   )r'   r*   Zm_list)r+   r,   r-   r.   ±   s    zModelIndexView.get_context_data)r/   r0   r1   r"   r.   r3   r,   r,   )r+   r-   rl   ®   s   rl   c                   s    e Zd ZdZ‡ fdd„Z‡  ZS )ÚModelDetailViewzadmin_doc/model_detail.htmlc                sü  | j d }ytj| j d ƒ}W n& tk
rD   ttdƒ| j  ƒ‚Y nX y|j|ƒ}W n& tk
rz   ttdƒ| j  ƒ‚Y nX |j}tj	|j
ƒ\}}}|o¬tj|dtdƒ| ƒ}|oÆtj|dtdƒ| ƒ}g }	x„|jD ]z}
t|
tjƒ�r"|
jjj}|
jjjj}tjtdƒ||dœ dtdƒ| ƒ}nt|
ƒ}|
j}|	j|
j||�pBd	|
jd
œƒ qÔW x |jD ]–}
|
jjj}|
jjjj}tdƒ||dœ }|	jd|
j dtjtdƒ| dtdƒ|j ƒdœƒ |	jd|
j dtjtdƒ| dtdƒ|j ƒdœƒ �qZW g }�x:|jjƒ D �]*\}}tj|ƒ�s(t|tƒ�ry$xt D ]}|j!|ƒ�r0t"‚�q0W W n t"k
�rf   �wY nX |j
}|�o�tjtj#|ƒdtdƒ|j ƒ}t|tƒ�r¼|	j|t$|ƒ|�p²d	dœƒ ntt%|ƒ�rüt&|ƒ �rüt'|ƒ �rü|	j|t$|ƒ|�pòd	dœƒ n4t(|ƒ}dj)dd„ |D ƒƒ}|j|||�p(d	dœƒ �qW xš|j*D ]�}tdƒ|j+jj|j+jj,dœ }|j-ƒ }|	jd| dtjtdƒ| dtdƒ|j ƒdœƒ |	jd| dtjtdƒ| dtdƒ|j ƒdœƒ �q>W t.ƒ j/f |d|j|j,f |||	|dœ–ŽS )NÚ
model_nameÚ	app_labelzApp %(app_label)r not foundz3Model %(model_name)r not found in app %(app_label)rri   zmodel:z0the related `%(app_label)s.%(data_type)s` object)rq   Ú	data_typer6   )r<   rr   ÚverboseÚ	help_textz/related `%(app_label)s.%(object_name)s` objects)rq   Úobject_namez%s.allÚListzall %s)r<   rr   rs   z%s.countÚIntegerznumber of %sz, c          	   S   s.   g | ]&}d j |d ftt|dd… ƒ•ƒ‘qS )ú=r   r   N)r^   ÚmapÚrepr)r7   Zarg_elr,   r,   r-   r9     s   z4ModelDetailView.get_context_data.<locals>.<listcomp>)r<   Ú	argumentsrs   z%s.%s)r<   rj   ÚdescriptionÚfieldsÚmethods)0r*   r   Zget_app_configÚLookupErrorr   r   Z	get_modelrm   r   rH   r2   rI   r}   Ú
isinstancer   Z
ForeignKeyZremote_fieldri   r/   rq   Úget_readable_field_data_typeZverbose_namerK   r<   rt   Zmany_to_manyrp   Ú__dict__rF   ÚinspectÚ
isfunctionÚpropertyÚMODEL_METHODS_EXCLUDEÚ
startswithÚStopIterationZtrim_docstringÚget_return_data_typer   r   r   r   r^   Zrelated_objectsZrelated_modelru   Zget_accessor_namer%   r.   )r'   r*   rp   Z
app_configri   Úoptsr=   r>   rP   r}   Úfieldrr   rq   rs   r~   Ú	func_namer`   Úexcluder{   Úprint_argumentsÚrelZaccessor)r+   r,   r-   r.   ¹   s¼    




&,

"
&,z ModelDetailView.get_context_data)r/   r0   r1   r"   r.   r3   r,   r,   )r+   r-   ro   ¶   s   ro   c                   s    e Zd ZdZ‡ fdd„Z‡  ZS )ÚTemplateDetailViewzadmin_doc/template_detail.htmlc       
         s®   | j d }g }ytjƒ }W n tk
r.   Y nhX xdt|jƒD ]V\}}t|ƒ| }|jƒ rv|jƒ �}|j	ƒ }	W d Q R X nd}	|j
||jƒ |	|dœƒ q<W tƒ jf |||dœ–ŽS )NÚtemplater6   )ÚfileÚexistsÚcontentsÚorder)r<   Ú	templates)r*   r   rC   r   Ú	enumerateÚdirsr   r“   ÚopenÚreadrK   r%   r.   )
r'   r*   r‘   r–   Zdefault_engineÚindexÚ	directoryZtemplate_fileÚfZtemplate_contents)r+   r,   r-   r.   @  s*    

z#TemplateDetailView.get_context_data)r/   r0   r1   r"   r.   r3   r,   r,   )r+   r-   r�   =  s   r�   c             C   s*   | j dƒr&| jdƒrdS | jdƒr&dS dS )z9Return a somewhat-helpful data type given a function nameÚget_Z_listrv   Ú_countrw   r6   )r‡   Úendswith)rŒ   r,   r,   r-   r‰   c  s    


r‰   c             C   s   | j | j S )zÑ
    Return the description for a given field type, if it exists. Fields'
    descriptions can contain format strings, which will be interpolated with
    the values of field.__dict__ before being output.
    )r|   r‚   )r‹   r,   r,   r-   r�   m  s    r�   r6   c             C   sÎ   g }xÄ| D ]¼}t |dƒrny
|j}W n tk
r8   w
Y nX |jt||t|jƒ |pTg |jrb|jgpdg  ƒƒ q
t |dƒr¶y$|j|j	|t|jƒ ||j
fƒ W qÆ tk
r²   w
Y qÆX q
ttdƒ| ƒ‚q
W |S )z…
    Return a list of views from a list of urlpatterns.

    Each object in the returned list is a two-tuple: (view_func, regex)
    Úurl_patternsÚcallbackz,%s does not appear to be a urlpattern object)Úhasattrr¡   rd   Úextendr[   ÚstrÚpatternrY   rK   r¢   r<   r   Ú	TypeErrorr   )r\   ÚbaserY   rZ   ÚpÚpatternsr,   r,   r-   r[   v  s$    


 
$
r[   c             C   sB   t | ƒ} t| ƒ} | jddƒjddƒjddƒ} | jdƒs>d|  } | S )zÎ
    Clean up urlpattern regexes into something more readable by humans. For
    example, turn "^(?P<sport_slug>\w+)/athletes/(?P<athlete_slug>\w+)/$"
    into "/<sport_slug>/athletes/<athlete_slug>/".
    ú^r6   ú$ú?ú/)r	   r
   Úreplacer‡   )r¦   r,   r,   r-   r]   ’  s    
r]   )r   r   r   r   r    )r6   N):rƒ   Ú	importlibr   Zpathlibr   Zdjango.appsr   Zdjango.confr   Zdjango.contribr   Z%django.contrib.admin.views.decoratorsr   Zdjango.contrib.admindocsr   Zdjango.contrib.admindocs.utilsr	   r
   Zdjango.core.exceptionsr   r   Z	django.dbr   Zdjango.httpr   Zdjango.template.enginer   Zdjango.urlsr   r   r   Zdjango.utils.decoratorsr   Zdjango.utils.inspectr   r   r   r   Zdjango.utils.translationr   r   Zdjango.views.genericr   r   r†   r!   r4   r5   rS   rV   rb   rl   ro   r�   r‰   r�   r[   r]   r,   r,   r,   r-   Ú<module>   sB   ' &
	
