G@d(dZddlmZddlmZddlmZddlZddlZddl Z ddl Z ddl m Z ddlZddlZddlZddlZddlZddlZddlmZddlZddlZddlmZmZmZddlmZdd lmZe j e j!e"Z#Gd d e$Z%d.d Z&d Z'dZ(dZ)dZ*dZ+d.dZ,dZ-dZ.dZ/dZ0dZ1dZ2dZ3dZ4dZ5dZ6dZ7d/dZ8ddggfdZ9d Z:d!Z; d/d"Zd%Z? d0d&Z@d'ZAd(ZBd)ZCd*ZDd+ZEd,ZFd-ZGdS)1zRunning programs utilities.) literal_eval)getuser)dedentN)parse)running_under_pytest get_home_dirrunning_in_mac_app)encoding)get_python_executableceZdZdS) ProgramErrorN)__name__ __module__ __qualname__5lib/python3.11/site-packages/spyder/utils/programs.pyr r 'sDrr ctjg}tjdkr|dn8t jt}|d|ztj |}tj |stj ||||tj |}tj |stj ||S)zP Return temporary Spyder directory, checking previously that it exists. ntspyderzspyder-) tempfile gettempdirosnameappendr to_unicode_from_fsrospjoinisdirmkdir)suffixto_joinusernametempdirs r get_temp_dirr%+s"$$%G w$x    .wyy99y8+,,,h G 9W    vh G 9W    Nrct}g}tjdkr+|drt j|r|St jdkrIt j|ddt jdddg}|t j|dd g}gd }nIt j|dd dg}|t j|d d dt jddg}gd}dtj ||D}| ||zt j d t j|zD]/}t j||}t j|r|cS0dS)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.appposixz.pyenvbinz/usrlocaloptz/opt) mambaforge miniforge3 miniforge miniconda3 anaconda3 minicondaanacondaz pyenv-winAppDataLocalzC:\ ProgramData) Mambaforge Miniforge3 Miniforge Miniconda3 Anaconda3 MinicondaAnacondac4g|]}tjg|dRS)condabin)rr).0ps r z(is_program_installed..ms- G G G!SX %q %* % % % G G GrPATHN)rsysplatformendswithrexistsrrr itertoolsproductextendenvironsplitpathsepisfile) basenamehome req_pathspyenvabcondapathabspaths ris_program_installedrXGs >>DI     f % % ! Jx  ! w' HT8U + + HVWe , ,  38D%((& 1 A A A$+u==> 38D)W55 SXfm44 6 A A A H Gy/@A/F/F G G GE UU]### 6"((44y@(4** :g   NNN rcg}tjdkr)d}|sfd|Dgz}|D]}t|}|r|cSdS)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.cmdcg|]}|zSrr)r@extrOs rrBz find_program..s:::X^:::rN)rrrFrX)rOnames extensionsrrVs` r find_programravsJE w$-   ,, H::::z:::hZGE#D))  KKK rc\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)rDrErFrVs rget_full_command_for_programrfs6 |xDMM&$9$9d## 6Mrc |dtjdktjdkrd}d}||z}|d||dd D]}|t t j|dvr[tj D]<\}}||kr|d ||in=nH|d3d |dvr)|d d ti|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. close_fdsr)rri creationflagsenvN) SYSTEMROOT SYSTEMDRIVEHOME) setdefaultrrgetmapstrupperkeysrKitemsupdater)kwargsCONSOLE_CREATION_FLAGSCREATE_NO_WINDOWenv_varkvs r#alter_subprocess_kwargs_by_platformr|sJ k27g#5666 w$!"%"22/+ABBB ::e   (8 " "#ci1C1C1E1E"F"FFF " 0 0 2 2""1"aggii//"5M00!Q888!E0 ::e   (VE]**u $$flnn%=>>> Mrc d|vr|dstdd|d<tjdksd|vrtjd|d<dD]"}||t j#tdi|}t j|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 executableSHELLstdinstdoutstderrr) r rrgetenvrn subprocessPIPEr|Popen)cmdstrsubprocess_kwargsstreams rrun_shell_commandrs$###,=g,F#788 8&*'" 7d?? 0 0 0.0i.@.@ l +/>>$$VZ_====;   F 8 8&7 8 88rc ,d|vr|drtdt|}|std|zt||pgz}dD]"}||tj#t di|}t j|fi|S)a Run program in a separate process. NOTE: returns the process object created by `subprocess.Popen()`. This can be used with `proc.communicate()` for example. If 'shell' appears in the kwargs, it must be False, otherwise ProgramError will be raised. If only the program name is given and not the full path, a lookup will be performed to find the program. If the lookup fails, ProgramError will be raised. Note that stdin, stdout and stderr will be set by default to PIPE unless specified in subprocess_kwargs. :str program: The name of the program to run. :list args: The program arguments. :subprocess_kwargs: These will be passed to subprocess.Popen. r~zNThis function is only for non-shell programs, use run_shell_command() instead.zProgram %s was not foundrr)r rarfrnrrr|r)programargsrfullcmdrs r run_programrs,###(9'(B#>?? ?7##G A5?@@@*733tzrBG/>>$$VZ_====;   G 9 9'8 9 99rcRddlm} ||}i}||d<||d<||d<||d<||d<||d<n#t$r d d d d d |d }YnwxYw|S) z4Load data from desktop entry with xdg specification.r) DesktopEntryr icon_pathexectypehiddenfpath)rrrrrr)xdg.DesktopEntryrgetNamegetIcongetExecgetType getHidden Exception)rrentry entry_datas rparse_linux_desktop_entryr s------  U## "]]__ 6"'--// ;"]]__ 6"]]__ 6$00 8# 7         sBBB$#B$c ddl}tj|dx}}tj|d}i}tj|r' ||}n#t $rYnwxYw|d}d}|r\tj|d|}|ds|dz}tj|sd}|S)z=Parse mac application bundle and return path for *.icns file.rNContentsz Info.plistCFBundleIconFile Resourcesz.icns) plistlibrrVrrN readPlistrrorF)app_bundle_pathr contents_path info_pathpl icon_filers r_get_mac_application_icon_pathr's OOO " _j I IIMI ]L99I B w~~i   ##I..BB    D )**IIGLL YGG !!'** ,!G+Iw~~i(( I s)A?? B  B ctjdkrtj}n0ddl}|tjd}|S)z Return current session username.rrN)rrgetloginpwdgetpwuidgetuid)r#rs r get_usernamerDsD w$;== << ,,Q/ Orczddl}|d|}g} |||d|j|z}||d}t |D]} i} ||| } | dr| dsl| | d<||| } |D]9} | | | d}|| | <%#t$rd| | <Y6wxYw| | #t$rYwxYwn#t$rYnwxYw|S)z3 See: https://stackoverflow.com/q/53132434 rN{}keyr) winregConnectRegistryOpenKeyKEY_READ QueryInfoKeyrangeEnumKey startswithrF QueryValueExEnvironmentErrorrr)key_pathhiveflagsubkeysrreg software_listr count_subkeyindexsoftware subkey_namesubkeypropertyvalues r_get_win_reg_inforOsMMM  t , ,CM nnS(Av/EFF**3//2 <((  EH $nnS%88 #..s33 3'0055 3&1HUO#^^C==F$+444$*$7$7$I$I!$LE16HX../44413HX...4!((222#     "       s[AD+-AD !C/.D/D>DDDD+ D'$D+&D''D++ D87D8c|dd}|ddkr|ddkrt|}|S)z/Normalize windows path and remove extra quotes.\/r")replacelowerrres r_clean_win_application_pathrrsL <<c " " ( ( * *D Aw#~~$r(c//D!! Krcddl}d|j|jf|j|jf|jdfg}dgdi}fd|D}t j|}t|fdD]q}|drg|d dd }tj |d}t|}|||<rd gd d i}fd |D}t j|}t|fdD]}|d|d } |d} |d}| r`| r]| dd } | dd} d kr!| rtj | tj | sd } rtj rÈfdtjD} | r| D]} | } | d}|rq| ds\tj | }tj |}t|}||| dz| zdz<t/t1|d}|D]\} }||vr||| <|S)z1Return all system installed windows applications.rNz3SOFTWARE\Microsoft\Windows\CurrentVersion\App PathsrcLg|] }t|d|d!Srrr@hfrrs rrBz)_get_win_applications..0 N N NB xA1w ? ? N N Nrc|SNrxsort_keys rz'_get_win_applications.. ( rrrZrz3SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall) DisplayNameInstallLocation DisplayIconrcLg|] }t|d|d!Srrrs rrBz)_get_win_applications..rrc|Srrrs rrz'_get_win_applications..rrrrr,cg|]A}tjtj|?|BSr)rrVrNr)r@flocations rrBz)_get_win_applications..sRGGGqGNN27<<!+D+DEEGGGGr)rZ.comr[uninsz ()r)rHKEY_LOCAL_MACHINEKEY_WOW64_32KEYKEY_WOW64_64KEYHKEY_CURRENT_USERrHchainsorted capitalizerrrV expandvarsrrLdirnamerNrlistdirrrFrrlistzipvaluesrt)rhfs app_paths_appsrrrexpanded_fpathappsriconfilesfnamefn_low valid_filerrrrrrs @@@@r_get_win_applicationsr {slMMMIH  "F$:;  "F$:;  !1% C fGHI N N N N N# N N NEOU+M=.C.C.C.CDDD,, D> ,5/,,..66vrBBCW//??N8HHN+IcN IH???GH D N N N N N# N N NEOU+M=.C.C.C.CDDDMM-. & &uo  MD M<<R((D::c??1%D2~~$~7??4007>>$''  MBGMM(33 MGGGGBJx$8$8GGG M!&MM!&%+__5M%N%N %Mf.?.?.H.HM$&GLL5$A$AE-/W-?-?-F-FN-H ..0.0N>LDu!4s!:; #t{{}}% & &r *F (( e   DJ Krci}ddg}g}|D]?}tj|}|D]&}t|}||'@t|dD]'}|ds|ddkr|d||d <(|S) z/Return all system installed linux applications.z/usr/share/**/*.desktopz~/.local/share/**/*.desktopc|dS)Nrr)rs rrz)_get_linux_applications..s QvYrrrr Applicationrr)globrrr)rdesktop_app_pathsall_entries_datarVfpathsrrs r_get_linux_applicationsrs D!%!004 0 0E2599J  # #J / / / / 0-3F3FGGG;; (# ; 6(:m(K(K'1'':DF# $ KrcNi}ddtg}g}|D]}|tj|z }|D]^}tj|r=tj|dd}|||<_|S)z-Return all system installed osx applications.z /**/*.appz/Users/{}/**/*.appr(r)formatrrrrVrrOrL)r app_foldersrrVrrs r_get_mac_applicationsrs D##LNN33K F""$)D//! 7==   7##E**0088;DDJ Krc\ddlm}ddlm}tj|stj|r|d}tj dkr>),,6 5++DD ??955Dxx Krc<i}tjdkrt}n-tjdkrt }nt }tjdkrd|D}nd|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'rcBi|]\}}tj|||Sr)rrr@rvals r z.get_installed_applications..s+JJJZc339S>>JSJJJrcBi|]\}}tj|||Sr)rrNr%s rr'z.get_installed_applications..s+KKKZc33:c??KSKKKr)rDrErrrr rrt)rs rget_installed_applicationsr) s D |x$&& D$&&&(( |xJJ4::<<JJJKK4::<<KKK Krci}tjdkr d|D}tjdkr|drtj|stddd|g|z} tj |}n#t$rd}YnwxYw||d |<ntjdkr|d rtj |std |g|z} tj |}n#t$rd}YnwxYw||d |<n/|d rtj |std t|}|d}g}g}t|dkr{|d}d|vr|d|}n/d|vr|d|}nd|vr|d|}nd|vr|d|}n|}|}nt|dkrd|vr*|dd |}n-d|vr)|dd |}d|vr/|D]+}||d|,n7d|vr/|D]+}||d|,n|}|}|r6|D]2} tj |gd}n#t$rd}YnwxYw|||<3n3 tj |g|zd}n#t$rd}YnwxYw|||<|S)z Generalized method for opening files with a specific application. Returns a dictionary of the command used and the return code. A code equal to 0 means the application executed successfully. rc:g|]}|ddS)rr)r)r@r s rrBz/open_files_with_application..+s&???u%--c**???rr'r(z2`app_path` must point to a valid OSX application!rcrdr )rZr[rr\z5`app_path` must point to a valid Windows executable!z.desktopz3`app_path` must point to a valid Linux application!rrz%uz%fz%Uz%FT)r~)rrrDrErFrVr ValueErrorrcallrrrNOSErrorrlenrr) app_pathfnames return_codescmd return_codermultiextrar s ropen_files_with_applicationr8!sXL w$????? |x!!&)) -bgmmH.E.E -,-- -tX&/ $/#..KK   KKK &1 SXXc]]## D!!"BCC ,GNN8,, ,+,, ,j6! $/#..KK   KKK &1 SXXc]]##!!*-- -"'..2J2J -,-- -*(33= v;;!  1IEx&&tU33!!&&tU33!!&&tU33!!&&tU33 [[1__x&&tSXXf-=-=>>!!&&tSXXf-=-=>>x#@@ELL!1!1$!>!>????@!!#@@ELL!1!1$!>!>????@  , 0 0$",/3%t"D"D"DKK $$$"#KKK$$/ S!!  0 (oseem4HHH      +L  sH;B BBD++ D:9D:"L:: M M M// M>=M>cR|J|,tj|}|r|j}nDd}nAtj|}|rt j|j|dz}nd}|r/t j|s|dz }t j|r|SdSdS)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_specoriginrrrN)packagemodulespecrVs rpython_script_existsrBxs    ~''//  ;DDDD~''00  8DK0058DDD z$  CKD :d   K   rc|Jt|ttfrt|ttfsJt||}t t j||gz|zdS)zv Run Python script in a separate process package=None -> module is in sys.path (standard library modules) N) isinstancetuplerrBrrDr)r?r@rp_argsrVs rrun_python_scriptrGso     dUDM * *Pz&5$-/P/PPPP  0 0D$$ 677777rc t|tsJd}g}tj||D]Q}|r;||ddR|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_threadsM$%EQV%E%EFFD JqMMM IIKKK Iaf     r)target)$r rrKpoprMrrYrrr splitdriverqtpy.QtWidgetsr\spyder.config.baser]criticalOkr WindowsErrorrDrErXrJrNamedTemporaryFiler%writerr closechmod threadingThreadstartNotImplementedError)r wdirrrVrWrUrpypathrjrFr\r]r4programsrrrthreadrs @rrun_python_script_in_terminalrs3*,, RZ.CGGL$ (("L LLLE %44D UK5$ G GF w$  <<T**D~d##A&11&99 666666000000$$AeHHA/00N 3J222 sxx#% 44  ct 5 5 5 5 5 5    2 2 2 2 2 2 , , , , , ,  %           ) )#",EE%>>,EE#t<<>   G#GEN33 u~w/?'@*M 6"""!#((3--TsCCCC      ! !  ']/4,../4 6 6 6  . GGK&&t,, - - - j ) ) G GGEL)AEEE F F F   GG3333 4 4 4 *.//000        !)<=== !!s3EAFFcZt|trdd|D} |dkr t|t|kS|dkr t|t|kS|dkr t|t|kS|dkr t|t|kS|dkr t|t|kS|dkr t|t|kSd S#t$rYd SwxYw) 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. .c,g|]}t|Sr)rq)r@is rrBz!check_version..0s222a3q66222r>>==<<=!=FT)rDrErr TypeError)actverversioncmp_ops r check_versionr"s"&%  422622233 S====5>>1 1 t^^==E'NN2 2 s]]==E'NN2 2 s]]==5>>1 1 t^^==E'NN2 2 t^^==E'NN2 25 tts/%D%D%D(%D%D4%D D*)D*c t|}t|dt|dd}|st|}|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. ``distribution_name`` is the distribution name of a package. For instance, for pylsp_black that name is python_lsp_black. Na try: import {} as mod except Exception: print('No Module') # spyder: test-skip print(getattr(mod, '__version__', getattr(mod, 'VERSION', None))) # spyder: test-skip -crjFz No ModuleNoneT__file__rz[0-9]zInvalid version numberr)rrrrrrzInvalid version condition 'rI)is_python_interpreterrrr communicatedecoderKrrrrrrLrJsearchr RuntimeErrorr)rr interpreterdistribution_namer4rqrrmodule_versionrversionsoutput_vermatchsymbrs ris_module_installedrZsn&  - -  VK((  ";s DDD!%!1!1!3!3..00   uu f$$u6!!!'!%4 / <>}}S))HHyH I IDIh--E$$&>$$$'D <<<"#H#H#H#HIIIu{{}}~~&CH nc4 H HFF s6AB BB-B== C  C  C22 C?>C?cPd}tj||tjdSdS)z8Check that the python interpreter file has a valid name.z.*python(\d\.?\d*)?(w)?(.exe)?$flagsNFTrJrIfilenamerMs r is_python_interpreter_valid_namers*0G x...6utrc~ddlm}tj|}t j|rt|sdStj |}t|r>tj dkr|sdSdStj dkr||r|rdS|sdSdSdS|rdSt|S)z7Evaluate whether a file is a python interpreter or not.r) is_conda_envFrTr')pyexec)spyder.utils.condarrrVrealpathrrNrr is_text_file is_pythonwrrDrEcheck_python_help)rr real_filenamers rrrs0/////G$$X..M J} % %0??u(77L-  0 7d?? tu \X % %|=111 l t! tu5 0u ///rcPd}tj||tjdSdS)z0Check that the python interpreter has 'pythonw'.z.*python(\d\.?\d*)?w(.exe)?$rNFTrrs rrrs*-G x...6utrc t|ddgi}|\}tgd}tfd|DrdSdS#t$rYdSwxYw)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.c3 K|]}|vV dSrr)r@liners r z$check_python_help..s'66$tv~666666rTF)rrrqallr)rrqr] valid_linesrs @rrrs8dM%:CCC$$&& V   6666+666 6 6 45 uusAA A.-A.c tjt|}tgd}t r|dtd|ddD}||zg}t|S#tjtj f$rYdSwxYw)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. )rspyder3z spyder.exez spyder3.exez bootstrap.pyzspyder-script.pyzSpyder.launch.pywz runtests.pyc3TK|]#}tj|V$dSr)rrVrO)r@args rrz$is_spyder_process..s2II#((--IIIIIIrNrlF) psutilProcessintsetraddcmdlineany NoSuchProcess AccessDenied)pidrAr_ arguments conditionss ris_spyder_processrs N3s88 $ $NNNOO  ! ! % IIm $ $ $IIRaRIIIII i'( :  &"5 6uusBBB>=B>c t|dg\}}|}t jd|sd}n#t $rd}YnwxYw|S)z>Return version information of the selected Python interpreter.z-Vz^Python \d+\.\d+\.\d+$r)rrrrKrJrr)rVrN__s rget_interpreter_infor s dTF++7799Rjjll  ""y2C88 C  99;;sA#A&& A54A5ctjdkrJtjt jt dd}|jdkrdStdStdS)z"Find git executable in the system.r'z check-git.shT)capture_outputrNgit) rDrErrunrrHERE returncodera)rqs rfind_gitr/sg |x~ HT> * *4AAA ?a  4E"""E"""rr)NN)NNN)H__doc__astrgetpassrtextwraprrr;rHros.pathrVrrJrrDrrrmpackaging.versionrrrrwrrr spyder.utilsr spyder.utils.miscr rWrrrrr r%rXrarfr|rrrrrrrr rrr"r)r8rBrGrPrYrrrrrrrrrrrrrrrrs"!     $##### 4444444444!!!!!!333333s{;3;x(())     9   8,,,^&$$$$N#9#9#9L":":":":J4:   FEEEP0(6.TTTn2#4b8888$.HL["["["["|   F   @D*.[[[[|%0%0%0P(4    # # # # #r