Your IP : 216.73.216.213
�
e f� � @ 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/python34/lib64/python3.4/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 sF | � } t | d � } z x| D]
} | j � } | d d � d
k rP q" n | j d d � } t | � d k r� t d | � � n | \ } } } } }
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 sj xc| j t j � D]O} | j } | d d k r8 q n | d rj | j d t j d d d d g �� n | d d k r� q n | d j d � s | d d r� q n | d d d } | j d
� r� | d d � } n | j | � } | s� q n | j
d k r
q n | j d k r%d } n | j r7d } n d } | j d t j | | d d g �� q Wd S)NZdomain�c� stableabir z Part of the stable ABI.ZclassesZobjtyper* �nameszc.� � PyObject*� PyVarObject*zReturn value: Always NULL.z Return value: New reference.z!Return value: Borrowed reference.r- )r4 r5 ) 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 rC c sv | j d d d � | j d t � i t j d 6t j d 6t _ t j � � f d d � } | t _ i d d
6d d 6S) NrA r Tzbuilder-initedZnoindexr1 c s& d | j k | j d <� | | | � S)Nr1 )Zoptionsr6 )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 Zflagr Z option_specZhandle_signature)r: rE r )rD r �setupk s
rG N)�__doc__�osr Zdocutilsr Zdocutils.parsers.rstr Zsphinxr Zsphinx.domains.cr r �dictr rC rG r r r r �<module> s A