a a@sDdZddlmZddlmZddlmZddlmZddl Z ddl Z ddl Z ddl Z ddl mZddlZddlZddlZddlZddlZddlZddlZddlmZddlZddlmZmZmZmZdd lmZdd l m!Z!m"Z"m#Z#dd l$m%Z%dd l&m'Z'e(e)e*Z+Gd dde,Z-dSddZ.ddZ/ddZ0ddZ1ddZ2ddZ3dTddZ4ddZ5dd Z6d!d"Z7d#d$Z8d%d&Z9d'd(Z:d)d*Z;d+d,Zd1d2Z?dUd3d4Z@ddggfd5d6ZAd7d8ZBd9d:ZCdVd;d<ZDd=d>ZEd?d@ZFdAdBZGdWdCdDZHdEdFZIdGdHZJdIdJZKdKdLZLdMdNZMdOdPZNdQdRZOdS)XzRunning programs utilities.)print_function) literal_eval)getuser)dedentN) parse_version)is_stable_versionrunning_under_pytest get_home_dirrunning_in_mac_app) is_anaconda)PY2is_text_stringto_text_string)encoding)get_python_executablec@s eZdZdS) ProgramErrorN)__name__ __module__ __qualname__rr4lib/python3.9/site-packages/spyder/utils/programs.pyr+srcCsntg}tjdkr |dntt}|d||durL||tj |}t |sjt ||S)zP Return temporary Spyder directory, checking previously that it exists. ntspyderzspyder-N) tempfileZ gettempdirosnameappendrZto_unicode_from_fsrospjoinisdirmkdir)suffixZto_joinusernameZtempdirrrr get_temp_dir/s        r#c Cst}g}tjdkr|dr,t|r,|Stdddt|ddg}t|ddg}gd }d d t||D}| ||ntj d rtdddt|ddg}|dg}gd }d d t||D}| ||n\t j dkr@t|dddg}|dtddg}gd}dd t||D}| ||t j dt j|D]&}t||}t|rV|SqVdS)a Return program absolute path if installed in PATH. Otherwise, return None. Also searches specific platform dependent paths that are not already in PATH. This permits general use without assuming user profiles are sourced (e.g. .bash_Profile), such as when login shells are not used to launch Spyder. On macOS systems, a .app is considered installed if it exists. darwin.appz/usrZlocalbinz.pyenvZoptz/opt)ZanacondaZ minicondaZ anaconda3Z miniconda3cSs g|]}tjg|dRqSZcondabinrr.0prrr `z(is_program_installed..linuxcSs g|]}tjg|dRqSr'r(r)rrrr,lr-rz pyenv-winzC:\Z ProgramData)ZAnacondaZ MinicondaZ Anaconda3Z Miniconda3cSs g|]}tjg|dRqSr'r(r)rrrr,ur-PATHN)r sysplatformendswithrexistsr itertoolsproductextend startswithrrenvironsplitpathsepisfile) basenamehomeZ req_pathsZpyenvabZcondapathabspathrrris_program_installedFs<          rBcsXg}tjdkr6d}|s6fdd|Dg}|D]}t|}|r:|Sq:dS)z Find program in PATH and return absolute path Try adding .exe or .bat to basename on Windows platforms (return None if not found) r).exe.bat.cmdcsg|] }|qSrr)r*Zextr<rrr,r-z find_program..N)rrr2rB)r<names extensionsrr@rrFr find_programs  rIcCs$tjdkr|drdd|gS|gS)aq Return the list of tokens necessary to open the program at a given path. On macOS systems, this function prefixes .app paths with 'open -a', which is necessary to run the application. On all other OS's, this function has no effect. :str path: The path of the program to run. :return: The list of tokens necessary to run the program. r$r%open-a)r0r1r2r@rrrget_full_command_for_programs  rMcKs|dtjdktjdkrd}d}||O}|d||ddurd D]R}|ttj|dvrJtj D]*\}}||krp|d ||iqJqpqJn.|ddurd |dvr|d d t i|S) aR Given a dict, populate kwargs to create a generally useful default setup for running subprocess processes on different platforms. For example, `close_fds` is set on posix and creation of a new console window is disabled on Windows. This function will alter the given kwargs and return the modified dict. Z close_fdsposixrriZ creationflagsenvN)Z SYSTEMROOTZ SYSTEMDRIVEHOME) setdefaultrrgetmapstrupperkeysr8itemsupdater )kwargsZCONSOLE_CREATION_FLAGSZCREATE_NO_WINDOWZenv_varkvrrr#alter_subprocess_kwargs_by_platforms"      r\cKszd|vr|dstdnd|d<tjdksBd|vrBtd|d<dD]}||tjqFtfi|}tj|fi|S)aF Execute the given shell command. Note that *args and **kwargs will be passed to the subprocess call. If 'shell' is given in subprocess_kwargs it must be True, otherwise ProgramError will be raised. . If 'executable' is not given in subprocess_kwargs, it will be set to the value of the SHELL environment variable. Note that stdin, stdout and stderr will be set by default to PIPE unless specified in subprocess_kwargs. :str cmdstr: The string run as a shell command. :subprocess_kwargs: These will be passed to subprocess.Popen. shellzBThe "shell" kwarg may be omitted, but if provided it must be True.Tr executableZSHELLstdinstdoutstderr) rrrgetenvrQ subprocessPIPEr\Popen)Zcmdstrsubprocess_kwargsstreamrrrrun_shell_commands ricKsxd|vr|drtdt|}|s0td|t||p.cs|SNrxsort_keyrrr-z'_get_win_applications..rrCrsz3SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall) DisplayNameInstallLocation DisplayIconrcs"g|]}t|d|dqSrrrrrrr,r-cs|Srrrrrrrr-rrr,cs&g|]}tjtj|r|qSr)rr@r;r)r*f)locationrrr,s)rC.comrDZuninsz ()r)rHKEY_LOCAL_MACHINEZKEY_WOW64_32KEYZKEY_WOW64_64KEYHKEY_CURRENT_USERr4chainsorted capitalizerrr@ expandvarsrr9dirnamer;rlistdirrr2r7rlistzipvaluesrW)rZhfsZ app_pathsZ_appsrrrZexpanded_fpathappsriconfilesfnameZfn_lowZ valid_filerrrr)rrrrr_get_win_applicationssj           rcCs~i}ddg}g}|D]*}t|}|D]}t|}||q&qt|dddD](}|dsP|ddkrP|d ||d <qP|S) z/Return all system installed linux applications.z/usr/share/**/*.desktopz~/.local/share/**/*.desktopcSs|dS)Nrrrrrrrr-z)_get_linux_applications..rrqrpZ Applicationrrr)globrwrr)rZdesktop_app_pathsZall_entries_datar@fpathsrrrvrrr_get_linux_applicationss rcCshi}ddtg}g}|D]}|t|7}q|D].}tj|r4tj|dd}|||<q4|S)z-Return all system installed osx applications.z /**/*.appz/Users/{}/**/*.appr%r)formatr~rrr@rr<r9)rZ app_foldersrr@rrrrrr_get_mac_applicationss   rcCsddlm}ddlm}tj|s0tj|r|d}t j dkrft |}|rtj|r||}qtj dkrrqt |}|d}|rtj|r||}q||}n |d}|S) z5Return application icon or default icon if not found.r)QIcon)imaZno_matchr$rrnhelp)Z qtpy.QtGuirZspyder.utils.icon_managerrrr@r;rrr0r1ryrrwZ fromTheme)rrrrrrnrvrrrget_application_icons$          rcCsbi}tjdkrt}ntjdkr(t}nt}tjdkrLdd|D}ndd|D}|S)z Return all system installed applications. The return value is a list of tuples where the first item is the icon path and the second item is the program executable path. r$rcSs i|]\}}t|r||qSr)rrr*rvalrrr %r-z.get_installed_applications..cSs i|]\}}t|r||qSr)rr;rrrrr'r-)r0r1rrrrrrW)rrrrget_installed_applicationss   rc Csi}tjdkrdd|D}tjdkr|dr.r$r%z2`app_path` must point to a valid OSX application!rJrKr )rCrDrrEz5`app_path` must point to a valid Windows executable!z.desktopz3`app_path` must point to a valid Linux application!rorz%uz%fz%Uz%FT)r])rrr0r1r2r@r ValueErrorrdZcallrtrr;OSErrorrwlenrr) Zapp_pathfnamesZ return_codescmdZ return_coderuZmultiZextrarrrropen_files_with_application,s                    rcCs|dus J|dur2tj|}|r,|j}qZd}n(tj|}|rVt|j|d}nd}|r~t|sp|d7}t|r~|SdS)z Return absolute path if Python script exists (otherwise, return None) package=None -> module is in sys.path (standard library modules) Nz.pyw) importlibutil find_specoriginrrr;)packagemodulespecr@rrrpython_script_existss     rcCsP|dus Jt|ttfr(t|ttfs,Jt||}ttj||g|dS)zv Run Python script in a separate process package=None -> module is in sys.path (standard library modules) N) isinstancetuplerrrlr0r^)rrrkp_argsr@rrrrun_python_scripts   rcCsHt|s Jd}g}t||D]"}|r ||ddq |S)ac Split the string `text` using shell-like syntax This avoids breaking single/double-quoted strings (e.g. containing strings with spaces). This function is almost equivalent to the shlex.split function (see standard library `shlex`) except that it is supporting unicode strings (shlex does not support unicode until Python 2.7.3). z/(\s+|(?.run_terminal_thread)target)$rrrrrrr rZto_fs_from_unicoderiZ WindowsErrorZqtpy.QtWidgetsrspyder.config.baserZcriticalZOkr0r1r7rBrrlrZNamedTemporaryFiler#writerr r8closechmod threadingZThreadstartNotImplementedError)rZwdirrkrrrr^rrrrZprogramsrjZarglistrthreadrrrrun_python_script_in_terminals                  rcCst|trddd|D}z|dkr:t|t|kWS|dkrTt|t|kWS|dkrnt|t|kWS|dkrt|t|kWS|dkrt|t|kWSWd SWntyYd S0d S) a Check version string of an active module against a required version. If dev/prerelease tags result in TypeError for string-number comparison, it is assumed that the dependency is satisfied. Users on dev branches are responsible for keeping their own packages up to date. Copyright (C) 2013 The IPython Development Team Distributed under the terms of the BSD License. .cSsg|] }t|qSr)rT)r*irrrr,=r-z!check_version..>>==<<=FTN)rrrr TypeError)ZactverversionZcmp_oprrr check_version/s   rcCsHd}z t|}t|dt|dd}Wnty6Yn0|sDt|}|S)z=, > or < to specify the exact requirement ; multiple conditions may be separated by ';' (e.g. '>=0.13;<1.0') If ``interpreter`` is not None, checks if a module is installed with a given ``version`` in the ``interpreter``'s environment. Otherwise checks in Spyder's environment. Na try: import {} as mod except Exception: print('No Module') # spyder: test-skip print(getattr(mod, '__version__', getattr(mod, 'VERSION', None))) # spyder: test-skip -crFz No ModuleNoneT__file__;z[0-9]zInvalid version numberr )r rr r r zInvalid version condition '%s')is_python_interpreterrrrl communicatedecoderrtrrrr9rsearchrr)rrZ interpreterrrrarbZmodule_versionrZversionsoutputZ_vermatchZsymbrrrris_module_installedisZ           r$cCs&d}tj||tjddurdSdSdS)z8Check that the python interpreter file has a valid name.z.*python(\d\.?\d*)?(w)?(.exe)?$flagsNFTrr#Ifilenamerrrr is_python_interpreter_valid_namesr+cCstj|}t|rt|s"dSt|rtjdkrHt |sBdSdSqt j dkrzt rft |rfdSt |stdSdSqdSnt |rdSt |SdS)z7Evaluate whether a file is a python interpreter or not.FrTr$N)rr@realpathrr;r+ is_pythonwrrZ is_text_filer0r1r check_python_help)r*Z real_filenamerrrrs(       rcCs&d}tj||tjddurdSdSdS)z0Check that the python interpreter has 'pythonw'.z.*python(\d\.?\d*)?w(.exe)?$r%NFTr'r)rrrr-sr-csnzTt|ddgid}|\}tgd}tfdd|DrLWdSWdSWntyhYdS0d S) zBCheck that the python interpreter can compile and provide the zen.rz import thisr)zBeautiful is better than ugly.z!Explicit is better than implicit.zSimple is better than complex.z#Complex is better than complicated.c3s|]}|vVqdSrr)r*linerarr r-z$check_python_help..TFN)rlrrallrt)r*rrZ valid_linesrr0rr.s   r.c Cs~z\tt|}tgd}tr,|dtdd|ddD}||@g}t|WStjtj fyxYdS0dS)aT Test whether given PID belongs to a Spyder process. This is checked by testing the first three command line arguments. This function returns a bool. If there is no process with this PID or its command line cannot be accessed (perhaps because the process is owned by another user), then the function returns False. )rZspyder3z spyder.exez spyder3.exez bootstrap.pyzspyder-script.pyzSpyder.launch.pywz runtests.pycss|]}tj|VqdSr)rr@r<)r*argrrrr1r-z$is_spyder_process..NrF) psutilZProcessintsetraddZcmdlineanyZ NoSuchProcessZ AccessDenied)pidr+rGZ argumentsZ conditionsrrris_spyder_processs     r:cCs@z t|dg\}}|}Wnty6d}Yn0|S)z>Return version information of the selected Python interpreter.z-Vrs)rlrr rtr)r@r__rrrget_interpreter_infos    r<cCsBtjdkr6tjttddd}|jdkr.dStdStdSdS)z"Find git executable in the system.r$z check-git.shT)Zcapture_outputrNZgit) r0r1rdrunrrHERE returncoderIrrrrfind_git$s   r@)N)N)NN)N)NN)P__doc__Z __future__rastrZgetpassrtextwraprrrr4ros.pathr@rrrdr0rrrrrr4rrrr r Zspyder.config.utilsr Zspyder.py3compatr r rZ spyder.utilsrZspyder.utils.miscrrArrr>rtrr#rBrIrMr\rirlrwryr~rrrrrrrrrrrrrrrrr$r+rr-r.r:r<r@rrrrsx          9'' & # HW   `!  Q