Your IP : 216.73.216.196
B
;��Y�) � @ s( d Z ddlmZ ddlmZ ddlmZ ddlmZ dZ edd d
d g�Z
G d d
� d
e �Z G dd� de �Z
e
�dd�Ze�dd�Ze�dd�Ze�dd�Ze�dd�Ze�dd�Ze�d d �Ze�d d �Ze�d d!�Ze
�d"d#�Ze�d$d%d&�Ze�d'd(d&�Ze�d)d*d&�Z e�d+d,d&�Z e�d-d.d&�Z e�d/d0d&�Z e�d1d2�Z e�d3d4�Z!e�d5d6�Z"e�d7d8�Z#e�d9d:�Z$e�d;d<d&�Z%e�d=d>�Z&e�d?d@�Z'e�dAdBdC�Z(e�dDdEdF�Z)e
�dGdH�Z*e*�dIdJdK�Z+e*�dLdM�Z,e*�dNdO�Z-e
�dPdQ�Z.e.�dRdSdT�Z/e.�dUdVdW�Z0e.�dUdXdY�Z1e.�dZd[�Z2e.�d\d]d^�Z3e.�d_d`�Z4e.�dadbd^�Z5e.�dcddd^�Z6e.�dedfdC�Z7e.�dgdhdC�Z8e.�didjdk�Z9e.�dldmdC�Z:e.�dndodC�Z;e.�dpdqdC�Z<e.�drdsdC�Z=e.�dtdudC�Z>G dvdw� dwe?�Z@eAe
�B� �ZCe@eCd+d=d?dAdDd_dadcdedgdidldnh
eCd d+d=d?dZdrh dx��ZDdyS )zz Docstring violation definition.� )� dropwhile)�partial)�
namedtuple� )�is_blank)�Error�
ErrorRegistry� ErrorParams�code�
short_desc�contextc @ sp e Zd ZdZdZdZdd� Zdd� Zedd� �Z ed d� �Z
ed
d � �Z ed d
� �Z dd� Z
dd� Zdd� ZdS )r zError in docstring style.Fc G s( || _ || _|| _|| _d| _d| _dS )zYInitialize the object.
`parameters` are specific to the created error.
N)r
r r �
parameters�
definition� explanation)�selfr
r r r
� r �F/opt/alt/python37/lib/python3.7/site-packages/pydocstyle/violations.py�__init__ s zError.__init__c C s || _ || _dS )z+Set the source code context for this error.N)r r )r r r r r r � set_context# s zError.set_contextc C s
| j jjS )N)r �module�name)r r r r �<lambda>( � zError.<lambda>c C s | j jS )N)r �start)r r r r r ) r c C s: d� | j| j�}| jdk r6| jj | j� }|d� |�7 }|S )z(Return the message to print to the user.z{}: {}Nz ({}))�formatr
r r r
)r �retZspecific_error_msgr r r �message+ s
z
Error.messagec C s� d}| j j}| j j}tttttt|�����}tt|t|� ��}d� |�}xFt
|�D ]:\}}|rjd| }||� || |�7 }|dkrV|d7 }P qVW |S )z,Return the source code lines for this error.� z {{:{}}}:{{}}� � z ...
) r �sourcer �list�reversedr r �len�strr � enumerate) r r �lines�offsetZlines_strippedZ
numbers_widthZ line_format�n�liner r r r& 4 s
z Error.linesc s� d� dd� � j�d�D ��� _d}� jr8� jr8|d7 }n*� jrN� jsN|d7 }n� jrb� jsb|d7 }|jf t� fdd�d D ���S )
N�
c s s | ]}t |�s|V qd S )N)r )�.0�lr r r � <genexpr>H s z Error.__str__.<locals>.<genexpr>z1{filename}:{line} {definition}:
{message}z
{explanation}
{lines}
z
{lines}
z
{explanation}
c 3 s | ]}|t � |�fV qd S )N)�getattr)r+ r )r r r r- Q s )�filenamer) r r r r& )�joinr �splitr �explainr �dict)r �templater )r r �__str__G s
z
Error.__str__c C s t | �S )N)r$ )r r r r �__repr__U s zError.__repr__c C s | j | jf|j |jfk S )N)r/ r) )r �otherr r r �__lt__X s z Error.__lt__N)�__name__�
__module__� __qualname__�__doc__r2 r r r �propertyr/ r) r r& r5 r6 r8 r r r r r s
r c @ sH e Zd ZdZg ZG dd� de�Zedd� �Zedd� �Z edd � �Z
d
S ) r z1A registry of all error codes, divided to groups.c @ s" e Zd ZdZdd� Zddd�ZdS )zErrorRegistry.ErrorGroupz#A group of similarly themed errors.c C s || _ || _g | _dS )z�Initialize the object.
`Prefix` should be the common prefix for errors in this group,
e.g., "D1".
`name` is the name of the group (its subject).
N)�prefixr �errors)r r> r r r r r d s z!ErrorRegistry.ErrorGroup.__init__Nc C s* t |||�}ttf|�� }| j�|� |S )z9Create an error, register it to this group and return it.)r r r r? �append)r Z
error_codeZ
error_descZ
error_contextZ error_params�factoryr r r � create_errorp s z%ErrorRegistry.ErrorGroup.create_error)N)r9 r: r; r< r rB r r r r �
ErrorGroupa s rC c C s | � ||�}| j�|� |S )z'Create a new error group and return it.)rC �groupsr@ )�clsr> r �groupr r r � create_groupy s zErrorRegistry.create_groupc c s, x&| j D ] }x|jD ] }|jV qW qW dS )zYield all registered codes.N)rD r? r
)rE rF �errorr r r �get_error_codes� s z ErrorRegistry.get_error_codesc C s� d}d}d}x�| j D ]z}||7 }||7 }|dd�|j��d� d 7 }||7 }x>|jD ]4}||7 }|d|j�d� d |j�d
� d 7 }qVW qW ||7 }|S ) z;Output the registry as reStructuredText, for documentation.zQ+------+-----------------------------------------------------------------------+
zQ| |
r �|z**{}**�N z|
� z| �F )rD r r �centerr? r
r �ljust)rE Zsep_lineZ
blank_line�tablerF rH r r r �to_rst� s .zErrorRegistry.to_rstN) r9 r: r; r< rD �objectrC � classmethodrG rI rQ r r r r r \ s r ZD1zMissing Docstrings�D100z"Missing docstring in public module�D101z!Missing docstring in public class�D102z"Missing docstring in public method�D103z$Missing docstring in public function�D104z#Missing docstring in public package�D105z!Missing docstring in magic method�D106z(Missing docstring in public nested class�D107z Missing docstring in __init__ZD2zWhitespace Issues�D200z5One-line docstring should fit on one line with quotesz found {0}�D201z0No blank lines allowed before function docstring�D202z/No blank lines allowed after function docstring�D203z,1 blank line required before class docstring�D204z+1 blank line required after class docstring�D205z:1 blank line required between summary line and description�D206z2Docstring should be indented with spaces, not tabs�D207zDocstring is under-indented�D208zDocstring is over-indented�D209z@Multi-line docstring closing quotes should be on a separate line�D210z1No whitespaces allowed surrounding docstring text�D211z-No blank lines allowed before class docstring�D212z;Multi-line docstring summary should start at the first line�D213z<Multi-line docstring summary should start at the second line�D214zSection is over-indentedz{0!r}�D215z"Section underline is over-indentedzin section {0!r}ZD3z
Quotes Issues�D300z Use """triple double quotes"""zfound {0}-quotes�D301z*Use r""" if any backslashes in a docstring�D302z Use u""" for Unicode docstringsZD4zDocstring Content Issues�D400z#First line should end with a periodz not {0!r}�D401z'First line should be in imperative moodz'{0}', not '{1}'z7First line should be in imperative mood; try rephrasingz found '{0}'�D402z3First line should not be the function's "signature"�D403z;First word of the first line should be properly capitalizedz{0!r}, not {1!r}�D404z0First word of the docstring should not be `This`�D405z+Section name should be properly capitalized�D406z&Section name should end with a newline�D407z&Missing dashed underline after section�D408zDSection underline should be in the line following the section's name�D409z5Section underline should match the length of its namez1Expected {0!r} dashes in section {1!r}, got {2!r}�D410z Missing blank line after section�D411z!Missing blank line before section�D412z?No blank lines allowed between a section header and its content�D413z%Missing blank line after last section�D414zSection has no contentc @ s e Zd Zdd� ZdS )�AttrDictc C s | | S )Nr )r �itemr r r � __getattr__� s zAttrDict.__getattr__N)r9 r: r; r� r r r r r~ � s r~ )Zpep257�numpyN)Er< � itertoolsr � functoolsr � collectionsr �utilsr �__all__r rR r r rG ZD1xxrB rT rU rV rW rX rY rZ r[ ZD2xxr\ r] r^ r_ r` ra rb rc rd re rf rg rh ri rj rk ZD3xxrl rm rn ZD4xxro rp ZD401brq rr rs rt ru rv rw rx ry rz r{ r| r} r3 r~ �setrI Z
all_errorsZ conventionsr r r r �<module> s� M>