1j{0 n
d Z ddlmZ ddlmZ ddlmZ ddlmZm Z m
Z
m Z m Z ddl
mZ ddlmZ d Z ed
g d Z G d d
Z G d d Ze dd Ze dd Ze dd Ze dd Ze dd Ze dd Z e d d Z e d d Z e d d! Z e d"d# Z e d$d%d& Z!e d'd(d& Z"e 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 Z-e d?d@ Z.e dAdBdC Z/e dDdEdF Z0e dGdH Z1e1 dIdJdK Z2e1 dLdM Z3e1 dNdO Z4e dPdQ Z5e5 dRdSdT Z6e5 dUdVdW Z7e5 dUdXdY Z8e5 dZd[ Z9e5 d\d]d^ Z:e5 d_d` Z;e5 dadbd^ Ze5 dgdhdC Z?e5 didjdk Z@e5 dldmdC ZAe5 dndodC ZBe5 dpdqdC ZCe5 drdsdC ZDe5 dtdudC ZEe5 dvdwdT ZFe5 dxdyd^ ZGe5 dzd{d| ZHe5 d}d~ ZIe5 dd ZJ G d deK ZL eMeN ZO eLeOh dz
eOh dz
eOh dz
d ZPdS )z Docstring violation definition. )
namedtuple)partial) dropwhile)AnyCallableIterableListOptional )
Definitionis_blank)Error
ErrorRegistry conventions ErrorParams)code
short_desccontextc
e Zd ZdZdZdZdedededee ddf
d Zd
e d eddfd Z
e d
Z e d Z
e defd Ze defd ZdefdZdefdZdd defdZdS )r zError in docstring style.Fr r r
parametersreturnNc Z || _ || _ || _ || _ d| _ d| _ dS )zYInitialize the object.
`parameters` are specific to the created error.
N)r r r r
definition explanation)selfr r r r s g/builddir/build/BUILD/cloudlinux-venv-1.0.11/venv/lib/python3.11/site-packages/pydocstyle/violations.py__init__zError.__init__ s5 $ $ r r c " || _ || _ dS )z+Set the source code context for this error.N)r r )r r r s r set_contextzError.set_context+ s $&r c $ | j j j S N)r modulenamer s r zError.0 s T_%;%@ r c | j j S r# )r error_linenor& s r r' zError.1 s != r c p | j d| j }| j | j j | j }|d| dz
}|S )z(Return the message to print to the user.z: Nz ())r r r formatr )r retspecific_error_msgs r messagez
Error.message3 sS //do// < #!4 !4do!F -*--- -C
r c | j dS d}| j j d }| j j }t t t t
t t | }t t |t | z }d| d}t | D ]5\ }}|rd|z }|| ||z | z
}|dk r|d z
} n6|S )
z,Return the source code lines for this error.N T)keependsz{:z}:{} z ...
) r source
splitlinesstartlistreversedr r lenstr enumerater, ) r r5 linesoffsetlines_stripped
numbers_width line_formatnlines r r= z Error.lines< s ? "2&1141@@ & T)Hhuoo>>?? @ @
C^)<)< < = =>>
2M222 00 GAt
"Tz k((VT:: :F1uu/)
r c 6 j rz Error.__str__..T sA ) )x{{)) ) ) ) ) )r z1{filename}:{line} {definition}:
{message}z
{explanation}
{lines}
z
{lines}
z
{explanation}
c 2 i | ]}|t | S )getattr)rG r% r s r
z!Error.__str__.._ s5
gdD))
r )filenamerC r r/ r r= rK )r joinsplitr5 explainr, )r templates ` r __str__z
Error.__str__R s #yy ) ) +11$77) ) ) D H ; 04< 0 8 8HH
[ 0 0 'HH
\ 0$+ 0 / /H x
r c t | S r# )r; r& s r __repr__zError.__repr__l s 4yyr otherc > | j | j f|j |j fk S r# )rN rC )r rV s r __lt__z Error.__lt__o s
ty)U^UZ,HHHr )__name__
__module__ __qualname____doc__rQ r5 r; r r r r! propertyrN rC r/ r= rS rU boolrX rK r r r r sk ## G
F
c]
&'j 's 't ' ' ' '
x@@AAH 8== > >D
X s X*
4# IG I I I I I I Ir r c e Zd ZdZg Z G d d Zedededefd Zede e fd Z
edefd Z d
S ) r z1A registry of all error codes, divided to groups.c l e Zd ZdZdededdfdZ d deded ee deee ge f fd
Z
dS ) ErrorRegistry.ErrorGroupz#A group of similarly themed errors.prefixr% r Nc 0 || _ || _ g | _ dS )zInitialize 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)rb r% errors)r rb r% s r r z!ErrorRegistry.ErrorGroup.__init__{ s !DK DI DKKKr
error_code
error_desc
error_contextc t ||| }t t g|R }| j | |S )z9Create an error, register it to this group and return it.)r r r rd append)r re rf rg error_paramsfactorys r create_errorz%ErrorRegistry.ErrorGroup.create_error sE 'z:}MML e3l333G K | , , ,Nr r# ) rY rZ r[ r\ r; r r
r r r rl rK r r
ErrorGroupra x s 11
3
c
d
,0 $C=
x}ou,
- r rm rb r% r c f | || }| j | |S )z'Create a new error group and return it.)rm groupsri )clsrb r% groups r create_groupzErrorRegistry.create_group s2 vt,,
% r c # D K | j D ]}|j D ] }|j V dS )zYield all registered codes.N)ro rd r )rp rq errors r get_error_codesz ErrorRegistry.get_error_codes sJ Z ! !E
!
!j
! ! !r c t d | j D }dd|dz z z dz }d|dz dz z d z }d
}| j D ]}||z
}||z
}|dd |j d |dz z d z z
}||z
}|j D ]K}||z
}|d|j d z d
z |j |dz z d z z
}L||z
}|S )z;Output the registry as reStructuredText, for documentation.c 3 R K | ]"}|j D ]}t |j V #d S r# )rd r: r )rG rq rt s r rI z'ErrorRegistry.to_rst.. sZ
! !
r z+------+- z+
| r3 z|
r1 z** z| r )maxro r% centerrd r r ljust)rp max_lensep_line
blank_linetablerq rt s r to_rstzErrorRegistry.to_rst sT
'! )< r r r r r r r r r r r r r r r r r r > r r r r r r r r r > r r r r r r r r r r r r )pep257numpygoogleN)Qr\ collectionsr functoolsr itertoolsr typingr r r r r
parserr utilsr __all__r r r rr D1xxrl r r r r r r r r D2xxr r r r r r r r r r r r r r r r D3xxr r r D4xxr r D401br r r r r r r r r r r r r r r r r r dictr setru
all_errorsr rK r r r s % % " " " " " " : : : : : : : : : : : : : :
3 j (I(I(IJJ _I _I _I _I _I _I _I _IDJ J J J J J J JZ !!$(<==
(
'
(
*
)
'
.
#
!!$(;<<
>
6
5
2
1
@
8
!
F
7
3
A
B
( !!$88
$
0
1
!!$(BCC
)
-
=
:
A
6
1
,
,
K
;7
&
'
E
+
%
*
4A
N
t
S ..00
1
1
h
*
E1 13 3 r