obdZddlmZmZddlZddlZddlZddlZddlm Z ddl m Z ejrddlm Z mZejGdd e Zy) aLManage filesystems in temporary locations. A temporary filesytem is stored in a location defined by your OS (``/tmp`` on linux). The contents are deleted when the filesystem is closed. A `TempFS` is a good way of preparing a directory structure in advance, that you can later copy. It can also be used as a temporary data store. )print_functionunicode_literalsN)errors)OSFS)OptionalTextcHeZdZdZ dfd ZdZdZfdZdZxZ S)TempFSaA temporary filesystem on the OS. Temporary filesystems are created using the `tempfile.mkdtemp` function to obtain a temporary folder in an OS-specific location. You can provide an alternative location with the ``temp_dir`` argument of the constructor. Examples: Create with the constructor:: >>> from fs.tempfs import TempFS >>> tmp_fs = TempFS() Or via an FS URL:: >>> import fs >>> tmp_fs = fs.open_fs("temp://") Use a specific identifier for the temporary folder to better illustrate its purpose:: >>> named_tmp_fs = fs.open_fs("temp://local_copy") >>> named_tmp_fs = TempFS(identifier="local_copy") c||_||_||_d|_|j dd|_t j |xsd||_tt|+|jy)ayCreate a new `TempFS` instance. Arguments: identifier (str): A string to distinguish the directory within the OS temp location, used as part of the directory name. temp_dir (str, optional): An OS path to your temp directory (leave as `None` to auto-detect). auto_clean (bool): If `True` (the default), the directory contents will be wiped on close. ignore_clean_errors (bool): If `True` (the default), any errors in the clean process will be suppressed. If `False`, they will be raised. F/-fsTempFS)dirN) identifier _auto_clean_ignore_clean_errors_cleanedreplacetempfilemkdtemp _temp_dirsuperr __init__)selfrtemp_dir auto_cleanignore_clean_errors __class__s +/usr/lib/python3/dist-packages/fs/tempfs.pyrzTempFS.__init__7sc,%%$7! $,,S#6!))**B Q fd$T^^4cy)NzTempFS()rs r __repr__zTempFS.__repr__Wsr!c8dj|jS)Nz )formatrr$s r __str__zTempFS.__str__[s%%dnn55r!cb|jr|jtt|y)a7Close the filesystem and release any resources. It is important to call this method when you have finished working with the filesystem. Some filesystems may not finalize changes until they are closed (archives for example). You may call this method explicitly (it is safe to call close multiple times), or you can use the filesystem as a context manager to automatically close. Hint: Depending on the value of ``auto_clean`` passed when creating the `TempFS`, the underlying temporary folder may be removed or not. Example: >>> tmp_fs = TempFS(auto_clean=False) >>> syspath = tmp_fs.getsyspath("/") >>> tmp_fs.close() >>> os.path.exists(syspath) True N)rcleanrr close)rrs r r+z TempFS.close_s$0    JJL fd!#r!c |jry tj|jd|_y#t$rC}|j s&t jdj||Yd}~d|_yd}~wwxYw)z:Clean (delete) temporary files created by this filesystem.Nz(failed to remove temporary directory; {})msgexcT) rshutilrmtreer ExceptionrrOperationFailedr')rerrors r r*z TempFS.clean{sy ==   MM$.. )  ,,,,BII%P-   s6 B2A==B) __tempfs__NTT) __name__ __module__ __qualname____doc__rr%r(r+r* __classcell__)rs@r r r s08  5@6$8r!r )r8 __future__rrtypingr/sixrrosfsr TYPE_CHECKINGrr python_2_unicode_compatibler r#r!r rAsQ 8  %  mTm!mr!