Your IP : 216.73.216.213
�
e f�4 � M @ s d Z d d l Z d d l 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 d d l
m Z d d l m Z m 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 d d l m Z d d l m Z m Z d d l! Z! d Z" d Z# d d l$ m% Z% d d � e% j& j' d <e% j& j' d <e% j& j' d <e% j& j' d <e j( Z) e j* Z+ d d � Z, d d � Z- e, e _( e- e _* i g d d � Z. i g d d! � Z/ Gd" d# � d# e � Z0 Gd$ d% � d% e1 � Z2 Gd& d' � d' e2 e � Z3 Gd( d) � d) e2 e � Z4 Gd* d+ � d+ e1 � Z5 Gd, d- � d- e5 e � Z6 Gd. d/ � d/ e5 e � Z7 Gd0 d1 � d1 e � Z8 e j9 d2 � Z: e j9 d3 � Z; Gd4 d5 � d5 e � Z< d6 d7 d8 d9 d: d; d< d= d> d? d@ dA dB dC dD dE dF dG dH dI dJ dK dL dM dN dO dP dQ dR dS dT dU dV dW dX dY dZ d[ d\ d] d^ d_ d` da db dc dd de df dg dh di dj dk dl dm dn do dp dq dr ds dt du dv dw dx dy dz d{ d| d} d~ d d� d� d� gM Z= Gd� d� � d� e � Z> e j9 d� � Z? d� d� � Z@ e j9 d� � ZA d� d� � ZB d� d� � ZC d S)�z�
pyspecific.py
~~~~~~~~~~~~~
Sphinx extension with Python doc-specific markup.
:copyright: 2008-2014 by Georg Brandl.
:license: Python license.
� N)�path)�asctime)�pformat)� StringOutput)� Directive)� new_document)�nodes�utils)�addnodes)�Builder)�split_explicit_title)�HTMLTranslator)�
TextWriter)�LaTeXTranslator)�
PyModulelevel�
PyClassmemberz https://bugs.python.org/issue%sz-https://github.com/python/cpython/tree/3.4/%s)�Bodyc C s d S)N� )�xr r �D/opt/alt/python34/lib64/python3.4/Doc/tools/extensions/pyspecific.py�<lambda>, s r Z
loweralphaZ
upperalphaZ
lowerromanZ
upperromanc C se | j j j | j j } | j j } d | k r@ d | j _ n z t | | � Wd | | j _ Xd S)N� keepdoctestF)�builder�env�metadataZcurrent_docname� highlighter�trim_doctest_flags�orig_visit_literal_block)�self�node�meta�old_trim_doctest_flagsr r r �new_visit_literal_block4 s r" c C sf | j j j | j d } | j j } d | k rA d | j _ n z t | | � Wd | | j _ Xd S)N� r F���)r r r Z curfilestackr r �orig_depart_literal_block)r r r r! r r r �new_depart_literal_block? s r& c C sB t j | � } d | } t j | | d t | �} | g g f S)Nzissue �refuri)r �unescaper � reference� ISSUE_URI) �typ�rawtext�text�lineno�inliner�options�content�issue�refnoder r r �
issue_roleP s
r4 c C s\ t | � \ } } } t j | � } t j | � } t j | | d t | �}
|
g g f S)Nr' )r r r( r r) �
SOURCE_URI) r+ r, r- r. r/ r0 r1 Zhas_t�title�targetr3 r r r � source_roleY s
r8 c @ s4 e Z d Z d Z d Z d Z d Z d d � Z d S)�ImplementationDetailTr r# c C s t j d d g � } | j } t j d d � } | j r� | j j | j d | j � \ } } | j t j d d | | � � n | j j
| | j | � | j r� t
| d t j � r� | d j d | � | d j d t j d � � n | j d t j d d | � � | g S)N�classesz impl-detailz CPython implementation detail:r � r# � )r �compoundr1 �strong� arguments�state� inline_textr. �append� paragraph� nested_parse�content_offset�children�
isinstance�insertZText)r Zpnoder1 Zadd_text�n�mr r r �runj s %# zImplementationDetail.runN)�__name__�
__module__� __qualname__� has_content�required_arguments�optional_arguments�final_argument_whitespacerK r r r r r9 c s
r9 c s. e Z d Z � f d d � Z d d � Z � S)�PyDecoratorMixinc s; t t | � j | | � } | j d t j d d � � | S)Nr �@)�superrS �handle_signaturerH r
� desc_addname)r �sig�signode�ret)� __class__r r rV ~ s z!PyDecoratorMixin.handle_signaturec C s d S)NFr )r r r r �
needs_arglist� s z PyDecoratorMixin.needs_arglist)rL rM rN rV r\ r r )r[ r rS } s rS c @ s e Z d Z d d � Z d S)�PyDecoratorFunctionc C s d | _ t j | � S)Nz py:function)�namer rK )r r r r rK � s zPyDecoratorFunction.runN)rL rM rN rK r r r r r] � s r] c @ s e Z d Z d d � Z d S)�PyDecoratorMethodc C s d | _ t j | � S)Nz py:method)r^ r rK )r r r r rK � s zPyDecoratorMethod.runN)rL rM rN rK r r r r r_ � s r_ c s" e Z d Z � f d d � Z � S)�PyCoroutineMixinc s; t t | � j | | � } | j d t j d d � � | S)Nr z
coroutine )rU r` rV rH r
Zdesc_annotation)r rX rY rZ )r[ r r rV � s z!PyCoroutineMixin.handle_signature)rL rM rN rV r r )r[ r r` � s r` c @ s e Z d Z d d � Z d S)�PyCoroutineFunctionc C s d | _ t j | � S)Nz py:function)r^ r rK )r r r r rK � s zPyCoroutineFunction.runN)rL rM rN rK r r r r ra � s ra c @ s e Z d Z d d � Z d S)�PyCoroutineMethodc C s d | _ t j | � S)Nz py:method)r^ r rK )r r r r rK � s zPyCoroutineMethod.runN)rL rM rN rK r r r r rb � s rb c @ s@ e Z d Z d Z d Z d Z d Z i Z d Z d d � Z d S)�DeprecatedRemovedT� r# z:Deprecated since version %s, will be removed in version %sc C s2 t j � } | j j | _ d | d <| j d | j d f } | | d <| j | } t | j � d k r� | j j | j d | j d � \ } } t j
| j d d | � } | j | � n g } | j r� | j j
| j | j | � n t | � r�t | d t j
� r�| d j r�t j | d j d d
�} | d j | _ | d j | _ | | d j 7} | d j t j
d d | � � n | d j d t j d d | d d
g �� n; t j
d d t j d d | d d
g �� } | j | � | j j j j } | j d | d | | j � | g | S)Nzdeprecated-removed�typer r# �version� rd r; Z translatableTz%s: r: �versionmodifiedz%s.Z
deprecated)r
rh r@ �documentr? �_label�lenrA r. r rC rB r1 rD rE rG Z rawsourceZinline�source�linerF Z replace_selfrH �settingsr Znote_versionchange) r r rf r- ZinodesZmessagesZparar1 r r r r rK � s<
# #
zDeprecatedRemoved.runN)
rL rM rN rO rP rQ rR � option_specrj rK r r r r rc � s rc z([Ii])ssue #([0-9]+)z (?im)^what's new in (.*?)\??$c @ s: e Z d Z d Z d Z d Z d Z i Z d d � Z d S)�MiscNewsFr# r c
C s< | j d } | j j j | j | j j d � } t j t j | � � } t j | | � } | j
j j j
j | � y7 t j | d d �} z | j � } Wd | j � XWn1 t k
r� d } t j | | � } | g SYn Xt j d | � } t j d | � } d d g | j � d
d � } | j j | | � g S) Nr r# �encodingzutf-8z The NEWS file is not available.z+`\1ssue #\2 <https://bugs.python.org/\2>`__z\1z.. default-role:: objr; rg )r? Z
state_machineZ input_linesrl r. Z input_offsetr �dirname�abspath�joinr@ ri rn Zrecord_dependencies�add�codecs�open�read�close� Exceptionr r> �issue_re�sub� whatsnew_re�
splitlinesZ insert_input)
r Zfnamerl Z
source_dirZfpath�fpr1 r- r �linesr r r rK � s*
z MiscNews.runN) rL rM rN rO rP rQ rR ro rK r r r r rp � s rp �assertZ
assignmentzatom-identifiersz
atom-literalszattribute-accesszattribute-referencesZ augassignZbinaryZbitwisezbltin-code-objectszbltin-ellipsis-objectzbltin-null-objectzbltin-type-objectsZbooleans�breakzcallable-typesZcalls�classZ comparisonsr= zcontext-managers�continueZ conversionsZ
customizationZdebugger�del�dictzdynamic-features�else�
exceptionsZ execmodelZ exprlistsZfloating�forZ
formatstringsZfunction�globalz
id-classesZ identifiers�ifZ imaginary�import�inZintegers�lambdaZlistsZnaming�nonlocalZnumbersz
numeric-typesZobjectszoperator-summary�passZpower�raise�returnzsequence-typesZshiftingZslicingsZ specialattrsZ specialnameszstring-methodsZstringsZ
subscriptions�truth�try�typesZtypesfunctionsZ typesmappingZ typesmethodsZ typesmodulesZtypesseqztypesseq-mutableZunary�while�with�yieldc @ sU e Z d Z d Z d d � Z d d � Z d d d � Z d d
� Z d d � Z d S)
�PydocTopicsBuilderz pydoc-topicsc C s
i | _ d S)N)�topics)r r r r �init s zPydocTopicsBuilder.initc C s d S)Nzall pydoc topicsr )r r r r �get_outdated_docs s z$PydocTopicsBuilder.get_outdated_docsNc C s d S)Nr; r )r �docnamer+ r r r �get_target_uri s z!PydocTopicsBuilder.get_target_uric
G s� t | � } x� | j t d d t t � �D]� } | | j j d d k rb | j d | � q+ n | j j d d | \ } } } | j j | | � } t d � } | j | j
| � t d d � } | j | | � | j
| j | <q+ Wd S) Nzbuilding topics... ZlengthZstdZlabelsz label %r not in documentationz<section node>rq zutf-8)r Zstatus_iterator�pydoc_topic_labelsrk r Z
domaindata�warnZget_and_resolve_doctreer rB Zidsr �write�outputr� )
r Zignored�writerZlabelr� ZlabelidZsectnameZdoctreeri Z destinationr r r r� s ! zPydocTopicsBuilder.writec
C s� t t j | j d � d � } z^ | j d j d � � | j d t � j d � � | j d t | j � d j d � � Wd | j � Xd S)Nz topics.py�wbz# -*- coding: utf-8 -*-
zutf-8z # Autogenerated by Sphinx on %s
z topics = �
)
rw r rt Zoutdirr� �encoder r r� ry )r �fr r r �finish- s +zPydocTopicsBuilder.finish) rL rM rN r^ r� r� r� r� r� r r r r r� s r� z (\w+(?:\+\d)?)(?:\s*\((.*)\))?c C s� t j | � } | d k r$ t � n | j � \ } } | t j | | � 7} | d k r� t j � } | | 7} | t j | | � 7} n | j � S)z-Transform an opcode signature into RST nodes.N) �
opcode_sig_re�match�
ValueError�groupsr
� desc_nameZdesc_parameterlistZdesc_parameter�strip)r rX rY rJ �opnameZarglistZ paramlistr r r �parse_opcode_signature< s
r� z([a-z()!]+)\s*(.*)c C s� t j | � } | d k r$ t � n | j � \ } } | j d d � j d d � } | t j | | � 7} | r� | t j d | d | � 7} n | S)z1Transform a pdb command signature into RST nodes.N�(r; �)r< )�
pdbcmd_sig_rer� r� r� �replacer
r� rW )r rX rY rJ r^ �args�fullnamer r r �parse_pdb_commandV s !r� c C s
| j d t � | j d t � | j d t � | j d t � | j t � | j t j � | j
d d d t � | j
d d d t � | j
d
d
d � | j
d d
t � | j
d d t � | j
d d t � | j
d d t � | j d t � i d d 6d d 6S)Nr2 rl z impl-detailzdeprecated-removedZopcodez %s (opcode)Z
pdbcommandZpdbcmdz%s (pdb command)Z 2to3fixerz%s (2to3 fixer)�pyZ decoratorZdecoratormethodZcoroutinefunctionZcoroutinemethodZmiscnewsz1.0rf TZparallel_read_safe)Zadd_roler4 r8 Z
add_directiver9 rc Z add_builderr� �
suspiciousZ CheckSuspiciousMarkupBuilderZadd_description_unitr� r� Zadd_directive_to_domainr] r_ ra rb rp )Zappr r r �setupc s"
r� )D�__doc__�rerv �osr Ztimer �pprintr Z docutils.ior Zdocutils.parsers.rstr Zdocutils.utilsr Zdocutilsr r Zsphinxr
Zsphinx.buildersr Zsphinx.util.nodesr Zsphinx.writers.htmlr
Zsphinx.writers.textr Zsphinx.writers.latexr Zsphinx.domains.pythonr r r� r* r5 Zdocutils.parsers.rst.statesr ZenumZ
convertersZvisit_literal_blockr Zdepart_literal_blockr% r" r& r4 r8 r9 �objectrS r] r_ r` ra rb rc �compiler{ r} rp r� r� r� r� r� r� r� r r r r �<module>
sz @
.$ (