Mh*$dZddlZddlZddlZddlZddlZddlZddlZddlm Z ej Z dZ ej dkrdZndZdZd ed efd Zd Zdd ed efdZGddeZdd efdZdZdZdZdZdZdZdZdZddZdS) z Utilities for path handling. N)systemc~tj|otj|tjS)zBWhether `path` is a directory, to which the user has write access.)ospathisdiraccessW_OKrs R/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/IPython/utils/path.py _writable_dirr s) 7==   ;29T27#;#;;win32c ddl}n"#t$r}td|d}~wwxYw|jjj}|j|j|jg|_|d}|||d}|dks|dkr|S|j S)zGet a long path name (expand ~) on Windows using ctypes. Examples -------- >>> get_long_path_name('c:\\docume~1') 'c:\\Documents and Settings' rNz2you need to have ctypes installed for this to worki) ctypes ImportErrorwindllkernel32GetLongPathNameW c_wchar_pc_uintargtypescreate_unicode_buffervalue)rre_GetLongPathNamebufrvs r _get_long_path_namers [ MMMM [ [ [RSSYZ Z [!=1B%+%5v7G M%!**3//  dC - - 77b3hhK9 s &!&c|S)z Dummy no-op.r s r rr6s r c t|S)zExpand a path into its long form. On Windows this expands any ~ in the paths. On other platforms, it is a null operation. )rr s r get_long_path_namer"<s t $ $$r rreturnctjd}||rd|t |dz}|S)z%Reverse of :func:`os.path.expanduser`~N)rr expanduser startswithlen)rhomes r compress_userr*EsI 7  c " "D t'd3t99::&& Kr ctj|}tj|r|S|ds&|dz}tj|r|St d|z)zReturn a valid python filename in the current directory. If the given name is not a file, it adds '.py' and searches again. Raises IOError with an informative message if the file isn't found. z.pyzFile `%r` not found.)rrr&isfileendswithIOError)namepy_names r get_py_filenamer1Ls 7  d # #D w~~d ==  , 7>>' " " N (4/ 0 00r filenamecL|dd}tj|r!tj|r|S|d}nt |t r|f}|D]}|dkrtj}ttj ||}tj|r!tj |cStd|d|)aFind a file by looking through a sequence of paths. This iterates through a sequence of paths looking for a file and returns the full, absolute path of the first occurrence of the file. If no set of path dirs is given, the filename is tested as is, after running through :func:`expandvars` and :func:`expanduser`. Thus a simple call:: filefind('myfile.txt') will find the file in the current working dir, but:: filefind('~/myfile.txt') Will find the file in the users home directory. This function does not automatically try any paths, such as the cwd or the user's home directory. Parameters ---------- filename : str The filename to look for. path_dirs : str, None or sequence of str The sequence of paths to look for the file in. If None, the filename need to be absolute or be in the cwd. If a string, the string is put into a sequence and the searched. If a sequence, walk through each element and join with ``filename``, calling :func:`expandvars` and :func:`expanduser` before testing for existence. Returns ------- path : str returns absolute path to file. Raises ------ IOError "'N).zFile z, does not exist in any of the search paths: ) striprrisabsr, isinstancestrgetcwd expand_pathjoinabspathr.)r2 path_dirsrtestnames r filefindrB]sN~~c""((--H w}}X27>>(#;#; Is # #!L -- 3;;ry{{rw||D(;;<< 7>>( # # -7??8,, , , , - '88YY( * **r ceZdZdS) HomeDirErrorN)__name__ __module__ __qualname__r r r rDrDsDr rDFctjd}tj|}t |sltjdkr\ ddl}||jd5}| |dd}dddn #1swxYwYn#YnxYw|rt |r!t|ts Jd|Std|z) aVReturn the 'home' directory, as a unicode string. Uses os.path.expanduser('~'), and checks for writability. See stdlib docs for how this is determined. For Python <3.8, $HOME is first priority on *ALL* platforms. For Python >=3.8 on Windows, %HOME% is no longer considered. Parameters ---------- require_writable : bool [default: False] if True: guarantees the return value is a writable directory, otherwise raises HomeDirError if False: The path is resolved, but it is not guaranteed to exist or be writable. r%ntrNz@Software\Microsoft\Windows\CurrentVersion\Explorer\Shell FoldersPersonalz#Homedir should be unicode not byteszD%s is not a writable dir, set $HOME environment variable to override) rrr&realpathr r/winregOpenKeyHKEY_CURRENT_USER QueryValueExr:r;rD)require_writablehomedirwregkeys r get_home_dirrTsV&g  %%Ggw''G  ! ! bgoo  ! ! ! !&S ?++C ;;A>  ? ? ? ? ? ? ? ? ? ? ? ? ? ? ?   D Hw!7!7H'3''NN)NNNN=?FGHH Hs0B3>B' B3'B++B3.B+/B33B7ctj}tjdkrl|ddp+tjt d}|r(t|rt|tsJ|SdS)zReturn the XDG_CONFIG_HOME, if it is defined and exists, else None. This is only for non-OS X posix (Linux,Unix,etc.) systems. posixXDG_CONFIG_HOMENz.config renvironr/getrr>rTr r:r;envxdgs r get_xdg_dirr^s~ *C w'gg'..Y"',,|~~y2Y2Y  =%% c3'' ' ' 'J 4r ctj}tjdkrl|ddp+tjt d}|r(t|rt|tsJ|SdS)zReturn the XDG_CACHE_HOME, if it is defined and exists, else None. This is only for non-OS X posix (Linux,Unix,etc.) systems. rVXDG_CACHE_HOMENz.cacherXr[s r get_xdg_cache_dirras~ *C w'gg&--Wlnnh1W1W  =%% c3'' ' ' 'J 4r ctjdkr|dd}tjtj|}tjdkr|dd}|S)zExpand $VARS and ~names in a string, like a shell :Examples: In [2]: os.environ['FOO']='test' In [3]: expand_path('variable FOO is $FOO') Out[3]: 'variable FOO is test' rIz$\ IPYTHON_TEMP)rr/replacer expandvarsr&)ss r r=r=sj w}} IIe^ , , 27--a0011A w}} IIne , , Hr ctd}dt||dS)z"Unescape glob pattern in `string`.cbdD]+}|d||},|S)Nz*[]!?z\{0})rdformat)rfpatterns r unescapezunescape_glob..unescapes7 < mapsplit)stringrks r unescape_globrps; 99S6<<#7#788 9 99r cg}tjdkrtnd}|D]5}|t j|p ||g6|S)z Do glob expansion for each element in `args` and return a flattened list. Unmatched glob pattern will remain as-is in the returned list. rc|SNr )xs r zshellglob..sqr )sysplatformrpextendglob)argsexpandedrkas r shellglobr} sbH!$  7 7}}[[H 77 ! 5! 6666 Or icttdstSd} tj||n#t$r}|j}Yd}~nd}~wwxYw|S)zHard links ``src`` to ``dst``, returning 0 or errno. Note that the special errno ``ENOLINK`` will be returned if ``os.link`` isn't supported by the operating system. linkrN)hasattrrENOLINKrOSErrorerrno)srcdst link_errnors r rrsp 2v  J S W  s6 AA  Actj|r=tj|tj|}t ||}|t jkrtj|j tj|j krdS|dtj ddfzz} t||n,# tj |n#t$rYnwxYwxYwtj||dS|dkrt!j||dSdS)a+Attempts to hardlink ``src`` to ``dst``, copying if the link fails. Attempts to maintain the semantics of ``shutil.copy``. Because ``os.link`` does not overwrite files, a unique temporary file will be used if the target already exists, then that file will be moved into place. Nz -temp-%04Xir)rrrr>basenamerrEEXISTstatst_inorandomrandint link_or_copyremoverrenameshutilcopy)rrrnew_dsts r rr/s= w}}S7gll3 0 0 5 566c3JU\!! 73<< "'#,,"5 5 5 F v~a'?'?&BBB  g & & & &   '""""      '3 q  C s0C!!D $C98D 9 DD DD c4tj|sG tj||dS#t$r!}|jt jkrYd}~dSd}~wwxYwtj|std|zdS)zensure that a directory exists If it doesn't exist, try to create it and protect against a race condition if another process is doing the same. The default permissions are 755, which differ from os.makedirs default of 777. )modeNz %r exists but is not a directory) rrexistsmakedirsrrrrr.)rrrs r ensure_dir_existsrSs 7>>$  A  K4 ( ( ( ( ( (   w%,&&'&&&&& W]]4 A84?@@@AAs9 A$AA$rs)F)r) __doc__rrvrrrrywarningsIPython.utils.processrgetfilesystemencoding fs_encodingr rwrr"r;r*r1rB ExceptionrDrTr^rar=rpr}rrrrr r r rs (((((( (c')) <<<<72 %%%111"8*8*s8*s8*8*8*8*v     9   )H)HC)H)H)H)HV&&   .:::    """"HAAAAAAr