import fnmatchimport functoolsimport ioimport ntpathimport osimport posixpathimport reimport sysfrom collections import Sequencefrom contextlib import contextmanagerfrom errno import EINVAL, ENOENT, ENOTDIRfrom operator import attrgetterfrom stat import S_ISDIR, S_ISLNK, S_ISREG, S_ISSOCK, S_ISBLK, S_ISCHR, S_ISFIFOfrom urllib.parse import quote_from_bytes as urlquote_from_bytessupports_symlinks = Trueif os.name == 'nt':import ntif sys.getwindowsversion()[:2] >= (6, 0):from nt import _getfinalpathnameelse:supports_symlinks = False_getfinalpathname = Noneelse:nt = None__all__ = ["PurePath", "PurePosixPath", "PureWindowsPath","Path", "PosixPath", "WindowsPath",]## Internals#def _is_wildcard_pattern(pat):# Whether this pattern needs actual matching using fnmatch, or can# be looked up directly as a file.return "*" in pat or "?" in pat or "[" in patclass _Flavour(object):"""A flavour implements a particular (platform-specific) set of pathsemantics."""def __init__(self):self.join = self.sep.joindef parse_parts(self, parts):parsed = []sep = self.sepaltsep = self.altsepdrv = root = ''it = reversed(parts)for part in it:if not part:continueif altsep:part = part.replace(altsep, sep)drv, root, rel = self.splitroot(part)if sep in rel:for x in reversed(rel.split(sep)):if x and x != '.':parsed.append(sys.intern(x))else:if rel and rel != '.':parsed.append(sys.intern(rel))if drv or root:if not drv:# If no drive is present, try to find one in the previous# parts. This makes the result of parsing e.g.# ("C:", "/", "a") reasonably intuitive.for part in it:drv = self.splitroot(part)[0]if drv:breakbreakif drv or root:parsed.append(drv + root)parsed.reverse()return drv, root, parseddef join_parsed_parts(self, drv, root, parts, drv2, root2, parts2):"""Join the two paths represented by the respective(drive, root, parts) tuples. Return a new (drive, root, parts) tuple."""if root2:if not drv2 and drv:return drv, root2, [drv + root2] + parts2[1:]elif drv2:if drv2 == drv or self.casefold(drv2) == self.casefold(drv):# Same drive => second path is relative to the firstreturn drv, root, parts + parts2[1:]else:# Second path is non-anchored (common case)return drv, root, parts + parts2return drv2, root2, parts2class _WindowsFlavour(_Flavour):# Reference for Windows paths can be found at# http://msdn.microsoft.com/en-us/library/aa365247%28v=vs.85%29.aspxsep = '\\'altsep = '/'has_drv = Truepathmod = ntpathis_supported = (os.name == 'nt')drive_letters = (set(chr(x) for x in range(ord('a'), ord('z') + 1)) |set(chr(x) for x in range(ord('A'), ord('Z') + 1)))ext_namespace_prefix = '\\\\?\\'reserved_names = ({'CON', 'PRN', 'AUX', 'NUL'} |{'COM%d' % i for i in range(1, 10)} |{'LPT%d' % i for i in range(1, 10)})# Interesting findings about extended paths:# - '\\?\c:\a', '//?/c:\a' and '//?/c:/a' are all supported# but '\\?\c:/a' is not# - extended paths are always absolute; "relative" extended paths will# fail.def splitroot(self, part, sep=sep):first = part[0:1]second = part[1:2]if (second == sep and first == sep):# XXX extended paths should also disable the collapsing of "."# components (according to MSDN docs).prefix, part = self._split_extended_path(part)first = part[0:1]second = part[1:2]else:prefix = ''third = part[2:3]if (second == sep and first == sep and third != sep):# is a UNC path:# vvvvvvvvvvvvvvvvvvvvv root# \\machine\mountpoint\directory\etc\...# directory ^^^^^^^^^^^^^^index = part.find(sep, 2)if index != -1:index2 = part.find(sep, index + 1)# a UNC path can't have two slashes in a row# (after the initial two)if index2 != index + 1:if index2 == -1:index2 = len(part)if prefix:return prefix + part[1:index2], sep, part[index2+1:]else:return part[:index2], sep, part[index2+1:]drv = root = ''if second == ':' and first in self.drive_letters:drv = part[:2]part = part[2:]first = thirdif first == sep:root = firstpart = part.lstrip(sep)return prefix + drv, root, partdef casefold(self, s):return s.lower()def casefold_parts(self, parts):return [p.lower() for p in parts]def resolve(self, path):s = str(path)if not s:return os.getcwd()if _getfinalpathname is not None:return self._ext_to_normal(_getfinalpathname(s))# Means fallback on absolutereturn Nonedef _split_extended_path(self, s, ext_prefix=ext_namespace_prefix):prefix = ''if s.startswith(ext_prefix):prefix = s[:4]s = s[4:]if s.startswith('UNC\\'):prefix += s[:3]s = '\\' + s[3:]return prefix, sdef _ext_to_normal(self, s):# Turn back an extended path into a normal DOS-like pathreturn self._split_extended_path(s)[1]def is_reserved(self, parts):# NOTE: the rules for reserved names seem somewhat complicated# (e.g. r"..\NUL" is reserved but not r"foo\NUL").# We err on the side of caution and return True for paths which are# not considered reserved by Windows.if not parts:return Falseif parts[0].startswith('\\\\'):# UNC paths are never reservedreturn Falsereturn parts[-1].partition('.')[0].upper() in self.reserved_namesdef make_uri(self, path):# Under Windows, file URIs use the UTF-8 encoding.drive = path.driveif len(drive) == 2 and drive[1] == ':':# It's a path on a local drive => 'file:///c:/a/b'rest = path.as_posix()[2:].lstrip('/')return 'file:///%s/%s' % (drive, urlquote_from_bytes(rest.encode('utf-8')))else:# It's a path on a network drive => 'file://host/share/a/b'return 'file:' + urlquote_from_bytes(path.as_posix().encode('utf-8'))class _PosixFlavour(_Flavour):sep = '/'altsep = ''has_drv = Falsepathmod = posixpathis_supported = (os.name != 'nt')def splitroot(self, part, sep=sep):if part and part[0] == sep:stripped_part = part.lstrip(sep)# According to POSIX path resolution:# http://pubs.opengroup.org/onlinepubs/009695399/basedefs/xbd_chap04.html#tag_04_11# "A pathname that begins with two successive slashes may be# interpreted in an implementation-defined manner, although more# than two leading slashes shall be treated as a single slash".if len(part) - len(stripped_part) == 2:return '', sep * 2, stripped_partelse:return '', sep, stripped_partelse:return '', '', partdef casefold(self, s):return sdef casefold_parts(self, parts):return partsdef resolve(self, path):sep = self.sepaccessor = path._accessorseen = {}def _resolve(path, rest):if rest.startswith(sep):path = ''for name in rest.split(sep):if not name or name == '.':# current dircontinueif name == '..':# parent dirpath, _, _ = path.rpartition(sep)continuenewpath = path + sep + nameif newpath in seen:# Already seen this pathpath = seen[newpath]if path is not None:# use cached valuecontinue# The symlink is not resolved, so we must have a symlink loop.raise RuntimeError("Symlink loop from %r" % newpath)# Resolve the symbolic linktry:target = accessor.readlink(newpath)except OSError as e:if e.errno != EINVAL:raise# Not a symlinkpath = newpathelse:seen[newpath] = None # not resolved symlinkpath = _resolve(path, target)seen[newpath] = path # resolved symlinkreturn path# NOTE: according to POSIX, getcwd() cannot contain path components# which are symlinks.base = '' if path.is_absolute() else os.getcwd()return _resolve(base, str(path)) or sepdef is_reserved(self, parts):return Falsedef make_uri(self, path):# We represent the path using the local filesystem encoding,# for portability to other applications.bpath = bytes(path)return 'file://' + urlquote_from_bytes(bpath)_windows_flavour = _WindowsFlavour()_posix_flavour = _PosixFlavour()class _Accessor:"""An accessor implements a particular (system-specific or not) way ofaccessing paths on the filesystem."""class _NormalAccessor(_Accessor):def _wrap_strfunc(strfunc):@functools.wraps(strfunc)def wrapped(pathobj, *args):return strfunc(str(pathobj), *args)return staticmethod(wrapped)def _wrap_binary_strfunc(strfunc):@functools.wraps(strfunc)def wrapped(pathobjA, pathobjB, *args):return strfunc(str(pathobjA), str(pathobjB), *args)return staticmethod(wrapped)stat = _wrap_strfunc(os.stat)lstat = _wrap_strfunc(os.lstat)open = _wrap_strfunc(os.open)listdir = _wrap_strfunc(os.listdir)chmod = _wrap_strfunc(os.chmod)if hasattr(os, "lchmod"):lchmod = _wrap_strfunc(os.lchmod)else:def lchmod(self, pathobj, mode):raise NotImplementedError("lchmod() not available on this system")mkdir = _wrap_strfunc(os.mkdir)unlink = _wrap_strfunc(os.unlink)rmdir = _wrap_strfunc(os.rmdir)rename = _wrap_binary_strfunc(os.rename)replace = _wrap_binary_strfunc(os.replace)if nt:if supports_symlinks:symlink = _wrap_binary_strfunc(os.symlink)else:def symlink(a, b, target_is_directory):raise NotImplementedError("symlink() not available on this system")else:# Under POSIX, os.symlink() takes two args@staticmethoddef symlink(a, b, target_is_directory):return os.symlink(str(a), str(b))utime = _wrap_strfunc(os.utime)# Helper for resolve()def readlink(self, path):return os.readlink(path)_normal_accessor = _NormalAccessor()## Globbing helpers#@contextmanagerdef _cached(func):try:func.__cached__yield funcexcept AttributeError:cache = {}def wrapper(*args):try:return cache[args]except KeyError:value = cache[args] = func(*args)return valuewrapper.__cached__ = Truetry:yield wrapperfinally:cache.clear()def _make_selector(pattern_parts):pat = pattern_parts[0]child_parts = pattern_parts[1:]if pat == '**':cls = _RecursiveWildcardSelectorelif '**' in pat:raise ValueError("Invalid pattern: '**' can only be an entire path component")elif _is_wildcard_pattern(pat):cls = _WildcardSelectorelse:cls = _PreciseSelectorreturn cls(pat, child_parts)if hasattr(functools, "lru_cache"):_make_selector = functools.lru_cache()(_make_selector)class _Selector:"""A selector matches a specific glob pattern part against the childrenof a given path."""def __init__(self, child_parts):self.child_parts = child_partsif child_parts:self.successor = _make_selector(child_parts)else:self.successor = _TerminatingSelector()def select_from(self, parent_path):"""Iterate over all child paths of `parent_path` matched by thisselector. This can contain parent_path itself."""path_cls = type(parent_path)is_dir = path_cls.is_direxists = path_cls.existslistdir = parent_path._accessor.listdirreturn self._select_from(parent_path, is_dir, exists, listdir)class _TerminatingSelector:def _select_from(self, parent_path, is_dir, exists, listdir):yield parent_pathclass _PreciseSelector(_Selector):def __init__(self, name, child_parts):self.name = name_Selector.__init__(self, child_parts)def _select_from(self, parent_path, is_dir, exists, listdir):if not is_dir(parent_path):returnpath = parent_path._make_child_relpath(self.name)if exists(path):for p in self.successor._select_from(path, is_dir, exists, listdir):yield pclass _WildcardSelector(_Selector):def __init__(self, pat, child_parts):self.pat = re.compile(fnmatch.translate(pat))_Selector.__init__(self, child_parts)def _select_from(self, parent_path, is_dir, exists, listdir):if not is_dir(parent_path):returncf = parent_path._flavour.casefoldfor name in listdir(parent_path):casefolded = cf(name)if self.pat.match(casefolded):path = parent_path._make_child_relpath(name)for p in self.successor._select_from(path, is_dir, exists, listdir):yield pclass _RecursiveWildcardSelector(_Selector):def __init__(self, pat, child_parts):_Selector.__init__(self, child_parts)def _iterate_directories(self, parent_path, is_dir, listdir):yield parent_pathfor name in listdir(parent_path):path = parent_path._make_child_relpath(name)if is_dir(path):for p in self._iterate_directories(path, is_dir, listdir):yield pdef _select_from(self, parent_path, is_dir, exists, listdir):if not is_dir(parent_path):returnwith _cached(listdir) as listdir:yielded = set()try:successor_select = self.successor._select_fromfor starting_point in self._iterate_directories(parent_path, is_dir, listdir):for p in successor_select(starting_point, is_dir, exists, listdir):if p not in yielded:yield pyielded.add(p)finally:yielded.clear()## Public API#class _PathParents(Sequence):"""This object provides sequence-like access to the logical ancestorsof a path. Don't try to construct it yourself."""__slots__ = ('_pathcls', '_drv', '_root', '_parts')def __init__(self, path):# We don't store the instance to avoid reference cyclesself._pathcls = type(path)self._drv = path._drvself._root = path._rootself._parts = path._partsdef __len__(self):if self._drv or self._root:return len(self._parts) - 1else:return len(self._parts)def __getitem__(self, idx):if idx < 0 or idx >= len(self):raise IndexError(idx)return self._pathcls._from_parsed_parts(self._drv, self._root,self._parts[:-idx - 1])def __repr__(self):return "<{}.parents>".format(self._pathcls.__name__)class PurePath(object):"""PurePath represents a filesystem path and offers operations whichdon't imply any actual filesystem I/O. Depending on your system,instantiating a PurePath will return either a PurePosixPath or aPureWindowsPath object. You can also instantiate either of these classesdirectly, regardless of your system."""__slots__ = ('_drv', '_root', '_parts','_str', '_hash', '_pparts', '_cached_cparts',)def __new__(cls, *args):"""Construct a PurePath from one or several strings and or existingPurePath objects. The strings and path objects are combined so asto yield a canonicalized path, which is incorporated into thenew PurePath object."""if cls is PurePath:cls = PureWindowsPath if os.name == 'nt' else PurePosixPathreturn cls._from_parts(args)def __reduce__(self):# Using the parts tuple helps share interned path parts# when pickling related paths.return (self.__class__, tuple(self._parts))@classmethoddef _parse_args(cls, args):# This is useful when you don't want to create an instance, just# canonicalize some constructor arguments.parts = []for a in args:if isinstance(a, PurePath):parts += a._partselif isinstance(a, str):# Force-cast str subclasses to str (issue #21127)parts.append(str(a))else:raise TypeError("argument should be a path or str object, not %r"% type(a))return cls._flavour.parse_parts(parts)@classmethoddef _from_parts(cls, args, init=True):# We need to call _parse_args on the instance, so as to get the# right flavour.self = object.__new__(cls)drv, root, parts = self._parse_args(args)self._drv = drvself._root = rootself._parts = partsif init:self._init()return self@classmethoddef _from_parsed_parts(cls, drv, root, parts, init=True):self = object.__new__(cls)self._drv = drvself._root = rootself._parts = partsif init:self._init()return self@classmethoddef _format_parsed_parts(cls, drv, root, parts):if drv or root:return drv + root + cls._flavour.join(parts[1:])else:return cls._flavour.join(parts)def _init(self):# Overriden in concrete Pathpassdef _make_child(self, args):drv, root, parts = self._parse_args(args)drv, root, parts = self._flavour.join_parsed_parts(self._drv, self._root, self._parts, drv, root, parts)return self._from_parsed_parts(drv, root, parts)def __str__(self):"""Return the string representation of the path, suitable forpassing to system calls."""try:return self._strexcept AttributeError:self._str = self._format_parsed_parts(self._drv, self._root,self._parts) or '.'return self._strdef as_posix(self):"""Return the string representation of the path with forward (/)slashes."""f = self._flavourreturn str(self).replace(f.sep, '/')def __bytes__(self):"""Return the bytes representation of the path. This is onlyrecommended to use under Unix."""return os.fsencode(str(self))def __repr__(self):return "{}({!r})".format(self.__class__.__name__, self.as_posix())def as_uri(self):"""Return the path as a 'file' URI."""if not self.is_absolute():raise ValueError("relative path can't be expressed as a file URI")return self._flavour.make_uri(self)@propertydef _cparts(self):# Cached casefolded parts, for hashing and comparisontry:return self._cached_cpartsexcept AttributeError:self._cached_cparts = self._flavour.casefold_parts(self._parts)return self._cached_cpartsdef __eq__(self, other):if not isinstance(other, PurePath):return NotImplementedreturn self._cparts == other._cparts and self._flavour is other._flavourdef __hash__(self):try:return self._hashexcept AttributeError:self._hash = hash(tuple(self._cparts))return self._hashdef __lt__(self, other):if not isinstance(other, PurePath) or self._flavour is not other._flavour:return NotImplementedreturn self._cparts < other._cpartsdef __le__(self, other):if not isinstance(other, PurePath) or self._flavour is not other._flavour:return NotImplementedreturn self._cparts <= other._cpartsdef __gt__(self, other):if not isinstance(other, PurePath) or self._flavour is not other._flavour:return NotImplementedreturn self._cparts > other._cpartsdef __ge__(self, other):if not isinstance(other, PurePath) or self._flavour is not other._flavour:return NotImplementedreturn self._cparts >= other._cpartsdrive = property(attrgetter('_drv'),doc="""The drive prefix (letter or UNC path), if any.""")root = property(attrgetter('_root'),doc="""The root of the path, if any.""")@propertydef anchor(self):"""The concatenation of the drive and root, or ''."""anchor = self._drv + self._rootreturn anchor@propertydef name(self):"""The final path component, if any."""parts = self._partsif len(parts) == (1 if (self._drv or self._root) else 0):return ''return parts[-1]@propertydef suffix(self):"""The final component's last suffix, if any."""name = self.namei = name.rfind('.')if 0 < i < len(name) - 1:return name[i:]else:return ''@propertydef suffixes(self):"""A list of the final component's suffixes, if any."""name = self.nameif name.endswith('.'):return []name = name.lstrip('.')return ['.' + suffix for suffix in name.split('.')[1:]]@propertydef stem(self):"""The final path component, minus its last suffix."""name = self.namei = name.rfind('.')if 0 < i < len(name) - 1:return name[:i]else:return namedef with_name(self, name):"""Return a new path with the file name changed."""if not self.name:raise ValueError("%r has an empty name" % (self,))drv, root, parts = self._flavour.parse_parts((name,))if (not name or name[-1] in [self._flavour.sep, self._flavour.altsep]or drv or root or len(parts) != 1):raise ValueError("Invalid name %r" % (name))return self._from_parsed_parts(self._drv, self._root,self._parts[:-1] + [name])def with_suffix(self, suffix):"""Return a new path with the file suffix changed (or added, if none)."""# XXX if suffix is None, should the current suffix be removed?f = self._flavourif f.sep in suffix or f.altsep and f.altsep in suffix:raise ValueError("Invalid suffix %r" % (suffix))if suffix and not suffix.startswith('.') or suffix == '.':raise ValueError("Invalid suffix %r" % (suffix))name = self.nameif not name:raise ValueError("%r has an empty name" % (self,))old_suffix = self.suffixif not old_suffix:name = name + suffixelse:name = name[:-len(old_suffix)] + suffixreturn self._from_parsed_parts(self._drv, self._root,self._parts[:-1] + [name])def relative_to(self, *other):"""Return the relative path to another path identified by the passedarguments. If the operation is not possible (because this is nota subpath of the other path), raise ValueError."""# For the purpose of this method, drive and root are considered# separate parts, i.e.:# Path('c:/').relative_to('c:') gives Path('/')# Path('c:/').relative_to('/') raise ValueErrorif not other:raise TypeError("need at least one argument")parts = self._partsdrv = self._drvroot = self._rootif root:abs_parts = [drv, root] + parts[1:]else:abs_parts = partsto_drv, to_root, to_parts = self._parse_args(other)if to_root:to_abs_parts = [to_drv, to_root] + to_parts[1:]else:to_abs_parts = to_partsn = len(to_abs_parts)cf = self._flavour.casefold_partsif (root or drv) if n == 0 else cf(abs_parts[:n]) != cf(to_abs_parts):formatted = self._format_parsed_parts(to_drv, to_root, to_parts)raise ValueError("{!r} does not start with {!r}".format(str(self), str(formatted)))return self._from_parsed_parts('', root if n == 1 else '',abs_parts[n:])@propertydef parts(self):"""An object providing sequence-like access to thecomponents in the filesystem path."""# We cache the tuple to avoid building a new one each time .parts# is accessed. XXX is this necessary?try:return self._ppartsexcept AttributeError:self._pparts = tuple(self._parts)return self._ppartsdef joinpath(self, *args):"""Combine this path with one or several arguments, and return anew path representing either a subpath (if all arguments are relativepaths) or a totally different path (if one of the arguments isanchored)."""return self._make_child(args)def __truediv__(self, key):return self._make_child((key,))def __rtruediv__(self, key):return self._from_parts([key] + self._parts)@propertydef parent(self):"""The logical parent of the path."""drv = self._drvroot = self._rootparts = self._partsif len(parts) == 1 and (drv or root):return selfreturn self._from_parsed_parts(drv, root, parts[:-1])@propertydef parents(self):"""A sequence of this path's logical parents."""return _PathParents(self)def is_absolute(self):"""True if the path is absolute (has both a root and, if applicable,a drive)."""if not self._root:return Falsereturn not self._flavour.has_drv or bool(self._drv)def is_reserved(self):"""Return True if the path contains one of the special names reservedby the system, if any."""return self._flavour.is_reserved(self._parts)def match(self, path_pattern):"""Return True if this path matches the given pattern."""cf = self._flavour.casefoldpath_pattern = cf(path_pattern)drv, root, pat_parts = self._flavour.parse_parts((path_pattern,))if not pat_parts:raise ValueError("empty pattern")if drv and drv != cf(self._drv):return Falseif root and root != cf(self._root):return Falseparts = self._cpartsif drv or root:if len(pat_parts) != len(parts):return Falsepat_parts = pat_parts[1:]elif len(pat_parts) > len(parts):return Falsefor part, pat in zip(reversed(parts), reversed(pat_parts)):if not fnmatch.fnmatchcase(part, pat):return Falsereturn Trueclass PurePosixPath(PurePath):_flavour = _posix_flavour__slots__ = ()class PureWindowsPath(PurePath):_flavour = _windows_flavour__slots__ = ()# Filesystem-accessing classesclass Path(PurePath):__slots__ = ('_accessor','_closed',)def __new__(cls, *args, **kwargs):if cls is Path:cls = WindowsPath if os.name == 'nt' else PosixPathself = cls._from_parts(args, init=False)if not self._flavour.is_supported:raise NotImplementedError("cannot instantiate %r on your system"% (cls.__name__,))self._init()return selfdef _init(self,# Private non-constructor argumentstemplate=None,):self._closed = Falseif template is not None:self._accessor = template._accessorelse:self._accessor = _normal_accessordef _make_child_relpath(self, part):# This is an optimization used for dir walking. `part` must be# a single part relative to this path.parts = self._parts + [part]return self._from_parsed_parts(self._drv, self._root, parts)def __enter__(self):if self._closed:self._raise_closed()return selfdef __exit__(self, t, v, tb):self._closed = Truedef _raise_closed(self):raise ValueError("I/O operation on closed path")def _opener(self, name, flags, mode=0o666):# A stub for the opener argument to built-in open()return self._accessor.open(self, flags, mode)def _raw_open(self, flags, mode=0o777):"""Open the file pointed by this path and return a file descriptor,as os.open() does."""if self._closed:self._raise_closed()return self._accessor.open(self, flags, mode)# Public API@classmethoddef cwd(cls):"""Return a new path pointing to the current working directory(as returned by os.getcwd())."""return cls(os.getcwd())def iterdir(self):"""Iterate over the files in this directory. Does not yield anyresult for the special paths '.' and '..'."""if self._closed:self._raise_closed()for name in self._accessor.listdir(self):if name in {'.', '..'}:# Yielding a path object for these makes little sensecontinueyield self._make_child_relpath(name)if self._closed:self._raise_closed()def glob(self, pattern):"""Iterate over this subtree and yield all existing files (of anykind, including directories) matching the given pattern."""pattern = self._flavour.casefold(pattern)drv, root, pattern_parts = self._flavour.parse_parts((pattern,))if drv or root:raise NotImplementedError("Non-relative patterns are unsupported")selector = _make_selector(tuple(pattern_parts))for p in selector.select_from(self):yield pdef rglob(self, pattern):"""Recursively yield all existing files (of any kind, includingdirectories) matching the given pattern, anywhere in this subtree."""pattern = self._flavour.casefold(pattern)drv, root, pattern_parts = self._flavour.parse_parts((pattern,))if drv or root:raise NotImplementedError("Non-relative patterns are unsupported")selector = _make_selector(("**",) + tuple(pattern_parts))for p in selector.select_from(self):yield pdef absolute(self):"""Return an absolute version of this path. This function workseven if the path doesn't point to anything.No normalization is done, i.e. all '.' and '..' will be kept along.Use resolve() to get the canonical path to a file."""# XXX untested yet!if self._closed:self._raise_closed()if self.is_absolute():return self# FIXME this must defer to the specific flavour (and, under Windows,# use nt._getfullpathname())obj = self._from_parts([os.getcwd()] + self._parts, init=False)obj._init(template=self)return objdef resolve(self):"""Make the path absolute, resolving all symlinks on the way and alsonormalizing it (for example turning slashes into backslashes underWindows)."""if self._closed:self._raise_closed()s = self._flavour.resolve(self)if s is None:# No symlink resolution => for consistency, raise an error if# the path doesn't exist or is forbiddenself.stat()s = str(self.absolute())# Now we have no symlinks in the path, it's safe to normalize it.normed = self._flavour.pathmod.normpath(s)obj = self._from_parts((normed,), init=False)obj._init(template=self)return objdef stat(self):"""Return the result of the stat() system call on this path, likeos.stat() does."""return self._accessor.stat(self)def owner(self):"""Return the login name of the file owner."""import pwdreturn pwd.getpwuid(self.stat().st_uid).pw_namedef group(self):"""Return the group name of the file gid."""import grpreturn grp.getgrgid(self.stat().st_gid).gr_namedef open(self, mode='r', buffering=-1, encoding=None,errors=None, newline=None):"""Open the file pointed by this path and return a file object, asthe built-in open() function does."""if self._closed:self._raise_closed()return io.open(str(self), mode, buffering, encoding, errors, newline,opener=self._opener)def touch(self, mode=0o666, exist_ok=True):"""Create this file with the given access mode, if it doesn't exist."""if self._closed:self._raise_closed()if exist_ok:# First try to bump modification time# Implementation note: GNU touch uses the UTIME_NOW option of# the utimensat() / futimens() functions.try:self._accessor.utime(self, None)except OSError:# Avoid exception chainingpasselse:returnflags = os.O_CREAT | os.O_WRONLYif not exist_ok:flags |= os.O_EXCLfd = self._raw_open(flags, mode)os.close(fd)def mkdir(self, mode=0o777, parents=False):if self._closed:self._raise_closed()if not parents:self._accessor.mkdir(self, mode)else:try:self._accessor.mkdir(self, mode)except OSError as e:if e.errno != ENOENT:raiseself.parent.mkdir(parents=True)self._accessor.mkdir(self, mode)def chmod(self, mode):"""Change the permissions of the path, like os.chmod()."""if self._closed:self._raise_closed()self._accessor.chmod(self, mode)def lchmod(self, mode):"""Like chmod(), except if the path points to a symlink, the symlink'spermissions are changed, rather than its target's."""if self._closed:self._raise_closed()self._accessor.lchmod(self, mode)def unlink(self):"""Remove this file or link.If the path is a directory, use rmdir() instead."""if self._closed:self._raise_closed()self._accessor.unlink(self)def rmdir(self):"""Remove this directory. The directory must be empty."""if self._closed:self._raise_closed()self._accessor.rmdir(self)def lstat(self):"""Like stat(), except if the path points to a symlink, the symlink'sstatus information is returned, rather than its target's."""if self._closed:self._raise_closed()return self._accessor.lstat(self)def rename(self, target):"""Rename this path to the given path."""if self._closed:self._raise_closed()self._accessor.rename(self, target)def replace(self, target):"""Rename this path to the given path, clobbering the existingdestination if it exists."""if self._closed:self._raise_closed()self._accessor.replace(self, target)def symlink_to(self, target, target_is_directory=False):"""Make this path a symlink pointing to the given path.Note the order of arguments (self, target) is the reverse of os.symlink's."""if self._closed:self._raise_closed()self._accessor.symlink(target, self, target_is_directory)# Convenience functions for querying the stat resultsdef exists(self):"""Whether this path exists."""try:self.stat()except OSError as e:if e.errno not in (ENOENT, ENOTDIR):raisereturn Falsereturn Truedef is_dir(self):"""Whether this path is a directory."""try:return S_ISDIR(self.stat().st_mode)except OSError as e:if e.errno not in (ENOENT, ENOTDIR):raise# Path doesn't exist or is a broken symlink# (see https://bitbucket.org/pitrou/pathlib/issue/12/)return Falsedef is_file(self):"""Whether this path is a regular file (also True for symlinks pointingto regular files)."""try:return S_ISREG(self.stat().st_mode)except OSError as e:if e.errno not in (ENOENT, ENOTDIR):raise# Path doesn't exist or is a broken symlink# (see https://bitbucket.org/pitrou/pathlib/issue/12/)return Falsedef is_symlink(self):"""Whether this path is a symbolic link."""try:return S_ISLNK(self.lstat().st_mode)except OSError as e:if e.errno not in (ENOENT, ENOTDIR):raise# Path doesn't existreturn Falsedef is_block_device(self):"""Whether this path is a block device."""try:return S_ISBLK(self.stat().st_mode)except OSError as e:if e.errno not in (ENOENT, ENOTDIR):raise# Path doesn't exist or is a broken symlink# (see https://bitbucket.org/pitrou/pathlib/issue/12/)return Falsedef is_char_device(self):"""Whether this path is a character device."""try:return S_ISCHR(self.stat().st_mode)except OSError as e:if e.errno not in (ENOENT, ENOTDIR):raise# Path doesn't exist or is a broken symlink# (see https://bitbucket.org/pitrou/pathlib/issue/12/)return Falsedef is_fifo(self):"""Whether this path is a FIFO."""try:return S_ISFIFO(self.stat().st_mode)except OSError as e:if e.errno not in (ENOENT, ENOTDIR):raise# Path doesn't exist or is a broken symlink# (see https://bitbucket.org/pitrou/pathlib/issue/12/)return Falsedef is_socket(self):"""Whether this path is a socket."""try:return S_ISSOCK(self.stat().st_mode)except OSError as e:if e.errno not in (ENOENT, ENOTDIR):raise# Path doesn't exist or is a broken symlink# (see https://bitbucket.org/pitrou/pathlib/issue/12/)return Falseclass PosixPath(Path, PurePosixPath):__slots__ = ()class WindowsPath(Path, PureWindowsPath):__slots__ = ()
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。
1. 开源生态
2. 协作、人、软件
3. 评估模型