U Ed/@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*zt|Wntk r$YdSXdS)zcReplacement for `os.path.exists` which works for host mapped volumes on Windows containers FT)oslstatOSErrorpathr-lib/python3.8/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)Nrrrrr 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|qSrrrprrrr?szpath2url..rr)splitr sepr$)rrr%rrrpath2url=s  r-cCs$dd|dD}tjj|}|S)z"Convert a URL to a local file pathcSsg|] }t|qSr)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/' utf8encodingrcSsg|] }t|qSrr'r(rrrrRszurl_escape..)r unicode_to_strr+r)rpartsrrr url_escapeLsr4cCs$dddtj|dddDS)zXUnescape special characters in a URL path Turns '/foo%20bar/' into '/foo bar/' rcSsg|]}tjt|ddqS)r/r0)r Zstr_to_unicoderr(rrrrYsz url_unescape..r/r0)rr r2r+rrrr url_unescapeTs r5cCs`tj|drdSd}ztjjt |}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_HIDDENZattrsrrris_file_hidden_win_sr?c Cstj|drdS|dks*t|jrtzt|}Wn:tk rr}z|jtj kr`WY dSW5d}~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. r6TNFst_flagsr)r rr8rstatS_ISLNKst_modererrnoENOENTS_ISDIRaccessX_OKR_OKgetattrr )r=r>errris_file_hidden_posixs   rLwin32r*cCstj|tj|krdSt|r(dS|sD|tjddtj}|t|d}tdd|tjDrrdStj|}|r| |r||krt |stj|}q~zt |}Wnt k rYdSXt |ddt@rdStj|}q~dS) 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)r6N)r)rpartrrrrszis_hidden..r@)r rnormpathis_file_hiddenr+r,lenanydirnamerrr rrJr )r=Zabs_rootZ inside_rootrstrrr is_hiddens,  rVcCs,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 rAlower)rZ other_pathZ path_statZother_path_statrrrsamefile_simples   rXcCs<|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|qSr*rr(rrrrszto_os_path..)rr+r rrrP)rrootr3rrr to_os_pathsr[cCsN||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|qSrYrr(rrrr szto_api_path..r)rrRrr rr,r+r)Zos_pathrZr3rrrr to_api_paths   r\cCs.zt|t|kWStk r(YdSXdS)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)NrrN)r9r:r;Z OpenProcessZ CloseHandlebool)pidr9Zhandlerrr_check_pid_win32s rcc Csjzt|dWnPtk r`}z2|jtjkr8WY dS|jtjkrNWY dSW5d}~XYnXdSdS)z'Copy of IPython.utils.process.check_pidrFTN)r killrrDZESRCHEPERM)rberrrrr_check_pid_posix's    rgcCsFt|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 concurrentZfuturesrZ wrap_futureZ 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}z t}Wntk r(d}YnX|r6d}|rLt}t|z|}Wn8tk r}zt|dkrt}W5d}~XYnX|S)NFTz"This event loop is already running) rjZget_event_loop RuntimeErrorZ is_closedZnew_event_loopZset_event_loopZrun_until_completestrrk)Zcreate_new_event_loopZloopr#rK maybe_asyncrrwrapped_s     zrun_sync..wrapped)rhri)rtrurrsrrun_syncLs  rvcCs |ddS)zREncodes a UNIX socket path string from a socket path for the `http+unix` URI form.r%2Freplace socket_pathrrrurlencode_unix_socket_pathusr|cCs |ddS)zWDecodes a UNIX sock path string from an encoded sock path for the `http+unix` URI form.rwrrxrzrrrurldecode_unix_socket_pathzsr}cCsdt|S)zJEncodes a UNIX socket URL from a socket path for the `http+unix` URI form.z http+unix://)r|rzrrrurlencode_unix_socketsr~cCsftj|sdSzFzttjtj}||Wntk rJYWdSXWdSW5|XdS)zSChecks whether a UNIX socket path on disk is in use by attempting to connect to it.FTN) r rrclosesocketZAF_UNIXZ SOCK_STREAMZconnectr)r{Zsockrrrunix_socket_in_uses   r)N)N)r*)r*)r*)6__doc__rjconcurrent.futuresrmr9rDrhr rrAsysZdistutils.versionrZ urllib.parserrrrZurllib.requestrZtornado.concurrentrZ TornadoFutureZtornador Zipython_genutilsr rJr rr$r&r-r.r4r5r?rLplatformrQrVrXr[r\r`rcrgZ check_pidrprvr|r}r~rrrrrsX         '  2    )