FeddlmZddlZddlZddlZddlZddlmZmZm Z m Z ddl m Z erddl Z ejde dejxsej Zd dZeZGd d eZy) ) annotationsN)IO TYPE_CHECKINGAnyCallable)RemovedInSphinx90WarningzH'sphinx.testing.path' is deprecated. Use 'os.path' or 'pathlib' instead.) stacklevelcZtjd}tj||S)zGet current umask valuer)osumask)r s 5/usr/lib/python3/dist-packages/sphinx/testing/path.pygetumaskrs HHQKEHHUO Lc eZdZdZdZeddZddZddZddZ ddZ ddZ dd Z dd Z dd d Zd!d"d Zd#d ZeZd$dZd%dZd&dZd'd(dZd)d*dZd)d+dZd,dZd!d-dZddZddZd.d/dZd0dZd1dZexZZ dfd Z!xZ"S)2pathz8 Represents a path which behaves like a string. c^|jtjj|S)zH The name of the directory the file or directory is in. ) __class__r rdirnameselfs rparentz path.parent's ~~bggood344rc@tjj|SN)r rbasenamers rrz path.basename.sww%%rc^|jtjj|S)z, Returns the absolute path. )rr rabspathrs rrz path.abspath1s ~~bggood344rc@tjj|S)z; Returns ``True`` if the path is absolute. )r risabsrs rr z path.isabs7ww}}T""rc@tjj|S)z> Returns ``True`` if the path is a directory. )r risdirrs rr#z path.isdir=r!rc@tjj|S)z9 Returns ``True`` if the path is a file. )r risfilers rr%z path.isfileCww~~d##rc@tjj|S)zB Returns ``True`` if the path is a symbolic link. )r rislinkrs rr(z path.islinkIr&rc@tjj|S)z@ Returns ``True`` if the path is a mount point. )r rismountrs rr*z path.ismountOswwt$$rc4tj|||y)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`. ) ignore_errorsonerrorN)shutilrmtree)rr,r-s rr/z path.rmtreeUs  d-Ircrtj|||tjj drtj |D]g\}}}tj |dtz|D]>}tj tjj||dtz@iyy)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. )symlinksSPHINX_READONLY_TESTDIRiiN) r.copytreer environgetwalkchmodUMASKrjoin)r destinationr1root_dirsfilesnames rr3z path.copytreegs kH= ::>>3 4 ')ggk&: G"eUuv~.!GDHHRWW\\$5uv~FG G 5rc0tj||y)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:s rmovetreez path.movetree}s  D+&rc.tj|y)z! Removes a file. N)r unlinkrs rrCz path.unlinks $rc,tj|S)z- Returns a stat of the file. )r statrs rrEz path.statswwt}rc0tj||yr)r utime)rargs rrGz path.utimes src t||fi|Sr)open)rmodekwargss rrJz path.opensD$)&))rc nt|dfd|i|5}|j|dddy#1swYyxYw)z6 Writes the given `text` to the file. wencodingNrJwrite)rtextrOrLfs r write_textzpath.write_texts:$ 9h 9& 9 Q GGDM   s+4c jt|fd|i|5}|jcdddS#1swYyxYw)z/ Returns the text in the file. rONrJread)rrOrLrSs r read_textzpath.read_texts6$ 4 4V 4 668   s)2cht|d5}|jcdddS#1swYyxYw)z0 Returns the bytes in the file. rbrKNrV)rrSs r read_byteszpath.read_bytess.$T " a668   s(1cx|rd}nd}t||5}|j|dddy#1swYyxYw)z Writes the given `bytes` to the file. :param append: If ``True`` given `bytes` are added at the end of the file. abwbr[NrP)rbytesappendrKrSs r write_byteszpath.write_bytess= DD $T " a GGEN   s09c@tjj|S)z5 Returns ``True`` if the path exist. )r rexistsrs rrdz path.existsr&rc@tjj|S)zb Returns ``True`` if the path exists unless it is a broken symbolic link. )r rlexistsrs rrfz path.lexistss wwt$$rc4tj|||y)z1 Recursively create directories. )exist_okN)r makedirs)rrKrhs rriz path.makedirss D$2rc |jtjj|gt |j|S)zP Joins the path with the argument given and returns the result. )rr rr9map)rargss rjoinpathz path.joinpaths0~~bggll4L#dnnd2KLMMrc,tj|Sr)r listdirrs rroz path.listdirszz$rcT|jjdt| dS)N())r__name__super__repr__)rrs rruz path.__repr__s*..))*!EG,<,>+?qAAr)returnr)rvstr)rvbool)FN)r,rxr-zCallable | NonervNone)F)r:rwr1rxrvry)r:rwrvry)rvry)rvr)rHrrvry)r)rKrwrLrrvr)zutf-8)rRrwrOrwrLrrvry)rOrwrLrrvrw)rvzbuiltins.bytes)r`rwrarxrvry)iF)rKintrhrxrvry)rlrrvr)rvz list[str])#rs __module__ __qualname____doc__ __slots__propertyrrrr r#r%r(r*r/r3rAr@rCrErGrJrTrXr\rbrdrfrirmro__div__ __truediv__ru __classcell__)rs@rrr sI 55 &5 # # $ $ % J$G,' D  * $ %3 N  %$GkBBrr)rvr{) __future__rr r.syswarningstypingrrrrsphinx.deprecationrbuiltinswarngetfilesystemencodinggetdefaultencodingFILESYSTEMENCODINGrr8rwrrrrrs}" 337  4&16/S..0L4JC4J4J4L  }B3}Br