FSrSrSSKrSSKrSSKrSSKrSSKrSSKr"SS\5r Sr Sr S Sjr SS jr SS jrS rSS jrg)zSimple file system utilities.)z"elaforge@google.com (Evan LaForge)z%matthewb@google.com (Matthew Blecker)Nc\rSrSrSrSrg) PasswdErrorz:Exception class for errors loading a password from a file.N)__name__ __module__ __qualname____firstlineno____doc____static_attributes__r4platform/bq/third_party/google/apputils/file_util.pyrrsBr rc[R"U5Vs/sH"n[RRX5PM$ sn$s snf)zHLike os.listdir with prepended dir_name, which is often more convenient.)oslistdirpathjoin)dir_namefns r ListDirPathr!s2/1zz(/C D/C"'',,x $/C DD Ds)Ac[U5nUR5UR5 $!UR5 f=f)z2Read entire contents of file with name 'filename'.)openreadclose)filenamefps rReadr&s, H~" 779HHJBHHJs-?cZ[R[R-[R-nU(dU[R-n[R "XU5n[R "XQ5 [R"U5 g![R"U5 f=f)aCreate a file 'filename' with 'contents', with the mode given in 'mode'. The 'mode' is modified by the umask, as in open(2). If 'overwrite_existing' is False, the file will be opened in O_EXCL mode. Args: filename: str; the name of the file contents: str; the data to write to the file overwrite_existing: bool; whether or not to allow the write if the file already exists mode: int; permissions with which to create the file (default is 0666 octal) N)rO_WRONLYO_TRUNCO_CREATO_EXCLrwriter)rcontentsoverwrite_existingmodeflagsfds rWriter)/sh ++ "RZZ /%  RYYE wwx%"HHRHHRLBHHRLs %BB*c[R"[RR U5S9up4[R "X15 [R "U5 [R"XB5 [R"X@5 g![R "U5 f=f![aHn[R"U5 Ue![an[U<SU<35nSnAUeSnAff=fSnAff=f)aCreate a file 'filename' with 'contents' atomically. As in Write, 'mode' is modified by the umask. This creates and moves a temporary file, and errors doing the above will be propagated normally, though it will try to clean up the temporary file in that case. This is very similar to the prodlib function with the same name. Args: filename: str; the name of the file contents: str; the data to write to the file mode: int; permissions with which to create the file (default is 0666 octal) )dirz!. Additional errors cleaning up: N) tempfilemkstemprrdirnamer#rchmodrenameOSErrorremove)rr$r&r( tmp_filenameexces r AtomicWriter6Fs ''BGGOOH,EF2HHRHHRLHH\ IIl%HHRL Hii  I H sAF Gc IHsGB",B*B'* C<5C  C7 C4C/)C7/C44C77C<cV[RRU5nUR[RR5n[ S[ U55Hmn[RRRUSUS-5nU(a3[R"U5 Ub[R"XQ5 MkMmMo g![aNnUR[R:Xa$[RRU5(deSnAMSnAff=f)aDMakes a directory including its parent directories. This function is equivalent to os.makedirs() but it avoids a race condition that os.makedirs() has. The race is between os.mkdir() and os.path.exists() which fail with errors when run in parallel. Args: directory: str; the directory to make force_mode: optional octal, chmod dir to get rid of umask interaction Raises: Whatever os.mkdir() raises when it fails for any reason EXCLUDING "dir already exists". If a directory already exists, it does not raise anything. This behaviour is different than os.makedirs() rN)rrnormpathsplitseprangelenrmkdirr/r1errnoEEXISTisdir) directory force_modenamedirsirr4s rMkDirsrGds   ) $$ BGGKK $ CI a 77;;  D!A#J 'D    ! ((4 $ "   ii5<<'BGGMM$,?,? -@s6C D(AD##D(cd[R"U5 [ R RU5nU(a@[ R"U5 [ R RU5nU(aM?gg![a)nUR[R:waeSnANSnAff=f![a)nUR[R:waeSnANSnAff=f![a9nUR[R[R4;aeSnAgSnAff=f)zRemoves dir_name and every non-empty directory in dir_name. Unlike os.removedirs and shutil.rmtree, this function doesn't raise an error if the directory does not exist. Args: dir_name: Directory to be removed. N) shutilrmtreer1r?ENOENTrrr.rmdirEACCES ENOTEMPTY)rerrparent_directorys rRmDirsrQs  MM(  wwx0  !" )9:     yyELL  !  99 $  %   yyu77 8 sXB&C,B6&C, B3 B..B36 C)C$C,$C))C,, D/6/D**D/cdUc5[R"[R"55nUR$[ U[ 5(a"[R"U5nUR$[ U[ 5(a"[R"U5nUR$[S5e)a$Find the home directory of a user. Args: user: int, str, or None - the uid or login of the user to query for, or None (the default) to query for the current process' effective user Returns: str - the user's home directory Raises: TypeError: if user is not int, str, or None. z.user must be None or an instance of int or str) pwdgetpwuidrgeteuid isinstanceintstrgetpwnam TypeErrorpw_dir)user pw_structs rHomeDirr^s \ RZZ\*I    $ T"I    $ T"I    D EEr )T)r_)N)r __author__r?rrSrIstatr, Exceptionrrrr)r6rGrQr^rr rrcsW $7  C)CE .<< <r