o b> @sdZddlZddlmZmZddlZddlZddlZddlZddl Z ddl m Z m Z m Z mZmZmZmZmZmZddlZddlZddlmZddlmZddlmZejZejejejej fZ!ej"ddkZ#e#skd Z$nd Z$hd Z%d Z&d Z'dZ(dZ)dZ*dZ+dZ,dZ-dZ.dddddddZ/dde/0DZ1e2e1Z3Gddde4Z5d d!Z6d"ej7j8d#e9fd$d%Z:d"ej7j8d#e ej7j8fd&d'Z;d"ej7j8d#e e9e ed"ej7j8d#e9fd,d-Z?ej@AZd.ZBd"ej7j8d#e9fd/d0ZCd1eZHd?ej7j8d"ej7j8d#e9fd@dAZId"ej7j8d#ej7j8fdBdCZJdDej7j8d1eabc.abstractmethodabc.abstractpropertyabc.abstractclassmethodabc.abstractstaticmethod__iter__ __aiter____next__ __getitem____class_getitem__ __setitem__ __delitem__ __contains__keys)__new____init____call__)&__del____repr____str__ __bytes____hash____bool____dir____len____length_hint__r __reversed____neg____pos____abs__ __invert__ __complex____int__ __float__r-r.r/r1r2r3 __index__ __enter__ __aenter____getnewargs_ex____getnewargs__ __getstate__ __reduce____copy__ __unicode__ __nonzero__ __await__r __anext__ __fspath__)< __format____lt____le____eq____ne____gt____ge__ __getattr____getattribute__ __delattr__ __delete____instancecheck____subclasscheck__r __missing__rr__add____sub____mul__ __truediv__ __floordiv____mod__ __divmod__ __lshift__ __rshift____and____xor____or____radd____rsub____rmul__ __rtruediv____rmod__ __rdivmod____rpow__ __rlshift__ __rrshift____rand____rxor____ror____iadd____isub____imul__ __itruediv__ __ifloordiv____imod__ __ilshift__ __irshift____iand____ixor____ior____ipow__ __setstate__ __reduce_ex__ __deepcopy__Z__cmp__ __matmul__ __rmatmul__Z__div__) __setattr____get____set__r __set_name__)__exit__ __aexit__) __round__)Nrr)rrcCs i|] \}}|D]}||qqSr).0paramsmethodsnamerrT/var/www/secure340b-portal/env/lib/python3.10/site-packages/pylint/checkers/utils.py src@s eZdZdS)NoSuchArgumentErrorN)__name__ __module__ __qualname__rrrrrsrcCs>|}|rt|jtjs|j}|rt|jtjr |o||jjuS)z=Returns true if node is inside the name of an except handler.) isinstanceparentastroid ExceptHandlerr)nodecurrentrrris_inside_excepts rrreturncCs0|j}|durt|tjrdS|j}|dusdS)z*Return true if given node is inside lambdaNTF)rrrLambdarrrrris_inside_lambdas rccsBt|tjtjfr|jD] }t|D]}|Vqq dS|VdS)z9Recursively returns all atoms in nested lists and tuples.N)rrrr eltsget_all_elements)rchilderrrrs   rcCst|tjrd|jd|jfffSt|tjrI|j}t|r&d|dffS| |d}|rIt|d tj tj tj fsId|d|djffSdS)zChecks if an assignment node in an except handler clobbers an existing variable. Returns (True, args for W0623) if assignment clobbers an existing variable, (False, None) otherwise. Tz object %rrrrzouter scope (line %s))FN)rrZ AssignAttrattrnameexpr as_string AssignNamer is_builtinlookupZ assign_typeAssign AugAssignr fromlineno)rrZstmtsrrrclobber_in_excepts    rcCs&t|dddkr|jtkrdSdS)zHreturn True if the node is referencing the "super" builtin function rNsuperTF)getattrrootr BUILTINS_NAMErrrris_supersrcCs$|D] }t|tjrdSqdS)zAreturn true if the function does nothing but raising an exceptionTF)Z get_childrenrrRaise)r child_noderrris_errors  r) __builtins__cCs|o|jtkS)zHReturns True if the given node is an object from the __builtin__ module.)rrrrrrris_builtin_objectsrrcCs|tvp|tvS)zMreturn true if could be considered as a builtin defined by python )rSPECIAL_BUILTINS)rrrrr!srvar_nodevarnamescopecst|tjr.|jD]"}t|tjrtfdd|jDs(t|tjr+|jvr+dSq dSt|t tj frI| tj D] }|j krFdSq0s  z&is_defined_in_scope..TrF)rrIfbodyranytargetsNonlocalnamesCOMP_NODE_TYPESFornodes_of_classrrWithitemsZ parent_ofr FunctionDefargs is_argument default_valueris_defined_in_scopeZ NoDefaultrr)rrrrZass_noderidsrrrr'sh             rcCs|j}|j}|rt|||rdS|j}|s|}|}|j}|r\|j|kr\|tjD] }|j|kr7dSq-|tj tj fD]}|dd|j DvrPdSqA|}|r\|j|ks'dS)zreturn True if the variable node is defined by a parent node (list, set, dict, or generator comprehension, lambda) or in a previous sibling node on the same line (statement_defining ; statement_using) TcSsg|] }|dp |dqS)rrr)rrrrr ksz%is_defined_before..F) rrrZ statementZprevious_siblingrrrr ImportFromImportr)rr_nodestmtlinenoZ assign_nodeZimp_noderrris_defined_beforeWs,  rcCsN|}t|tjtjfr%|jjD]}|tjD] }||ur#dSqqdS)zbreturn true if the given Name node is used in function or lambda default argument's value TF) rrrrrrdefaultsrName)rr default_nodeZdefault_name_noderrris_default_argumentqs rcCsR|j}|dur't|tjrdS|jst|tjtjtjfr dS|j}|dusdS)z5return true if the name is used in function decoratorNTF) rrrZ DecoratorsZ is_statementrrZComprehensionScopeListComprrrris_func_decorator~s  rframecCsDz|j}Wn tyYdSw|D] }||tjvrdSqdS)zjreturn True if `frame` is an astroid.Class node with `node` in the subtree of its bases attribute FT)rAttributeErrorrrr)rrrbaserrris_ancestor_names  rcCs>|rt|tjtjtjfr|j}|rt|tjtjtjfs |S)zLreturn the higher parent which is not an AssignName, Tuple or List node )rrrrr rrrrr assign_parentsr class_nodecCs0|D]}||vrt||tjrdSqdS)z=return True if is a method overridden from an ancestorTF) ancestorsrrr)rrancestorrrroverrides_a_methods rmessagescsfdd}|S)z@decorator to store messages that are handled by a checker methodcs |_|Sr)Z checks_msgs)funcrrrstore_messagessz&check_messages..store_messagesr)rrrrrcheck_messagess rc@seZdZdZdS)IncompleteFormatStringz:A format string ended in the middle of a format specifier.N)rrr__doc__rrrrrsrc@seZdZdZddZdS)UnsupportedFormatCharacterzXA format character in a format string is not one of the supported format characters.cCst||||_dSr) Exceptionr!index)selfrrrrr!s  z#UnsupportedFormatCharacter.__init__N)rrrrr!rrrrrs r format_stringc st}t}g}d}fdd}d}|tkr|}|dkr||\}}d}|dkr_d} ||\}}|} | dkrU|dkrC| d7} n|dkrK| d8} ||\}}| dks:|d} | | }|d vrm||\}}|d vsc|d kr||d7}||\}}n|tjvr||\}}|tjvs|d kr||\}}|d kr|d7}||\}}n|tjvr||\}}|tjvs|d vr||\}}trd } nd} || vrt||r|||||<n |dkr|d7}|||d7}|tks||||fS)a'Parses a format string, returning a tuple of (keys, num_args), where keys is the set of mapping keys in the format string, and num_args is the number of arguments required by the format string. Raises IncompleteFormatString or UnsupportedFormatCharacter if a parse error occurs.rcs$|d7}|tkr t||fS)Nr)lenr)irrr next_chars  z&parse_format_string..next_char%N(r)z#0- +*.ZhlLzdiouxXeEfFgGcrs%azdiouxXeEfFgGcrs%) setdictrstringdigitsPY3Kraddappend) rrZ key_typesZ pos_typesnum_argsrrcharkeydepthZ key_startZkey_endflagsrrrparse_format_stringsr                    7rcCs"zt|WStytwr)_stringformatter_field_name_split ValueErrorrrrrrsplit_format_field_namess   rc cst}z2||}|D]'}tdd|ddDrq |d}|d}|V|r4t|D]}|Vq.q WdSty\}z|jddrTdVd VWYd}~dSt|d}~ww) zy Given a format string, return an iterator of all the valid format fields. It handles nested fields as well. css|]}|duVqdSrr)ritemrrrr"z(collect_string_fields..rNrrzcannot switch from manual1) r Formatterparseallcollect_string_fieldsrr startswithr)r formatterZ parseiteratorresultrnestedfieldexcrrrr s.   r c Csg}d}t}t|D]E}|rt|r|t|q |rLt|\}}t|tjr6|t|t |}z | |t |fWq t yKt w|d7}q ||t|fS)aq Parses a PEP 3101 format string, returning a tuple of (keyword_arguments, implicit_pos_args_cnt, explicit_pos_args), where keyword_arguments is the set of mapping keys in the format string, implicit_pos_args_cnt is the number of arguments required by the format string and explicit_pos_args is the number of arguments passed with the position. rr)rr strisdigitrrrnumbersNumberintrlistrrr)rZkeyword_argumentsZimplicit_pos_args_cntZexplicit_pos_argsrZkeynameZ fielditeratorrrrparse_format_method_string:s$      rrcCs*|ddko|dko|do|d S)zkreturn True if attribute name is protected (start with _ and some other details), False otherwise. r___)r endswith)rrrris_attr_protectedZs rcCsN|}|dur%t|tjs%|jdurd}n|j}|dur%t|tjr|S)zhreturn klass node for a method node (or a staticmethod or a classmethod), return null otherwise N)rrrClassDefr)rklassrrrnode_frame_classes  r cCstd}||S)zqCheck that attribute name is private (at least two leading underscores, at most one trailing underscore) z^_{2,}.*[^_]+_?$)recompilematch)rregexrrris_attr_privatevs  r% call_nodepositionkeywordcCsn|dur |dur td|dur z|j|WStyYnw|r5|jr5|jD] }|j|kr4|jSq(t)a Returns the specified argument from a function call. :param astroid.Call call_node: Node representing a function call to check. :param int position: position of the argument. :param str keyword: the keyword of the argument. :returns: The node representing the argument, None if the argument is not found. :rtype: astroid.Name :raises ValueError: if both position and keyword are None. :raises NoSuchArgumentError: if no argument at the provided position or with the provided keyword. Nz2Must specify at least one of: position or keyword.)rr IndexErrorkeywordsargvaluer)r&r'r(r+rrrget_argument_from_call~s      r-cCsD|jdvr|jtkrdSt|dsdStdd|jddDS)zV Return true if the given class node is subclass of exceptions.Exception. )r BaseExceptionTrFcss|]}t|VqdSr)inherit_from_std_ex)rrrrrrrz&inherit_from_std_ex..)Zrecurs)rrEXCEPTIONS_MODULEhasattrrrrrrrr/s  r/handlercs>ddt|ts |f}fdd|D}|jsdS||S)ar Check if the given exception handler catches the given error_type. The *handler* parameter is a node, representing an ExceptHandler node. The *error_type* can be an exception, such as AttributeError, the name of an exception, or it can be a tuple of errors. The function will return True if the handler catches any of the given errors. cSst|ts|jS|Sr)rrr)errorrrrstringify_errors z&error_of_type..stringify_errorcsh|]}|qSrr)rr3r4rr sz error_of_type..T)rtupletypeZcatch)r2 error_typeZexpected_errorsrr5r error_of_types  r:c CsR|jsdS|jjD]}t|tjsq z t|rWdSWq tjy&Yq wdS)zA Detect if the given function node is decorated with a property. FT) decoratorsnodesrrr_is_property_decoratorInferenceError)r decoratorrrrdecorated_with_propertys  r@r?cCsj|D].}t|tjr2|jtkr|jdkrdS|D]}|jdkr1|jtkr1dSqqdS)NpropertyTF)inferrrrrrrr)r?inferedrrrrr=s    r=rqnamesc sZ|jr|jjng}|D]}ztfdd|DrWdSWq tjy*Yq wdS)zMDetermine if the `func` node has a decorator with the qualified name `qname`.c3s$|] }|duo |vVqdSr)qname)rrrDrrrs z!decorated_with..TF)r;r<rrBrr>)rrDr;Zdecorator_noderrFrdecorated_withs rGi)maxsizeis_abstract_cbcCs|dur tttd}i}zt|}WntyiYStjy*iYSw|D]M}|D]F}|}t |tj r\t |}|sM|j |vrL||j =q3t |tj s\|j |vr\||j =t |tj ry||}|rn|||j <q3|sy|j |vry||j =q3q-|S)a Get the unimplemented abstract methods for the given *node*. A method can be considered abstract if the callback *is_abstract_cb* returns a ``True`` value. The check defaults to verifying that a method is decorated with abstract methods. The function will work only for new-style classes. For old-style classes, it will simply return an empty dictionary. For the rest of them, it will return a dictionary of abstract method names and their inferred objects. NrF)rrG ABC_METHODSreversedmroNotImplementedErrorrZ ResolveErrorvaluesrr safe_inferrr)rrIvisitedrLrobjrCabstractrrrunimplemented_abstract_methodss>          rScCsP|}tjtjf}|rt|j|s|j}|rt|j|r|r&t|j|r&|jSdS)zDReturn the ExceptHandler or the TryExcept node in which the node is.N)rr TryExceptrr)rrZignoresrrrfind_try_except_wrapper_node+s rUcCspt|}|sdSt|tjr|jj}|jj}ntj dd|jD}|j}t dd|D}t |t }|p7|S)z8Check if the given node is from a fallback import block.Fcss|]}|jVqdSr)rrr2rrrrCs z)is_from_fallback_block..css"|] }t|tjtjfVqdSr)rrrr)rZ import_noderrrrHs  ) rUrrrrrhandlers itertoolschain from_iterabler"_except_handlers_ignores_exception ImportError)rcontextZ other_bodyrWZhas_fallback_importsZignores_import_errorrrris_from_fallback_block9s    r^rWcCstt|fd}tt||S)N)r9)rr:rmap)rW exceptionrrrrr[Psr[cs,t|}t|tjrfdd|jDSdS)a]Return the collections of handlers handling the exception in arguments. Args: node (astroid.NodeNG): A node that is potentially wrapped in a try except. exception (builtin.Exception or str): exception or name of the exception. Returns: list: the collection of handlers that are handling the exception or None. csg|] }t|r|qSr)r:rVr`rrrfs  z*get_exception_handlers..N)rUrrrTrW)rr`r]rrarget_exception_handlersWs   rbcCst|}t|tjS)aCheck if the node is directly under a Try/Except statement. (but not under an ExceptHandler!) Args: node (astroid.Raise): the node raising the exception. Returns: bool: True if the node is inside a try/except statement, False otherwise. )rUrrrT)rr]rrris_node_inside_try_exceptls rccCst||}|s dSt|S)zCheck if the node is in a TryExcept which handles the given exception. If the exception is not given, the function is going to look for bare excepts. F)rbr)rr`Zmanaging_handlersrrrnode_ignores_exceptionzs rdcCs2|D]}|j|ur|jddrdSqdS)zVreturn true if the given class node should be considered as an abstract class F)Zpass_is_abstractT)rrr is_abstract)rmethodrrrclass_is_abstracts  rgr,attrcCsRz||}Wn tjyYdSw|d}t|tjr't|jjtjr'dSdS)NFrT)rrZ NotFoundErrorrrrr,Const)r,rh attributesfirstrrr_supports_protocol_methods rlcCstjtjtjtjf}t||Sr)rrSetCompDictComp GeneratorExpr)rZcomprehensionsrrris_comprehensions  rpcCst|to t|tSr)rlGETITEM_METHOD KEYS_METHODr,rrr_supports_mapping_protocols rtcC t|tSr)rlCONTAINS_METHODrsrrr"_supports_membership_test_protocol rwcCst|tp t|tSr)rl ITER_METHODrqrsrrr_supports_iteration_protocols rzcCrur)rl AITER_METHODrsrrr"_supports_async_iteration_protocolrxr|cCrur)rlrqrsrrr_supports_getitem_protocolrxr}cCrur)rlSETITEM_METHODrsrrr_supports_setitem_protocolrxrcCrur)rlDELITEM_METHODrsrrr_supports_delitem_protocolrxrcCs<|}|d}|d}|dp|d}|p|p|S)NZmixinrRr)lowerrr )rlnameZis_mixinreZis_baserrr_is_abstract_class_names    rcCsR|dur't|tjr t|rdSt|dd}|dur t|r dS|j}|dusdS)NTrF)rrrrgrrr)rrrrris_inside_abstract_classs  rprotocol_callbackcCst|tjrt|s dS|}|dur||rdSt|tjr2t|s&dS|r,dS||r2dSt|tjrKt|j tjrKt|j rK|j }||SdS)NTF) rrrhas_known_bases metaclassZ BaseInstanceZhas_dynamic_getattr_basesZProxyZ_proxied)r,rmetarrr_supports_protocols.    rF check_asynccCs|rt}nt}t||Sr)r|rzr)r,rZprotocol_checkrrr is_iterables rcCrur)rrtrsrrr is_mappingrxrcCst|t}|p t|Sr)rrwr)r, supportedrrrsupports_membership_test s  rcCs$t|tjr t|tr dSt|tS)NT)rrrrlCLASS_GETITEM_METHODrr}rsrrrsupports_getitems   rcCrur)rrrsrrrsupports_setitemrxrcCrur)rrrsrrrsupports_delitemrxrcCsjz |j|d}t|}Wn tjyYdSwzt|WdStjy*YdSty4|YSw)zReturn the inferred value for the given node. Return None if inference failed or if there is some ambiguity (more than one node has been inferred). r]N)rBnextrr> StopIteration)rr]Zinferitr,rrrrOs   rOrcCsjz|jWSty Ynw|jD]}t||d}t|tjr)||us)t||ds/d|_dSqd|_dS)z=Return true if all base classes of a class could be inferred.rFT)Z_all_bases_knownrrrOrrrr)rr]rrrrrr6s$     rcCs4|dupt|tjo|jdupt|tjo|jdkS)NNone)rrrir,rrrrrris_noneJs rcCsrt}z"|D]}|tjkst|rq||t|dkr#WdSqWn tjy0YdSw|r7|SdS)zReturn the inferred type for `node` If there is more than one possible type, or if inferred type is Uninferable or None, return None rN) rrBrZ Uninferablerrrr>pop)rtypesZvar_typerrr node_typeRs   rc Csd}t|tjs dS|jr|jjng}|D]9}t|tjsq|j}t|tjr,|jdkr-qz t |j }Wn tj y@Yqwt|tjrNt ||SqdS)z>Check if the given function node is a singledispatch function.)zfunctools.singledispatchzsingledispatch.singledispatchFregister)rrrr;r<Callr AttributerrrrBr>rG)rZsingledispatch_qnamesr;r?rZfunc_defrrr(is_registered_in_singledispatch_functiongs&   rcCsnt|ddr t|jdSt|ddrt|jdSt|ddr't|jdSt|ddr4t|jdS|jS)z Get the last lineno of the given node. For a simple statement this will just be node.lineno, but for a node that has child statements (e.g. a method) this will be the lineno of the last child statement recursively. finalbodyForelserWr)rget_node_last_linenorrrWrrrrrrrs    rcCs:d}|}|j|}|ot|dtjo|djdkS)z;Check if the postponed evaluation of annotations is enabled annotationsr __future__)rlocalsgetrrrmodname)rrmodulerrrris_postponed_evaluation_enableds  rrrc CsXtdd||fDs dS|D]}z tj||rWdSWqty)YqwdS)z Check if first node is a subclass of second node. :param child: Node to check for subclass. :param parent: Node to check for superclass. :returns: True if child is derived from parent. False otherwise. css|] }t|tjVqdSr)rrr)rrrrrrsz!is_subclass_of..FT)r rrhelpersZ is_subtyper )rrrrrris_subclass_ofs  r)NNr)F)rr functoolsrrrXrr!sysrtypingrrrrrr r r r rrZastroid.exceptionsr rrrrrrrmrnror version_inforr0rJryr{Z NEXT_METHODrqrr~rrvrrZ_SPECIAL_METHODS_PARAMSrZSPECIAL_METHODS_PARAMSrZ PYMETHODSrrrZ node_classesZNodeNGboolrrrrrr__dict__copyrrrrrrrrrrrrrrrrr rrr r%rrr-r/rr:rr@r=rGrSrTrUr^r[rbrrcrdrrgrlrprtrwrzr|r}rrrrrrrrrrrrOrrr8rrrrrrrrrs,    (>m        0     "N!$        ;            !