,>SE d Z ddlmZ ddlmZ ddlZddlmZmZmZ ddl m
Z
ddl m Z ddl
mZ dd lmZmZmZmZmZmZ dd
lmZ d Z dddZ G d de ZdS )z5Special methods checker and helper function's module. ) annotations)CallableN)basesnodesutil)InferenceContext)InferenceResult) BaseChecker) PYMETHODSSPECIAL_METHODS_PARAMSdecorated_withis_function_body_ellipsisonly_required_for_messages
safe_infer)PyLinter__next__nodenodes.FunctionDefcallercontextInferenceContext | NonereturnInferenceResult | Nonec | || }t | }n"# t j $ r Y dS t $ r Y dS w xY w t | dS # t j $ r Y dS t $ r |cY S w xY w)zSafely infer the return value of a function.
Returns None if inference failed or if there is some ambiguity (more than
one node has been inferred). Otherwise, returns inferred value.
)r N)infer_call_resultnextastroidInferenceError
StopIteration)r r r inferitvalues /builddir/build/BUILD/cloudlinux-venv-1.0.10/venv/lib/python3.11/site-packages/pylint/checkers/classes/special_methods_checker.py_safe_infer_call_resultr# s (((AAW
! tt tt W
t ! tt s, &) A AA A A=/ A=<A=c e Zd ZdZdZddde dddd gifd
d d dd
gifdddddddddddd
ZdG fd Z ed dd d d!d"d#d$d%d&d'd(d)
dHd, Z e Z
dHd-Z e dId2 Z
e dJd3 Ze dJd4 Ze dJd5 Ze dJd6 Ze dJd7 Ze dJd8 Ze dJd9 ZdKd;ZdKd<ZdKd=ZdKd>ZdKd?ZdKd@ZdKdAZdKdBZ dKdCZ dKdDZ dKdEZ dKdFZ xZ!S )LSpecialMethodsCheckerzOChecker which verifies that special methods
are implemented correctly.
classesz __iter__ returns non-iteratornon-iterator-returnedzVUsed when an __iter__ method returns something which is not an iterable (i.e. has no `z ` method) old_names)W0234zold-non-iterator-returned-1)E0234zold-non-iterator-returned-2z6The special method %r expects %s param(s), %d %s given#unexpected-special-method-signaturezEmitted when a special method was defined with an invalid number of parameters. If it has too few or too many, it might not work at all.)E0235zbad-context-manager)z,__len__ does not return non-negative integerinvalid-length-returnedzPUsed when a __len__ method returns something which is not a non-negative integer)z __bool__ does not return boolinvalid-bool-returnedzAUsed when a __bool__ method returns something which is not a bool)z __index__ does not return intinvalid-index-returnedzGUsed when an __index__ method returns something which is not an integer)z __repr__ does not return strinvalid-repr-returnedzCUsed when a __repr__ method returns something which is not a string)z__str__ does not return strinvalid-str-returnedzBUsed when a __str__ method returns something which is not a string)z __bytes__ does not return bytesinvalid-bytes-returnedzAUsed when a __bytes__ method returns something which is not bytes)z __hash__ does not return intinvalid-hash-returnedzEUsed when a __hash__ method returns something which is not an integer)z4__length_hint__ does not return non-negative integer invalid-length-hint-returnedzXUsed when a __length_hint__ method returns something which is not a non-negative integer)z __format__ does not return strinvalid-format-returnedzEUsed when a __format__ method returns something which is not a string)z&__getnewargs__ does not return a tupleinvalid-getnewargs-returnedzHUsed when a __getnewargs__ method returns something which is not a tuple)zB__getnewargs_ex__ does not return a tuple containing (tuple, dict) invalid-getnewargs-ex-returnedzbUsed when a __getnewargs_ex__ method returns something which is not of the form tuple(tuple, dict))
E0301E0302E0303E0304E0305E0306E0307E0308E0309E0310E0311E0312E0313linterr r Nonec
t | | j | j | j | j | j | j | j | j | j
| j | j | j
d | _ d S )N) __iter____len____bool__ __index____repr____str__ __bytes____hash____length_hint__
__format____getnewargs____getnewargs_ex__)super__init__ _check_iter
_check_len _check_bool _check_index _check_repr
_check_str _check_bytes _check_hash_check_length_hint
_check_format_check_getnewargs_check_getnewargs_ex
_protocol_map)selfrE __class__s r" rU z SpecialMethodsChecker.__init__ s{
( ( * ( * ( # 6 , " 4!%!:
r- r. r/ r0 r1 r2 r3 r4 r5 r6 r7 r r c | sd S t || }|r9|j | j v r+t | s | j |j || |j t
v r| | d S d S N) is_methodr# namerb r r "_check_unexpected_method_signaturerc r inferreds r" visit_functiondefz'SpecialMethodsChecker.visit_functiondef s ~~ F*466
: T ///-d33 0
*D ty )$ 9 9 9 9 ! ! 3 3D 9 9 9 9 9 " !re c | t |j }|d S |j j s|j j sd S t |dg r
|j j }n|j j dd }t | t |j j z
}t |j j }||z }d}t |t r||v}d|d d|d }n3||z
}|dk rd}n%|dk rd}n |dk r||z
dk p |j j }|r-|dk rdnd } | d
|j ||| f| d S d S ) Nzbuiltins.staticmethod Fzbetween r z or Twaswerer+ )argsr )
r ri rr varargr
lendefaults
isinstancetuple add_message)
rc r expected_paramsall_args mandatoryoptionalcurrent_paramsemitrestverbs
r" rj z8SpecialMethodsChecker._check_unexpected_method_signature s 0; " Fy~ di&6
F $!8 9 : : *y~HHy~abb)HMMC (:$;$;; ty)**"X- ou - - H O3D V ); U U QRAS U UOO #Y.Dqyy %_ 2 Fdi6FG *a / /55VD 5i .$G
re r type_strboolc t | t j o%| j |k ot | t j S rg )rv r Instanceri r Const)r r s r" _is_wrapped_typez&SpecialMethodsChecker._is_wrapped_type s>
tU^ , ,
2 U"
2 tU[111
re c t | d rdS t | t j ot | j t S )NintT)r% r rv r r r! r r s r" _is_intz SpecialMethodsChecker._is_int B 1 1$ > > 4$ ,,LDJ1L1LLre c t | d rdS t | t j ot | j t S )Nr T)r% r rv r r r! r r s r" _is_strz SpecialMethodsChecker._is_str r re c t | d rdS t | t j ot | j t S )Nr T)r% r rv r r r! r r s r" _is_boolz SpecialMethodsChecker._is_bool
B 1 1$ ? ? 4$ ,,MDJ1M1MMre c t | d rdS t | t j ot | j t S )NbytesT)r% r rv r r r! r r s r" _is_bytesz SpecialMethodsChecker._is_bytes B 1 1$ @ @ 4$ ,,NDJ1N1NNre c t | d rdS t | t j ot | j t S )Nrw T)r% r rv r r r! rw r s r" _is_tuplez SpecialMethodsChecker._is_tuple r re c t | d rdS t | t j ot | j t S )NdictT)r% r rv r r r! r r s r" _is_dictz SpecialMethodsChecker._is_dict" r re c t | t j rdS t | t j rdS t | t j r2 | t dS # t j $ r Y nw xY wt | t j
rb| }|rLt |t j
r2 | t dS # t j $ r Y nw xY wdS )NTF) rv r Generatorr ComprehensionScoper
local_attr NEXT_METHODr
NotFoundErrorClassDef metaclass)r r s r" _is_iteratorz"SpecialMethodsChecker._is_iterator) s dEO , , 4 dE 4 5 5 4 dEN + +
,,,t(
en
-
- ((I
Z 5> B B
((555 4 , Dus$ A0 0BBC, ,C>=C>rl c b | | s| d| d S d S )Nr' r )r rx rk s r" rV z!SpecialMethodsChecker._check_iterB sE ** A 44 @ @ @ @ @ A Are c | | s| d| d S t |t j r$|j dk r| d| d S d S d S )Nr- r r r rx rv r r r! rk s r" rW z SpecialMethodsChecker._check_lenF s ||H%% C 6T B B B B B
%+
.
. C8>A3E3E 6T B B B B B C C3E3Ere c b | | s| d| d S d S )Nr. r )r rx rk s r" rX z!SpecialMethodsChecker._check_boolL sC }}X&& A 44 @ @ @ @ @ A Are c b | | s| d| d S d S )Nr/ r r rx rk s r" rY z"SpecialMethodsChecker._check_indexP sC ||H%% B 5D A A A A A B Bre c b | | s| d| d S d S )Nr0 r r rx rk s r" rZ z!SpecialMethodsChecker._check_reprT C ||H%% A 44 @ @ @ @ @ A Are c b | | s| d| d S d S )Nr1 r r rk s r" r[ z SpecialMethodsChecker._check_strX sC ||H%% @ 3$ ? ? ? ? ? @ @re c b | | s| d| d S d S )Nr2 r )r rx rk s r" r\ z"SpecialMethodsChecker._check_bytes\ sC ~~h'' B 5D A A A A A B Bre c b | | s| d| d S d S )Nr3 r r rk s r" r] z!SpecialMethodsChecker._check_hash` r re c | | s| d| d S t |t j r$|j dk r| d| d S d S d S )Nr4 r r r rk s r" r^ z(SpecialMethodsChecker._check_length_hintd s ||H%% H ;$ G G G G G
%+
.
. H8>A3E3E ;$ G G G G G H H3E3Ere c b | | s| d| d S d S )Nr5 r r rk s r" r_ z#SpecialMethodsChecker._check_formatl sC ||H%% C 6T B B B B B C Cre c b | | s| d| d S d S )Nr6 r )r rx rk s r" r` z'SpecialMethodsChecker._check_getnewargsp sE ~~h'' G : F F F F F G Gre c | | s| d| d S t |t j sd S d}t |j dk rd}n|j d | j f|j d | j ffD ]Y\ }}t |t j rt | }|r)t |t j s || sd} nZ|r| d| d S d S )Nr7 r F Tr ro ) r rx rv r Tuplert eltsr Callr r UninferableBase)rc r rl found_errorargchecks r" ra z*SpecialMethodsChecker._check_getnewargs_exv s7 ~~h'' =D I I I F(EK00 F x} " " KK q!4>2 q!4=1
U c5:.. *$S//C z#t/C D D 5:: &* J =D I I I I I J Jre )rE r r rF )r r r rF )r r r r r r )r r r r )r r rl r r rF )"__name__
__module__ __qualname____doc__ri r msgsrU r rm visit_asyncfunctiondefrj staticmethodr r r r r r r r rV rW rX rY rZ r[ r\ r] r^ r_ r` ra
__classcell__)rd s @r" r% r% 8 s D
, #
=&1
=
=
= <<
E 1
2 ;< =
WQ Q Df
& - ! &!%( : : : : /0 0 0 0d
\
M M M \M M M M \M N N N \N O O O \O O O O \O N N N \N \0A A A AC C C C A A A AB B B BA A A A@ @ @ @B B B BA A A AH H H HC C C CG G G G J J J J J J J Jre r% rg )r r r r r r r r )r
__future__r collections.abcr r r r r astroid.contextr astroid.typingr pylint.checkersr
pylint.checkers.utilsr r r
r r r pylint.lint.pylinterr r r# r% re r" r s]
< ; " " " " " " $ $ $ $ $ $ & & & & & & & & & & , , , , , , * * * * * * ' ' ' ' ' ' * ) ) ) ) ) (, 4[J [J [J [J [JK [J [J [J [J [Jre