B
    A!p\@                 @   s   d Z ddlZddlZddlmZ ddlmZ ddlmZ ddl	m
Z
 ddl	mZ dd	hZd
ZdZdZdZdhZdZejdkrdZndZdd ZG dd de
Zdd ZdS )z0Checkers for various standard library functions.    N)Instance)Const)IAstroidChecker)BaseChecker)utilsopenfilezunittest.casezthreading.Threadz	copy.copyzos._Environz	os.getenvzsubprocess.Popen)   r   _ioZ__builtin__c       
      C   s   t | tsdS t| }d}d|k}|t| s>t| t|krBdS d|k}d|k}d|k}d|k}d|k}d	|kr|s~|s~|rdS d
}|r|rdS || | | }	|	dkrdS |s|s|s|sdS d
S )NFzrwatb+UxxrwatbUT   )
isinstancestrsetlen)
modeZmodes_modeZcreatingZreadingZwritingZ	appendingtextZbinaryZtotal r   5lib/python3.7/site-packages/pylint/checkers/stdlib.py_check_mode_str0   s0    
r   c               @   s  e Zd ZefZdZddddddifdd	d
ddddd	Zdddddddhdddddhddddd d!d"d#d$h	d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5hd6d7d8hd9d:d!d"d#d$hd;d<d=d>d?d@hdAdBdCdDdEhdFhdGdHdIdJdKdLdMhdNhdOdPZdQdR ZdSdT Z	dUdV Z
edWdXdYdZd[d\d]d^d_d` Zeddadb Zeddcdd Zeddedf Zeddgdh Zdidj Zdkdl Zdmdn Zdodp Zdqdr Zdsdt ZduS )vStdlibCheckerZstdlib)z""%s" is not a valid mode for open.zbad-open-modezPython supports: r, w, a[, x] modes with b, +, and U (only with r) options. See http://docs.python.org/2/library/functions.html#openz)Using datetime.time in a boolean context.zboolean-datetimezUsing datetime.time in a boolean context can hide subtle bugs when the time they represent matches midnight UTC. This behaviour was fixed in Python 3.5. See http://bugs.python.org/issue13936 for reference.Z
maxversion)r	      )z*Redundant use of %s with constant value %rzredundant-unittest-assertzThe first argument of assertTrue and assertFalse is a condition. If a constant is passed as parameter, that condition will be always true. In this case a warning should be emitted.)zUsing deprecated method %s()zdeprecated-methodzThe method is marked as deprecated and will be removed in a future version of Python. Consider looking for an alternative in the documentation.)z*threading.Thread needs the target functionzbad-thread-instantiationzThe warning is emitted when a threading.Thread class is instantiated without the target function being passed. By default, the first parameter is the group param, not the target param. )z<Using copy.copy(os.environ). Use os.environ.copy() instead. zshallow-copy-environzos.environ is not a dict object but proxy object, so shallow copy has still effects on original object. See https://bugs.python.org/issue15373 for reference. )z$%s does not support %s type argumentzinvalid-envvar-valuezxEnv manipulation functions support only string type arguments. See https://docs.python.org/3/library/os.html#os.getenv. )z,%s default type is %s. Expected str or None.zinvalid-envvar-defaultzEnv manipulation functions return None or str values. Supplying anything different as a default may cause bugs. See https://docs.python.org/3/library/os.html#os.getenv. )zGUsing preexec_fn keyword which may be unsafe in the presence of threadszsubprocess-popen-preexec-fna+  The preexec_fn parameter is not safe to use in the presence of threads in your application. The child process could deadlock before exec is called. If you must use it, keep it trivial! Minimize the number of libraries you call into.https://docs.python.org/3/library/subprocess.html#popen-constructor)	ZW1501ZW1502ZW1503ZW1505ZW1506ZW1507ZE1507ZW1508ZW1509zcgi.parse_qszcgi.parse_qslzctypes.c_bufferz2distutils.command.register.register.check_metadataz,distutils.command.sdist.sdist.check_metadataztkinter.Misc.tk_menuBarz tkinter.Menu.tk_bindForTraversalzcommands.getstatusz	os.popen2z	os.popen3z	os.popen4zmacostools.touchedz#unittest.case.TestCase.assertEqualsz&unittest.case.TestCase.assertNotEqualsz)unittest.case.TestCase.assertAlmostEqualsz,unittest.case.TestCase.assertNotAlmostEqualszunittest.case.TestCase.assert_z)xml.etree.ElementTree.Element.getchildrenz)xml.etree.ElementTree.Element.getiteratorz+xml.etree.ElementTree.XMLParser.getiteratorz'xml.etree.ElementTree.XMLParser.doctype))      r   )r      r   zinspect.getargspecZfailUnlessEqualZassertEqualsZfailIfEqualZassertNotEqualsZfailUnlessAlmostEqualZassertAlmostEqualsZfailIfAlmostEqualZassertNotAlmostEqualsZ
failUnlessZassert_ZfailUnlessRaisesZfailIfZassertRaisesRegexpZassertRegexpMatchesZassertNotRegexpMatcheszbase64.encodestringzbase64.decodestringzntpath.splituncz
cgi.escapez#configparser.RawConfigParser.readfpzinspect.getmoduleinfozlogging.warnzlogging.Logger.warnzlogging.LoggerAdapter.warnznntplib._NNTPBase.xpathzplatform.popenzimportlib.find_loaderzplistlib.readPlistzplistlib.writePlistzplistlib.readPlistFromByteszplistlib.writePlistToByteszasyncio.tasks.asynczfractions.gcdzinspect.getargvalueszinspect.formatargspeczinspect.formatargvalueszinspect.getcallargszplatform.linux_distributionzplatform.distz4importlib._bootstrap_external.FileLoader.load_module))r	   r   r   )r	   r   r   )r	   r   r   )r	   r	   r   )r	      r   )r	   r"   r"   )r	   r   r   )r	   r    r   )r   r   r	   c             C   s,   |j s(|js(t|jdkr(| jd|d d S )Nr   zbad-thread-instantiation)node)kwargskeywordsr   argsadd_message)selfr#   r   r   r   _check_bad_thread_instantiation   s    z-StdlibChecker._check_bad_thread_instantiationc             C   s2   |j r.x&|j D ]}|jdkr| jd|d qW d S )NZ
preexec_fnzsubprocess-popen-preexec-fn)r#   )r%   argr'   )r(   r#   keywordr   r   r   _check_for_preexec_fn_in_Popen   s    
z,StdlibChecker._check_for_preexec_fn_in_Popenc             C   s@   t j|dd}x,| D ] }| tkr| jd|d P qW d S )Nr   )positionzshallow-copy-environ)r#   )r   get_argument_from_callinferredqname
OS_ENVIRONr'   )r(   r#   r*   r/   r   r   r   _check_shallow_copy_environ   s
    z)StdlibChecker._check_shallow_copy_environzbad-open-modezredundant-unittest-assertzdeprecated-methodzbad-thread-instantiationzshallow-copy-environzinvalid-envvar-valuezinvalid-envvar-defaultzsubprocess-popen-preexec-fnc             C   s  yx|j  D ]}|tjkr qn| jtkrLt|j ddtkr| 	| n| jt
krh| || nxt|tjr| tkr| | q| tkr| | n<t|tjr| }|tkr| | n|tkr| || | || qW W n tjk
r
   dS X dS )zVisit a Call node.nameN)funcinferastroidUninferablerootr3   OPEN_MODULEgetattr
OPEN_FILES_check_open_modeUNITTEST_CASE_check_redundant_assertr   ZClassDefr0   THREADING_THREADr)   SUBPROCESS_POPENr,   FunctionDef	COPY_COPYr2   ENV_GETTERS_check_env_function_check_deprecated_methodInferenceError)r(   r#   r/   r3   r   r   r   
visit_call  s.    
zStdlibChecker.visit_callc             C   s   |j dkr| |j d S )Nnot)op_check_datetimeZoperand)r(   r#   r   r   r   visit_unaryop)  s    
zStdlibChecker.visit_unaryopc             C   s   |  |j d S )N)rJ   test)r(   r#   r   r   r   visit_if.  s    zStdlibChecker.visit_ifc             C   s   |  |j d S )N)rJ   rL   )r(   r#   r   r   r   visit_ifexp2  s    zStdlibChecker.visit_ifexpc             C   s   x|j D ]}| | qW d S )N)valuesrJ   )r(   r#   valuer   r   r   visit_boolop6  s    zStdlibChecker.visit_boolopc                s   t jd }t|jtjr"|jj}nt|jtjr:|jj}nd S tj	tj
tjf}t||s\d S | }tfdd||fD rjd||fd nTxRj|  D ]@\} |t jkrt fdd||fD rjd||fd P qW d S )Nr   c             3   s   | ]}| j d  kV  qdS )r   N)
deprecated).0r3   )r(   r   r   	<genexpr>P  s    z9StdlibChecker._check_deprecated_method.<locals>.<genexpr>zdeprecated-method)r#   r&   c             3   s   | ]}| kV  qd S )Nr   )rS   r3   )	func_listr   r   rT   U  s    )sysversion_infor   r4   r6   Z	AttributeZattrnameNamer3   BoundMethodZUnboundMethodrA   r0   anyr'   rR   items)r(   r#   r/   Zpy_versZ	func_nameZacceptable_nodesr0   Z
since_versr   )rU   r(   r   rE   ;  s&    



z&StdlibChecker._check_deprecated_methodc             C   sP   t |tjrL|jrLt |jd tjrL|jdkrL| jd|j|jd jf|d d S )Nr   )Z
assertTrueZassertFalsezredundant-unittest-assert)r&   r#   )r   r6   rY   r&   r   r3   r'   rP   )r(   r#   r5   r   r   r   r>   Z  s    
z%StdlibChecker._check_redundant_assertc             C   sP   yt | }W n tjk
r&   dS X t|trL| dkrL| jd|d dS )zZ Check that a datetime was infered.
        If so, emit boolean-datetime warning.
        Nzdatetime.timezboolean-datetime)r#   )nextr5   r6   rF   r   r   r0   r'   )r(   r#   Zinferedr   r   r   rJ   g  s    zStdlibChecker._check_datetimec             C   sf   yt j|ddd}W n t jk
r*   dS X |rbt |}t|tjrbt|jsb| j	d||jd dS )z>Check that the mode argument of an open or file call is valid.r   r   )r-   r+   Nzbad-open-mode)r#   r&   )
r   r.   ZNoSuchArgumentError
safe_inferr   r6   r   r   rP   r'   )r(   r#   Zmode_argr   r   r   r<   r  s    
zStdlibChecker._check_open_modec             C   s   d}d}|j r dd |j D }nd }|jr6|jd }n|rL||krL|| }nd }|rn| j|dt||dd t|jd	kr|jd
 }n|r||kr|| }nd }|r| j||dt|dd d S )Nkeydefaultc             S   s   i | ]}|j |jqS r   )rP   r*   )rS   r+   r   r   r   
<dictcomp>  s    z5StdlibChecker._check_env_function.<locals>.<dictcomp>r   zinvalid-envvar-valueF)r#   messagecall_argr5   
allow_noner   r   zinvalid-envvar-defaultT)r#   r5   ra   rb   rc   )r%   r&   _check_invalid_envvar_valuer   r]   r   )r(   r#   r5   Zenv_name_kwargZenv_value_kwargr$   Zenv_name_argZenv_value_argr   r   r   rD     s:    

z!StdlibChecker._check_env_functionc             C   s   |t jd fkrd S | }t|trhd}|jd kr:| }nt|jtsJd}|r| j|||| fd n| j|||| fd d S )NFT)r#   r&   )	r6   r7   r0   r   r   rP   r   r'   Zpytype)r(   r#   r5   ra   rb   rc   r3   emitr   r   r   rd     s    

z)StdlibChecker._check_invalid_envvar_valueN)__name__
__module____qualname__r   Z__implements__r3   ZmsgsrR   r)   r,   r2   r   Zcheck_messagesrG   rK   rM   rN   rQ   rE   r>   rJ   r<   rD   rd   r   r   r   r   r   N   s   'r   c             C   s   |  t|  dS )z.required method to auto register this checker N)Zregister_checkerr   )Zlinterr   r   r   register  s    ri   )__doc__rV   r6   Zastroid.basesr   Zastroid.node_classesr   Zpylint.interfacesr   Zpylint.checkersr   r   r;   r=   r?   rB   r1   rC   r@   rW   r9   r   r   ri   r   r   r   r   <module>   s,   
  k