'![c@sSdZddlmZddlZddlZddlZddlZddlmZm Z ddl m Z m Z ddlm Z ddlmZddlmZdd lmZdd lmZdd lmZmZmZmZmZmZmZmZmZmZm Z m!Z!m"Z"m#Z#m$Z$m%Z%dd l&m'Z'ej(d dfkrZdZ)ndZ)ddddhZ*ej+ddZ,ej+ddZ-dZ.dZ/dZ0dZ1dZ2dZ3dZ4d Z5d!Z6d"Z7d#Z8d$Z9d%Z:d&Z;e<d'Z=d(Z>id)d*d+fd,6d-d.d/fd06d1d2d3fd46d5d6d7fd86d9d:d;fd<6d=d>d?fd@6dAdBdCfdD6dEdFdGfdH6dIdJdKfdL6dMdNdOfdP6dQdRdSfdT6dUdVdWfdX6dYdZd[fd\6d]d^d_fd`6dadbdcfdd6dedfdgfdh6didjdkfdl6dmdndofdp6dqdrdsfdt6dudvdwfdx6dydzd{fd|6d}d~dfd6dddfd6dddfd6dddfd6dddfd6dddfd6dddfd6Z?de@fdYZAdefdYZBdefdYZCddZDdZEdZFdS(s classes checker for Python code i(t generatorsN(t GeneratortBUILTINS(tInconsistentMroErrortDuplicateBasesError(t decorators(tobjects(tfunction_to_method(tIAstroidChecker(t BaseChecker(t PYMETHODStSPECIAL_METHODS_PARAMStoverrides_a_methodtcheck_messagestis_attr_privatetis_attr_protectedtnode_frame_classtis_builtin_objecttdecorated_with_propertytunimplemented_abstract_methodstdecorated_withtclass_is_abstractt safe_inferthas_known_basest is_iterabletis_comprehension(tget_global_optioniit__next__tnexttbooltrangetslicet memoryviewt_CallSignatures!args kws starred_args starred_kwst_ParameterSignaturesargs kwonlyargs varargs kwargscCs8i}g}g}g}x|jp'gD]v}|j|j}}|dkrrt|tjrr|j|jq(t|tjr|j||ts( tkwargsR0tvarargsR1tallR7R,tTrueR/tFalse( t definitionR.tsame_kw_variadicstsame_args_variadicstsame_kwonlyargst same_argstno_additional_kwarg_argumentsR2tis_argt is_kwonly((R.s6lib/python2.7/site-packages/pylint/checkers/classes.pyt_definition_equivalent_to_calljs,      cCs,|jj}|jdkr(|d}n|S(Nt classmethodtmethodi(RJRK(R,ttype(RKt positional((s6lib/python2.7/site-packages/pylint/checkers/classes.pyt_positional_parameterss  cCs(x!|D]}t||r|SqWdS(s Return the type of the node if it exists in potential_types. Args: node (astroid.node): node to get the type of. potential_types (tuple): potential types of the node. Returns: type: type of the node or None. N(R'R&(tnodetpotential_typestpotential_type((s6lib/python2.7/site-packages/pylint/checkers/classes.pyt_get_node_types cCst||t||kS(s} Check equality of nodes based on the comparison of their attributes named attr_name. Args: node_a (astroid.node): first node to compare. node_b (astroid.node): second node to compare. attr_name (str): name of the nodes attribute to use for comparison. Returns: bool: True if node_a.attr_name == node_b.attr_name, False otherwise. (tgetattr(tnode_atnode_bt attr_name((s6lib/python2.7/site-packages/pylint/checkers/classes.pyt_check_arg_equalitys c Cs|jdks|jdkr"tSg|jD]}|j^q,}t}x?|D]7}y|j|}Wntjjk r|}nXy|j|}Wntjjk r|}nXg||fD]}||k^q} t | rt |  rt Sidtj 6dtj 6dtj6dtj6} td| D} t|| } | rQt|| skt St||| | st SqQqQWtS(s0 Check if original and overridden methods arguments have different default values Return True if one of the overridden arguments has a default value different from the default value of the original argument If one of the method doesn't have argument (.args is None) return False R%R+teltscss|] }|VqdS(N((R:t astroid_type((s6lib/python2.7/site-packages/pylint/checkers/classes.pys sN(R,R&R@R+tobjectt default_valueR(t exceptionst NoDefaulttanyR>R?tConsttClassDeftTupletListttupleRRR'RW( toriginalt overriddentparamtoriginal_param_namestdefault_missingt param_nametoriginal_defaulttoverridden_defaultR$t default_listtastroid_type_compared_attrt handled_typest original_type((s6lib/python2.7/site-packages/pylint/checkers/classes.pyt'_has_different_parameters_default_values6     %   c Cstjj||}x|D]x\}}||f}t|sDtSg|D]}|j^qK}tt|j|r~qn|j|jkrtSqWt S(N( tsixtmovest zip_longestR>R?R+R^tmaptmatchR@( RdRetdummy_parameter_regextzippedtoriginal_paramtoverridden_paramtparamsRftnames((s6lib/python2.7/site-packages/pylint/checkers/classes.pyt_has_different_parameterss  c Cst|}t|}t|||}t|jj|jj|}|jtkrdt}}ntd|jj|jjfDdk}td|jj |jj fDdk}t ||||fS(sEDetermine if the two methods have different parameters They are considered to have different parameters if: * they have different positional parameters, including different names * one of the methods is having variadics, while the other is not * they have different keyword only parameters. css|]}|sdVqdS(iN((R:Rf((s6lib/python2.7/site-packages/pylint/checkers/classes.pys sicss|]}|sdVqdS(iN((R:Rf((s6lib/python2.7/site-packages/pylint/checkers/classes.pys s( RNR|R,R7R+R R@tsumR5R6R^( RdReRvtoriginal_parameterstoverridden_parameterstdifferent_positionaltdifferent_kwonlytdifferent_kwargtdifferent_vararg((s6lib/python2.7/site-packages/pylint/checkers/classes.pyt_different_parameterss.       " " cCs|jtkot|S(N(R+tINVALID_BASE_CLASSESR(tcls((s6lib/python2.7/site-packages/pylint/checkers/classes.pyt_is_invalid_base_class!scCs|j|}x|D]}ylxe|jD]W}t|tjr,y|jd|jdWntjk r{q,qXtSq,q,WWqtjk rtSXqWtS(Nt__get__t__set__( RStinferR'R(tInstancet NotFoundErrorR?tInferenceErrorR@(Rtattrt attributest attributetinferred((s6lib/python2.7/site-packages/pylint/checkers/classes.pyt_has_data_descriptor%s   c Cst|tjstSx|D]}y|j|}Wntjk rOqnXx|D]}x|jtjD]}yt|j j }Wntj t fk rqpnXt|tj sqpn|j}t|tjr|j}n|j|jkrptSqpWqWWqWtS(s Check if the func was called in any of the given methods, belonging to the *klass*. Returns True if so, False otherwise. (R'R(t FunctionDefR@RSRtnodes_of_classtCallRtfuncRRt StopIterationt BoundMethodt_proxiedt UnboundMethodR+R?( RtklasstmethodsRKtinferedt infer_methodR.tboundtfunc_obj((s6lib/python2.7/site-packages/pylint/checkers/classes.pyt_called_in_methods8s*    cCsy|j|}Wntjk r*tSXdjt}xv|D]n}yt|j}Wntjk rvqAnXt |tj rt |rt S|j |krAt SqAWtS(s4 Check if the given attribute *name* is a property in the given *klass*. It will look for `property` calls or for functions with the given name, decorated by `property` or `property` subclasses. Returns ``True`` if the name is a property in the given klass, ``False`` otherwise. s {0}.property(RSR(RR@tformatRRRRR'RRR?tpytype(R+RRt property_nameRR((s6lib/python2.7/site-packages/pylint/checkers/classes.pyt_is_attribute_propertySs   cCsYxR|jtjD]>}|j}t|tjr|jdkr|j rtSqWt S(Ntsuper( RR(RRR'R)R+R,R?R@(t fundef_nodeR.R((s6lib/python2.7/site-packages/pylint/checkers/classes.pyt_has_bare_super_callps  cCsy%|j|d|}t|}Wn&tjk r<dStk rMdSXyt|dSWn&tjk rwdStk r|SXdS(s Safely 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 infered value. tcontextN(tinfer_call_resultRR(RR&R(ROtcallerRtinferitR%((s6lib/python2.7/site-packages/pylint/checkers/classes.pyt_safe_infer_call_resultzs   cCs`t|j}t|tjr\|j}tdtjj ||Dr\t Snt S(Ncss3|])\}}|o*|o*|j|jkVqdS(N(R%(R:t first_slott second_slot((s6lib/python2.7/site-packages/pylint/checkers/classes.pys s( RRR'R(R`tslotsR>RqRrRsR?R@(Rtassigned_valueRt other_slots((s6lib/python2.7/site-packages/pylint/checkers/classes.pyt_has_same_layout_slotss  s+Unable to check methods signature (%s / %s)smethod-check-failedsUsed when Pylint has been unable to check methods signature compatibility for an unexpected reason. Please report this kind if you don't make sense of it.tF0202s4An attribute defined in %s line %s hides this methods method-hiddens~Used when a class defines a method which is hidden by an instance attribute from an ancestor class or set by some client code.tE0202s1Access to member %r before its definition line %ssaccess-member-before-definitionsGUsed when an instance member is accessed before it's actually assigned.tE0203s%Attribute %r defined outside __init__sattribute-defined-outside-initsGUsed when an instance attribute is defined outside the __init__ method.tW0201s1Access to a protected member %s of a client classsprotected-accesssUsed when a protected member (i.e. class member with a name beginning with an underscore) is access outside the class or a descendant of the class where it's defined.tW0212sMethod has no argumentsno-method-argumentsbUsed when a method which should have the bound instance as first argument has no argument defined.tE0211s+Method should have "self" as first argumentsno-self-argumentsUsed when a method has an attribute different the "self" as first argument. This is considered as an error since this is a so common convention that you shouldn't break it!tE0213s0Class method %s should have %s as first argumentsbad-classmethod-argumentsUsed when a class method has a first argument named differently than the value specified in valid-classmethod-first-arg option (default to "cls"), recommended to easily differentiate them from regular instance methods.tC0202s4Metaclass method %s should have %s as first argumentsbad-mcs-method-argumentsUsed when a metaclass method has a first argument named differently than the value specified in valid-classmethod-first-arg option (default to "cls"), recommended to easily differentiate them from regular instance methods.tC0203s:Metaclass class method %s should have %s as first argumentsbad-mcs-classmethod-argumentsUsed when a metaclass class method has a first argument named differently than the value specified in valid-metaclass-classmethod-first-arg option (default to "mcs"), recommended to easily differentiate them from regular instance methods.tC0204s'Static method with %r as first argumentsbad-staticmethod-argumentsUsed when a static method has "self" or a value specified in valid-classmethod-first-arg option or valid-metaclass-classmethod-first-arg option as first argument.tW0211sMethod could be a functions no-self-usesYUsed when a method doesn't use its bound instance, and so could be written as a function.tR0201s#Parameters differ from %s %r methodsarguments-differstUsed when a method has a different number of arguments than in the implemented interface or in an overridden method.tW0221s#Signature differs from %s %r methodssignature-differssgUsed when a method signature is different than in the implemented interface or in an overridden method.tW0222s7Method %r is abstract in class %r but is not overriddensabstract-methodsbUsed when an abstract method (i.e. raise NotImplementedError) is not overridden in concrete class.tW0223s0__init__ method from base class %r is not calledssuper-init-not-calledsaUsed when an ancestor class method has an __init__ method which is not called by a derived class.tW0231sClass has no __init__ methodsno-initsEUsed when a class has no __init__ method, neither its parent classes.tW0232s9__init__ method from a non direct base class %r is calledsnon-parent-init-calledsnUsed when an __init__ method is called on a class which is not in the direct ancestors for the analysed class.tW0233s%Useless super delegation in method %rsuseless-super-delegationsUsed whenever we can detect that an overridden method is useless, relying on super() delegation to do the same thing as another method from the MRO.tW0235sCInvalid object %r in __slots__, must contain only non empty stringssinvalid-slots-objects=Used when an invalid (non-string) object occurs in __slots__.tE0236s4Assigning to attribute %r not defined in class slotssassigning-non-slotsCUsed when assigning to an attribute not defined in the class slots.tE0237sInvalid __slots__ objects invalid-slotsshUsed when an invalid __slots__ is found in class. Only a string, an iterable or a sequence is permitted.tE0238s$Inheriting %r, which is not a class.sinherit-non-classs?Used when a class inherits from something which is not a class.tE0239s1Inconsistent method resolution order for class %rsinconsistent-mros>Used when a class has an inconsistent method resolution order.tE0240sDuplicate bases for class %rsduplicate-basess&Used when a class has duplicate bases.tE0241s9Consider using a decorator instead of calling classmethodsno-classmethod-decoratorsGUsed when a class method is defined without using the decorator syntax.tR0202s:Consider using a decorator instead of calling staticmethodsno-staticmethod-decoratorsHUsed when a static method is defined without using the decorator syntax.tR0203s/Class __slots__ should be a non-string iterablessingle-string-used-for-slotssHUsed when a class __slots__ is a simple string, rather than an iterable.tC0205tScopeAccessMapcBs)eZdZdZdZdZRS(s'Store the accessed variables per scope.cCstjd|_dS(NcSs tjtS(N(t collectionst defaultdicttlist(((s6lib/python2.7/site-packages/pylint/checkers/classes.pyt%s(RRt_scopes(R4((s6lib/python2.7/site-packages/pylint/checkers/classes.pyt__init__#scCs;t|}|dkrdS|j||jj|dS(sSet the given node as accessed.N(RR&RtattrnameR*(R4ROtframe((s6lib/python2.7/site-packages/pylint/checkers/classes.pyt set_accessed(s  cCs|jj|iS(s/Get the accessed variables for the given scope.(Rtget(R4tscope((s6lib/python2.7/site-packages/pylint/checkers/classes.pytaccessed1s(t__name__t __module__t__doc__RRR(((s6lib/python2.7/site-packages/pylint/checkers/classes.pyR s  t ClassCheckerc BseZdZefZdZeZdZdid=d6dd 6d d 6d d 6fdid>d6dd 6dd 6dd 6fdid?d6dd 6dd 6dd 6fdid@d6dd 6dd 6dd 6ffZ dAdZ e j dZe j dZd Zd!Zd"Zd#Zd$ZeZd%Zd&Zd'Zd(Zd)Zd*Zd+Zed,d-d.d/Zd0Zd1Z d2Z!d3Z"d4Z#d5d6Z$d7Z%d8Z&d9Z'd:Z(d;Z)d<Z*RS(Bschecks for : * methods without self as first argument * overridden methods signature * access only to existent members via self * attributes not defined in the __init__ method * unreachable code tclassesisdefining-attr-methodsRt__new__tsetUptdefaulttcsvRLstmetavarsGList of method names used to declare (i.e. assign) instance attributes.thelpsvalid-classmethod-first-argRss=List of valid names for the first argument in a class method.s%valid-metaclass-classmethod-first-argtmcssGList of valid names for the first argument in a metaclass class method.sexclude-protectedt_asdictt_fieldst_replacet_sourcet_makessQList of member names, which should be excluded from the protected access warning.cCs2tj||t|_g|_d|_dS(N(R RRt _accessedt _first_attrsR&t_meth_could_be_func(R4tlinter((s6lib/python2.7/site-packages/pylint/checkers/classes.pyRgs  cCst|dddS(Nsdummy-variables-rgxR(RR&(R4((s6lib/python2.7/site-packages/pylint/checkers/classes.pyt _dummy_rgxmscCst|ddtS(Nsignore-mixin-membersR(RR?(R4((s6lib/python2.7/site-packages/pylint/checkers/classes.pyt _ignore_mixinrscCs|j||jdkrlt|rly|jdWqltjk rh|jdd|d|qlXn|j||j||j |dS(s&init visit variable _accessed tclassRsno-initR,RON( t_check_bases_classesRLRt local_attrR(Rt add_messaget _check_slotst_check_proper_basest_check_consistent_mro(R4RO((s6lib/python2.7/site-packages/pylint/checkers/classes.pytvisit_classdefws    cCs~y|jWnitk r=|jdd|jd|n=tk ri|jdd|jd|ntk rynXdS(s<Detect that a class has a consistent mro or duplicate bases.sinconsistent-mroR,ROsduplicate-basesN(tmroRRR+RtNotImplementedError(R4RO((s6lib/python2.7/site-packages/pylint/checkers/classes.pyRs   cCsx|jD]}t|}|tjdfkr7q nt|tjre|jdtfreq nt|tj  st |r |j dd|j d|q q WdS(s` Detect that a class inherits something which is not a class or a type. s%s.typesinherit-non-classR,RON( tbasesRR(tYESR&R'Rt is_subtype_ofRR`RRt as_string(R4ROtbasetancestor((s6lib/python2.7/site-packages/pylint/checkers/classes.pyRs   c s|jr&|jdjdkr&dS|jj|}|jdkrZ|j||n|jjdspdS|j j |j }xt j |jD]o\}}g|D]@}t|jtjtjf r|j |kr|^q}|sqntfd|Dr"qnx|j|D]L}t}x3|j|D]$} | jjkrLt}qLqLW|r2Pq2q2Wy|j|Wqtjk r xa|D]U} | jjkrt| j|rqn|jdd|d| qqWqXqWdS( sclose a class node: check that instance attributes are defined in __init__ and check access to existent members itmixinNt metaclasssattribute-defined-outside-initc3s$|]}|jjkVqdS(N(RR+(R:RO(tdefining_methods(s6lib/python2.7/site-packages/pylint/checkers/classes.pys sR,RO(RR+tlowerRRRLt_check_accessed_membersRtis_message_enabledtconfigtdefining_attr_methodstrootRqt iteritemstinstance_attrsR't statementR(tDeletet AugAssignR^tinstance_attr_ancestorsR@RR?RRRR( R4tcnodeRtcurrent_moduleRtnodestntparentt attr_definedRO((Rs6lib/python2.7/site-packages/pylint/checkers/classes.pytleave_classdefsF"   "     cCs|jsdS|j||jj}t|_|j||jdk|jdkrn|j |dSxq|j |jD]]}y||j}Wnt k rqnXt |t jsqn|j||d|PqW|jrOxa|jjD]P}t |t jr#|jdkr#dSt |t jr|jdkrdSqWny|j|jd }|j}t |t jr|jd kr|jj}nt |t jr|j|jr|jj|jf}|jd d |d |nWnt jk rnXdS(s"check method arguments, overridingNRRRetgettertsettertdeletertpropertyiRKs method-hiddenR,RO(RRR(t is_methodt_check_useless_super_delegationRRR?Rt_check_first_arg_for_typeRLR+t _check_inittlocal_attr_ancestorstKeyErrorR'R(Rt_check_signatureRRt AttributeRR)t instance_attrR`RtqnameR t fromlinenoRR(R4RORRet meth_nodet decoratortoverridden_frameR,((s6lib/python2.7/site-packages/pylint/checkers/classes.pytvisit_functiondefsJ      !   c Cs(|jsdS|jrdS|j}t|dkr<dS|d}t|tjtjfsedS|j}t|tj sdSt|j tj sdSyt |j j j}Wntjk rdSXt|tjsdS|j j|jkrdS|jj}|j|kr"dSt|jtjs;dS|jj|jkrTdS|jj}xr|j|jD]^}y||j} Wntk rqvnXt| tjsdSt| j|jrdSPqvWt|j} t |} t!| | r$|j"dd|d|jfndS(sQCheck if the given function node is an useless method override We consider it *useless* if it uses the super() builtin, but having nothing additional whatsoever than not implementing the method at all. If the method uses super() to delegate an operation to the rest of the MRO, and if the method called is the same as the current one, the arguments passed to super() are the same as the parameters that were passed to this method, then the method could be removed altogether, by letting other implementation to take precedence. Niisuseless-super-delegationROR,(#RRtbodytlenR'R(tExprtReturnR%RRR%RtexprRRRtSuperRR+RRt mro_pointerRLRRR"R#RRpR,R9R3RIR( R4tfunctionR-RR.t super_callt current_scopeRReR)RzR,((s6lib/python2.7/site-packages/pylint/checkers/classes.pyRs\       cCsId|jkrdSx/|jdD]}|tjkr>q#nt| rqt| rq|jdd|q#nt|tjr|jdd|q#nt |dsq#nt|tj rg|j D]}|d^q}n |j }|tjkrdSx9|D]1}y|j |Wq tjk r<q q Xq Wq#WdS(Nt __slots__s invalid-slotsROssingle-string-used-for-slotstiteredi(tlocalstigetattrR(RRRRR'R_thasattrtDicttitemsR8t_check_slots_eltR(R4RORtitemtvaluestelt((s6lib/python2.7/site-packages/pylint/checkers/classes.pyRls.#  cCsx|jD]}|tjkr(q nt|tj sQt|jtj rv|jdd|j d|q n|js |jdd|j d|q q WdS(Nsinvalid-slots-objectR,RO( RR(t UninferableR'R_R%Rqt string_typesRR(R4RAR((s6lib/python2.7/site-packages/pylint/checkers/classes.pyR>s     cCs|jr|jjdk r.|jjn|jjdsDdS|jj}|j r|j dkr|j t kr|j pt||j pt|ptjot| r|jdd|qndS(son method node, check if this method couldn't be a function ignore class, static and abstract methods, initializer, methods overridden from a parent class. s no-self-useNRKRO(RR,R&RtpopRR RRRRLR+R t is_abstractR RRqtPY3RR(R4ROt class_node((s6lib/python2.7/site-packages/pylint/checkers/classes.pytleave_functiondefs   cCsJ|j|r#|jj|dS|jjds9dS|j|dS(scheck if the getattr is an access to a class member if so, register it. Also check for access to protected class member from outside its class (but ignore __special__ methods) Nsprotected-access(t_uses_mandatory_method_paramRRRR t!_check_protected_attribute_access(R4RO((s6lib/python2.7/site-packages/pylint/checkers/classes.pytvisit_attributes cCsKt|jtjr:|j|r:|jj|n|j|dS(N(R't assign_typeR(RRIRRt_check_in_slots(R4RO((s6lib/python2.7/site-packages/pylint/checkers/classes.pytvisit_assignattrscsMtj}|rIt|tjrI|j}d|jksI|j rMdS|j}|dkridSt d|j DrdSt fd|DsIt d|DsFt j |rdSj |jkrt|j rdSj dkr!t|jjr!dS|jddj fd qFqIndS( sU Check that the given AssignAttr node is defined in the class slots. R7Ncss-|]#}d|jko$|jdkVqdS(R7RZN(R9R+(R:R((s6lib/python2.7/site-packages/pylint/checkers/classes.pys sc3s!|]}|jjkVqdS(N(R%R(R:tslot(RO(s6lib/python2.7/site-packages/pylint/checkers/classes.pys scss|]}|jdkVqdS(t__dict__N(R%(R:RO((s6lib/python2.7/site-packages/pylint/checkers/classes.pys st __class__sassigning-non-slotR,RO(RR1R'R(RRR9tnewstyleRR&R^t ancestorsRRRRRR%R(R4RORRR((ROs6lib/python2.7/site-packages/pylint/checkers/classes.pyRMs.     sprotected-accesssno-classmethod-decoratorsno-staticmethod-decoratorcCsT|j||jd}t|tjs0dS|j|rCdS|j|dS(Ni(t_check_classmethod_declarationttargetsR'R(t AssignAttrRIRJ(R4t assign_nodeRO((s6lib/python2.7/site-packages/pylint/checkers/classes.pyt visit_assigns  cst|jtjsdS|jj}t|tj sG|jd krKdS|jdkr`dnd}|j}t|tjsdS|jj d}t|tjsdS|jt fd|j Dr|j |d|j dndS( s[Checks for uses of classmethod() or staticmethod() When a @classmethod or @staticmethod decorator should be used instead. A message will be emitted only if the assignment is at a class scope and only if the classmethod's argument belongs to the class where it is defined. `node` is an assign node. NRJt staticmethodsno-classmethod-decoratorsno-staticmethod-decoratoric3s|]}|jkVqdS(N(R+(R:tmember(t method_name(s6lib/python2.7/site-packages/pylint/checkers/classes.pys sRO(RJRY(R'R%R(RRR)R+RR`R,R^t mymethodsRRU(R4RORtmsgt parent_classt classmeth_arg((R[s6lib/python2.7/site-packages/pylint/checkers/classes.pyRTs$    cCs}|j}t|ry||jjkryt|}|jj}|dkrk|jdd|d|dSt |jt j rt |jj t j r|jj jdkrdS|j|jrdS||jkp||jksy|jj}t |t jrZt|jdkrZt |jdt jrZ|jdj}t||rZdSn|jdd|d|qyndS(sGiven an attribute access node (set or get), check if attribute access is legitimate. Call _check_first_attr with node before calling this method. Valid cases are: * self._attr in a method or cls._attr in a classmethod. Checked by _check_first_attr. * Klass._attr inside "Klass" class. * Klass2._attr inside "Klass" class when Klass2 is a base class of Klass. sprotected-accessROR,NRii(RRR texclude_protectedRR1RR&RR'R(RRR)R+t_is_type_self_callt basenamesRRtAssignR.RUt AssignNameR(R4RORRtcalleetstmtR+((s6lib/python2.7/site-packages/pylint/checkers/classes.pyRJs.    cCsbt|tjoat|jtjoa|jjdkoat|jdkoa|j|jdS(NRLii( R'R(RRR)R+R.R,t_is_mandatory_method_param(R4R1((s6lib/python2.7/site-packages/pylint/checkers/classes.pyRaQs'cCs=|jr9|j|jdks-|jd r9t|_ndS(sXcheck if the name handle an access to a class member if so, register it iN(RR+R@R(R4RO((s6lib/python2.7/site-packages/pylint/checkers/classes.pyt visit_nameWsc Csd }xtj|D]\}}y|j|wWntjk rLnXyt|j|wWntk rznXy|j|}Wntjk rqXg|D]}||kr|^q}|sqn|dj }gt |D]0\} }| dks|j |k r|^q}t |dkr|d} | j } | j } xp|D]e} | j | kra| j | kratj| j| | ra|jdd| d|| fqaqaWqqWd S( s'check that accessed members are definedtAttributeErrort Exceptiont BaseExceptioniisaccess-member-before-definitionROR,N(RiRjRk(RqR RR(RRRRR&Rt enumerateR.RR(t are_exclusiveRR(R4RORtexcsRRtdefstmtsRfRtitdefstmtRtlnot_node((s6lib/python2.7/site-packages/pylint/checkers/classes.pyR_s>  %*    ! icCs|jjdkrdS|jjo/|jd}|jj||jd}|jdkr|dks||jjks||jjkr|j dd|d|dSd|jdsis%s or %rR,RO(R.RztjoinR(R4RyR ROtmessageR[tvalid((s6lib/python2.7/site-packages/pylint/checkers/classes.pyRws  cCsd}t|rdStt||jdd}xl|D]d\}}|jj}||krqqDn||jkrqDn|jdd|d||jfqDWdS(s^check that the given class node implements abstract methods from base classes cSs|jdtS(Ntpass_is_abstract(RER@(RK((s6lib/python2.7/site-packages/pylint/checkers/classes.pyREsNtkeycSs|dS(Ni((R?((s6lib/python2.7/site-packages/pylint/checkers/classes.pyRssabstract-methodROR,( RtsortedRR=RRR9RR+(R4RORERR+RKtowner((s6lib/python2.7/site-packages/pylint/checkers/classes.pyRs    c CsT|jjd r*|jjd r*dS|jj}t|}t|}x|jtjD]v}|j }t |tj  sd|j dkrqdnt |j tjrt |j j tjr|j j jdkrdSyx|j jD]}|tjkrqnt |tjr[t |jtjr[t|jr[|jjdkr[dSt |tjrqdSy ||=Wqtk r||kr|jdd|d|jqqXqWWqdtjk rqdqdXqdWxotj|D]^\}}t|} |jdks| r0| jdkr0qn|jdd|jd|qWdS( sWcheck that the __init__ method call super or ancestors'__init__ method ssuper-init-not-calledsnon-parent-init-calledNRRROR,RZ(RR RRt_ancestors_to_calltdictRR(RRR'R%RR1R)R+RRBRRR`RRR2R#RRRqR R( R4ROt klass_nodetto_calltnot_called_yetRfR1RRKR((s6lib/python2.7/site-packages/pylint/checkers/classes.pyR!sN         $cCs~t|tjo!t|tjsG|jdd||fd|dS|j}t||}t||}|jjdks|jjdkrdSt|j rdS|j rx<|j j D]+}t|tj r|j dkrdSqWnt||d|jr1|jdd||j fd|nIt|jjt|jjkrz|jdd||j fd|ndS( s@check that the signature of the two given methods match smethod-check-failedR,RONRRvsarguments-differssignature-differs(R'R(RRtinstantiate_classRR,R&RR+RRR%RRRR.tdefaults(R4tmethod1t refmethodt class_typeRtinstanceR*((s6lib/python2.7/site-packages/pylint/checkers/classes.pyR$!s6  $      $ cCs|j|jS(sCheck that attribute lookup name use first attribute variable name Name is `self` for method, `cls` for classmethod and `mcs` for metaclass. (RgR1(R4RO((s6lib/python2.7/site-packages/pylint/checkers/classes.pyRIHscCs/|jo.t|tjo.|j|jdkS(sCheck if astroid.Name corresponds to first attribute variable name Name is `self` for method, `cls` for classmethod and `mcs` for metaclass. i(RR'R(R)R+(R4RO((s6lib/python2.7/site-packages/pylint/checkers/classes.pyRgOs(RRR(R(R(RRRRRN(+RRRRt__implements__R+tMSGStmsgstprioritytoptionsR&RRtcachedpropertyRRRRRRR,tvisit_asyncfunctiondefRRR>RHRKRNRMR RXRTRJRaRhRR RwRR!R$RIRg(((s6lib/python2.7/site-packages/pylint/checkers/classes.pyR6sp           ; 5 W     &  # 8   2 7  4 ' tSpecialMethodsCheckercBseZdZefZdZidddeiddgd6fd6d d d idgd6fd6dddifd6ZdZe d dddZ e Z dZ e dZdZdZRS(sOChecker which verifies that special methods are implemented correctly. Rs__iter__ returns non-iteratorsnon-iterator-returnedsaUsed when an __iter__ method returns something which is not an iterable (i.e. has no `%s` method)tW0234tE0234t old_namestE0301s6The special method %r expects %s param(s), %d %s givens#unexpected-special-method-signaturesEmitted 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.tE0235sbad-context-managertE0302s,__len__ does not return non-negative integersinvalid-length-returnedsQUsed when an __len__ method returns something which is not a non-negative integertE0303icCsq|jsdS|jdkr/|j|n|jdkrN|j|n|jtkrm|j|ndS(Nt__iter__t__len__(RR+t _check_itert _check_lenR t"_check_unexpected_method_signature(R4RO((s6lib/python2.7/site-packages/pylint/checkers/classes.pyR,rs c Cs}t|j}|dkrdS|jj r;|jj r;dSt|tdgr`|jj}n|jjd}t|t|jj}t|jj}||}t |t r||k}d|}n`||}|dkrt }nA|dkrt }n,|dkr0||dkp)|jj }n|ry|dkrHdnd} |j dd|j||| fd |ndS( Ns .staticmethodisbetween %d or %ditwastweres#unexpected-special-method-signatureR,RO(R R+R&R,R6RRR.RR'RcR@R?R( R4ROtexpected_paramstall_argst mandatorytoptionaltcurrent_paramstemittresttverb((s6lib/python2.7/site-packages/pylint/checkers/classes.pyRs4             cCs|tjkrtSt|tr&tSt|tjrgy|jttSWqtjk rcqXnht|tj r|j }|rt|tj ry|jttSWqtjk rqXqnt S(N( R(RR?R'RRRt NEXT_METHODRR`RR@(ROR((s6lib/python2.7/site-packages/pylint/checkers/classes.pyt _is_iterators&    cCsGt||}|dk rC|j|sC|jdd|qCndS(Nsnon-iterator-returnedRO(RR&RR(R4ROR((s6lib/python2.7/site-packages/pylint/checkers/classes.pyRs cCst||}| s%|tjkr)dSt|tjra|jdkrat|tj radSt|tjs|jdd|dS|j}t|t j  s|dkr|jdd|ndS(Ntintsinvalid-length-returnedROi( RR(RBR'RR+R_RR%Rqt integer_types(R4RORR%((s6lib/python2.7/site-packages/pylint/checkers/classes.pyRs (Rsnon-iterator-returned(Rsnon-iterator-returned(Rsbad-context-manager(RRRRRR+RRRR R,RRRYRRR(((s6lib/python2.7/site-packages/pylint/checkers/classes.pyRXs4    - RcCs^i}xQ|jdtD]=}yt|j||| on the given class node, ensuring it is a Function node N(RR'R(tFunctionR(ROR[t node_attr((s6lib/python2.7/site-packages/pylint/checkers/classes.pyt node_methodscCs*|jt||jt|dS(s.required method to auto register this checker N(tregister_checkerRR(R((s6lib/python2.7/site-packages/pylint/checkers/classes.pytregisters(GRt __future__RRtsysRqR(t astroid.basesRRtastroid.exceptionsRRRRtastroid.scoped_nodesRtpylint.interfacesRtpylint.checkersR tpylint.checkers.utilsR R R R RRRRRRRRRRRRt pylint.utilsRt version_infoRRt namedtupleR!R"R3R9RIRNRRRWRpR|RRRRRRR&RRRRZRRRRRR(((s6lib/python2.7/site-packages/pylint/checkers/classes.pyts     j      $    ,  1                                  %