'![c=@sdZddlZddlZyddlmZWn!ek rUddlmZnXyddlmZWn!ek rddlmZnXddlZddlZddl Z ddl Z ddl Z ddl Z ddl mZmZddlZddlmZddlmZejZejejejejfZe jdd kZesad Znd ZedZdZ e j!rdndZ"dZ#dZ$dZ%dZ&dZ'idd6dd6dds6ddx6dd 6dd6Z)d|e)j*DZ+ee+Z,d}e-fd~YZ.dZ/dZ0dZ1dZ2dZ3dZ4ej5j6ZdZ7dZ8dZ9dZ:dZ;dZ<dZ=dZ>dZ?dZ@de-fdYZAde-fdYZBdZCdZDdZEdZFdddZGdZHdZIdZJdZKdZLeddddZMdZNdZOdZPdZQdZRdZSdZTdZUdZVdZWdZXdZYdZZdZ[dZ\dZ]dZ^dZ_dZ`dZadZbdZcdZddZeeddddZfddZgdZhdZidZjdZkdZldZmdS(s7some functions that may be useful for various checkers iN(tsingledispatch(t lru_cache(tmaptbuiltins(tbases(t scoped_nodesiit exceptionsRsabc.abstractpropertysabc.abstractmethodsabc.abstractclassmethodsabc.abstractstaticmethodt__iter__tnextt__next__t __getitem__t __setitem__t __delitem__t __contains__tkeyst__new__t__init__t__call__t__del__t__repr__t__str__t __bytes__t__hash__t__bool__t__dir__t__len__t__length_hint__t __reversed__t__neg__t__pos__t__abs__t __invert__t __complex__t__int__t __float__t __index__t __enter__t __aenter__t__getnewargs_ex__t__getnewargs__t __getstate__t __reduce__t__copy__t __unicode__t __nonzero__t __await__t __aiter__t __anext__t __fspath__t __format__t__lt__t__le__t__eq__t__ne__t__gt__t__ge__t __getattr__t__getattribute__t __delattr__t __delete__t__instancecheck__t__subclasscheck__t __missing__t__add__t__sub__t__mul__t __truediv__t __floordiv__t__mod__t __divmod__t __lshift__t __rshift__t__and__t__xor__t__or__t__radd__t__rsub__t__rmul__t __rtruediv__t__rmod__t __rdivmod__t__rpow__t __rlshift__t __rrshift__t__rand__t__rxor__t__ror__t__iadd__t__isub__t__imul__t __itruediv__t __ifloordiv__t__imod__t __ilshift__t __irshift__t__iand__t__ixor__t__ior__t__ipow__t __setstate__t __reduce_ex__t __deepcopy__t__cmp__t __matmul__t __rmatmul__t__div__it __setattr__t__get__t__set__t __set_name__it__exit__t __aexit__t __round__cCs,i|]"\}}|D]}||qqS(((t.0tparamstmethodstname((s4lib/python2.7/site-packages/pylint/checkers/utils.pys vs  tNoSuchArgumentErrorcBseZRS((t__name__t __module__(((s4lib/python2.7/site-packages/pylint/checkers/utils.pyRu}scCsH|}x)|r1t|jtj r1|j}q W|oG||jjkS(s=Returns true if node is inside the name of an except handler.(t isinstancetparenttastroidt ExceptHandlerRt(tnodetcurrent((s4lib/python2.7/site-packages/pylint/checkers/utils.pytis_inside_excepts ccsWt|tjtjfrNx5|jD]"}xt|D] }|Vq8Wq%Wn|VdS(s9Recursively returns all atoms in nested lists and tuples.N(RxRztTupletListteltstget_all_elements(R|tchildte((s4lib/python2.7/site-packages/pylint/checkers/utils.pyRs cCst|tjr5t|jd|jjfffSt|tjr|j}t |rlt|dffS|j |d}|rt|dj tj tj tjf rt|d|djffSntdfS(sChecks 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. s object %rRiisouter scope (line %s)N(RxRzt AssignAttrtTruetattrnametexprt as_stringt AssignNameRtt is_builtintlookupt assign_typetAssignt AugAssignR{t fromlinenotFalsetNone(R|Rttstmts((s4lib/python2.7/site-packages/pylint/checkers/utils.pytclobber_in_excepts#   cCs5t|dddkr1|jjtkr1tStS(sHreturn True if the node is referencing the "super" builtin function RttsuperN(tgetattrRtrootRtt BUILTINS_NAMERR(R|((s4lib/python2.7/site-packages/pylint/checkers/utils.pytis_superscCs2x+|jD]}t|tjr)tStSWdS(sAreturn true if the function does nothing but raising an exceptionN(t get_childrenRxRztRaiseRR(R|t child_node((s4lib/python2.7/site-packages/pylint/checkers/utils.pytis_errorscCs+x$|D]}t|tjrtSqWtS(s:return true if the given statement node raise an exception(RxRzRRR(tbodyR|((s4lib/python2.7/site-packages/pylint/checkers/utils.pyt is_raisings t __builtins__cCs|o|jjtkS(sHReturns True if the given node is an object from the __builtin__ module.(RRtR(R|((s4lib/python2.7/site-packages/pylint/checkers/utils.pytis_builtin_objectscCs|tkp|tkS(sMreturn true if could be considered as a builtin defined by python (RtSPECIAL_BUILTINS(Rt((s4lib/python2.7/site-packages/pylint/checkers/utils.pyRsc Cs|j}|j}x|rt|tr]x|jtjD]}|j|kr=tSq=Wnt|tjrx|j jtjD]}|j|krtSqWnSt|tj rx>|j D]J\}}|j |rPn|rt|tjr|j|krtSqWnt|tj tjfr|jj|r|jj |ry |jj||j}wWqtjk rqXntSt|dd|krtSPnIt|tjrt|jtjr|j}|j|krtSqn|j}qW|j}|j}|j}x|r|j|krx-|jtjD]}|j|krQtSqQWxW|jtjtjfD]:}|g|jD]} | dp| d^qkrtSqW|j}q)WtS(sreturn 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) RtiiN(RtRyRxtCOMP_NODE_TYPEStnodes_of_classRzRRtForttargettWithtitemst parent_oftLambdat FunctionDeftargst is_argumentt default_valuet NoDefaultRRR{t statementtprevious_siblingRt ImportFromtImporttnamesR( tvar_nodetvarnamet_nodetass_nodeRtidststmttlinenotimp_nodeRt((s4lib/python2.7/site-packages/pylint/checkers/utils.pytis_defined_beforesd             "0cCsi|j}t|tjrexD|jjD]3}x*|jtjD]}||krDtSqDWq+Wnt S(sXreturn true if the given Name node is used in function default argument's value ( tscopeRxRzRRtdefaultsRtNameRR(R|Ryt default_nodetdefault_name_node((s4lib/python2.7/site-packages/pylint/checkers/utils.pytis_func_defaults  cCsm|j}x]|dk rht|tjr.tS|jsXt|tjtj tj fr\Pn|j}q Wt S(s5return true if the name is used in function decoratorN( RyRRxRzt DecoratorsRt is_statementRRtComprehensionScopetListCompR(R|Ry((s4lib/python2.7/site-packages/pylint/checkers/utils.pytis_func_decorators    cCsSy |j}Wntk r!tSXx*|D]"}||jtjkr)tSq)WtS(sireturn True if `frame` is a astroid.Class node with `node` in the subtree of its bases attribute (RtAttributeErrorRRRzRR(tframeR|Rtbase((s4lib/python2.7/site-packages/pylint/checkers/utils.pytis_ancestor_name!s   cCs;x4|r6t|tjtjtjfr6|j}qW|S(sLreturn the higher parent which is not an AssignName, Tuple or List node (RxRzRRRRy(R|((s4lib/python2.7/site-packages/pylint/checkers/utils.pyt assign_parent.s  cCsAx:|jD],}||kr t||tjr tSq WtS(s=return True if is a method overridden from an ancestor(t ancestorsRxRzRRR(t class_nodeRttancestor((s4lib/python2.7/site-packages/pylint/checkers/utils.pytoverrides_a_method8s"csfd}|S(s@decorator to store messages that are handled by a checker methodcs |_|S(N(t checks_msgs(tfunc(tmessages(s4lib/python2.7/site-packages/pylint/checkers/utils.pytstore_messagesBs ((RR((Rs4lib/python2.7/site-packages/pylint/checkers/utils.pytcheck_messages?stIncompleteFormatStringcBseZdZRS(s:A format string ended in the middle of a format specifier.(RvRwt__doc__(((s4lib/python2.7/site-packages/pylint/checkers/utils.pyRGstUnsupportedFormatCharactercBseZdZdZRS(sXA format character in a format string is not one of the supported format characters.cCstj||||_dS(N(t ExceptionRtindex(tselfR((s4lib/python2.7/site-packages/pylint/checkers/utils.pyRNs(RvRwRR(((s4lib/python2.7/site-packages/pylint/checkers/utils.pyRKsc st}d}fd}d}xX|tkr~|}|dkrq||\}}d }|dkrd}||\}}|}xT|dkr|dkr|d7}n|dkr|d8}n||\}}qW|d} || !}nx"|dkr&||\}}qW|dkrR|d7}||\}}n(x%|tjkry||\}}qUW|d kr||\}}|dkr|d7}||\}}qx(|tjkr||\}}qWn|d kr||\}}ntrd } nd } || kr?t|n|rU|j|qq|dkrq|d7}qqn|d7}q'W||fS(s'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.ics3|d7}|tkr%tn||fS(Ni(tlenR(ti(t format_string(s4lib/python2.7/site-packages/pylint/checkers/utils.pyt next_charZs  t%t(it)s#0- +t*t.thlLsdiouxXeEfFgGcrs%asdiouxXeEfFgGcrs%N(tsetRRtstringtdigitstPY3KRtadd( RRtnum_argsRRtchartkeytdeptht key_starttkey_endtflags((Rs4lib/python2.7/site-packages/pylint/checkers/utils.pytparse_format_stringRs`                  cCs9|ddko8|dko8|jdo7|jd S(skreturn True if attribute name is protected (start with _ and some other details), False otherwise. it_t__(t startswithtendswith(R((s4lib/python2.7/site-packages/pylint/checkers/utils.pytis_attr_protectedscCs]|j}xJ|dk rXt|tj rX|jdkrFd}q|jj}qW|S(shreturn klass node for a method node (or a staticmethod or a classmethod), return null otherwise N(RRRxRztClassDefRy(R|tklass((s4lib/python2.7/site-packages/pylint/checkers/utils.pytnode_frame_classs  " cCstjd}|j|S(sqCheck that attribute name is private (at least two leading underscores, at most one trailing underscore) s^_{2,}.*[^_]+_?$(tretcompiletmatch(Rtregex((s4lib/python2.7/site-packages/pylint/checkers/utils.pytis_attr_privatescCs|dkr'|dkr'tdn|dk rYy|j|SWqYtk rUqYXn|r|jrx*|jD]}|j|krr|jSqrWntdS(s 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. s2Must specify at least one of: position or keyword.N(Rt ValueErrorRt IndexErrortkeywordstargtvalueRu(t call_nodetpositiontkeywordR((s4lib/python2.7/site-packages/pylint/checkers/utils.pytget_argument_from_calls   cCs[|jdkr(|jjtkr(tSt|ds;tStd|jdtDS(sV Return true if the given class node is subclass of exceptions.Exception. Rt BaseExceptionRcss|]}t|VqdS(N(tinherit_from_std_ex(RqRy((s4lib/python2.7/site-packages/pylint/checkers/utils.pys strecurs(RR (RtRtEXCEPTIONS_MODULERthasattrRtanyR(R|((s4lib/python2.7/site-packages/pylint/checkers/utils.pyR s csTdt|ts$|f}nfd|D}|jsGtS|j|S(sr 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|tjs|jS|S(N(Rxtsixt string_typesRv(terror((s4lib/python2.7/site-packages/pylint/checkers/utils.pytstringify_errorscsh|]}|qS(((RqR(R(s4lib/python2.7/site-packages/pylint/checkers/utils.pys s (RxttuplettypeRtcatch(thandlert error_typetexpected_errors((Rs4lib/python2.7/site-packages/pylint/checkers/utils.pyt error_of_types   cCsk|js tSxW|jjD]I}t|tjs8qnyt|rKtSWqtjk rbqXqWtS(sA Detect if the given function node is decorated with a property. ( t decoratorsRtnodesRxRzRt_is_property_decoratorRtInferenceError(R|t decorator((s4lib/python2.7/site-packages/pylint/checkers/utils.pytdecorated_with_propertys  cCsx|jD]}t|tjr |jjtkrM|jdkrMtSx?|jD].}|jdkrZ|jjtkrZtSqZWq q WdS(Ntproperty( tinferRxRzRRRtRRRR(RtinferedR((s4lib/python2.7/site-packages/pylint/checkers/utils.pyRs$$cst|jr|jjng}xR|D]J}y*tfd|jDrQtSWq"tjk rkq"q"Xq"WtS(sMDetermine if the `func` node has a decorator with the qualified name `qname`.c3s-|]#}|dk o$|jkVqdS(N(Rtqname(RqR(tqnames(s4lib/python2.7/site-packages/pylint/checkers/utils.pys s(RRRR"RRzRR(RR%Rtdecorator_node((R%s4lib/python2.7/site-packages/pylint/checkers/utils.pytdecorated_withs " tmaxsizeicCso|dkr$tjtdt}ni}yt|j}Wn&tk rTiStj k rhiSXx|D]}x|j D]}|}t |tj r t |}|s|j|kr||j=qqnt |tjs |j|kr||j=qq nt |tjr||}|r=|||joscss*|] }t|tjtjfVqdS(N(RxRzRR(Rqt import_node((s4lib/python2.7/site-packages/pylint/checkers/utils.pys rs(R9RRxRzR{RyRthandlerst itertoolstchaint from_iterableRt"_except_handlers_ignores_exceptiont ImportError(R|tcontextt other_bodyR;thas_fallback_importstignores_import_error((s4lib/python2.7/site-packages/pylint/checkers/utils.pytis_from_fallback_blockds      cCs+tjtd|f}tt||S(NR(R)R*RRR(R;t exceptionR((s4lib/python2.7/site-packages/pylint/checkers/utils.pyR?xscs9t|}t|tjr5fd|jDSdS(sMReturn the collections of handlers handling the exception in arguments. Args: node (astroid.Raise): the node raising the exception. exception (builtin.Exception or str): exception or name of the exception. Returns: generator: the collection of handlers that are handling the exception or None. c3s$|]}t|r|VqdS(N(R(Rqt_handler(RF(s4lib/python2.7/site-packages/pylint/checkers/utils.pys sN(R9RxRzR7R;R(R|RFRA((RFs4lib/python2.7/site-packages/pylint/checkers/utils.pytget_exception_handlers}s cCst|}t|tjS(sCheck 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. (R9RxRzR7(R|RA((s4lib/python2.7/site-packages/pylint/checkers/utils.pytis_node_inside_try_excepts cCs#t||}|stSt|S(sFCheck if the node is in a TryExcept which handles the given exception.(RHRR(R|RFtmanaging_handlers((s4lib/python2.7/site-packages/pylint/checkers/utils.pytnode_ignores_exceptionscCsIxB|jD]4}|jj|kr |jdtrAtSq q WtS(sVreturn true if the given class node should be considered as an abstract class tpass_is_abstract(RsRyRt is_abstractRR(R|tmethod((s4lib/python2.7/site-packages/pylint/checkers/utils.pytclass_is_abstracts  cCsjy|j|}Wntjk r*tSX|d}t|tjrft|jjtjrftSnt S(Ni( RRzt NotFoundErrorRRxRRyRtConstR(Rtattrt attributestfirst((s4lib/python2.7/site-packages/pylint/checkers/utils.pyt_supports_protocol_methods cCs+tjtjtjtjf}t||S(N(RzRtSetComptDictCompt GeneratorExpRx(R|tcomprehensions((s4lib/python2.7/site-packages/pylint/checkers/utils.pytis_comprehensions  cCst|tot|tS(N(RUtGETITEM_METHODt KEYS_METHOD(R((s4lib/python2.7/site-packages/pylint/checkers/utils.pyt_supports_mapping_protocolscCs t|tS(N(RUtCONTAINS_METHOD(R((s4lib/python2.7/site-packages/pylint/checkers/utils.pyt"_supports_membership_test_protocolscCst|tpt|tS(N(RUt ITER_METHODR[(R((s4lib/python2.7/site-packages/pylint/checkers/utils.pyt_supports_iteration_protocolscCs t|tS(N(RUR[(R((s4lib/python2.7/site-packages/pylint/checkers/utils.pyt_supports_getitem_protocolscCs t|tS(N(RUtSETITEM_METHOD(R((s4lib/python2.7/site-packages/pylint/checkers/utils.pyt_supports_setitem_protocolscCs t|tS(N(RUtDELITEM_METHOD(R((s4lib/python2.7/site-packages/pylint/checkers/utils.pyt_supports_delitem_protocolscCsX|j}|jd}|jd}|jdpE|jd}|pW|pW|S(NtmixinR5R(tlowerRR(Rttlnametis_mixinRMtis_base((s4lib/python2.7/site-packages/pylint/checkers/utils.pyt_is_abstract_class_names  cCssxl|dk rnt|tjrbt|r1tSt|dd}|dk rbt|rbtSn|j}qWt S(NRt( RRxRzRRORRRlRyR(R|Rt((s4lib/python2.7/site-packages/pylint/checkers/utils.pytis_inside_abstract_classs  cCst|tjrPt|s"tS|j}|dk rP||rMtSqPnt|tjrt|srtS|jrtS||rtSnt|t j rt|j tjrt|j r|j }||St S(N( RxRzRthas_known_basesRt metaclassRt BaseInstancethas_dynamic_getattrt_basestProxyt_proxiedR(Rtprotocol_callbacktmeta((s4lib/python2.7/site-packages/pylint/checkers/utils.pyt_supports_protocols(          cCs t|tS(N(RwRa(R((s4lib/python2.7/site-packages/pylint/checkers/utils.pyt is_iterablescCs t|tS(N(RwR](R((s4lib/python2.7/site-packages/pylint/checkers/utils.pyt is_mappingscCst|t}|pt|S(N(RwR_Rx(Rt supported((s4lib/python2.7/site-packages/pylint/checkers/utils.pytsupports_membership_testscCs t|tS(N(RwRb(R((s4lib/python2.7/site-packages/pylint/checkers/utils.pytsupports_getitem scCs t|tS(N(RwRd(R((s4lib/python2.7/site-packages/pylint/checkers/utils.pytsupports_setitem$scCs t|tS(N(RwRf(R((s4lib/python2.7/site-packages/pylint/checkers/utils.pytsupports_delitem(scCsyy"|jd|}t|}Wntjk r9dSXyt|dSWn&tjk rcdStk rt|SXdS(sReturn 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). RAN(R"RRzRRt StopIteration(R|RAtinferitR((s4lib/python2.7/site-packages/pylint/checkers/utils.pyR1-s  cCsy |jSWntk rnXxb|jD]W}t|d|}t|tj ss||ksst|d| r)t|_tSq)Wt |_t S(s=Return true if all base classes of a class could be inferred.RA( t_all_bases_knownRRR1RxRzRRnRR(RRARtresult((s4lib/python2.7/site-packages/pylint/checkers/utils.pyRnBs     cCsL|dkpKt|tjr-|jdkpKt|tjoK|jdkS(NR(RRxRzRQRRRt(R|((s4lib/python2.7/site-packages/pylint/checkers/utils.pytis_noneTs !cCst}y_xX|jD]J}|tjkst|r@qn|j|t|dkrdSqWWntjk rdSX|r|j SdS(sReturn the inferred type for `node` If there is more than one possible type, or if inferred type is YES or None, return None iN( RR"Rzt UninferableRRRRRtpop(R|ttypestvar_type((s4lib/python2.7/site-packages/pylint/checkers/utils.pyt node_type[s   cCsd}t|tjstS|jr1|jjng}x|D]}t|tjs\q>n|j}t|tj s>|j dkrq>nyt |j j }Wntj k rq>nXt|tjr>t||Sq>WtS(s>Check if the given function node is a singledispatch function.sfunctools.singledispatchssingledispatch.singledispatchtregister(sfunctools.singledispatchssingledispatch.singledispatch(RxRzRRRRtCallRt AttributeRRRR"RR'(R|tsingledispatch_qnamesRRRtfunc_def((s4lib/python2.7/site-packages/pylint/checkers/utils.pyt(is_registered_in_singledispatch_functionps$  "cCst|dtr#t|jdSt|dtrFt|jdSt|dtrit|jdSt|dtrt|jdS|jS(s 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. t finalbodyitorelseR;R(RRtget_node_last_linenoRRR;RR(R|((s4lib/python2.7/site-packages/pylint/checkers/utils.pyRscCs3|}x&|jr.|j}t|r tSq WtS(s3Return True if the given node is in a comprehension(RyRZRR(R|tcurnode((s4lib/python2.7/site-packages/pylint/checkers/utils.pytin_comprehensions    cCsx|jD]}y|j}Wntjk r9q nXxN|D]F}t|tjs_qAn|jdkrA|jjdkrAtSqAWq Wt S(sCheck if a class definition defines an Enum class. :param node: The class node to check. :type node: astroid.ClassDef :returns: True if the given node represents an Enum class. False otherwise. :rtype: bool tEnumtenum( RtinferredRzRRxRRtRRR(R|Rtinferred_basesR((s4lib/python2.7/site-packages/pylint/checkers/utils.pyt is_enum_classs  $ (sabc.abstractpropertysabc.abstractmethodsabc.abstractclassmethodsabc.abstractstaticmethod(RRR(&RRRRRRRRRRRRRRRR R!R"RRRR R!R"R#R$R%R&R'R(R)R*R+R,R-R.R/R0(<R1R2R3R4R5R6R7R8R9R:R;R<R=R R>R R R?R@RARBRCRDRERFRGRHRIRJRKRLRMRNRORPRQRRRSRTRURVRWRXRYRZR[R\R]R^R_R`RaRbRcRdReRfRgRhRi(RjRkRlR Rm(RnRo(Rp(ii(R(nRt collectionsR)RR@Rtbackports.functools_lru_cacheR<RtsysRtwarningsRt six.movesRRRzRRrRRvRRRVRWRXRt version_infoRR RR+R`tPY2t NEXT_METHODR[RcReR^R\Rt_SPECIAL_METHODS_PARAMSRtSPECIAL_METHODS_PARAMSt PYMETHODSRRuR~RRRRRt__dict__tcopyRRRRRRRRRRRRRRRRR R RR RR'R6R9RER?RHRIRKRORURZR]R_RaRbRdRfRlRmRwRxRyR{R|R}R~R1RnRRRRRR(((s4lib/python2.7/site-packages/pylint/checkers/utils.pyts                         <    F      :