ó ù2¢\c@s]dZddlmZddlZddlZddlZddlZddlmZddl m Z m Z ddl Z ddl mZddlmZddlmZydd lmZmZWn'ek rëdd lmZmZnXd „Zdd „Zd „Zd„Zeeddd„ƒZeeddd„ƒZ defd„ƒYZ!dS(s9 Utilities for file-based Contents/Checkpoints managers. iÿÿÿÿ(tcontextmanagerN(t HTTPError(t to_api_patht to_os_path(tstr_to_unicode(t Configurable(tBool(t encodebytest decodebytes(t encodestringt decodestringcCsgttdƒr"tj||ƒnAtjdkrStjj|ƒrStj|ƒntj||ƒdS(sh replace dst with src switches between os.replace or os.rename based on python 2.7 or python 3 treplacetntN(thasattrtosR tnametpathtexiststremovetrename(tsrctdst((s@lib/python2.7/site-packages/notebook/services/contents/fileio.pyt replace_file!s !cCs[tj||ƒytj||ƒWn0tk rV|rW|jd|dtƒqWnXdS(sZcopy src to dst like shutil.copy2, but log errors in copystat instead of raising scopystat on %s failedtexc_infoN(tshutiltcopyfiletcopystattOSErrortdebugtTrue(RRtlog((s@lib/python2.7/site-packages/notebook/services/contents/fileio.pyt copy2_safe.s  cCs/tjj|ƒ\}}tjj|d|ƒS(stName of the intermediate file used in atomic writes. The .~ prefix will make Dropbox ignore the temporary file.s.~(RRtsplittjoin(Rtdirnametbasename((s@lib/python2.7/site-packages/notebook/services/contents/fileio.pytpath_to_intermediate:scCs/tjj|ƒ\}}tjj||dƒS(sEName of invalid file after a failed atomic write and subsequent read.s.invalid(RRR R!(RR"R#((s@lib/python2.7/site-packages/notebook/services/contents/fileio.pytpath_to_invalidAssutf-8cks6tjj|ƒr?tjjtjj|ƒtj|ƒƒ}nt|ƒ}tjj|ƒrst||d|ƒn|r§|j ddƒt j |dd||}nt j |d|}y |VWn!|j ƒt ||ƒ‚nX|jƒtj|jƒƒ|j ƒtjj|ƒr2tj|ƒndS(sÊContext manager to write to a file only if the entire write is successful. This works by copying the previous file contents to a temporary file in the same directory, and renaming that file back to the target if the context exits with an error. If the context is successful, the new data is synced to disk and the temporary file is removed. Parameters ---------- path : str The target file to write to. text : bool, optional Whether to open the file in text mode (i.e. to write unicode). Default is True. encoding : str, optional The encoding to use for files opened in text mode. Default is UTF-8. **kwargs Passed to :func:`io.open`. Rtnewlines twtencodingtwbN(RRtislinkR!R"treadlinkR$tisfileRt setdefaulttiotopentcloseRtflushtfsynctfilenoR(RttextR(Rtkwargsttmp_pathtfileobj((s@lib/python2.7/site-packages/notebook/services/contents/fileio.pytatomic_writingFs(-      cks¶tjj|ƒr?tjjtjj|ƒtj|ƒƒ}n|rs|jddƒtj|dd||}ntj|d|}y |VWn|j ƒ‚nX|j ƒdS(sÄContext manager to write file without doing atomic writing ( for weird filesystem eg: nfs). Parameters ---------- path : str The target file to write to. text : bool, optional Whether to open the file in text mode (i.e. to write unicode). Default is True. encoding : str, optional The encoding to use for files opened in text mode. Default is UTF-8. **kwargs Passed to :func:`io.open`. R&s R'R(R)N( RRR*R!R"R+R-R.R/R0(RR4R(RR5R7((s@lib/python2.7/site-packages/notebook/services/contents/fileio.pyt_simple_writingƒs-  tFileManagerMixincBseZdZeededdƒZed„ƒZed„ƒZedd„ƒZ d„Z d „Z d d „Z d „Z d „Zd„ZRS(sº Mixin for ContentsAPI classes that interact with the filesystem. Provides facilities for reading, writing, and copying both notebooks and generic files. Shared by FileContentsManager and FileCheckpoints. Note ---- Classes using this mixin must provide the following attributes: root_dir : unicode A directory against against which API-style paths are to be resolved. log : logging.Logger tconfigthelps}By default notebooks are saved on disk on a temporary file and then if succefully written, it replaces the old ones. This procedure, namely 'atomic_writing', causes some bugs on file system whitout operation order enforcement (like some networked fs). If set to False, the new notebook is written directly on the old one which could fail (eg: full filesystem or quota )c os=|j|ƒ(tj|||Ž }|VWdQXWdQXdS(s<wrapper around io.open that turns permission errors into 403N(t perm_to_403R.R/(tselftos_pathtargsR5tf((s@lib/python2.7/site-packages/notebook/services/contents/fileio.pyR/Çsc osx|j|ƒc|jrEt|d|j||Ž }|VWdQXn)t|d|j||Ž }|VWdQXWdQXdS(sáwrapper around atomic_writing that turns permission errors to 403. Depending on flag 'use_atomic_writing', the wrapper perform an actual atomic writing or simply writes the file (whatever an old exists or not)RN(R=tuse_atomic_writingR8RR9(R>R?R@R5RA((s@lib/python2.7/site-packages/notebook/services/contents/fileio.pyR8Îs  tccsy dVWn€ttfk r‹}|jtjtjhkr…|sZt|jpQdƒ}nt|d|jƒ}t dd|ƒ‚qŒ‚nXdS(s7context manager for turning permission errors into 403.Ns unknown filetrooti“uPermission denied: %s( RtIOErrorterrnotEPERMtEACCESRtfilenameRtroot_dirR(R>R?teR((s@lib/python2.7/site-packages/notebook/services/contents/fileio.pyR=Ûs cCst||d|jƒdS(sPcopy src to dest like shutil.copy2, but log errors in copystat RN(RR(R>Rtdest((s@lib/python2.7/site-packages/notebook/services/contents/fileio.pyt_copyìscCsctjj|jƒ}t||ƒ}tjj|ƒtjjj|ƒs_tdd|ƒ‚n|S(sYGiven an API path, return its file system path. Parameters ---------- path : string The relative API path to the named file. Returns ------- path : string Native, absolute OS path to for a file. Raises ------ 404: if path is outside root i”s%%s is outside root contents directory(RRtabspathRJRtsept startswithR(R>RRDR?((s@lib/python2.7/site-packages/notebook/services/contents/fileio.pyt _get_os_pathós %ic CsÓ|j|dddƒµ}ytj|d|ƒSWntk rM}|}nXt|ƒ}|j swtjj|ƒ r“t dd||fƒ‚nt |ƒ}t ||ƒt ||ƒ|j ||ƒSWdQXdS(s Read a notebook from an os path.trR(sutf-8t as_versioniuUnreadable Notebook: %s %rN( R/tnbformattreadt ExceptionR$RBRRRRR%Rt_read_notebook(R>R?RSRARKte_origR6t invalid_file((s@lib/python2.7/site-packages/notebook/services/contents/fileio.pyRW s     c Cs;|j|ddƒ }tj||dtjƒWdQXdS(sSave a notebook to an os_path.R(sutf-8tversionN(R8RTtwritet NO_CONVERT(R>R?tnbRA((s@lib/python2.7/site-packages/notebook/services/contents/fileio.pyt_save_notebook#scCsÖtjj|ƒs(tdd|ƒ‚n|j|dƒ}|jƒ}WdQX|dksg|dkr½y|jdƒdfSWq½tk r¹|dkrºtdd|dd ƒ‚qºq½Xnt |ƒjd ƒd fS( s*Read a non-notebook file. os_path: The path to be read. format: If 'text', the contents will be decoded as UTF-8. If 'base64', the raw bytes contents will be encoded as base64. If not specified, try to decode as UTF-8, and fall back to base64 isCannot read non-file %strbNR4tutf8s%s is not UTF-8 encodedtreasons bad formattasciitbase64( RRR,RR/RUtNonetdecodet UnicodeErrorR(R>R?tformatRAtbcontent((s@lib/python2.7/site-packages/notebook/services/contents/fileio.pyt _read_file(s    cCs¿|ddhkr$tddƒ‚ny=|dkrE|jdƒ}n|jdƒ}t|ƒ}Wn,tk r}tdd||fƒ‚nX|j|dtƒ}|j|ƒWdQXdS( sSave content of a generic file.R4Rcis:Must specify format of file contents as 'text' or 'base64'R`RbuEncoding error saving %s: %sN(RtencodeRRVR8tFalseR[(R>R?tcontentRgRht b64_bytesRKRA((s@lib/python2.7/site-packages/notebook/services/contents/fileio.pyt _save_fileEs  (t__name__t __module__t__doc__RRRBRR/R8R=RMRQRWR^RiRn(((s@lib/python2.7/site-packages/notebook/services/contents/fileio.pyR:¯s       ("Rqt contextlibRRFR.RRt tornado.webRtnotebook.utilsRRRTtipython_genutils.py3compatRttraitlets.configRt traitletsRRcRRt ImportErrorR R RRdRR$R%RR8R9R:(((s@lib/python2.7/site-packages/notebook/services/contents/fileio.pyts0        <+