Your IP : 216.73.216.213
3
� f1: � M @ s d Z ddlZddlZddlmZmZ ddlmZ ddlm Z ddl
m Z ddl m
Z
ddlmZ dd lmZmZ dd
lmZ dd lmZ dd lmZ dd
lmZ ddlm Z ddl m Z m Z ddl m!Z! ddl"m#Z#m$Z$ ddl%Z%dZ&dZ'ddl(m)Z) dd� e)j*j+d< e)j*j+d< e)j*j+d< e)j*j+d< e j,Z-e!j.Z/dd � Z0d d � Z1e0e _,e1e!_.i g fd d �Z2i g fd!d"�Z3G d#d$� d$e
�Z4G d%d&� d&e5�Z6G d'd(� d(e6e#�Z7G d)d*� d*e6e$�Z8G d+d,� d,e5�Z9G d-d.� d.e9e#�Z:G d/d0� d0e9e$�Z;G d1d2� d2e$�Z<G d3d4� d4e
�Z=ej>d5�Z?ej>d6�Z@G d7d8� d8e
�ZAd9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcdddedfdgdhdidjdkdldmdndodpdqdrdsdtdudvdwdxdydzd{d|d}d~dd�d�d�d�d�d�gMZBG d�d�� d�e�ZCej>d��ZDd�d�� ZEej>d��ZFd�d�� ZGd�d�� ZHdS )�z�
pyspecific.py
~~~~~~~~~~~~~
Sphinx extension with Python doc-specific markup.
:copyright: 2008-2014 by Georg Brandl.
:license: Python license.
� N)�getenv�path)�asctime)�pformat)� StringOutput)� Directive)� new_document)�nodes�utils)�addnodes)�Builder)� translators)�split_explicit_title)�HTMLTranslator)�
TextWriter�TextTranslator)�LaTeXTranslator)�
PyModulelevel�
PyClassmemberz https://bugs.python.org/issue%sz-https://github.com/python/cpython/tree/3.6/%s)�Bodyc C s d S )N� )�xr r �D/opt/alt/python36/lib64/python3.6/Doc/tools/extensions/pyspecific.py�<lambda>- s r Z
loweralphaZ
upperalphaZ
lowerromanZ
upperromanc C sH | j jj| j j }| jj}d|kr*d| j_zt| |� W d || j_X d 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_block5 s r% c C sJ | j jj| jd }| jj}d|kr,d| j_zt| |� W d || j_X d 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 s0 t j|�}d| }tj||t| d�}|gg fS )Nzbpo-)�refuri)r
�unescaper � reference� ISSUE_URI) �typ�rawtext�text�lineno�inliner�options�content�issue�refnoder r r �
issue_roleQ s
r7 c C s@ t |�\}}} tj|�}tj| �} tj||t| d�}
|
gg fS )N)r* )r r
r+ r r, �
SOURCE_URI) r. r/ r0 r1 r2 r3 r4 Zhas_t�title�targetr6 r r r � source_roleZ s
r; c @ s( e Zd ZdZdZdZdZdZdd� ZdS )�ImplementationDetailTr r& z CPython implementation detail:c C s, t jdgd�}td j| j�}| j}t j||�}| jrh| jj | jd | j
�\}}|j t j d || �� � | jj
|| j|� |jo�t|d t j ��rt j|d jdd�}|d j|_|d j|_||d j7 }|d jt j dd|dd�� |d jd|� |d jd t jd
�� n|jdt j dd|�� |gS ) Nz impl-detail)�classes�sphinxr � T)� translatableFr& � )r? r? )r �compoundr
�gettext�
label_textr4 �strong� arguments�state� inline_textr1 �append� paragraph� nested_parse�content_offset�children�
isinstance�inline� rawsource�source�line� replace_self�insertZText)r! Zpnode�labelr4 Zadd_text�n�mr r r �runn s&
zImplementationDetail.runN) �__name__�
__module__� __qualname__� has_content�required_arguments�optional_arguments�final_argument_whitespacerD rX r r r r r< d s r< c s$ e Zd Z� fdd�Zdd� Z� ZS )�PyDecoratorMixinc s* t t| �j||�}|jdtjdd�� |S )Nr �@)�superr` �handle_signaturerT r � desc_addname)r! �sig�signode�ret)� __class__r r rc � s z!PyDecoratorMixin.handle_signaturec C s dS )NFr )r! r r r �
needs_arglist� s z PyDecoratorMixin.needs_arglist)rY rZ r[ rc ri �
__classcell__r r )rh r r` � s r` c @ s e Zd Zdd� ZdS )�PyDecoratorFunctionc C s d| _ tj| �S )Nz py:function)�namer rX )r! r r r rX � s zPyDecoratorFunction.runN)rY rZ r[ rX r r r r rk � s rk c @ s e Zd Zdd� ZdS )�PyDecoratorMethodc C s d| _ tj| �S )Nz py:method)rl r rX )r! r r r rX � s zPyDecoratorMethod.runN)rY rZ r[ rX r r r r rm � s rm c s e Zd Z� fdd�Z� ZS )�PyCoroutineMixinc s* t t| �j||�}|jdtjdd�� |S )Nr z
coroutine )rb rn rc rT r �desc_annotation)r! re rf rg )rh r r rc � s z!PyCoroutineMixin.handle_signature)rY rZ r[ rc rj r r )rh r rn � s rn c @ s e Zd Zdd� ZdS )�PyCoroutineFunctionc C s d| _ tj| �S )Nz py:function)rl r rX )r! r r r rX � s zPyCoroutineFunction.runN)rY rZ r[ rX r r r r rp � s rp c @ s e Zd Zdd� ZdS )�PyCoroutineMethodc C s d| _ tj| �S )Nz py:method)rl r rX )r! r r r rX � s zPyCoroutineMethod.runN)rY rZ r[ rX r r r r rq � s rq c s$ e Zd Z� fdd�Zdd� Z� ZS )�PyAbstractMethodc s* t t| �j||�}|jdtjdd�� |S )Nr zabstractmethod )rb rr rc rT r ro )r! re rf rg )rh r r rc � s z!PyAbstractMethod.handle_signaturec C s d| _ tj| �S )Nz py:method)rl r rX )r! r r r rX � s zPyAbstractMethod.run)rY rZ r[ rc rX rj r r )rh r rr � s rr c @ s, e Zd ZdZdZdZdZi ZdZdd� Z dS )�DeprecatedRemovedT� r& zKDeprecated since version {deprecated}, will be removed in version {removed}c
C s� t j� }| jj|_d|d< | jd | jd f}||d< td j| j�}|j| jd | jd d�}t | j�dkr�| jj
| jd | j d �\}}t j
| jd d
f|�d d i�}|j|� ng }| jr�| jj| j| j|� t |��rtt|d t j
�o�|d j�rPt j|d jd
d�}|d j|_|d j|_||d j7 }|d jt j
d
d
|d d�� |d jdt jd
d| dgd�� n.t j
d
d
t jd
d| dgd�d d�}|j|� | jjjj} | j d|d || j � |g| S )Nzdeprecated-removed�typer r& �versionr> )�
deprecatedZremoved� rt r? r@ FT)r@ z%s: �versionmodified)r= z%s.rw ) r ry rG �documentrF r
rC �_label�format�lenrH r1 r rJ rI r4 rK rL rN rP rO rQ rR rM rS rT �settingsr Znote_versionchange)
r! r" rv rU r0 ZinodesZmessagesZparar4 r r r r rX � s@
zDeprecatedRemoved.runN)
rY rZ r[ r\ r] r^ r_ � option_specr{ rX r r r r rs � s rs z(?:[Ii]ssue #|bpo-)([0-9]+)z (?im)^what's new in (.*?)\??$c @ s( e Zd ZdZdZdZdZi Zdd� ZdS )�MiscNewsFr& r c
C s� | j d }| jjj| j| jj d �}td�}|sBtjtj |��}tj
||�}| j j j
jj|� y*tj|dd�}z |j� }W d |j� X W n& tk
r� d}tj||�}|gS X tjd|�}tjd|�}d d
g|j� d d � } | jj| |� g S ) Nr r& ZPY_MISC_NEWS_DIRzutf-8)�encodingz The NEWS file is not available.z,`bpo-\1 <https://bugs.python.org/issue\1>`__z\1z.. default-role:: objr? rx ) rF Z
state_machineZ input_linesrQ r1 Z input_offsetr r �dirname�abspath�joinrG rz r~ Zrecord_dependencies�add�codecs�open�read�close� Exceptionr rE �issue_re�sub� whatsnew_re�
splitlinesZ insert_input)
r! ZfnamerQ Z
source_dirZfpath�fpr4 r0 r" �linesr r r rX � s.
z MiscNews.runN) rY rZ r[ r\ r] r^ r_ r rX r r r r r� � s r� �assertZ
assignmentzatom-identifiersz
atom-literalszattribute-accesszattribute-referencesZ augassignZbinaryZbitwisezbltin-code-objectszbltin-ellipsis-objectzbltin-null-objectzbltin-type-objectsZbooleans�breakzcallable-typesZcalls�classZ comparisonsrB 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 Zd ZdZeZdd� Zdd� Zd
dd�Zd d
� Z d d � Z
dS )�PydocTopicsBuilderz pydoc-topicsc C s i | _ i | _d S )N)�topicsZ
secnumbers)r! r r r �init1 s zPydocTopicsBuilder.initc C s dS )Nzall pydoc topicsr )r! r r r �get_outdated_docs5 s z$PydocTopicsBuilder.get_outdated_docsNc C s dS )Nr? r )r! �docnamer. r r r �get_target_uri8 s z!PydocTopicsBuilder.get_target_uric
G s� yddl m} W n tk
r* | j}Y nX t| �}x�|tdtt�d�D ]�}|| jjd d krp| jd| � qH| jjd d | \}}}| jj || �}t
d�} | j |j | � t
d d
�}
|j| |
� |j| j|< qHW d S ) Nr )�status_iteratorzbuilding topics... )ZlengthZstdZlabelsz label %r not in documentationz<section node>zutf-8)r� )Z sphinx.utilr� � ImportErrorr �pydoc_topic_labelsr} r Z
domaindata�warnZget_and_resolve_doctreer rI Zidsr �write�outputr� ) r! Zignoredr� �writerrU r� ZlabelidZsectnameZdoctreerz Z destinationr r r r� ; s$
zPydocTopicsBuilder.writec
C sl t tj| jd�d�}zH|jdjd�� |jdt� jd�� |jdt| j� d jd�� W d |j � X d S )Nz topics.py�wbz# -*- coding: utf-8 -*-
zutf-8z # Autogenerated by Sphinx on %s
z topics = �
)
r� r r� Zoutdirr� �encoder r r� r� )r! �fr r r �finishP s "zPydocTopicsBuilder.finish)N) rY rZ r[ rl r Zdefault_translator_classr� r� r� r� r� r r r r r� , s
r� z (\w+(?:\+\d)?)(?:\s*\((.*)\))?c C sb t j|�}|dkrt�|j� \}}|tj||�7 }|dk rZtj� }||7 }|tj||�7 }|j� S )z-Transform an opcode signature into RST nodes.N) �
opcode_sig_re�match�
ValueError�groupsr � desc_nameZdesc_parameterlistZdesc_parameter�strip)r re rf rW �opnameZarglistZ paramlistr r r �parse_opcode_signature_ s
r� z([a-z()!]+)\s*(.*)c C sf t j|�}|dkrt�|j� \}}|jdd�jdd�}|tj||�7 }|rb|tjd| d| �7 }|S )z1Transform a pdb command signature into RST nodes.N�(r? �)rA )�
pdbcmd_sig_rer� r� r� �replacer r� rd )r re rf rW rl �args�fullnamer r r �parse_pdb_commandy s
r� c C s� | j dt� | j dt� | jdt� | jdt� | jt� | jtj � | j
dddt � | j
ddd t � | j
d
d
d � | j
d d
t� | j
d dt� | j
d dt� | j
d dt� | j
d dt� | jdt� ddd�S )Nr5 rQ z impl-detailzdeprecated-removedZopcodez %s (opcode)Z
pdbcommandZpdbcmdz%s (pdb command)Z 2to3fixerz%s (2to3 fixer)�pyZ decoratorZdecoratormethodZcoroutinefunctionZcoroutinemethod�abstractmethodZmiscnewsz1.0T)rv Zparallel_read_safe)Zadd_roler7 r; Z
add_directiver< rs Z add_builderr� �
suspiciousZ CheckSuspiciousMarkupBuilderZadd_object_typer� r� Zadd_directive_to_domainrk rm rp rq rr r� )Zappr r r �setup� s
r� )I�__doc__�rer� �osr r Ztimer �pprintr Z docutils.ior Zdocutils.parsers.rstr Zdocutils.utilsr Zdocutilsr r
r> r Zsphinx.buildersr Z
sphinx.localer
Zsphinx.util.nodesr Zsphinx.writers.htmlr Zsphinx.writers.textr r Zsphinx.writers.latexr Zsphinx.domains.pythonr r r� r- r8 Zdocutils.parsers.rst.statesr �enumZ
convertersZvisit_literal_blockr Zdepart_literal_blockr( r% r) r7 r; r< �objectr` rk rm rn rp rq rr rs �compiler� r� r� r� r� r� r� r� r� r� r r r r �<module>
s~ 4
#
0
&
0