'![c@sdZddlZddlZddlZddlmZddlmZddlmZddl m Z id-d 6d.d6d/d6d0d6d1d6d2d6Z dd d!d"d#d$d%d&hZ d3d4d'Z d(ejfd)YZd*Zd+Zd,ZdS(5s"checker for use of Python logging iN(tcheckers(t interfaces(tutils(tcheck_messagess>Specify string format arguments as logging function parametersslogging-not-lazysUsed when a logging statement has a call form of "logging.(format_string % (format_args...))". Such calls should leave string interpolation to the logging method itself and be written "logging.(format_string, format_args...)" so that the program may avoid incurring the cost of the interpolation in those cases in which no message will be logged. For more, see http://www.python.org/dev/peps/pep-0282/.tW1201sLUse % formatting in logging functions and pass the % parameters as argumentsslogging-format-interpolationsUsed when a logging statement has a call form of "logging.(format_string.format(format_args...))". Such calls should use % formatting instead, but leave interpolation to the logging function by passing the parameters as arguments.tW1202s;Unsupported logging format character %r (%#02x) at index %dslogging-unsupported-formatsdUsed when an unsupported format character is used in a logging statement format string.tE1200s<Logging format string ends in middle of conversion specifierslogging-format-truncatedsmUsed when a logging statement format string terminates before the end of a conversion specifier.tE1201s,Too many arguments for logging format stringslogging-too-many-argss>Used when a logging format string is given too many arguments.tE1205s.Not enough arguments for logging format stringslogging-too-few-argss=Used when a logging format string is given too few arguments.tE1206tcriticaltdebugterrort exceptiontfataltinfotwarntwarningcCs\t|tjo[t|jtjo[|r?|jj|knto[|rX|j|kStS(sDetermines if a BoundMethod node represents a method call. Args: func (astroid.BoundMethod): The BoundMethod AST node to check. types (Optional[String]): Optional sequence of caller type names to restrict check. methods (Optional[String]): Optional sequence of method names to restrict check. Returns: bool: true if the node represents a method call for the given type and method names, False otherwise. (t isinstancetastroidt BoundMethodtboundtInstancetnametTrue(tfuncttypestmethods((s6lib/python2.7/site-packages/pylint/checkers/logging.pytis_method_callIs tLoggingCheckercBseZdZejZdZeZdidd6dd6dd6dd 6ffZ d Z d Z d Z e ejd ZdZedZdZdZRS(s!Checks use of the logging module.tloggingslogging-modulestdefaulttcsvttypestmetavarsbLogging modules to check that the string format arguments are in logging function parameter formatthelpcCst|_|jj}t||_i|_xJ|D]B}|jdd}t|dkr7|d|j|ds(RtinferRRRt_proxiedtparenttClassDefR@tanyt ancestorsRRt exceptionstInferenceErrortFalsetNone(tinferredRE(R.(s6lib/python2.7/site-packages/pylint/checkers/logging.pytis_logger_classs  N(Rtattrnamet_check_log_method(R-R.R?RNRtresult((R.R-s6lib/python2.7/site-packages/pylint/checkers/logging.pyt visit_calls cCsv|dkr@|js3|js3t|jdkr7dSd}n9|tkru|jsh|jsh|j rldSd}ndSt|j|tjr|j|}|jdks|jdkrrtg|j |j fD]}|j |r|^qdkrr|j dd |qrn\t|j|tj rF|j|j|n,t|j|tjrr|j||ndS( s9Checks calls to logging.log(level, format, *format_args).tlogiNiit%t+slogging-not-lazyR.(tstarargstkwargsR,targstCHECKED_CONVENIENCE_FUNCTIONSRRtBinOptoptlefttrightt_is_operand_literal_strt add_messagetCallt_check_call_functConstt_check_format_string(R-R.Rt format_postbinopt_operand((s6lib/python2.7/site-packages/pylint/checkers/logging.pyRPs& '    $cCst|tjo|jdkS(sL Return True if the operand in argument is a literal string tstr(RRRbR(toperand((s6lib/python2.7/site-packages/pylint/checkers/logging.pyR^scCsZtj|j}d}d}t|||rVt|j rV|jdd|ndS( sChecks that function call is not format_string.format(). Args: node (astroid.node_classes.Call): Call AST node to be checked. Rgtunicodetformatslogging-format-interpolationR.N(RgRi(Rj(Rt safe_inferRRtis_complex_format_strRR_(R-R.RRR((s6lib/python2.7/site-packages/pylint/checkers/logging.pyRas "c Cs0t|j|d}|s!dS|j|j}t|tjsLd}ny#tj|\}}|rndSWnvtjk r}||j }|j dd|d|t ||j fdStj k r|j dd|dSX||kr |j dd|n"||kr,|j d d|ndS( sChecks that format string tokens match the supplied arguments. Args: node (astroid.node_classes.NodeNG): AST node to be checked. format_arg (int): Index of the format string in the node arguments. iNislogging-unsupported-formatR.RXslogging-format-truncatedslogging-too-many-argsslogging-too-few-args( t_count_supplied_tokensRXtvalueRtsixt string_typesRtparse_format_stringtUnsupportedFormatCharactertindexR_tordtIncompleteFormatString( R-R.t format_argtnum_argst format_stringtrequired_num_argst keyword_argstextchar((s6lib/python2.7/site-packages/pylint/checkers/logging.pyRcs,    (R(t__name__t __module__t__doc__RtIAstroidCheckert__implements__RtMSGStmsgstoptionsR2R:R;RtkeysRRRPt staticmethodR^RaRc(((s6lib/python2.7/site-packages/pylint/checkers/logging.pyR[s"      cCstj|}|dks1t|jtj r5tSy"tt j j |j}Wnt k rkt SXx$|D]\}}}}|rstSqsWt S(sChecks if node represents a string with complex formatting specs. Args: node (astroid.node_classes.NodeNG): AST node to check Returns: bool: True if inferred string uses complex formatting, False otherwise N(RRkRLRRnRoRpRtlisttstringt Formattertparset ValueErrorRK(R.RMtparsedt_t format_spec((s6lib/python2.7/site-packages/pylint/checkers/logging.pyRls"" cCstd|DS(s|Counts the number of tokens in an args list. The Python log functions allow for special keyword arguments: func, exc_info and extra. To handle these cases correctly, we only count arguments that aren't keywords. Args: args (list): AST nodes that are arguments for a log format string. Returns: int: Number of AST nodes that aren't keywords. css'|]}t|tjsdVqdS(iN(RRtKeyword(RAtarg((s6lib/python2.7/site-packages/pylint/checkers/logging.pys "s(tsum(RX((s6lib/python2.7/site-packages/pylint/checkers/logging.pyRms cCs|jt|dS(s.Required method to auto-register this checker.N(tregister_checkerR(tlinter((s6lib/python2.7/site-packages/pylint/checkers/logging.pytregister%s(s>Specify string format arguments as logging function parametersslogging-not-lazysUsed when a logging statement has a call form of "logging.(format_string % (format_args...))". Such calls should leave string interpolation to the logging method itself and be written "logging.(format_string, format_args...)" so that the program may avoid incurring the cost of the interpolation in those cases in which no message will be logged. For more, see http://www.python.org/dev/peps/pep-0282/.(sLUse % formatting in logging functions and pass the % parameters as argumentsslogging-format-interpolationsUsed when a logging statement has a call form of "logging.(format_string.format(format_args...))". Such calls should use % formatting instead, but leave interpolation to the logging function by passing the parameters as arguments.(s;Unsupported logging format character %r (%#02x) at index %dslogging-unsupported-formatsdUsed when an unsupported format character is used in a logging statement format string.(s<Logging format string ends in middle of conversion specifierslogging-format-truncatedsmUsed when a logging statement format string terminates before the end of a conversion specifier.(s,Too many arguments for logging format stringslogging-too-many-argss>Used when a logging format string is given too many arguments.(s.Not enough arguments for logging format stringslogging-too-few-argss=Used when a logging format string is given too few arguments.(((RRRoRtpylintRRtpylint.checkersRtpylint.checkers.utilsRRRYRt BaseCheckerRRlRmR(((s6lib/python2.7/site-packages/pylint/checkers/logging.pyts@