|
Server : Apache System : Linux iad1-shared-b8-43 6.6.49-grsec-jammy+ #10 SMP Thu Sep 12 23:23:08 UTC 2024 x86_64 User : dh_edsupp ( 6597262) PHP Version : 8.2.26 Disable Function : NONE Directory : /lib/python3/dist-packages/django/contrib/admindocs/__pycache__/ |
Upload File : |
o
3�a7 � @ s d Z ddlZddlmZ ddlmZ ddlmZ ddlm Z ddl
m Z ddl m
Z
zddlZddlZddlZW n eyC d ZY nw d
Zd d � Zd
d� Zd"dd�Zdddddd�Zdd� Zd#dd�Zer}ejjj � de� e� � D ] \Z Z ee e � qse d �Z!e d �Z"d d � Z#d d!� Z$dS )$zBMisc. utility functions/classes for admin documentation generator.� N)�HeaderParseError)� HeaderParser)�cleandoc)�reverse)�_lazy_re_compile)� mark_safeFTc C s" | j }t| d| jj�}|d | S )N� __qualname__�.)�
__module__�getattr� __class__�__name__)� view_func�mod_name� view_name� r �@/usr/lib/python3/dist-packages/django/contrib/admindocs/utils.py�
get_view_name s r c C s� | sddi fS t | �} t�d| �}|d }t|�dkr d}i }n<t� }z |�|d �}W n ty@ i }d�|dd� �}Y n w t|� � �}|rSd�|dd� �}n d�|dd� �}|||fS )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)� docstring�parts�title�body�metadata�parserr r r �parse_docstring s(
�
r$ c C sR dd|t d��d�ddd�}|od| }d}tjj|| |d d
|d �}t|d �S )
z<
Convert the string from reST to an XHTML fragment.
T� zdjango-admindocs-docroot�/F)�doctitle_xform�initial_header_level�default_reference_context� link_base� raw_enabled�file_insertion_enabledz<%s>z7
.. default-role:: cmsreference
%s
.. default-role::
N�html)� source_path�destination_path� writer_name�settings_overrides�fragment)r �rstrip�docutils�core�
publish_partsr )�textr) �thing_being_parsed� overrides�sourcer r r r � parse_rst8 s � � r; 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� fdd� }t jjj�| |� d S )Nc sB |d u ri }t jj||fd� |jjj|�� f i|��}|gg fS �N�refuri)r4 �nodes� reference�document�settingsr* �lower)�name�rawtextr7 �lineno�inliner�options�content�node��urlbaser r �_rolec s ����
z$create_reference_role.<locals>._role�NN)r4 �parsers�rst�roles�register_canonical_role)�rolenamerP rQ r rO r �create_reference_roleb s
rX c C sP |d u ri }|j jj}tjj||fdt| |j jj|�� f i|��}|gg fS rA ) rE rF r) r4 rC rD �ROLESr* rG ) rH rI r7 rJ rK rL rM �contextrN r r r �default_reference_roles s
����
r[ � cmsreferencez \(\?P(<\w+>)z\(c C s� dd� t �| �D �}g }|D ]F\}}}d\}}t| |d� �D ]4\}} | dkr0|dkr0|d7 }n | dkr<|dkr<|d8 }| }|d krS|�| ||| d � |f� nq q|D ]
\}
}| �|
|�} qW| 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 s& g | ]}|� d �|�d �|d f�qS )r r )�start�end��.0�mr r r �
<listcomp>� s ��z(replace_named_groups.<locals>.<listcomp>�r NN�(�\r �)r )�named_group_matcher�finditer� enumerate�append�replace) �pattern�named_group_indices�group_pattern_and_namer] r^ �
group_name�unmatched_open_brackets� prev_char�idx�val�
group_patternr r r �replace_named_groups� s( �
�� ru c C sD dd� t �| �D �}g }|D ]A}d\}}t| |d d� �D ]0\}}|dkr/|dkr/|d7 }n |dkr;|dkr;|d8 }|}|d krN|�||d
| f� nq qg }d} |D ]\}}
| r`|| ksb| si|�||
f� |
} qV|r�g d} } |D ] \}}
| r�| �| | |� � | �| d|� d � |
} qu| �| | d� � d �| �S | 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>
c S s g | ]}|� d ��qS )r )r] r_ r r r rb � s z*replace_unnamed_groups.<locals>.<listcomp>rc r Nrd re rf r � z<var>r )�unnamed_group_matcherrh ri rj r ) rl �unnamed_group_indices�
group_indicesr] rp rq rr rs �group_start_end_indices�prev_endr^ �
final_patternr r r �replace_unnamed_groups� s>
��
r} )NrR )%�__doc__r � email.errorsr � email.parserr �inspectr � django.urlsr �django.utils.regex_helperr �django.utils.safestringr �
docutils.corer4 �docutils.nodes�docutils.parsers.rst.roles� ImportError�docutils_is_availabler r$ r; rY rX r[ rS rT rU rV r rH rP rg rw ru r} r r r r �<module> sF �
"�
&