Your IP : 216.73.216.213
B
� f� � @ sr d Z ddlmZ ddlmZ ddlmZ ddlmZ ddl m
Z
G dd� d�Z G d d
� d
e �Z
d d � Zd
d� ZdS )a�
c_annotations.py
~~~~~~~~~~~~~~~~
Supports annotations for C API elements:
* reference count annotations for C API functions. Based on
refcount.py and anno-api.py in the old Python documentation tools.
* stable API annotations
Usage: Set the `refcount_file` config value to the path to the reference
count data file.
:copyright: Copyright 2007-2014 by Georg Brandl.
:license: Python license.
� )�path)�nodes)�
directives)�addnodes)�CObjectc @ s e Zd Zdd� ZdS )�RCEntryc C s || _ g | _d| _d | _d S )N� )�name�args� result_type� result_refs)�selfr � r �G/opt/alt/python37/lib64/python3.7/Doc/tools/extensions/c_annotations.py�__init__ s zRCEntry.__init__N)�__name__�
__module__� __qualname__r r r r r r s r c @ s e Zd Zedd� �Zdd� ZdS )� Annotationsc C s� | � }t |d�}z�x�|D ]�}|�� }|d d� dkr6q|�dd�}t|�dkrZtd| ��|\}}}} }
y || } W n$ tk
r� t|� } ||< Y nX | r�| dkr�d } nt| �} |r�| j� ||| f� q|| _
| | _ qW W d |� � X |S ) N�r� )r �#�:� � zWrong field count in %rZnull)
�open�strip�split�len�
ValueError�KeyErrorr �intr
�appendr r �close) �cls�filename�d�fp�line�parts�function�type�arg�refcount�comment�entryr r r �fromfile% s0
zAnnotations.fromfilec C s� x�|� tj�D ]�}|j}|d dkr&q|d rH|�dtjdddgd�� |d dkrVq|d �d �r|d d srq|d d d }|�d
�r�|d d � }| � |�}|s�qn|j
� d �s�q|j d kr�d
}n|j r�d}nd}|�dtj||dgd�� qW d S )NZdomain�c� stableabir z Part of the stable ABI.)�classesZobjtyper* �nameszc.� zObject*zReturn value: Always NULL.z Return value: New reference.z!Return value: Borrowed reference.r- )
Ztraverser Z desc_content�parent�insertr ZemphasisZhas_key�
startswith�getr �endswithr )r
�appZdoctreeZnodeZparr r/ Zrcr r r �add_annotationsG s4
zAnnotations.add_annotationsN)r r r � classmethodr0 r< r r r r r $ s "r c C s* t �t�| j| jj��}| �d|j� d S )Nz doctree-read) r r0 r �joinZsrcdirZconfig�
refcount_file�connectr< )r; Z refcountsr r r �init_annotationse s rA c sL | � ddd� | �dt� tjtjd�t_tj� � fdd�}|t_ddd �S )
Nr? r Tzbuilder-inited)Znoindexr2 c s d| j k|jd< � | ||�S )Nr2 )Zoptionsr6 )r
ZsigZsignode)�old_handle_signaturer r �new_handle_signatureu s z#setup.<locals>.new_handle_signaturez1.0)�versionZparallel_read_safe)Zadd_config_valuer@ rA r �flagr Z option_specZhandle_signature)r; rC r )rB r �setupk s rF N)�__doc__�osr Zdocutilsr Zdocutils.parsers.rstr Zsphinxr Zsphinx.domains.cr r �dictr rA rF r r r r �<module> s A