| Server IP : 186.64.123.29 / Your IP : 216.73.217.94 Web Server : LiteSpeed System : Linux house.hostinglat.cl 5.15.0-185-generic #195-Ubuntu SMP Fri Jun 19 17:11:50 UTC 2026 x86_64 User : tuemp9827 ( 1016) PHP Version : 8.1.31 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : OFF | Sudo : ON | Pkexec : ON Directory : /usr/share/glib-2.0/codegen/__pycache__/ |
Upload File : |
o
�*c�( � @ s. d dl Z d dlZddlmZ G dd� d�ZdS )� N� )�utilsc @ sh e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd d
� Z dd� Z
dd� Z dd� Z dd� Z
dd� ZdS )�RstCodeGeneratorz3Generates documentation in reStructuredText format.c C s || _ | �� d S )N)�ifaces�_generate_expand_dicts)�selfr � r �*/usr/share/glib-2.0/codegen/codegen_rst.py�__init__ s zRstCodeGenerator.__init__c C s� g }|� d�D ]G}|�� }|dkr|�d� q| jD ] }|�|| j| �}q| jD ] }|�|| j| �}q)|rIt� ddd� |�}t� ddd� |�}|�|� qd�
|�S )z)Expands parameters and constant literals.�
� z@[a-zA-Z0-9_]*c S � d| � d�dd � d S �Nz``r r ��group��mr r r �<lambda>% � z*RstCodeGenerator._expand.<locals>.<lambda>z%[a-zA-Z0-9_]*c S r
r r r r r r r + r ) �split�strip�append�_expand_member_dict_keys�replace�_expand_member_dict�_expand_iface_dict_keys�_expand_iface_dict�re�sub�join)r �s�expandParamsAndConstants�res�line�keyr r r �_expand s.
��
zRstCodeGenerator._expandc C s i | _ i | _| jD ]n}d|j� �}d|j� d�}|| j|< |jD ]}d|j|jf }d|j� d|j� d�}|| j |< q |jD ]}d|j|jf }d|j� d|j� d�}|| j |< q>|jD ]}d|j|jf }d|j� d |j� d�}|| j |< q\q t| j �� d
d �| _ t| j�� d
d �| _
d S )
z9Generates the dictionaries used to expand gtk-doc sigils.�#�`z`_z%s.%s()�.z#%s::%s�::z#%s:%s�:T)�reverseN) r r r �name�methods�signals�
properties�sorted�keysr r )r �ir$ �valuer r �pr r r r 1 s2
�
�
�z'RstCodeGenerator._generate_expand_dictsc C s� t |j�}d|j� d�dd| |jd| dddddd|j� d�d|j�� d| �|jd�dg}|jr<|d |j� d
�dg7 }|jrE|g d �7 }|dg7 }d �|�S )
z2Generates the header and preamble of the document.z.. _r* r �=z -----------� Descriptionz
Description:TzInterface available since: r( )� .. warning::r z This interface is deprecated.r r r ) �lenr, �doc_string_briefr r% �
doc_string�since�
deprecatedr )r �iface�
header_lenr" r r r �_generate_headerR s6
� �
z!RstCodeGenerator._generate_headerc C s: dt |� |dt |� dd|� d|� d�ddg}d�|�S )z)Generates a section with the given title.�-r z.. � r* r )r8 r )r �titler, r" r r r �_generate_sectionw s
�
z"RstCodeGenerator._generate_sectionc C s� g }|j D ]Z}|j� d|j� �}|jr|jrd}n|jr d}nd}||dt|� dddd|j� d |� d |j� �dd| �|jd
�dg
7 }|jrQ|d |j� d �dg7 }|j rZ|g d
�7 }|dg7 }qd�
|�S )z!Generates the properties section.r* � readwrite�writable�readable�^r r) � rA TzProperty available since: r( )r7 r z This property is deprecated.r r r ) r/ r, rF rE r8 � signaturer% r: r; r< r )r r= r" r4 rB �accessr r r �_generate_properties� s:
� �
z%RstCodeGenerator._generate_propertiesc C s. ddg}t |j�}t |j�}|dkr!|dkr!|d|j� d�g7 }nl|d|j� d�g7 }t|j�D ]*\}}||d krL|dkrL|d|j� d |j� �g7 }q0|d|j� d |j� d
�g7 }q0t|j�D ]&\}}||d krx|d |j� d |j� �g7 }q`|d |j� d |j� d
�g7 }q`|d dg7 }|dg7 }d
�|�S )z/Generates the method signature as a code block.r) r r rH � ()� (r z IN rA �,z
OUT � )r )r8 �in_args�out_argsr, � enumeraterI r )r �methodr" � n_in_args�
n_out_args�idx�argr r r �_generate_method_signature� sD �
� ��� ���
z+RstCodeGenerator._generate_method_signaturec C s� g }|j D ]\}|j� d|j� �}||dt|� d| �|�d| �|jd�dg7 }|jD ]}| �|jd�}||j� d|� �dg7 }q*|dg7 }|jrS|d|j� d�dg7 }|jr\|g d�7 }|dg7 }qd� |�S ) z Generates the methods section.r( rG r T� zMethod available since: )r7 r z This method is deprecated.r r r )
r- r, r8 rX r% r: rP r; r< r )r r= r" r rB �a�arg_descr r r �_generate_methods� �:
�
�
�
z"RstCodeGenerator._generate_methodsc C s� ddg}t |j�}|dkr|d|j� d�g7 }n<|d|j� d�g7 }t|j�D ]&\}}||d kr?|d|j� d |j� �g7 }q'|d|j� d |j� d
�g7 }q'|d dg7 }|dg7 }d �|�S )
z Generates the signal signature.r) r r rH rL rM r z rA rN rO r )r8 �argsr, rR rI r )r �signalr" �n_argsrV rW r r r �_generate_signal_signature� s2 �
� � ���
z+RstCodeGenerator._generate_signal_signaturec C s� g }|j D ]\}|j� d|j� �}||dt|� d| �|�d| �|jd�dg7 }|jD ]}| �|jd�}||j� d|� �dg7 }q*|dg7 }|jrS|d|j� d�dg7 }|jr\|g d�7 }|dg7 }qd � |�S )
z Generates the signals section.r) rG r TrY zSignal available since: r( )r7 r z This signal is deprecated.r r r )
r. r, r8 ra r% r: r^ r; r< r )r r= r" r rB rZ r[ r r r �_generate_signals r] z"RstCodeGenerator._generate_signalsc C s� | j D ]v}ttj�||� d|j� d��d��[}|�| �|�� t|j �dkr8|�| �
d|j�� |�| � |�� t|j �dkrQ|�| �
d|j�� |�| �
|�� t|j�dkrj|�| �
d|j�� |�| �|�� W d � n1 stw Y qdS ) z7Generates the reStructuredText file for each interface.r@ z.rst�wr �
Properties�Methods�SignalsN)r �open�os�pathr r, �writer? r8 r/ rC rK r- r\ r. rb )r �rst�outdirr2 �outfiler r r �generate? s
$� ���zRstCodeGenerator.generateN)�__name__�
__module__� __qualname__�__doc__r
r% r r? rC rK rX r\ ra rb rn r r r r r s !%
')& &r )rh r r r r r r r r �<module> s