B 9d/@sdZddlZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl m Z ddl mZmZmZmZddlmZddlmZddlmZddlmZee d d Zd d Zd dZddZddZ ddZ!ddZ"ddZ#d9ddZ$d:ddZ%e j&dkr e$Z'ne%Z'd;dd Z(d!d"Z)dzNotebook related utilitiesN) LooseVersion)quoteunquoteurlparseurljoin) pathname2url)Future)gen) py3compat UF_HIDDENicCs(yt|Wntk r"dSXdS)zcReplacement for `os.path.exists` which works for host mapped volumes on Windows containers FT)oslstatOSError)pathr[/work/yifan.wang/ringdown/master-ringdown-env/lib/python3.7/site-packages/notebook/utils.pyexistss rcGsf|dd}|dd}dd|D}ddd|D}|rJd|}|rV|d}|dkrbd}|S) zJoin components of url into a relative url Use to prevent double slash when joining subpath. This will leave the initial and final / in place r/cSsg|]}|dqS)r)strip).0srrr 2sz!url_path_join..css|]}|r|VqdS)Nr)rrrrr 3sz url_path_join..z//) startswithendswithjoin)piecesinitialfinalstrippedresultrrr url_path_join*sr"cCst|jdS)z)Determine whether a given URL is absoluter)rrr)urlrrrurl_is_absolute9sr$cCs6dd|tjD}|ddkr*d|d<t|}|S)z"Convert a local file path to a URLcSsg|] }t|qSr)r)rprrrr?szpath2url..rr)splitr sepr")rrr#rrrpath2url=s  r)cCs$dd|dD}tjj|}|S)z"Convert a URL to a local file pathcSsg|] }t|qSr)r)rr%rrrrHszurl2path..r)r'r rr)r#rrrrrurl2pathFs r*cCs(tj|ddd}ddd|DS)zVEscape special characters in a URL path Turns '/foo bar/' into '/foo%20bar/' utf8)encodingrcSsg|] }t|qSr)r)rr%rrrrRszurl_escape..)r unicode_to_strr'r)rpartsrrr url_escapeLsr/cCs$dddtj|dddDS)zXUnescape special characters in a URL path Turns '/foo%20bar/' into '/foo bar/' rcSsg|]}tjt|ddqS)r+)r,)r Zstr_to_unicoder)rr%rrrrZsz url_unescape..r+)r,)rr r-r')rrrr url_unescapeTsr0cCs`tj|drdSd}ytjjt |}Wnt k rFYnX|dkr\||@r\dSdS)aIs a file hidden? This only checks the file itself; it should be called in combination with checking the directory containing the file. Use is_hidden() instead to check the file and its parent directories. Parameters ---------- abs_path : unicode The absolute path to check. stat_res : os.stat_result, optional Ignored on Windows, exists for compatibility with POSIX version of the function. .TrF) r rbasenamerctypeswindllkernel32ZGetFileAttributesWr Z cast_unicodeAttributeError)abs_pathstat_resZwin32_FILE_ATTRIBUTE_HIDDENattrsrrris_file_hidden_win_sr;c Cstj|drdS|dks*t|jrnyt|}Wn4tk rl}z|jtj krZdSWdd}~XYnXt |jrt |tj tj BsdSt|ddt@rdSdS)aIs a file hidden? This only checks the file itself; it should be called in combination with checking the directory containing the file. Use is_hidden() instead to check the file and its parent directories. Parameters ---------- abs_path : unicode The absolute path to check. stat_res : os.stat_result, optional The result of calling stat() on abs_path. If not passed, this function will call stat() internally. r1TNFst_flagsr)r rr3rstatS_ISLNKst_modererrnoENOENTS_ISDIRaccessX_OKR_OKgetattrr )r8r9errris_file_hidden_posixs  rHwin32r&cCstj|tj|krdSt|r(dS|sD|tjddtj}|t|d}tdd|tjDrrdStj|}xt|r| |r||krt |stj|}qyt |}Wnt k rdSXt |ddt@rdStj|}qWdS) aIs a file hidden or contained in a hidden directory? This will start with the rightmost path element and work backwards to the given root to see if a path is hidden or in a hidden directory. Hidden is determined by either name starting with '.' or the UF_HIDDEN flag as reported by stat. If abs_path is the same directory as abs_root, it will be visible even if that is a hidden folder. This only checks the visibility of files and directories *within* abs_root. Parameters ---------- abs_path : unicode The absolute path to check for hidden directories. abs_root : unicode The absolute path of the root directory in which hidden directories should be checked for. FTrNcss|]}|dVqdS)r1N)r)rpartrrrrszis_hidden..r<)r rnormpathis_file_hiddenr'r(lenanydirnamerrr rrFr )r8Zabs_rootZ inside_rootrstrrr is_hiddens,  rRcCs,t|}t|}||ko*||kS)ao Fill in for os.path.samefile when it is unavailable (Windows+py2). Do a case-insensitive string comparison in this case plus comparing the full stat result (including times) because Windows + py2 doesn't support the stat fields needed for identifying if it's the same file (st_ino, st_dev). Only to be used if os.path.samefile is not available. Parameters ----------- path: String representing a path to a file other_path: String representing a path to another file Returns ----------- same: Boolean that is True if both path and other path are the same )r r=lower)r other_pathZ path_statZother_path_statrrrsamefile_simples  rUcCs<|dd}dd|D}tjj|f|}tj|S)zConvert an API path to a filesystem path If given, root will be prepended to the path. root must be a filesystem path already. rcSsg|]}|dkr|qS)r&r)rr%rrrrszto_os_path..)rr'r rrrL)rrootr.rrr to_os_pathsrWcCsN||r|t|d}|tjjtjj}dd|D}d|}|S)zConvert a filesystem path to an API path If given, root will be removed from the path. root must be a filesystem path already. NcSsg|]}|dkr|qS)r&r)rr%rrrr szto_api_path..r)rrNrr rr(r'r)Zos_pathrVr.rrrr to_api_paths   rXcCs*yt|t|kStk r$dSXdS)zcheck version string v >= check 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. TN)r TypeError)vcheckrrr check_versionsr\cCs4ddl}|jjdd|}|r,|jj|t|S)NrrJ)r4r5r6Z OpenProcessZ CloseHandlebool)pidr4handlerrr_check_pid_win32s r`c Cs^yt|dWnDtk rT}z&|jtjkr2dS|jtjkrBdSWdd}~XYnXdSdS)z'Copy of IPython.utils.process.check_pidrFTN)r killrr@ZESRCHEPERM)r^errrrr_check_pid_posix's  rdcCsFt|rt|St|tjjr,t|St}| ||SdS)zxLike tornado's deprecated gen.maybe_future but more compatible with asyncio for recent versions of tornado N) inspect isawaitableasyncio ensure_future isinstance concurrentfuturesr wrap_future set_result)objfrrr maybe_future;s    rpcs tsSfdd}|S)aIf async, runs maybe_async and blocks until it has executed, possibly creating an event loop. If not async, just returns maybe_async as it is the result of something that has already executed. Parameters ---------- maybe_async : async or non-async object The object to be executed, if it is async. Returns ------- result : Whatever the async object returns, or the object itself. c sd}y t}Wntk r(d}YnX|r6d}|rLt}t|y|}Wn8tk r}zt|dkrt}Wdd}~XYnX|S)NFTz"This event loop is already running) rgget_event_loop RuntimeError is_closednew_event_loopset_event_looprun_until_completestrrh)Zcreate_new_event_looploopr!rG) maybe_asyncrrwrapped_s     zrun_sync..wrapped)rerf)ryrzr)ryrrun_syncLs  r{cCs |ddS)zREncodes a UNIX socket path string from a socket path for the `http+unix` URI form.rz%2F)replace) socket_pathrrrurlencode_unix_socket_pathusr~cCs |ddS)zWDecodes a UNIX sock path string from an encoded sock path for the `http+unix` URI form.z%2Fr)r|)r}rrrurldecode_unix_socket_pathzsrcCsdt|S)zJEncodes a UNIX socket URL from a socket path for the `http+unix` URI form.z http+unix://)r~)r}rrrurlencode_unix_socketsrcCs\tj|sdSzsX         '  2    )