Your IP : 216.73.216.213
��Yf�7 � 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 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! � Z0 Gd" d# � d# e � Z1 Gd$ d% � d% e2 � Z3 Gd& d' � d' e3 e � Z4 Gd( d) � d) e3 e! � Z5 Gd* d+ � d+ e2 � Z6 Gd, d- � d- e6 e � Z7 Gd. d/ � d/ e6 e! � Z8 Gd0 d1 � d1 e! � Z9 Gd2 d3 � d3 e � Z: e j; d4 � Z< e j; d5 � Z= Gd6 d7 � d7 e � Z> 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� d� d� gM Z? Gd� d� � d� e � Z@ e j; d� � ZA d� d� � ZB e j; d� � ZC d� d� � ZD d� d� � ZE 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�TextTranslator)�LaTeXTranslator)�
PyModulelevel�
PyClassmemberz https://bugs.python.org/issue%sz-https://github.com/python/cpython/tree/3.5/%s)�Bodyc C s d S)N� )�xr r �D/opt/alt/python35/lib64/python3.5/Doc/tools/extensions/pyspecific.py�<lambda>, s r Z
loweralphaZ
upperalphaZ
lowerromanZ
upperromanc C sb | j j j | j j } | j j } d | k r= d | j _ 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 sc | j j j | j d } | j j } d | k r> d | j _ 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)Nzbpo-�refuri)r �unescaper � reference� ISSUE_URI) �typ�rawtext�text�lineno�inliner�options�content�issue�refnoder r r �
issue_roleP s
r5 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/ r0 r1 r2 Zhas_t�title�targetr4 r r r � source_roleY s
r9 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 | | � � | 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 �compoundr2 �strong� arguments�state� inline_textr/ �append� paragraph� nested_parse�content_offset�children�
isinstance�insertZText)r Zpnoder2 Zadd_text�n�mr r r �runj s % zImplementationDetail.runN)�__name__�
__module__� __qualname__� has_content�required_arguments�optional_arguments�final_argument_whitespacerL r r r r r: c s
r: 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 �@)�superrT �handle_signaturerI r
� desc_addname)r �sig�signode�ret)� __class__r r rW ~ s z!PyDecoratorMixin.handle_signaturec C s d S)NFr )r r r r �
needs_arglist� s z PyDecoratorMixin.needs_arglist)rM rN rO rW r] r r )r\ r rT } s rT c @ s e Z d Z d d � Z d S)�PyDecoratorFunctionc C s d | _ t j | � S)Nz py:function)�namer rL )r r r r rL � s zPyDecoratorFunction.runN)rM rN rO rL 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 rL )r r r r rL � s zPyDecoratorMethod.runN)rM rN rO rL 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 )rV ra rW rI r
�desc_annotation)r rY rZ r[ )r\ r r rW � s z!PyCoroutineMixin.handle_signature)rM rN rO rW r r )r\ r ra � s ra c @ s e Z d Z d d � Z d S)�PyCoroutineFunctionc C s d | _ t j | � S)Nz py:function)r_ r rL )r r r r rL � s zPyCoroutineFunction.runN)rM rN rO rL r r r r rc � s rc c @ s e Z d Z d d � Z d S)�PyCoroutineMethodc C s d | _ t j | � S)Nz py:method)r_ r rL )r r r r rL � s zPyCoroutineMethod.runN)rM rN rO rL r r r r rd � s rd c s. e Z d Z � f d d � Z d d � Z � S)�PyAbstractMethodc s; t t | � j | | � } | j d t j d d � � | S)Nr zabstractmethod )rV re rW rI r
rb )r rY rZ r[ )r\ r r rW � s
z!PyAbstractMethod.handle_signaturec C s d | _ t j | � S)Nz py:method)r_ r rL )r r r r rL � s zPyAbstractMethod.run)rM rN rO rW rL r r )r\ r re � s re 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 s, 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 | � 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 | � � | 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� rg r< Z translatableTz%s: r; �versionmodifiedz%s.Z
deprecated)r
rk rA �documentr@ �_label�lenrB r/ r rD rC r2 rE rF rH Z rawsourceZinline�source�linerG Z replace_selfrI �settingsr Znote_versionchange) r r ri r. ZinodesZmessagesZparar2 r r r r rL � s<
#
zDeprecatedRemoved.runN)
rM rN rO rP rQ rR rS � option_specrm rL r r r r rf � s rf z(?:[Ii]ssue #|bpo-)([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,`bpo-\1 <https://bugs.python.org/issue\1>`__z\1z.. default-role:: objr< rj )r@ Z
state_machineZ input_linesro r/ Z input_offsetr �dirname�abspath�joinrA rl rq Zrecord_dependencies�add�codecs�open�read�close� Exceptionr r? �issue_re�sub� whatsnew_re�
splitlinesZ insert_input)
r Zfnamero Z
source_dirZfpath�fpr2 r. r �linesr r r rL � s*
z MiscNews.runN) rM rN rO rP rQ rR rS rr rL r r r r rs � s rs �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 @ s[ e Z d Z d Z e 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 | _ i | _ d S)N)�topicsZ
secnumbers)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 y d d l m } Wn t k
r1 | j } Yn Xt | � } x� | t d d t t � �D]� } | | j j d d k r� | j d | � qZ | j j d d | \ } } } | j j | | � } t
d � } | j | j | � t
d d
� }
| j | |
� | j | j | <qZ Wd S) Nr )�status_iteratorzbuilding topics... ZlengthZstdZlabelsz label %r not in documentationz<section node>rt zutf-8)Z sphinx.utilr� � ImportErrorr �pydoc_topic_labelsrn r Z
domaindata�warnZget_and_resolve_doctreer rC Zidsr �write�outputr� ) r Zignoredr� �writerZlabelr� ZlabelidZsectnameZdoctreerl 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 = �
)
rz r rw Zoutdirr� �encoder r r� r| )r �fr r r �finishA s +zPydocTopicsBuilder.finish) rM rN rO r_ r Zdefault_translator_classr� r� r� r� r� r r r r r� s r� z (\w+(?:\+\d)?)(?:\s*\((.*)\))?c C s� t j | � } | d k r! t � | j � \ } } | t j | | � 7} | d k r� t j � } | | 7} | t j | | � 7} | j � S)z-Transform an opcode signature into RST nodes.N) �
opcode_sig_re�match�
ValueError�groupsr
� desc_nameZdesc_parameterlistZdesc_parameter�strip)r rY rZ rK �opnameZarglistZ paramlistr r r �parse_opcode_signatureP s
r� z([a-z()!]+)\s*(.*)c C s� t j | � } | d k r! t � | j � \ } } | j d d � j d d � } | t j | | � 7} | r� | t j d | d | � 7} | S)z1Transform a pdb command signature into RST nodes.N�(r< �)r= )�
pdbcmd_sig_rer� r� r� �replacer
r� rX )r rY rZ rK r_ �args�fullnamer r r �parse_pdb_commandj 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 d t � | j d t � d d d d i S)Nr3 ro z impl-detailzdeprecated-removedZopcodez %s (opcode)Z
pdbcommandZpdbcmdz%s (pdb command)Z 2to3fixerz%s (2to3 fixer)�pyZ decoratorZdecoratormethodZcoroutinefunctionZcoroutinemethod�abstractmethodZmiscnewsri z1.0Zparallel_read_safeT)Zadd_roler5 r9 Z
add_directiver: rf Z add_builderr� �
suspiciousZ CheckSuspiciousMarkupBuilderZadd_description_unitr� r� Zadd_directive_to_domainr^ r` rc rd re rs )Zappr r r �setupw s$
r� )F�__doc__�rery �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 r Zsphinx.writers.latexr Zsphinx.domains.pythonr r r� r+ r6 Zdocutils.parsers.rst.statesr ZenumZ
convertersZvisit_literal_blockr Zdepart_literal_blockr& r# r' r5 r9 r: �objectrT r^ r` ra rc rd re rf �compiler~ r� rs r� r� r� r� r� r� r� r r r r �<module>
s| @
.$ /