o i/@sdZddlZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl m Z ddl mZmZmZmZddlmZddlmZddlmZddlmZee d d Zd d Zd dZddZddZ ddZ!ddZ"ddZ#d9ddZ$d9ddZ%e j&dkre$Z'ne%Z'd:dd Z(d!d"Z)d:d#d$Z*d:d%d&Z+d'd(Z,d)d*Z-d+d,Z.e j&dkre-Z/ne.Z/d-d.Z0d/d0Z1d1d2Z2d3d4Z3d5d6Z4d7d8Z5dS);zNotebook related utilitiesN) LooseVersion)quoteunquoteurlparseurljoin) pathname2url)Future)gen) py3compat UF_HIDDENicCs&zt|WdStyYdSw)zcReplacement for `os.path.exists` which works for host mapped volumes on Windows containers FT)oslstatOSErrorpathrI/var/www/edux/Edux_v2/venv/lib/python3.10/site-packages/notebook/utils.pyexistss   rcGsf|dd}|dd}dd|D}ddd|D}|r%d|}|r+|d}|dkr1d}|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|VqdSNrrrrr 3sz url_path_join..z//) startswithendswithjoin)piecesinitialfinalstrippedresultrrr url_path_join*s   r%cCst|jdS)z)Determine whether a given URL is absoluter)rrr)urlrrrurl_is_absolute9sr'cCs6dd|tjD}|ddkrd|d<t|}|S)z"Convert a local file path to a URLcSg|]}t|qSrrrprrrr?zpath2url..rr)splitr sepr%)rr r&rrrpath2url=s  r0cCs$dd|dD}tjj|}|S)z"Convert a URL to a local file pathcSr(r)rr*rrrrHr,zurl2path..r)r.r rr)r&r rrrrurl2pathFs r1cCs(tj|ddd}ddd|DS)zVEscape special characters in a URL path Turns '/foo bar/' into '/foo%20bar/' utf8encodingrcSr(rr)r*rrrrRr,zurl_escape..)r unicode_to_strr.r)rpartsrrr url_escapeLsr7cCs$dddtj|dddDS)zXUnescape special characters in a URL path Turns '/foo%20bar/' into '/foo bar/' rcSsg|] }tjt|ddqS)r2r3)r str_to_unicoderr*rrrrYsz url_unescape..r2r3)rr r5r.rrrr url_unescapeTs r9cCs`tj|dr dSd}z tjjt |}Wn t y#YdSw|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 rbasenamerctypeswindllkernel32GetFileAttributesWr cast_unicodeAttributeError)abs_pathstat_reswin32_FILE_ATTRIBUTE_HIDDENattrsrrris_file_hidden_win_s rGc Cstj|dr dS|dust|jr7zt|}Wnty6}z|jtj kr1WYd}~dSd}~wwt |jrIt |tj tj BsIdSt|ddt@rSdSdS)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. r:TNFst_flagsr)r rr<rstatS_ISLNKst_modererrnoENOENTS_ISDIRaccessX_OKR_OKgetattrr )rCrDerrris_file_hidden_posixs"  rTwin32r-cCstj|tj|krdSt|rdS|s"|tjddtj}|t|d}tdd|tjDr9dStj|}|r| |r||krt |sUtj|}q?zt |}Wn t yfYdSwt |ddt@rqdStj|}|r| |r||ksJdS) 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)r:N)r)rpartrrrrszis_hidden..rH)r rnormpathis_file_hiddenr.r/lenanydirnamerrr rrRr )rCabs_root inside_rootrstrrr is_hiddens0     r`cCs,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 rIlower)r other_path path_statother_path_statrrrsamefile_simples  recCs>|dd}dd|D}tjj|g|R}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. rcSg|]}|dkr|qSr-rr*rrrrzto_os_path..)rr.r rrrX)rrootr6rrr to_os_paths rjcCsN||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. NcSrfrgrr*rrrr rhzto_api_path..r)rrZrr rr/r.r)os_pathrir6rrrr to_api_paths  rlcCs(z t|t|kWStyYdSw)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. T)r TypeError)vcheckrrr check_versions  rpcCs4ddl}|jjdd|}|r|jj|t|S)NrrV)r=r>r? OpenProcess CloseHandlebool)pidr=handlerrr_check_pid_win32s rvc Csbz t|dWdSty0}z|jtjkrWYd}~dS|jtjkr+WYd}~dSd}~ww)z'Copy of IPython.utils.process.check_pidrNFT)r killrrLESRCHEPERM)rterrrrr_check_pid_posix's   r{cCsBt|r t|St|tjjrt|St}| ||S)zxLike tornado's deprecated gen.maybe_future but more compatible with asyncio for recent versions of tornado ) inspect isawaitableasyncio ensure_future isinstance concurrentfuturesr wrap_future set_result)objfrrr maybe_future;s    rcs 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}zt}Wn tyd}Ynw|rd}|r%t}t|z|}W|StyR}zt|dkrGt}WYd}~|SWYd}~|Sd}~ww)NFTz"This event loop is already running) r~get_event_loop RuntimeError is_closednew_event_loopset_event_looprun_until_completestrr)create_new_event_looploopr$rS maybe_asyncrrwrapped_s,      zrun_sync..wrapped)r|r})rrrrrrun_syncLs  rcC |ddS)zREncodes a UNIX socket path string from a socket path for the `http+unix` URI form.r%2Freplace socket_pathrrrurlencode_unix_socket_pathu rcCr)zWDecodes a UNIX sock path string from an encoded sock path for the `http+unix` URI form.rrrrrrrurldecode_unix_socket_pathzrrcCsdt|S)zJEncodes a UNIX socket URL from a socket path for the `http+unix` URI form.z http+unix://)rrrrrurlencode_unix_socketsrcCshtj|sdSz&zttjtj}||Wnty'YW|dSwW|dS|w)zSChecks whether a UNIX socket path on disk is in use by attempting to connect to it.FT) r rrsocketAF_UNIX SOCK_STREAMconnectrclose)rsockrrrunix_socket_in_uses   rrrg)6__doc__r~concurrent.futuresrr=rLr|r rrIsysdistutils.versionr urllib.parserrrrurllib.requestrtornado.concurrentr TornadoFuturetornador ipython_genutilsr rRr rr%r'r0r1r7r9rGrTplatformrYr`rerjrlrprvr{ check_pidrrrrrrrrrrsZ         ' 2    )