Your IP : 216.73.216.213
B
� f�E � O @ 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 ddl m Z m!Z! ddl"m#Z# ddl$m%Z%m&Z& ddl'Z'dZ(dZ)dZ*ddl+m,Z, dd� e,j-j.d< e,j-j.d< e,j-j.d< e,j-j.d < e j/Z0e#j1Z2d d � Z3d d � Z4e3e _/e4e#_1i g fd!d"�Z5i g fd#d$�Z6i g fd%d&�Z7G d'd(� d(e
�Z8G d)d*� d*e
�Z9G d+d,� d,e:�Z;G d-d.� d.e;e%�Z<G d/d0� d0e;e&�Z=G d1d2� d2e:�Z>G d3d4� d4e:�Z?G d5d6� d6e>e%�Z@G d7d8� d8e>e&�ZAG d9d:� d:e?e&�ZBG d;d<� d<e?e&�ZCG d=d>� d>e&�ZDG d?d@� d@e
�ZEe�FdAejG�ZHe�FdBejG�ZIe�FdC�ZJG dDdE� dEe
�ZKdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcdddedfdgdhdidjdkdldmdndodpdqdrdsdtdudvdwdxdydzd{d|d}d~dd�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�gOZLG d�d�� d�e�ZMe�Fd��ZNd�d�� ZOe�Fd��ZPd�d�� ZQd�d�� ZRdS )�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)�status_iterator)�split_explicit_title)�HTMLTranslator)�
TextWriter�TextTranslator)�LaTeXTranslator)�
PyModulelevel�
PyClassmemberz5https://bugs.python.org/issue?@action=redirect&bpo=%sz+https://github.com/python/cpython/issues/%sz-https://github.com/python/cpython/tree/3.7/%s)�Bodyc C s d S )N� )�xr r �D/opt/alt/python37/lib64/python3.7/Doc/tools/extensions/pyspecific.py�<lambda>/ � 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_block7 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_blockB s r* c C s~ t �|�}dt|� k r"dk rXn n2|jjd|�d�|d�}|�|||�} | g|gfS d| }tj||t| d�}
|
gg fS )Ni�� i� z The BPO ID z/ seems too high -- use :gh:`...` for GitHub IDs)�linezbpo-)�refuri) r
�unescape�int�reporter�error� problematicr � reference� ISSUE_URI) �typ�rawtext�text�lineno�inliner�options�content�issue�msg�prb�refnoder r r �
issue_roleS s
r? c C sn t �|�}t|�dk rH|jjd|�d�|d�}|�|||�} | g|gfS d| }tj||t| d�}
|
gg fS )Ni�~ zThe GitHub ID z. seems too low -- use :issue:`...` for BPO IDs)r+ zgh-)r, ) r
r- r. r/ r0 r1 r r2 � GH_ISSUE_URI) r4 r5 r6 r7 r8 r9 r: r; r< r= r> r r r �
gh_issue_roleb s
rA c C s@ t |�\}}} t�|�}t�| �} tj||t| d�}
|
gg fS )N)r, )r r
r- r r2 �
SOURCE_URI) r4 r5 r6 r7 r8 r9 r: Zhas_t�title�targetr> r r r � source_roler s
rE c @ s( e Zd ZdZdZdZdZdZdd� ZdS )�ImplementationDetailTr � z CPython implementation detail:c C s. t jdgd�}td �| j�}| j}t �||�}| jrh| j� | jd | j
�\}}|� t j d || �� � | j�
|| j|� |j�rt|d t j ��rt j|d jdd�}|d j|_|d j|_||d j7 }|d �t j dd|dd�� |d �d|� |d �d t �d
�� n|�dt � dd|�� |gS ) Nz impl-detail)�classes�sphinxr � T)� translatableFrG � )rJ rJ )r �compoundr
�gettext�
label_textr: �strong� arguments�state� inline_textr7 �append� paragraph� nested_parse�content_offset�children�
isinstance�inline� rawsource�sourcer+ � replace_self�insertZText)r# �pnode�labelr: Zadd_text�n�mr r r �run� s&
zImplementationDetail.runN) �__name__�
__module__� __qualname__� has_content�required_arguments�optional_arguments�final_argument_whitespacerO rc r r r r rF | s rF c @ s$ e Zd ZdZdZdZdZdd� ZdS )� AvailabilityFrG r Tc C sn d}t j|| jd dgd�}| j�|| j�\}}|�|| � | j�| jd | j�\}}|�|| � |gS )Nz$:ref:`Availability <availability>`: r � availability)rH )r rU rQ rR rS r7 �extend)r# Zavailability_refr_ ra rb r r r rc � s
zAvailability.runN)rd re rf rg rh ri rj rc r r r r rk � s
rk c s$ e Zd Z� fdd�Zdd� Z� ZS )�PyDecoratorMixinc s* t t| ��||�}|�dt�dd�� |S )Nr �@)�superrn �handle_signaturer^ r � desc_addname)r# �sig�signode�ret)� __class__r r rq � s z!PyDecoratorMixin.handle_signaturec C s dS )NFr )r# r r r �
needs_arglist� s z PyDecoratorMixin.needs_arglist)rd re rf rq rw �
__classcell__r r )rv r rn � s rn c @ s e Zd Zdd� ZdS )�PyDecoratorFunctionc C s d| _ t�| �S )Nz py:function)�namer rc )r# r r r rc � s zPyDecoratorFunction.runN)rd re rf rc r r r r ry � s ry c @ s e Zd Zdd� ZdS )�PyDecoratorMethodc C s d| _ t�| �S )Nz py:method)rz r rc )r# r r r rc � s zPyDecoratorMethod.runN)rd re rf rc r r r r r{ � s r{ c s e Zd Z� fdd�Z� ZS )�PyCoroutineMixinc s* t t| ��||�}|�dt�dd�� |S )Nr z
coroutine )rp r| rq r^ r �desc_annotation)r# rs rt ru )rv r r rq � s z!PyCoroutineMixin.handle_signature)rd re rf rq rx r r )rv r r| � s r| c s e Zd Z� fdd�Z� ZS )�PyAwaitableMixinc s* t t| ��||�}|�dt�dd�� |S )Nr z
awaitable )rp r~ rq r^ r r} )r# rs rt ru )rv r r rq � s z!PyAwaitableMixin.handle_signature)rd re rf rq rx r r )rv r r~ � s r~ c @ s e Zd Zdd� ZdS )�PyCoroutineFunctionc C s d| _ t�| �S )Nz py:function)rz r rc )r# r r r rc � s zPyCoroutineFunction.runN)rd re rf rc r r r r r � s r c @ s e Zd Zdd� ZdS )�PyCoroutineMethodc C s d| _ t�| �S )Nz py:method)rz r rc )r# r r r rc � s zPyCoroutineMethod.runN)rd re rf rc r r r r r� � s r� c @ s e Zd Zdd� ZdS )�PyAwaitableFunctionc C s d| _ t�| �S )Nz py:function)rz r rc )r# r r r rc � s zPyAwaitableFunction.runN)rd re rf rc r r r r r� � s r� c @ s e Zd Zdd� ZdS )�PyAwaitableMethodc C s d| _ t�| �S )Nz py:method)rz r rc )r# r r r rc � s zPyAwaitableMethod.runN)rd re rf rc r r r r r� � s r� c s$ e Zd Z� fdd�Zdd� Z� ZS )�PyAbstractMethodc s* t t| ��||�}|�dt�dd�� |S )Nr zabstractmethod )rp r� rq r^ r r} )r# rs rt ru )rv r r rq � s z!PyAbstractMethod.handle_signaturec C s d| _ t�| �S )Nz py:method)rz r rc )r# r r r rc � s zPyAbstractMethod.run)rd re rf rq rc rx r r )rv r r� � s r� c @ s0 e Zd ZdZdZdZdZi ZdZdZ dd� Z
dS ) �DeprecatedRemovedT� rG zKDeprecated since version {deprecated}, will be removed in version {removed}zCDeprecated since version {deprecated}, removed in version {removed}c C s. t �� }| jj|_d|d< | jd | jd f}||d< | jjjj}tdd� |jj �
d�D ��}td d� | jd �
d�D ��}||k r�| j }n| j }t
d
�|�}|j| jd | jd d �}t| j�d k�r| j�| jd
| jd �\}} tj| jd
df|�ddi�}
|�|
� ng } | j�r2| j�| j| j|� t|��r�t|d tj��r�|d j�r�tj|d jdd�} |d j | _ |d j | _ | |d j 7 } |d � tjdd| dd�� |d � dtjdd| dgd�� n.tjddtjdd| dgd�dd�}
|�|
� | jjjj}|�!d|d || j� |g| S )Nzdeprecated-removed�typer rG �versionc s s | ]}t |�V qd S )N)r. )�.0�er r r � <genexpr> s z(DeprecatedRemoved.run.<locals>.<genexpr>�.c s s | ]}t |�V qd S )N)r. )r� r� r r r r� s rI )�
deprecatedZremoved� r� rJ rK FT)rK z%s: �versionmodified)rH z%s.r� )"r r� rR �documentrQ �settingsr �tupleZconfigr� �split�_deprecated_label�_removed_labelr
rN �format�lenrS r7 r rU rT r: rV rW rY r[ rZ r\ r+ rX r] r^ Znote_versionchange) r# r$ r� r Zcurrent_versionZremoved_versionr` r6 ZinodesZmessagesZparar: r r r rc sL
zDeprecatedRemoved.runN) rd re rf rg rh ri rj � option_specr� r� rc r r r r r� � s r� z(?:[Ii]ssue #|bpo-)([0-9]+)z(?:gh-issue-|gh-)([0-9]+)z (?im)^what's new in (.*?)\??$c @ s( e Zd ZdZdZdZdZi Zdd� ZdS )�MiscNewsFrG r c
C s� | j d }| jj�| j| jj d �}td�}|sBt�t� |��}t�
||�}| j j j
j�|� y&tj|dd��}|�� }W d Q R X W n& tk
r� d}t�||�}|gS X t�d|�}t�d|�}t�d |�}d
d g|�� d d � } | j�| |� g S )
Nr rG ZPY_MISC_NEWS_DIRzutf-8)�encodingz The NEWS file is not available.z :issue:`\1`z:gh:`\1`z\1z.. default-role:: objrJ r� ) rQ Z
state_machineZ input_linesr\ r7 Z input_offsetr r �dirname�abspath�joinrR r� r� Zrecord_dependencies�add�io�open�read� Exceptionr rP �issue_re�sub� gh_issue_re� whatsnew_re�
splitlinesZ insert_input)
r# Zfnamer\ Z
source_dirZfpath�fpr: r6 r$ �linesr r r rc D s*
z MiscNews.runN) rd re rf rg rh ri rj r� rc r r r r r� = s r� �assertZ
assignment�asynczatom-identifiersz
atom-literalszattribute-accesszattribute-referencesZ augassign�awaitZbinaryZbitwisezbltin-code-objectszbltin-ellipsis-objectzbltin-null-objectzbltin-type-objectsZbooleans�breakzcallable-typesZcalls�classZ comparisonsrM 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 �initx s zPydocTopicsBuilder.initc C s dS )Nzall pydoc topicsr )r# r r r �get_outdated_docs| s z$PydocTopicsBuilder.get_outdated_docsNc C s dS )NrJ r )r# �docnamer4 r r r �get_target_uri s z!PydocTopicsBuilder.get_target_uric
G s� t | �}x�ttdtt�d�D ]�}|| jjd d krD| �d| � q | jjd d | \}}}| j�|| �}td�}|� |j
| � t dd�} |� || � |j
| j|< q W d S ) Nzbuilding topics... )�lengthZstd�labelsz label %r not in documentationz<section node>zutf-8)r� )r r �pydoc_topic_labelsr� r Z
domaindata�warnZget_and_resolve_doctreer rT Zidsr �write�outputr� )
r# Zignored�writerr` r� ZlabelidZsectnameZdoctreer� Z destinationr r r r� � s
zPydocTopicsBuilder.writec C sl t t�| jd�d�}zH|�d�d�� |�dt� �d�� |�dt| j� d �d�� W d |� � 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� �close)r# �fr r r �finish� s "zPydocTopicsBuilder.finish)N) rd re rf rz r Zdefault_translator_classr� r� r� r� r� r r r r r� s s
r� z (\w+(?:\+\d)?)(?:\s*\((.*)\))?c C sb t �|�}|dkrt�|�� \}}|t�||�7 }|dk rZt�� }||7 }|t�||�7 }|�� S )z-Transform an opcode signature into RST nodes.N) �
opcode_sig_re�match�
ValueError�groupsr � desc_nameZdesc_parameterlistZdesc_parameter�strip)r rs rt rb �opnameZarglistZ paramlistr r r �parse_opcode_signature� s
r� z([a-z()!]+)\s*(.*)c C sf t �|�}|dkrt�|�� \}}|�dd��dd�}|t�||�7 }|rb|t�d| d| �7 }|S )z1Transform a pdb command signature into RST nodes.N�(rJ �)rL )�
pdbcmd_sig_rer� r� r� �replacer r� rr )r rs rt rb rz �args�fullnamer r r �parse_pdb_command� s
r� c C s | � dt� | � dt� | � dt� | �dt� | �dt� | �dt� | �t � | �t
j � | � dddt
� | � d d
d t� | � d d d
� | �ddt� | �ddt� | �ddt� | �ddt� | �ddt� | �ddt� | �ddt� | �dt� ddd�S )Nr; Zghr\ z impl-detailrl zdeprecated-removedZopcodez %s (opcode)Z
pdbcommandZpdbcmdz%s (pdb command)Z 2to3fixerz%s (2to3 fixer)�pyZ decoratorZdecoratormethodZcoroutinefunctionZcoroutinemethodZawaitablefunctionZawaitablemethod�abstractmethodZmiscnewsz1.0T)r� Zparallel_read_safe)Zadd_roler? rA rE Z
add_directiverF rk r� Z add_builderr� �
suspiciousZ CheckSuspiciousMarkupBuilderZadd_object_typer� r� Zadd_directive_to_domainry r{ r r� r� r� r� r� )Zappr r r �setup� s(
r� )S�__doc__�rer� �osr r Ztimer Zpprintr Z docutils.ior Zdocutils.parsers.rstr Zdocutils.utilsr Zdocutilsr r
rI r Zsphinx.buildersr Z
sphinx.localer
Z sphinx.utilr Zsphinx.util.nodesr Zsphinx.writers.htmlr Zsphinx.writers.textr r Zsphinx.writers.latexr Zsphinx.domains.pythonr r r� r3 r@ rB Zdocutils.parsers.rst.statesr �enumZ
convertersZvisit_literal_blockr" Zdepart_literal_blockr) r' r* r? rA rE rF rk �objectrn ry r{ r| r~ r r� r� r� r� r� �compile�Ir� r� r� r� r� r� r� r� r� r� r� r r r r �<module>
s� 4
#
9
$
+