Vi_SrSSKJr SSKrSSKrSSKrSSKrSSKrSSKrSSK J r J r J r /SQr SrSrSr\ S r"S S \5r\R2\R4-\R6-r\"\S 5(a\\R<-r\"\S 5(a\\R>-r\r \"\S5(a\ \RB-r SSK"r"Sr#Sr%Sr&\RNS:XaHSSK(r(SSK(J)r) SSK*J+r+J,r, \(RZR\R^r0\)\)\)\+\,\,/\0l1Sr2S%Sjr3OSr2S%Sjr3\3r4S\2l"SS\5r5S&Sjr6S'Sjr7\7r8\9 "SS \95r:\;S!:Xa4\%"S"5r<\>> FilePerms(user='rwx', group='xrw', other='wxr') # note character order FilePerms(user='rwx', group='rwx', other='rwx') >>> int(FilePerms('r', 'r', '')) 288 >>> oct(288)[-3:] # XXX Py3k '440' See also the :meth:`FilePerms.from_int` and :meth:`FilePerms.from_path` classmethods for useful alternative ways to construct :class:`FilePerms` objects. cP\rSrSrSr\"S5rSSSS.rSrS S jr S r S r S r g)FilePerms._FilePermPropertyyrwx)rwxcXlX lgN attributeoffset)selfr'r(s r__init__$FilePerms._FilePermProperty.__init__~s &N KNc6UcU$[XR5$r%)getattrr')r)fp_objtype_s r__get__#FilePerms._FilePermProperty.__get__s~ 6>>2 2r,c^[UTR5nX2:Xag[[U55TR- nU(a![ SU<SU<STR<35eU4SjnSR[[U5USS95n[UTRU5 TRX5 g![ a [ SU-5ef=f) Nzexpected string, not %rzgot invalid chars z in permission specification z*, expected empty string or one or more of c">TRU$r%) _perm_val)cr)s r5FilePerms._FilePermProperty.__set__..s!2r,T)keyreverse) r.r'setstr _perm_set TypeError ValueError _perm_charsjoinsortedsetattr_update_integer)r)r/valuecur invalid_charssort_key new_values` r__set__#FilePerms._FilePermProperty.__set__s&$..1C| C #CJ$.. @  %25$:J:J"LMM 3Hs5z+3T!CDI FDNNI 6   3 C 9E ABB Cs !B::CcSnSnUH+nSURU5-nX6URS---nM- U=RU-slg)Nrxwrr)indexr(_integer)r)r/rFmoder:symbolbits rrE+FilePerms._FilePermProperty._update_integersNDC399V,,q12  OOt #Or,r&r%) __name__ __module__ __qualname____firstlineno__rA frozensetr>r5r*r1rKrE__static_attributes__r,r_FilePermPropertyrys1 e$ !!,  ! 3  4( $r,r]c`SuUlUlUlSUlXlX lX0lg)Nr9r9r9r)_user_group_otherrQusergroupother)r)rcrdres rr*FilePerms.__init__s*/9, DK    r,cU[-nSn/nU(a(URX![-5 US-nU(aM(UR5 U"U6$)zCreate a :class:`FilePerms` object from an integer. >>> FilePerms.from_int(0o644) # note the leading zero-oh for octal FilePerms(user='rw', group='r', other='r') )r9r#r"xwr!rxrwrrO) FULL_PERMSappend_SINGLE_FULL_PERMr;)clsir:partss rfrom_intFilePerms.from_intsT Z: LL!223 4 !GAa  E{r,c[R"U5nUR[R"UR55$)a/Make a new :class:`FilePerms` object based on the permissions assigned to the file or directory at *path*. Args: path (str): Filesystem path of the target file. Here's an example that holds true on most systems: >>> import tempfile >>> 'r' in FilePerms.from_path(tempfile.gettempdir()).user True )rstatrqS_IMODEst_mode)rnrstat_ress r from_pathFilePerms.from_paths/774=||DLL)9)9:;;r,cUR$r%)rQr)s r__int__FilePerms.__int__s }}r,r`rrar rbrcURRnU<SUR<SUR<SUR<S3$)Nz(user=z, group=z, other=)) __class__rVrcrdre)r)cns r__repr__FilePerms.__repr__s0 ^^ $ $tyy$**djj: ;r,)rarQrbr`rdrercNr_)rVrWrXrY__doc__objectr]r* classmethodrqrxr|rcrdrerr[r\r,rr r Os{'R($F($T  <<  Wa (D5 h *E6 h *E6;r,r O_NOINHERIT O_NOFOLLOWO_BINARYc[R"U[RS5nU[R-n[R"U[RU5 g![a gf=f)zDoes a best-effort :func:`fcntl.fcntl` call to set a fd to be automatically closed by any future child processes. Implementation from the :mod:`tempfile` module. rN)fcntlF_GETFD FD_CLOEXECF_SETFDIOError)fdflagss r set_cloexecrs_  2KKEMM15E U%% %E KKEMM5 1      s&A"" A/.A/cg)z5Dummy set_cloexec for platforms without fcntl supportNr\)rs rrrs r,c [U40UD6$)avA convenient interface to the :class:`AtomicSaver` type. Example: >>> try: ... with atomic_save("file.txt", text_mode=True) as fo: ... _ = fo.write('bye') ... 1/0 # will error ... fo.write('bye') ... except ZeroDivisionError: ... pass # at least our file.txt didn't get overwritten See the :class:`AtomicSaver` documentation for details. )r ) dest_pathkwargss rrrs y +F ++r,c[U[5(aU$[R"5=(d [R"5nUR U5$r%) isinstanceunicodesysgetfilesystemencodinggetdefaultencodingdecode)rencodings rpath_to_unicoders?$   ((*Fc.D.D.FH ;;x  r,nt) c_wchar_p)DWORDLPVOIDcD[R"X5 g![a)nUR[R:XaSnAO eSnAff=f[ U5n[ U5n[ [U5[U5SSSS5nU(d[SU<SU<35eg)Nrzfailed to replace z with ) rrename WindowsErrorrrr _ReplaceFilerr)srcdstweress rreplacer s  IIc   xx5<<'   c"c"9S>9S>D$0CEF Fs A AAA cVU(a [X5 g[R"X5 gzsyy""r,cU(a[R"X5 g[R"X5 [R"U5 gr)rrlinkunlinkrs rrrBs2  IIc   GGC  IIcNr,aSimilar to :func:`os.replace` in Python 3.3+, this function will atomically create or replace the file at path *dst* with the file at path *src*. On Windows, this function uses the ReplaceFile API for maximum possible atomicity on a range of filesystems. c:\rSrSrSr\rSrSrSr Sr Sr Sr g ) r iWa| ``AtomicSaver`` is a configurable `context manager`_ that provides a writable :class:`file` which will be moved into place as long as no exceptions are raised within the context manager's block. These "part files" are created in the same directory as the destination path to ensure atomic move operations (i.e., no cross-filesystem moves occur). Args: dest_path (str): The path where the completed file will be written. overwrite (bool): Whether to overwrite the destination file if it exists at completion time. Defaults to ``True``. file_perms (int): Integer representation of file permissions for the newly-created file. Defaults are, when the destination path already exists, to copy the permissions from the previous file, or if the file did not exist, to respect the user's configured `umask`_, usually resulting in octal 0644 or 0664. text_mode (bool): Whether to open the destination file in text mode (i.e., ``'w'`` not ``'wb'``). Defaults to ``False`` (``wb``). part_file (str): Name of the temporary *part_file*. Defaults to *dest_path* + ``.part``. Note that this argument is just the filename, and not the full path of the part file. To guarantee atomic saves, part files are always created in the same directory as the destination path. overwrite_part (bool): Whether to overwrite the *part_file*, should it exist at setup time. Defaults to ``False``, which results in an :exc:`OSError` being raised on pre-existing part files. Be careful of setting this to ``True`` in situations when multiple threads or processes could be writing to the same part file. rm_part_on_exc (bool): Remove *part_file* on exception cases. Defaults to ``True``, but ``False`` can be useful for recovery in some cases. Note that resumption is not automatic and by default an :exc:`OSError` is raised if the *part_file* exists. Practically, the AtomicSaver serves a few purposes: * Avoiding overwriting an existing, valid file with a partially written one. * Providing a reasonable guarantee that a part file only has one writer at a time. * Optional recovery of partial data in failure cases. .. _context manager: https://docs.python.org/2/reference/compound_stmts.html#with .. _umask: https://en.wikipedia.org/wiki/Umask c XlURSS5UlURSS5UlURSS5UlURSS5UlURSS5UlURSS5UlURS S 5UlU(a[S UR5<35e[RRUR5Ul[RRUR5UlUR (d US -UlO9[RR#URUR 5UlUR(aS OSUlUR(a[&O[(UlSUlg)NrT file_permsoverwrite_partF part_filerm_part_on_exc text_mode bufferingzunexpected kwargs: z.partzw+zw+b)rpoprrr part_filenamerrrr?keysrrabspathdirnamedest_dir part_pathrBrR_TEXT_OPENFLAGS_BIN_OPENFLAGS open_flagsr)r)rrs rr*AtomicSaver.__init__s+"K6 **\48$jj)95A#ZZ T:$jj)94@K7K4 v{{}FG G87 !!&0DNWW\\$--9K9KLDN NND -1^^/r,cpSnURnUcA[R"UR5n[R"UR 5n[R"URURU5n[U5 [R"X@RUR5UlU(a#[R""URU5 gg![ [4a URnSnNf=f![ [4a UR R%5 ef=f)NTF)rrrtrrurvrr_default_file_permsopenrrrfdopenrRrrchmodclose)r)do_chmodrrwrs r_open_part_fileAtomicSaver._open_part_files__   !774>>2!\\(*:*:; WWT^^T__j AB2yy$..A  4 #W% !!55   !W% $$& sAC%!D %DD ,D5c[RRUR5(a6UR(d%[ [ RSUR5eUR(aN[RRUR5(a [R"UR5 UR5 g)aCalled on context manager entry (the :keyword:`with` statement), the ``setup()`` method creates the temporary file in the same directory as the destination file. ``setup()`` tests for a writable directory with rename permissions early, as the part file may not be written to immediately (not using :func:`os.access` because of the potential issues of effective vs. real privileges). If the caller is not using the :class:`AtomicSaver` as a context manager, this method should be called explicitly before writing. z*Overwrite disabled and file already existsN) rrlexistsrrrrrrrrrr{s rsetupAtomicSaver.setups 77??4>> * *>>ellJ"nn..   277??4>>#B#B IIdnn % r,c:UR5 UR$r%)rrr{s r __enter__AtomicSaver.__enter__s ~~r,cURR5 U(a4UR(a"[R"UR 5 gg[UR URURS9 g![ a gf=f![aE UR(a2[R"UR 5 e![ a ef=fef=f)N)r) rrrrrr Exceptionrrrrr)exc_typeexc_valexc_tbs r__exit__AtomicSaver.__exit__s  ""IIdnn-   $..$..$(NN 4 !   ""IIdnn- !    sA B)B B BC - C C  CC CC ) rrrrrRrrrrrrrrN) rVrWrXrYrRW_PERMSrr*rrrrr[r\r,rr r Ws)0b#.60r,r c ## [U[5(aU/n[R"SR UVs/sHn[ R "U5PM sn55nU(d/nO[U[5(aU/n[R"SR UVs/sHn[ R "U5PM sn55n[R"U5Hupxn U(acUH]n URU 5(dMU(aURU 5(aM:[RR Xz5n U v M_ U H]n URU 5(dMU(aURU 5(aM:[RR Xz5n U v M_ M gs snfs snf7f)aReturns a generator that yields file paths under a *directory*, matching *patterns* using `glob`_ syntax (e.g., ``*.txt``). Also supports *ignored* patterns. Args: directory (str): Path that serves as the root of the search. Yielded paths will include this as a prefix. patterns (str or list): A single pattern or list of glob-formatted patterns to find under *directory*. ignored (str or list): A single pattern or list of glob-formatted patterns to ignore. include_dirs (bool): Whether to include directories that match patterns, as well. Defaults to ``False``. For example, finding Python files in the current directory: >>> _CUR_DIR = os.path.dirname(os.path.abspath(__file__)) >>> filenames = sorted(iter_find_files(_CUR_DIR, '*.py')) >>> os.path.basename(filenames[-1]) 'urlutils.py' Or, Python files while ignoring emacs lockfiles: >>> filenames = iter_find_files(_CUR_DIR, '*.py', ignored='.#*') .. _glob: https://en.wikipedia.org/wiki/Glob_%28programming%29 |N) r basestringrecompilerBfnmatch translaterwalkmatchr) directorypatternsignored include_dirsppats_reign_rerootdirsfilesbasenamefilenames rr r sO:(J'':jj"JA7#4#4Q#7"JKLG  GZ ( () ZZ!H1'"3"3A"6!HI JFWWY/E  ==**6<<#9#9 !ww||D;H"N !H}}X&&v||H5577<<7 0 -#K "Is,8G  F? A G & G AG AG 4AG c [R"U5nUb U"X5nO [5n[U5 /nUHnXu;aM [RR X5n[RR X5n U(aR[RR U5(a.[R"U5n [R"X5 M[RRU5(a[XX#5 M[X5 M [%X5 U(a [U5eg![a*n URU RS5 Sn A GM1Sn A f[a(n UR!X[#U 545 Sn A GMaSn A ff=f![&aGn [(b[+U [(5(aSn A NUR!X[#U 545 Sn A NSn A ff=f)aThe ``copy_tree`` function is an exact copy of the built-in :func:`shutil.copytree`, with one key difference: it will not raise an exception if part of the tree already exists. It achieves this by using :func:`mkdir_p`. As of Python 3.8, you may pass :func:`shutil.copytree` the `dirs_exist_ok=True` flag to achieve the same effect. Args: src (str): Path of the source directory to copy. dst (str): Destination path. Existing directories accepted. symlinks (bool): If ``True``, copy symlinks rather than their contents. ignore (callable): A callable that takes a path and directory listing, returning the files within the listing to be ignored. For more details, check out :func:`shutil.copytree` and :func:`shutil.copy2`. Nr)rlistdirr<rrrBislinkreadlinksymlinkrr rrextendargsEnvironmentErrorrlr=rrrr) rrsymlinksignorenames ignored_nameserrorsnamesrcnamedstnamelinktoewhys r copy_treer (so* JJsOE s*   CL F  '',,s)'',,s) 8BGGNN733W- 6+w''8<g'(0Fm % MM!&&) $ $ 8 MM7SX6 7 7 8 0  # 3 (E(E  MM3SX. / / 0sOAD>0D> D> F%> F"E-- F":FF"% G6/G1G11G6c\rSrSrSSjrSrSrSrSrSSjr SS jr SS jr S r S r S rSrSrSrSrSrSrg) DummyFileioNcpXlX lSUlSUlSUlSUlSUlSUlg)NFr)rrRclosedrisattyrnewlines softspace)r)rrRrs rr*DummyFile.__init__rs6       r,cSUlg)NT)rr{s rrDummyFile.close|s  r,cg)Nrr\r{s rfilenoDummyFile.filenosr,c<UR(a [S5egNI/O operation on a closed filerr@r{s rflushDummyFile.flush ;;=> >r,c[5er% StopIterationr{s rnextDummyFile.next or,c<UR(a [S5egNrr9rr)sizes rreadDummyFile.read ;;=> >r,c<UR(a [S5egr'rr(s rreadlineDummyFile.readliner,r,c>UR(a [S5e/$rrr(s r readlinesDummyFile.readliness ;;=> > r,c<UR(a [S5egrrr{s rseekDummyFile.seekrr,c<UR(a [S5eg)Nrrrr{s rtellDummyFile.tells ;;=> >r,c<UR(a [S5egrrr{s rtruncateDummyFile.truncaterr,c<UR(a [S5egrr)r)strings rwriteDummyFile.writerr,c<UR(a [S5egrr)r)list_of_stringss r writelinesDummyFile.writelinesrr,c[5er%r!r{s r__next__DummyFile.__next__r%r,c<UR(a [S5egrrr{s rrDummyFile.__enter__rr,cgr%r\rs rrDummyFile.__exit__sr,)rrrrrRrrr)r!N)r)rVrWrXrYr*rrrr#r*r.r1r4r7r:r>rBrErrr[r\r,rr r osR          r,r __main__z/tmp/final.txtrofl )F)NF)FN)>r __future__rrrrrtrrshutilrrr__all__rkrrmr NameErrorr=rbytesrrr O_RDWRO_CREATO_EXCLrhasattrrrrrrr ImportErrorrrrctypesrctypes.wintypesrrwindllkernel32 ReplaceFilerargtypesrr_atomic_renamer r r r filer rVfr>r\r,rrasB & )) *   J;J;^))bjj(2994 2}r~~%O 2|r}}$O  2zbkk!N " , !77d? -==))55L& 9"FF4L*#V&Vr5 p:z  LL^ z % &!    ' &IGuJ`   @  Dj ' &sAFF/F>/#G  F,+F,/ F;:F;>G G  G