Your IP : 216.73.216.213
3
� 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/python36/lib64/python3.6/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 ]�}|j� }|d d� d
kr6q|jdd�}t|�dkrZtd| ��|\}}}} }
y || } W n$ tk
r� t|� } ||< Y nX | s�| d kr�d } nt| �} |r�| jj ||| f� q|| _
| | _ qW W d |j � X |S ) N�r� r �#�:� � zWrong field count in %rZnull)r r )
�open�strip�split�len�
ValueError�KeyErrorr �intr
�appendr r �close) �cls�filename�d�fp�line�parts�function�type�arg�refcountZcomment�entryr r r �fromfile% s0
zAnnotations.fromfilec C s� x�|j tj�D ]�}|j}|d dkr&q|d rH|jdtjdddgd�� |d dkrVq|d jd � s|d d rvq|d d d }|jd
�r�|d d � }| j |�}|s�qn |j
dkr�q|j d kr�d}n|j r�d}nd}|jdtj||dgd�� qW d S )NZdomain�c� stableabir z Part of the stable ABI.)�classesZobjtyper* �nameszc.� � PyObject*� PyVarObject*zReturn value: Always NULL.z Return value: New reference.z!Return value: Borrowed reference.r- )r5 r6 ) Ztraverser Z desc_content�parent�insertr ZemphasisZhas_key�
startswith�getr r )r
�appZdoctreeZnodeZparr r. Zrcr r r �add_annotationsG s4
zAnnotations.add_annotationsN)r r r � classmethodr/ r< r r r r r $ s "r c C s* t jtj| j| jj��}| jd|j� d S )Nz doctree-read) r r/ r �join�srcdir�config�
refcount_file�connectr< )r; Z refcountsr r r �init_annotationse s rC c sL | j ddd� | jdt� tjtjd�t_tj� � fdd�}|t_ddd �S )
NrA r Tzbuilder-inited)Znoindexr1 c s d| j k|jd< � | ||�S )Nr1 )Zoptionsr7 )r
ZsigZsignode)�old_handle_signaturer r �new_handle_signatureu s z#setup.<locals>.new_handle_signaturez1.0)�versionZparallel_read_safe)Zadd_config_valuerB rC r �flagr Z option_specZhandle_signature)r; rE r )rD r �setupk s rH N)�__doc__�osr Zdocutilsr Zdocutils.parsers.rstr Zsphinxr Zsphinx.domains.cr r �dictr rC rH r r r r �<module> s A