Ib{/dZddlZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl m Z ddl mZmZmZmZddlmZddlmZddlmZddlmZee d d Zd Zd Zd ZdZ dZ!dZ"dZ#d"dZ$d"dZ%e jLdk(re$Z'ne%Z'd#dZ(dZ)d#dZ*d#dZ+dZ,dZ-dZ.e jLdk(re-Z/ne.Z/dZ0dZ1dZ2dZ3d Z4d!Z5y)$zNotebook related utilitiesN) LooseVersion)quoteunquoteurlparseurljoin) pathname2url)Future)gen) py3compat UF_HIDDENicN tj|y#t$rYywxYw)zcReplacement for `os.path.exists` which works for host mapped volumes on Windows containers FT)oslstatOSError)paths 0/usr/lib/python3/dist-packages/notebook/utils.pyexistsrs+   s  $$c|djd}|djd}|Dcgc]}|jd}}djd|D}|rd|z}|r|dz}|dk(rd}|Scc}w)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/c3&K|] }|s| ywN).0ss r z url_path_join..3s/AQa/sz//) startswithendswithstripjoin)piecesinitialfinalrstrippedresults r url_path_joinr&*s Qi""3'G 2J   $E&,- -H- XX// /Fv v|f ~v M .sA6cJt|jjdS)z)Determine whether a given URL is absoluter)rrr)urls rurl_is_absoluter)9s C=   ( ( --c|jtjDcgc] }t|}}|ddk(rd|d<t |}|Scc}w)z"Convert a local file path to a URLrr)splitrseprr&)rpr!r(s rpath2urlr0=sO!%BFF!3 5AuQx 5F 5 bzRr  C J 6sA c|jdDcgc] }t|}}tjj|}|Scc}w)z"Convert a URL to a local file pathr)r-rrrr )r(r/r!rs rurl2pathr2Fs=#&99S> 3awqz 3F 3 77<< D K4sActj|djd}dj|Dcgc] }t |c}Scc}w)zVEscape special characters in a URL path Turns '/foo bar/' into '/foo%20bar/' utf8encodingr)r unicode_to_strr-r r)rpartsr/s r url_escaper9LsB  $ $TF ; A A# FE 88u-!U1X- ..-sAc djtj|djdDcgc]"}tjt |d$c}Scc}w)zXUnescape special characters in a URL path Turns '/foo%20bar/' into '/foo bar/' rr4r5)r r r7r-str_to_unicoder)rr/s r url_unescaper<TsY 88))$@FFsK    f= s'A"ctjj|jdryd} tj j jtj|}|dkDr||zryy#t$rYywxYw)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) rrbasenamerctypeswindllkernel32GetFileAttributesWr cast_unicodeAttributeError)abs_pathstat_reswin32_FILE_ATTRIBUTE_HIDDENattrss ris_file_hidden_winrK_s  ww!,,S1"& &&99  " "8 ,  19!<<      sTNFst_flagsr)rrr@rstatS_ISLNKst_modererrnoENOENTS_ISDIRaccessX_OKR_OKgetattrr )rGrHes ris_file_hidden_posixrYs  ww!,,S14<<(8(89 wwx(H ||H$$%yy277RWW#45xQ')3  ww%,,&  sC DC>=C>>Dwin32c,tjj|tjj|k(ryt|ry|s4|j tj ddtj z}|t |d}td|j tj Drytjj|}|r|j|r||k7rt|s tjj|}C tj|}t|ddtzrytjj|}|r|j|r||k7ry#t$rYywxYw)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. FTrNc3>K|]}|jdyw)r>N)r)rparts rrzis_hidden..s FD4??3  FsrM)rrnormpathis_file_hiddenr-r.lenanydirnamerrrrrWr )rGabs_root inside_rootrsts r is_hiddenrgs<( ww!RWW%5%5h%??h >>"&&!,Q/"&&83x=>*K FK,=,=bff,E FF 77??8 $D 4??8,1Ad|77??4(D  $B 2z1 % 1wwt$ 4??8,1A    s$F FFctj|}tj|}|j|jk(xr||k(S)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 )rrNlower)r other_path path_statother_path_stats rsamefile_simplermsH( Iggj)O JJLJ,,. . )  (*r*c|jdjd}|Dcgc] }|dk7s | }}tjj|g|}|Scc}w)zConvert an API path to a filesystem path If given, root will be prepended to the path. root must be a filesystem path already. rr,)rr-rrr )rrootr8r/s r to_os_pathrpsV JJsO ! !# &E )1bQ )E ) 77<< %u %D K *s AAc:|j|r|t|d}|jtjj j tjj }|Dcgc] }|dk7s | }}dj|}|Scc}w)zConvert a filesystem path to an API path If given, root will be removed from the path. root must be a filesystem path already. Nr,r)rrarrrr.r-r )os_pathror8r/rs r to_api_pathrss{ $#d)*% MM"''++ & , ,RWW[[ 9E )1bQ )E ) 88E?D K *s 4 B?BcP t|t|k\S#t$rYywxYw)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)vchecks r check_versionrxs-A,u"555 s  %%cddl}|jjjdd|}|r%|jjj |t |S)Nrr\)rArBrC OpenProcess CloseHandlebool)pidrAhandles r_check_pid_win32rsJ]] # # / /!C 8F  **F4 <r*c tj|dy#t$rJ}|jtjk(rYd}~y|jtj k(rYd}~yd}~wwxYw)z'Copy of IPython.utils.process.check_pidrTNF)rkillrrQESRCHEPERM)r}errs r_check_pid_posixr'sT  Q  99 # YY%++ % s  A,A'A'&A''A,ctj|rtj|St |t j jrtj|Stj}|j||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)objfs r maybe_futurer;si 3$$S)) C++22 3""3'' NN  Sr*cJtjsSfd}|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. cld} tj}|jrd} |r)tj}tj | j }|S#t$rd}YLwxYw#t$r.}t|dk(rtj}Yd}~Sd}~wwxYw)NFTz"This event loop is already running) rget_event_loop is_closed RuntimeErrornew_event_loopset_event_looprun_until_completestrr)create_new_event_looploopr%rX maybe_asyncs rwrappedzrun_sync..wrapped_s % -))+D~~(,% ))+D  " "4 ( <,,[9F   )$( ! ) <1v== ..{;  >+ &}}V^^V-?-?@ [!   s$AA77 BBBBB(r)r,)6__doc__rconcurrent.futuresrrArQrrrrNsysdistutils.versionr urllib.parserrrrurllib.requestrtornado.concurrentr TornadoFuturetornador ipython_genutilsr rWr rr&r)r0r2r9r<rKrYplatformr`rgrmrprsrxrr check_pidrrrrrrrr*rrs   *;:'7& D+u -  . /@%N<<7'N)N0d*4    <<7 I I"&R+ + D r*