File: //usr/lib/python3/dist-packages/sphinx/ext/__pycache__/graphviz.cpython-310.pyc
o
�$�ai> � @ s0 d Z ddlZddlZddlZddlmZ ddlmZmZ ddlm Z m
Z
m Z m Z ddl
mZ ddlmZ ddlmZmZ ddlZdd lmZ dd
lmZ dd lmZmZ dd l m Z m Z dd
l m Z m!Z! ddl"m#Z# ddl$m%Z% ddl&m'Z' ddl(m)Z) ddl*m+Z+ ddl,m-Z- ddl.m/Z/ ddl0m1Z1 ddl2m3Z3 ddl4m5Z5 e �6e7�Z8G dd� de�Z9G dd� d�Z:G d d � d ej;ej<ej=�Z>d ed e>d e?d!ej@fd"d#�ZAd$e d!e?fd%d&�ZBG d'd(� d(e �ZCG d)d*� d*e �ZD dKd+e!d,e?d-e
d.e?d/e?d0e?d!e e?e?f fd1d2�ZE dLd+e-d e>d,e?d-e
d/e?d3e?d4e?d0e?d!e e?e?f fd5d6�ZFd+e-d e>d!dfd7d8�ZG dKd+e/d e>d,e?d-e
d/e?d0e?d!dfd9d:�ZHd+e/d e>d!dfd;d<�ZI dMd+e3d e>d,e?d-e
d/e?d!df d=d>�ZJd+e3d e>d!dfd?d@�ZKd+e5d e>d!dfdAdB�ZLd+e1d e>d!dfdCdD�ZMdEedFeNd!dfdGdH�ZOdEed!e
e?e f fdIdJ�ZPdS )Na
sphinx.ext.graphviz
~~~~~~~~~~~~~~~~~~~
Allow graphviz-formatted graphs to be included in Sphinx-generated
documents inline.
:copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� N)�path)�PIPE�CalledProcessError)�Any�Dict�List�Tuple)�nodes)�Node)� Directive�
directives)�Sphinx)� SphinxError)�_�__)�logging�sha1)�SphinxDirective�SphinxTranslator)�
copy_asset)�search_image_for_language)�set_source_info)� ensuredir)�
OptionSpec)�HTMLTranslator)�LaTeXTranslator)�ManualPageTranslator)�TexinfoTranslator)�TextTranslatorc @ s e Zd ZdZdS )�
GraphvizErrorzGraphviz errorN)�__name__�
__module__� __qualname__�category� r$ r$ �5/usr/lib/python3/dist-packages/sphinx/ext/graphviz.pyr + s r c @ sb e Zd ZdZe�d�Ze�d�Zddedededd fd
d �Z ddedd fd d
�Z
defdd�Z d S )�ClickableMapDefinitionz1A manipulator for clickable map file of graphviz.z<map id="(.*?)"z
href=".*?"� �filename�content�dot�returnNc C s, d | _ || _|�� | _g | _| j|d� d S )N�r* )�idr( �
splitlinesr) � clickable�parse)�selfr( r) r* r$ r$ r% �__init__4 s
z ClickableMapDefinition.__init__c C s� | j �| jd �}|std| j ��|�d�| _| jdkr;t|�� �� � }d|dd � | _| jd �
d| j�| jd< | jD ]}| j � |�rL| j
�|� q>d S )Nr z$Invalid clickable map file found: %s� z%3z grapviz%si����)� maptag_re�matchr) r r( �groupr- r �encode� hexdigest�replace�href_re�searchr/ �append)r1 r* �matched�hashed�liner$ r$ r% r0 < s
��z ClickableMapDefinition.parsec C s. | j rd�| jd g| j | jd g �S dS )zvGenerate clickable map tags if clickable item exists.
If not exists, this only returns empty string.
�
r ���r' )r/ �joinr) )r1 r$ r$ r% �generate_clickable_mapM s $z-ClickableMapDefinition.generate_clickable_map)r' )N) r r! r" �__doc__�re�compiler4 r: �strr2 r0 rC r$ r$ r$ r% r& / s
r& c @ s e Zd ZdS ��graphvizN)r r! r" r$ r$ r$ r% rI X s rI � directive�node�captionr+ c C sl t �d|�}d|v r|j�d�|d< | j�|| j�\}}t j|dg|�R � }|�|� t | |� ||7 }|S )Nr' �align)
r �figure�
attributes�pop�state� inline_text�linenorL �extendr )rJ rK rL � figure_node�inodes�messages� caption_noder$ r$ r% �figure_wrapper\ s
rY �argumentc C s t �| d�S )N)�left�center�right)r �choice)rZ r$ r$ r% �
align_speci s r_ c @ �\ e Zd ZU dZdZdZdZdZej e
ej ej ej ej ej d�Z e
ed< dee fd d
�Zd S ) �Graphviz�3
Directive to insert arbitrary dot markup.
Tr r3 F��altrM rL �layout� graphviz_dot�name�class� option_specr+ c C s� | j ra| jj}| jr|jjtd�| jd�gS t| j d | j �}| j �
|�\}}| j � |� z t |dd�� }|�
� }W d � n1 sCw Y W n0 ty` |jjtd�| | jd�g Y S w d�| j�}d }|�� sz| jjjtd�| jd�gS t� }||d < d
| j ji|d < d | jv r�| jd |d d < d
| jv r�| jd
|d d < d| jv r�| jd |d< d| jv r�| jd |d< d| jv r�| jd |d< |r�||d< d| jvr�| �|� |gS t| || jd �}| �|� |gS )NzCGraphviz directive cannot have both content and a filename argument)r? r �utf-8��encodingz8External Graphviz file %r not found or reading it failedr@ z.Ignoring "graphviz" directive without content.�code�docname�optionsrf re rd rM rh �classesr( rL )� argumentsrQ �documentr) �reporter�warningr rS r �env�
relfn2path�note_dependency�open�read�OSErrorrB �strip�
state_machinerI rn ro �add_namerY ) r1 rr rZ � rel_filenamer( �fp�dotcoderK rN r$ r$ r% �run sf �
�� � �� �
z Graphviz.runN�r r! r" rD � has_content�required_arguments�optional_arguments�final_argument_whitespacer � unchangedr_ � class_optionri r �__annotations__r r
r� r$ r$ r$ r% ra m �
�
ra c @ r` ) �GraphvizSimplerb Tr3 r Frc ri r+ c C s� t � }d| j| jd d�| j�f |d< d| jji|d< d| jv r*| jd |d d< d| jv r8| jd |d d< d | jv rD| jd |d < d
| jv rP| jd
|d
< d | jv r\| jd |d < d
| jvri| �|� |gS t | || jd
�}| �|� |gS )Nz
%s %s {
%s
}
r r@ rm rn ro rf re rd rM rh rp rL )
rI rg rq rB r) ru rn ro r} rY )r1 rK rN r$ r$ r% r� � s* �
zGraphvizSimple.runNr� r$ r$ r$ r% r� � r� r� r1 rm ro �format�prefixr( c
C s� |� d| jjj�}|t|� t|� t| jjj� �� }d|t|��� |f }t �
| jj |�} t �
| jj
| jj|�}
t �|
�rC| |
fS t| jd�rR| jj� |�rRdS tt �|
�� |g} | �| jjj� | �d| d|
g� |� dd�} |r�t �t �
| jj|��}
n t �t �
| jj| ��}
|d kr�| �d
d |
g� z#tj| |�� tt|
d d
�}t �|
�s�ttd�|j|j f ��| |
fW S t y� t � td�|� t| jd�s�i | j_d | jj|< Y dS t y� } z
ttd�|j|j f �|�d}~ww )z3Render graphviz code into a PNG or PDF output file.rf z%s-%s.%s�_graphviz_warned_dot)NNz-Tz-orn �index�pngz-Tcmapxz-o%s.mapT)�input�stdout�stderr�cwd�checkz;dot did not produce an output file:
[stderr]
%r
[stdout]
%rzYdot command %r cannot be run (needed for graphviz output), check the graphviz_dot settingz.dot exited with error:
[stderr]
%r
[stdout]
%rN)!�get�builder�configrf rG �graphviz_dot_argsr7 r r8 � posixpathrB �imgpathr �outdir�imagedir�isfile�hasattrr� r �dirnamerT �srcdir�
subprocessr� r r r r� r� rz �loggerrt r )r1 rm ro r� r� r( rf �hashkey�fname�relfn�outfn�dot_argsrn r� �ret�excr$ r$ r% �
render_dot� sd ��
� �
�
�
����r� �imgclsrd c
C s | j jj}z|dvrttd�| ��t| |||||�\} }
W n ty7 } z
t�td�|| � tj | �d } ~ ww |dg|�
dg � } d� t d | ��}| d u rZ| j
�| �|�� tj �|d u ri|�
d| �|��� �}d|v r{| j
�d |d |d f � |d
kr�| j
�d � | j
�d | |f � | j
�d
| � | j
�d� n_t|
d dd��O}
t|
d |
�� |d�}|jr�| j
�d � | j
�d| ||j|f � | j
�d� | j
�|�� � n| j
�d � | j
�d| ||f � | j
�d� W d � n1 s�w Y d|v �r| j
�d� tj �)N)r� �svgz=graphviz_output_format must be one of 'png', 'svg', but is %r�dot code %r: %srI rp � rd rM z!<div align="%s" class="align-%s">r� z<div class="graphviz">z3<object data="%s" type="image/svg+xml" class="%s">
z<p class="warning">%s</p>z</object></div>
z.maprj rk r, z1<img src="%s" alt="%s" usemap="#%s" class="%s" />z</div>
z$<img src="%s" alt="%s" class="%s" />)r� r� �graphviz_output_formatr r r� r� rt r �SkipNoder� rB �filter�bodyr< r7 r{ rx r& ry r/ r- rC )r1 rK rm ro r� r� rd r( r� r� r� r� rp �mapfile�imgmapr$ r$ r% �render_dot_html sb
��� �� � � � � �
r� c C �$ t | ||d |d |�d�d� d S �Nrm ro r( )r( )r� r� �r1 rK r$ r$ r% �html_visit_graphvizD � $r� c
C s� z
t | ||d||�\}}W n ty& } z
t�td�||� tj|�d }~ww | �|�} | s^d}
d} d|v rV|d dkrAd}
d} n|d dkrLd }
d
} n
|d d krVd }
d} | j� d
|
� | j� d| � | sp| j� d| � tj�)N�pdfr� r' rM r[ �{z\hspace*{\fill}}r] z{\hspace*{\fill}�}r\ z{\hfillz
%sz \sphinxincludegraphics[]{%s}z%s
)
r� r r� rt r r r� � is_inliner� r< ) r1 rK rm ro r� r( r� r� r� r� �pre�postr$ r$ r% �render_dot_latexH s4 ��
r� c C r� r� )r� r� r� r$ r$ r% �latex_visit_graphvizj r� r� c
C sr z t | ||d|�\}}W n ty% } z
t�td�||� tj|�d }~ww |d ur6| j�d|d d� � tj�)Nr� r� z @image{%s,,,[graphviz],png}
���) r� r r� rt r r r� r� r< )r1 rK rm ro r� r� r� r� r$ r$ r% �render_dot_texinfon s ��r� c C s t | ||d |d � d S )Nrm ro )r� r� r$ r$ r% �texinfo_visit_graphvizz s r� c C s: d|j v r| �td�|d � tj�| �td�� tj��Nrd z [graph: %s]z[graph])rO �add_textr r r� r� r$ r$ r% �text_visit_graphviz~ s
�r� c C s> d|j v r| j�td�|d � tj�| j�td�� tj�r� )rO r� r< r r r� r� r$ r$ r% �man_visit_graphviz� s
�r� �appr� c C sJ |d u r!| j jdkr#t�tjddd�}t�| jd�}t||� d S d S d S )N�html� templatesrI � graphviz.css�_static)r� r� r rB �sphinx� package_dirr� r )r� r� �src�dstr$ r$ r% �on_build_finished� s
�r� c C s� | j ttd ftd ftd ftd ftd fd� | �dt� | �dt � | �dt � | �
ddd� | �
dg d� | �
d d
d� | � d � | � d t
� tjd
d�S )N)r� �latex�texinfo�text�manrI �graph�digraphrf r* r� r� r� r� r� zbuild-finishedT)�version�parallel_read_safe)�add_noderI r� r� r� r� r� �
add_directivera r� �add_config_value� add_css_file�connectr� r� �__display_version__)r� r$ r$ r% �setup� s �
r� rH )rI NNN)rI )QrD r� rE r� �osr r r �typingr r r r �docutilsr �docutils.nodesr
�docutils.parsers.rstr r r� �sphinx.applicationr
�
sphinx.errorsr �
sphinx.localer r � sphinx.utilr r �sphinx.util.docutilsr r �sphinx.util.fileutilr �sphinx.util.i18nr �sphinx.util.nodesr �sphinx.util.osutilr �sphinx.util.typingr �sphinx.writers.htmlr �sphinx.writers.latexr �sphinx.writers.manpager �sphinx.writers.texinfor �sphinx.writers.textr � getLoggerr r� r r& �General�Inline�ElementrI rG rN rY r_ ra r� r� r� r� r� r� r� r� r� r� � Exceptionr� r� r$ r$ r$ r% �<module> s�
)
D,���
�5�����
�4����
�"���
�