Your IP : 216.73.216.213
��Yf� � @ s� d Z d d l m Z d d l m Z d d l m Z d d l m Z d d l m
Z
Gd d � d � Z Gd d
� d
e � Z
d d � Z d
d � Z d S)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 Z d Z d d � Z d S)�RCEntryc C s( | | _ g | _ d | _ d | _ d S)N� )�name�args� result_type� result_refs)�selfr � r �G/opt/alt/python35/lib64/python3.5/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 Z d Z e d d � � Z d d � Z d S)� Annotationsc C s@ | � } t | d � } zx| D]} | j � } | d d � d
k rM q" | j d d � } t | � d k r� t d | � � | \ } } } } }
y | | } Wn& t k
r� t | � } | | <Yn X| s� | d k r� d } n t | � } | r| j j | | | f � q" | | _
| | _ q" WWd | 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 sX xQ| j t j � D]=} | j } | d d k r5 q | d rd | j d t j d d d d g �� | d d k rw q | d j d � s | d d r� q | d d d } | j d
� r� | d d � } | j | � } | s� q n | j
d k r� q | j d k rd } n | j r%d } n d } | j d t j | | d d g �� q Wd 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. �rcr r r �add_annotationsG s4
# zAnnotations.add_annotationsN)r r r � classmethodr/ r= r r r r r $ s "r c C s; t j t j | j | j j � � } | j d | j � d S)Nz doctree-read) r r/ r �join�srcdir�config�
refcount_file�connectr= )r; Z refcountsr r r �init_annotationse s rD c sr | j d d d � | j d t � d t j d t j i t _ t j � � f d d � } | t _ d d
d d i S) NrB r Tzbuilder-initedZnoindexr1 c s& d | j k | j d <� | | | � S)Nr1 )Zoptionsr7 )r
ZsigZsignode)�old_handle_signaturer r �new_handle_signatureu s z#setup.<locals>.new_handle_signature�versionz1.0Zparallel_read_safe)Zadd_config_valuerC rD r Zflagr Z option_specZhandle_signature)r; rF r )rE r �setupk s rH N)�__doc__�osr Zdocutilsr Zdocutils.parsers.rstr Zsphinxr Zsphinx.domains.cr r �dictr rD rH r r r r �<module> s A