o Ni@sddlmZddlZddlZddlZddlZddlmZmZm Z ddl m Z er2ddl Z ddl mZejde ddepAeZdd d ZeZGd ddeZdS)) annotationsN)IO TYPE_CHECKINGAny)RemovedInSphinx90Warning)CallablezH'sphinx.testing.path' is deprecated. Use 'os.path' or 'pathlib' instead.) stacklevelreturnintcCstd}t||S)zGet current umask valuer)osumask)r rG/home/ubuntu/.local/lib/python3.10/site-packages/sphinx/testing/path.pygetumasks  rcs8eZdZdZdZedQddZdRddZdQd d ZdSd d Z dSddZ dSddZ dSddZ dSddZ  dTdUddZdVdWd d!ZdXd"d#ZeZdYd$d%ZdZd'd(Zd[d*d+Zd\d]d0d1Zd^d_d5d6Zd^d`d7d8Zdad:d;ZdVdbd>d?ZdSd@dAZdSdBdCZdcdddGdHZdedJdKZdfdMdNZeZZ dRfdOdP Z!Z"S)gpathz8 Represents a path which behaves like a string. rr cC|tj|S)zH The name of the directory the file or directory is in. ) __class__r rdirnameselfrrrparent*sz path.parentstrcC tj|SN)r rbasenamerrrrr1s z path.basenamecCr)z, Returns the absolute path. )rr rabspathrrrrr4sz path.abspathboolcCr)z; Returns ``True`` if the path is absolute. )r risabsrrrrr: z path.isabscCr)z> Returns ``True`` if the path is a directory. )r risdirrrrrr @rz path.isdircCr)z9 Returns ``True`` if the path is a file. )r risfilerrrrr!Frz path.isfilecCr)zB Returns ``True`` if the path is a symbolic link. )r rislinkrrrrr"Lrz path.islinkcCr)z@ Returns ``True`` if the path is a mount point. )r rismountrrrrr#Rrz path.ismountFN ignore_errorsonerror7Callable[[Callable[..., Any], str, Any], object] | NoneNonecCtj|||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%rrrr*Xsz path.rmtree destinationsymlinkscCsrtj|||dtjdr5t|D]#\}}}t|dt@|D]}ttj ||dt@q#qdSdS)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,SPHINX_READONLY_TESTDIRiiN) r)copytreer environgetwalkchmodUMASKrjoin)rr+r,root_dirsfilesnamerrrr.ns z path.copytreecCst||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+rrrmovetreesz path.movetreecCst|dS)z! Removes a file. N)r unlinkrrrrr;sz path.unlinkrcC t|S)z- Returns a stat of the file. )r statrrrrr=s z path.statargcCst||dSr)r utime)rr>rrrr?sz path.utimermodekwargsIO[str]cKst||fi|Sr)open)rrArBrrrrDsz path.openutf-8textencodingcKsFt|dfd|i|}||WddS1swYdS)z6 Writes the given `text` to the file. wrGNrDwrite)rrFrGrBfrrr write_texts "zpath.write_textcKs@t|fd|i| }|WdS1swYdS)z/ Returns the text in the file. rGNrDread)rrGrBrKrrr read_texts$zpath.read_textbuiltins.bytescCs8t|dd }|WdS1swYdS)z0 Returns the bytes in the file. rbrANrM)rrKrrr read_bytess$zpath.read_bytesbytesappendcCsJ|rd}nd}t||d}||WddS1swYdS)z Writes the given `bytes` to the file. :param append: If ``True`` given `bytes` are added at the end of the file. abwbrRNrI)rrTrUrArKrrr write_bytess  "zpath.write_bytescCr)z5 Returns ``True`` if the path exist. )r rexistsrrrrrYrz path.existscCr)zb Returns ``True`` if the path exists unless it is a broken symbolic link. )r rlexistsrrrrrZs z path.lexistsr exist_okcCr()z1 Recursively create directories. )r\N)r makedirs)rrAr\rrrr]sz path.makedirsargscGs"|tjj|gt|j|RS)zP Joins the path with the argument given and returns the result. )rr rr4map)rr^rrrjoinpaths"z path.joinpath list[str]cCr<r)r listdirrrrrrbs z path.listdircs|jjdtdS)N())r__name__super__repr__rrrrrgsz path.__repr__)r r)r r)r r)FN)r$rr%r&r r')F)r+rr,rr r')r+rr r')r r')r r)r>rr r')r@)rArrBrr rC)rE)rFrrGrrBrr r')rGrrBrr r)r rP)rTrTrUrr r')r[F)rAr r\rr r')r^rr r)r ra)#re __module__ __qualname____doc__ __slots__propertyrrrrr r!r"r#r*r.r:r9r;r=r?rDrLrOrSrXrYrZr]r`rb__div__ __truediv__rg __classcell__rrrhrr#sB                       r)r r ) __future__rr r)syswarningstypingrrrsphinx.deprecationrbuiltinscollections.abcrwarngetfilesystemencodinggetdefaultencodingFILESYSTEMENCODINGrr3rrrrrrs&