U \Sh@sddlmZddlZddlZddlZddlmZmZmZm Z erHddl Z e pVe Z ddddZeZGdd d eZdS) ) annotationsN)IO TYPE_CHECKINGAnyCallableintreturncCstd}t||S)zGet current umask valuer)osumask)r r F/root/rtd-docs/venv/lib/python3.8/site-packages/sphinx/testing/path.pygetumasks  rcseZdZdZeddddZddddZdddd Zd dd d Zd dd dZ d dddZ d dddZ d dddZ dMd dddddZ dNdd ddddZdddd d!ZeZddd"d#Zd$dd%d&Zd$dd'd(d)ZdOdd$d+d,d-d.ZdPddd$dd0d1d2ZdQdd$dd3d4d5Zd6dd7d8ZdRdd dd9d:d;Zd ddd?ZdSdAd ddBdCdDZd$ddEdFdGZdHddIdJZeZZddfdKdL Z Z!S)Tpathz8 Represents a path which behaves like a string. rcCs|tj|S)zH The name of the directory the file or directory is in. ) __class__r rdirnameselfr r r parentsz path.parentstrcCs tj|SN)r rbasenamerr r r r%sz path.basenamecCs|tj|S)z, Returns the absolute path. )rr rabspathrr r r r(sz path.abspathboolcCs tj|S)z; Returns ``True`` if the path is absolute. )r risabsrr r r r.sz path.isabscCs tj|S)z> Returns ``True`` if the path is a directory. )r risdirrr r r r4sz path.isdircCs tj|S)z9 Returns ``True`` if the path is a file. )r risfilerr r r r:sz path.isfilecCs tj|S)zB Returns ``True`` if the path is a symbolic link. )r rislinkrr r r r@sz path.islinkcCs tj|S)z@ Returns ``True`` if the path is a mount point. )r rismountrr r r rFsz path.ismountFNzCallable | NoneNone) ignore_errorsonerrorr cCstj|||ddS)al Removes the file or directory and any files or directories it may contain. :param ignore_errors: If ``True`` errors are silently ignored, otherwise an exception is raised in case an error occurs. :param onerror: A callback which gets called with the arguments `func`, `path` and `exc_info`. `func` is one of :func:`os.listdir`, :func:`os.remove` or :func:`os.rmdir`. `path` is the argument to the function which caused it to fail and `exc_info` is a tuple as returned by :func:`sys.exc_info`. )r r!N)shutilrmtree)rr r!r r r r#Lsz path.rmtree) destinationsymlinksr cCsntj|||dtjdrjt|D]B\}}}t|dt@|D] }ttj ||dt@qFq&dS)a~ Recursively copy a directory to the given `destination`. If the given `destination` does not exist it will be created. :param symlinks: If ``True`` symbolic links in the source tree result in symbolic links in the destination tree otherwise the contents of the files pointed to by the symbolic links are copied. )r%ZSPHINX_READONLY_TESTDIRiiN) r"copytreer environgetwalkchmodUMASKrjoin)rr$r%root_dirsfilesnamer r r r&^s  z path.copytree)r$r cCst||dS)z Recursively move the file or directory to the given `destination` similar to the Unix "mv" command. If the `destination` is a file it may be overwritten depending on the :func:`os.rename` semantics. N)r"move)rr$r r r movetreetsz path.movetreecCst|dS)z! Removes a file. N)r unlinkrr r r r3sz path.unlinkrcCs t|S)z- Returns a stat of the file. )r statrr r r r4sz path.stat)argr cCst||dSr)r utime)rr5r r r r6sz path.utimerr)modekwargsr cKst||f|Sr)open)rr8r9r r r r:sz path.openutf-8)textencodingr9r c Ks0t|dfd|i|}||W5QRXdS)z6 Writes the given `text` to the file. wr=Nr:write)rr<r=r9fr r r write_textszpath.write_text)r=r9r c Ks4t|fd|i|}|W5QRSQRXdS)z/ Returns the text in the file. r=Nr:read)rr=r9rAr r r read_textszpath.read_textzbuiltins.bytesc Cs,t|dd}|W5QRSQRXdS)z0 Returns the bytes in the file. rbr8NrC)rrAr r r read_bytesszpath.read_bytes)bytesappendr c Cs4|r d}nd}t||d}||W5QRXdS)z Writes the given `bytes` to the file. :param append: If ``True`` given `bytes` are added at the end of the file. abwbrGNr?)rrIrJr8rAr r r write_bytess zpath.write_bytescCs tj|S)z5 Returns ``True`` if the path exist. )r rexistsrr r r rNsz path.existscCs tj|S)zb Returns ``True`` if the path exists unless it is a broken symbolic link. )r rlexistsrr r r rOsz path.lexistsr)r8exist_okr cCstj|||ddS)z1 Recursively create directories. )rQN)r makedirs)rr8rQr r r rRsz path.makedirs)argsr cGs |tjj|ft|j|S)zP Joins the path with the argument given and returns the result. )rr rr,map)rrSr r r joinpathsz path.joinpathz list[str]cCs t|Sr)r listdirrr r r rVsz path.listdircs|jjdtdS)N())r__name__super__repr__rrr r r[sz path.__repr__)FN)F)r7)r;)r;)F)rPF)"rY __module__ __qualname____doc__propertyrrrrrrrrr#r&r2r1r3r4r6r:rBrErHrMrNrOrRrUrVZ__div__ __truediv__r[ __classcell__r r r\r rs: r) __future__rr r"systypingrrrrbuiltinsgetfilesystemencodinggetdefaultencodingZFILESYSTEMENCODINGrr+rrr r r r s