一图看懂 pathlib 模块：面向对象的文件系统路径, 资料整理+笔记（大全）
本文由 大侠(AhcaoZhu)原创，转载请声明。
链接: https://blog.csdn.net/Ahcao2008
一图看懂 pathlib 模块：面向对象的文件系统路径, 资料整理+笔记（大全）
- 摘要
- 模块图
- 类关系图
- 模块全展开
-
- 【pathlib】
- 统计
- 常量
-
- int
- bool
- tuple
- 模块
-
- 9 fnmatch
- 10 functools
- 11 io
- 12 ntpath
- 13 os
- 14 posixpath
- 15 re
- 16 sys
- 17 nt
- 函数
-
- 18 quote_from_bytes(bs, safe='/')
- 19 _ignore_error(exception)
- 20 _is_wildcard_pattern(pat)
- 类
-
- 21 collections.abc.Sequence
- 22 operator.attrgetter
- 23 pathlib._Flavour
-
- method
- 1 join_parsed_parts(self, drv, root, parts, drv2, root2, parts2)
- 2 parse_parts(self, parts)
- 24 pathlib._WindowsFlavour
-
- data
- method
- 9 casefold(self, s)
- 10 casefold_parts(self, parts)
- 11 compile_pattern(self, pattern)
- 12 gethomedir(self, username)
- 13 is_reserved(self, parts)
- 14 make_uri(self, path)
- 15 resolve(self, path, strict=False)
- 16 splitroot(self, part, sep=sep)
- 25 pathlib._PosixFlavour
-
- data
- method
- 6 casefold(self, s)
- 7 casefold_parts(self, parts)
- 8 compile_pattern(self, pattern)
- 9 gethomedir(self, username)
- 10 is_reserved(self, parts)
- 11 make_uri(self, path)
- 12 resolve(self, path, strict=False)
- 13 splitroot(self, part, sep=sep)
- 26 pathlib._Accessor
- 27 pathlib._NormalAccessor
-
- method
- 1 lchmod(self, pathobj, mode)
- 2 readlink(self, path)
- static method
- 3 chmod(self, mode)
- 4 listdir()
- 5 lstat(self)
- 6 mkdir(self, mode=0o777, parents=False, exist_ok=False)
- 7 open(self, mode='r', buffering=-1, encoding=None,
- 8 rename(self, target)
- 9 replace(self, target)
- 10 rmdir(self)
- 11 scandir()
- 12 stat(self)
- 13 symlink(a, b, target_is_directory)
- 14 unlink(self)
- 15 utime()
- 28 pathlib._Selector
-
- method
- 1 select_from(self, parent_path)
- 29 pathlib._TerminatingSelector
- 30 pathlib._PreciseSelector
- 31 pathlib._WildcardSelector
- 32 pathlib._RecursiveWildcardSelector
- 33 pathlib._PathParents
- 34 pathlib.PurePath
-
- property
- method
- 11 as_posix(self)
- 12 as_uri(self)
- 13 is_absolute(self)
- 14 is_reserved(self)
- 15 joinpath(self, *args)
- 16 match(self, path_pattern)
- 17 relative_to(self, *other)
- 18 with_name(self, name)
- 19 with_suffix(self, suffix)
- 35 pathlib.PurePosixPath
- 36 pathlib.PureWindowsPath
- 37 pathlib.Path
-
- method
- 1 absolute(self)
- 2 chmod(self, mode)
- 3 exists(self)
- 4 expanduser(self)
- 5 glob(self, pattern)
- 6 group(self)
- 7 is_block_device(self)
- 8 is_char_device(self)
- 9 is_dir(self)
- 10 is_fifo(self)
- 11 is_file(self)
- 12 is_mount(self)
- 13 is_socket(self)
- 14 is_symlink(self)
- 15 iterdir(self)
- 16 lchmod(self, mode)
- 17 lstat(self)
- 18 mkdir(self, mode=0o777, parents=False, exist_ok=False)
- 19 open(self, mode='r', buffering=-1, encoding=None,
- 20 owner(self)
- 21 read_bytes(self)
- 22 read_text(self, encoding=None, errors=None)
- 23 rename(self, target)
- 24 replace(self, target)
- 25 resolve(self, strict=False)
- 26 rglob(self, pattern)
- 27 rmdir(self)
- 28 samefile(self, other_path)
- 29 stat(self)
- 30 symlink_to(self, target, target_is_directory=False)
- 31 touch(self, mode=0o666, exist_ok=True)
- 32 unlink(self)
- 33 write_bytes(self, data)
- 34 write_text(self, data, encoding=None, errors=None)
- class method
- 35 cwd(cls)
- 36 home(cls)
- 38 pathlib.PosixPath
- 39 pathlib.WindowsPath
-
- method
- 1 group(self)
- 2 is_mount(self)
- 3 owner(self)
- 内嵌函数或方法
- 私有或局部
- 剩余
- 【fnmatch】
- 统计
- 常量
- 模块
-
- 1 os
- 2 posixpath
- 3 re
- 4 functools
- 函数
-
- 5 fnmatch(name, pat)
- 6 filter(names, pat)
- 7 fnmatchcase(name, pat)
- 8 translate(pat)
- 私有或局部
- 剩余
- 【functools】
- 【io】
- 【ntpath】
- 【os】
- 【posixpath】
- 统计
- 常量
-
- bool
- str
- 模块
-
- 9 os
- 10 sys
- 11 stat
- 12 genericpath
- 函数
-
- 13 commonprefix(m)
- 14 exists(path)
- 15 getatime(filename)
- 16 getctime(filename)
- 17 getmtime(filename)
- 18 getsize(filename)
- 19 isdir(s)
- 20 isfile(path)
- 21 samefile(f1, f2)
- 22 sameopenfile(fp1, fp2)
- 23 samestat(s1, s2)
- 24 _get_sep(path)
- 25 normcase(s)
- 26 isabs(s)
- 27 join(a, *p)
- 28 split(p)
- 29 splitext(p)
- 30 splitdrive(p)
- 31 basename(p)
- 32 dirname(p)
- 33 islink(path)
- 34 lexists(path)
- 35 ismount(path)
- 36 expanduser(path)
- 37 expandvars(path)
- 38 normpath(path)
- 39 abspath(path)
- 40 realpath(filename)
- 41 _joinrealpath(path, rest, seen)
- 42 relpath(path, start=None)
- 43 commonpath(paths)
- 私有或局部
- 剩余
- 【re】
- 【sys】
- 【nt】
摘要
全文介绍系统内置 pathlib 模块、函数、类及类的方法和属性。
它通过代码抓取并经AI智能翻译和人工校对。
是一部不可多得的权威字典类工具书。它是系列集的一部分。后续陆续发布、敬请关注。【原创：AhcaoZhu大侠】
模块图
pathlib
◆fnmatch
◆functools
◆io
◆ntpath
◆os
◆posixpath
◆re
◆sys
◆nt
类关系图
◆object
◆BaseException
◆Exception
◆OSError
◆BlockingIOError
◆io.UnsupportedOperation
◆ValueError
◆OSError
◆re.error
◆_frozen_importlib.BuiltinImporter
◆_io.IncrementalNewlineDecoder
◆_io._IOBase
◆_io._BufferedIOBase
◆_io.BufferedRWPair
◆_io.BufferedRandom
◆_io.BufferedReader
◆_io.BufferedWriter
◆_io.BytesIO
◆io.BufferedIOBase
◆_io._RawIOBase
◆_io.FileIO
◆_io._WindowsConsoleIO
◆io.RawIOBase
◆_io._TextIOBase
◆_io.StringIO
◆_io.TextIOWrapper
◆io.TextIOBase
◆io.IOBase
◆_io._BufferedIOBase
◆_io._RawIOBase
◆_io._TextIOBase
◆_thread.RLock
◆abc.ABC
◆os.PathLike
◆collections.abc.Container
◆collections.abc.Iterable
◆collections.abc.Sized
◆collections.abc.Collection
◆collections.abc.Mapping
◆collections.abc.MutableMapping
◆os._Environ
◆collections.abc.Reversible
◆collections.abc.Sequence
pathlib._PathParents
◆functools._lru_cache_wrapper
◆functools.partial
◆functools.partialmethod
◆list
◆functools._HashedSeq
◆nt.DirEntry
◆operator.attrgetter
◆os._wrap_close
pathlib.PurePath
pathlib.Path
pathlib.PosixPath
pathlib.WindowsPath
pathlib.PurePosixPath
pathlib.Path
pathlib.PureWindowsPath
pathlib.Path
pathlib._Accessor
pathlib._NormalAccessor
pathlib._Flavour
pathlib._PosixFlavour
pathlib._WindowsFlavour
pathlib._Selector
pathlib._PreciseSelector
pathlib._RecursiveWildcardSelector
pathlib._WildcardSelector
pathlib._TerminatingSelector
◆re.Match
◆re.Pattern
◆re.Scanner
◆tuple
◆functools.CacheInfo
◆nt.times_result
◆nt.uname_result
◆os.stat_result
◆os.statvfs_result
◆os.terminal_size
◆Enum
◆Flag
◆int
◆IntFlag
◆RegexFlag
模块全展开
【pathlib】
pathlib, fullname=pathlib, file=pathlib.py
统计
| 序号 | 类别 | 数量 |
|---|---|---|
| 1 | int | 5 |
| 2 | bool | 1 |
| 4 | str | 4 |
| 5 | tuple | 2 |
| 6 | list | 1 |
| 8 | dict | 1 |
| 9 | module | 9 |
| 10 | class | 19 |
| 11 | function | 3 |
| 12 | builtin_function_or_method | 8 |
| 13 | residual | 7 |
| 14 | system | 9 |
| 15 | private | 20 |
| 16 | all | 60 |
常量
int
1 EINVAL 22
2 ENOENT 2
3 ENOTDIR 20
4 EBADF 9
5 ELOOP 10062
bool
6 supports_symlinks True
tuple
7 _IGNORED_ERROS (2, 20, 9, 10062)
8 _IGNORED_WINERRORS (21, 1921)
模块
9 fnmatch
fnmatch, fullname=fnmatch, file=fnmatch.py
与shell模式匹配的文件名。
fnmatch(FILENAME, PATTERN)根据本地约定进行匹配。
fnmatchcase(FILENAME, PATTERN)总是考虑大小写。
这些函数通过将模式转换为正则表达式进行操作。它们缓存已编译的正则表达式以提高速度。
函数translate(PATTERN)返回一个与PATTERN对应的正则表达式。(它不编译它。)
10 functools
functools, fullname=functools, file=functools.py
11 io
io, fullname=io, file=io.py
12 ntpath
ntpath, fullname=ntpath, file=ntpath.py
13 os
os, fullname=os, file=os.py
14 posixpath
posixpath, fullname=posixpath, file=posixpath.py
Posix路径名的常用操作。不要直接导入这个模块，而是导入os并将这个模块引用为os.path。
15 re
re, fullname=re, file=re.py
16 sys
sys, fullname=sys, file=
17 nt
nt, fullname=nt, file=
这个模块提供了对操作系统功能的访问，这些功能是由C标准和POSIX标准(一个稍微伪装的Unix接口)标准化的。
函数
18 quote_from_bytes(bs, safe=‘/’)
quote_from_bytes(bs, safe=‘/’), module=urllib.parse, line:853 at urllib\parse.py
类似于quote()，但接受bytes对象而不是str对象，并且不执行字符串到字节的编码。
它总是返回一个ASCII字符串。
quote_from_bytes(b'abc def?') -> 'abc%20def%3f'
19 _ignore_error(exception)
_ignore_error(exception), module=pathlib, line:45 at pathlib.py
20 _is_wildcard_pattern(pat)
_is_wildcard_pattern(pat), module=pathlib, line:50 at pathlib.py
类
21 collections.abc.Sequence
Sequence, collections.abc.Sequence, module=collections.abc, line:-1 at collections\abc.py
对只读序列的所有操作。具体的子类必须重写new或init、getitem和len。
22 operator.attrgetter
attrgetter, operator.attrgetter, module=operator
23 pathlib._Flavour
_Flavour, pathlib._Flavour, module=pathlib
flavor实现了一组特定的(特定于平台的)路径语义。
method
1 join_parsed_parts(self, drv, root, parts, drv2, root2, parts2)
kind=method class=_Flavour objtype=function line:101 at …\pathlib.py
连接由各自(驱动器、根、部件)元组表示的两个路径。返回一个新的(驱动器，根，部件)元组。
2 parse_parts(self, parts)
kind=method class=_Flavour objtype=function line:63 at …\pathlib.py
24 pathlib._WindowsFlavour
_WindowsFlavour, pathlib._WindowsFlavour, module=pathlib
data
1 altsep=/ kind:data type:str class:
2 drive_letters={‘d’, ‘e’, ‘t’, ‘s’, ‘o’, ‘x’, ‘h’, ‘H’, ‘a’, ‘S’, ‘E’, ‘I’, ‘C’, ‘f’, ‘A’, ‘U’,… kind:data type:set class:
3 ext_namespace_prefix=\?\ kind:data type:str class:
4 has_drv=True kind:data type:bool class:
5 is_supported=True kind:data type:bool class:
6 pathmod=kind:data type:module class:
7 reserved_names={‘PRN’, ‘COM3’, ‘AUX’, ‘LPT6’, ‘COM6’, ‘CON’, ‘LPT3’, ‘LPT8’, ‘COM1’, ‘LPT2’, 'L… kind:data type:set class:
8 sep=\ kind:data type:str class:
method
9 casefold(self, s)
kind=method class=_WindowsFlavour objtype=function line:184 at …\pathlib.py
10 casefold_parts(self, parts)
kind=method class=_WindowsFlavour objtype=function line:187 at …\pathlib.py
11 compile_pattern(self, pattern)
kind=method class=_WindowsFlavour objtype=function line:190 at …\pathlib.py
12 gethomedir(self, username)
kind=method class=_WindowsFlavour objtype=function line:255 at …\pathlib.py
13 is_reserved(self, parts)
kind=method class=_WindowsFlavour objtype=function line:231 at …\pathlib.py
14 make_uri(self, path)
kind=method class=_WindowsFlavour objtype=function line:243 at …\pathlib.py
15 resolve(self, path, strict=False)
kind=method class=_WindowsFlavour objtype=function line:193 at …\pathlib.py
16 splitroot(self, part, sep=sep)
kind=method class=_WindowsFlavour objtype=function line:145 at …\pathlib.py
25 pathlib._PosixFlavour
_PosixFlavour, pathlib._PosixFlavour, module=pathlib
data
1 altsep= kind:data type:str class:
2 has_drv=False kind:data type:bool class:
3 is_supported=False kind:data type:bool class:
4 pathmod=kind:data type:module class:
5 sep=/ kind:data type:str class:
method
6 casefold(self, s)
kind=method class=_PosixFlavour objtype=function line:309 at …\pathlib.py
7 casefold_parts(self, parts)
kind=method class=_PosixFlavour objtype=function line:312 at …\pathlib.py
8 compile_pattern(self, pattern)
kind=method class=_PosixFlavour objtype=function line:315 at …\pathlib.py
9 gethomedir(self, username)
kind=method class=_PosixFlavour objtype=function line:372 at …\pathlib.py
10 is_reserved(self, parts)
kind=method class=_PosixFlavour objtype=function line:363 at …\pathlib.py
11 make_uri(self, path)
kind=method class=_PosixFlavour objtype=function line:366 at …\pathlib.py
12 resolve(self, path, strict=False)
kind=method class=_PosixFlavour objtype=function line:318 at …\pathlib.py
13 splitroot(self, part, sep=sep)
kind=method class=_PosixFlavour objtype=function line:294 at …\pathlib.py
26 pathlib._Accessor
_Accessor, pathlib._Accessor, module=pathlib
访问器实现了访问文件系统路径的特定(特定于系统的或不特定的)方式。
27 pathlib._NormalAccessor
_NormalAccessor, pathlib._NormalAccessor, module=pathlib
method
1 lchmod(self, pathobj, mode)
kind=method class=_NormalAccessor objtype=function line:414 at …\pathlib.py
2 readlink(self, path)
kind=method class=_NormalAccessor objtype=function line:442 at …\pathlib.py
static method
3 chmod(self, mode)
kind=static method class=_NormalAccessor objtype=builtin_function_or_method line:1285 at …\pathlib.py
修改文件的访问权限。
path 要修改的路径。可以始终指定为str、bytes或类路径对象。
在某些平台上，path也可以指定为打开的文件描述符。如果此功能不可用，则使用它将引发异常。
mode 操作系统模式位域。
dir_fd 如果不是None，它应该是一个打开目录的文件描述符，path应该是相对的;Path将相对于该目录。
follow_symlinks
如果为False，并且路径的最后一个元素是一个符号链接，chmod将修改符号链接本身，而不是链接指向的文件。
当指定 path 作为打开的文件描述符时，使用dir_fd或遵循符号链接是错误的。
Dir_fd 和 follow_symlinks 可能无法在您的平台上实现。如果不可用，使用它们将引发NotImplementedError。
4 listdir()
kind=static method class=_NormalAccessor objtype=builtin_function_or_method
返回一个包含目录中文件名称的列表。
Path可以指定为str、bytes或类路径对象。
如果path是bytes，返回的文件名也将是bytes;
在所有其他情况下，返回的文件名将是str。
如果path为None，则使用path='.'。
在某些平台上，path也可以指定为打开的文件描述符;文件描述符必须指向目录。如果此功能不可用，则使用它会引发NotImplementedError。
这个列表的顺序是任意的。它不包括特殊分录'.'和'..'，即使它们已经出现在目录中。
5 lstat(self)
kind=static method class=_NormalAccessor objtype=builtin_function_or_method line:1319 at …\pathlib.py
在给定的路径上执行统计系统调用，而不遵循符号链接。
类似于stat()，但不遵循符号链接。等效于stat(path, follow_symlinks=False)。
6 mkdir(self, mode=0o777, parents=False, exist_ok=False)
kind=static method class=_NormalAccessor objtype=builtin_function_or_method line:1266 at …\pathlib.py
创建目录。
如果dir_fd不是None，它应该是一个打开到目录的文件描述符，path应该是相对的;Path将相对于该目录。
Dir_fd可能无法在您的平台上实现。如果不可用，使用它将引发NotImplementedError。
mode参数在Windows上被忽略。
7 open(self, mode=‘r’, buffering=-1, encoding=None,
kind=static method class=_NormalAccessor objtype=builtin_function_or_method line:1199 at …\pathlib.py
打开一个文件进行低级IO。
返回一个文件描述符(整数)。如果dir_fd不是None，它应该是一个打开到目录的文件描述符，path应该是相对的;Path将相对于该目录。
dir_fd可能无法在您的平台上实现。如果不可用，使用它将引发NotImplementedError。
8 rename(self, target)
kind=static method class=_NormalAccessor objtype=builtin_function_or_method line:1328 at …\pathlib.py
重命名文件或目录。
如果src_dir_fd或dst_dir_fd不是None，它应该是一个打开到目录的文件描述符，并且各自的路径字符串(src或dst)应该是相对的;该路径将相对于该目录。
src_dir_fd和dst_dir_fd，可能不能在你的平台上实现。如果不可用，使用它们将引发NotImplementedError。
9 replace(self, target)
kind=static method class=_NormalAccessor objtype=builtin_function_or_method line:1336 at …\pathlib.py
重命名文件或目录，覆盖目标。
如果src_dir_fd或dst_dir_fd不是None，它应该是一个打开到目录的文件描述符，并且各自的路径字符串(src或dst)应该是相对的;
该路径将相对于该目录。src_dir_fd和dst_dir_fd，可能不能在你的平台上实现。
如果不可用，使用它们将引发NotImplementedError。
10 rmdir(self)
kind=static method class=_NormalAccessor objtype=builtin_function_or_method line:1311 at …\pathlib.py
删除目录。
如果dir_fd不是None，它应该是一个打开到目录的文件描述符，path应该是相对的;Path将相对于该目录。
dir_fd可能无法在您的平台上实现。
如果不可用，使用它将引发NotImplementedError。
11 scandir()
kind=static method class=_NormalAccessor objtype=builtin_function_or_method
返回给定路径的DirEntry对象的迭代器。
Path可以指定为str、bytes或类路径对象。
如果path是字节，生成的DirEntry对象的名称也将是字节;在所有其他情况下，它们将是str。
如果path为None，则使用path='.'。
12 stat(self)
kind=static method class=_NormalAccessor objtype=builtin_function_or_method line:1178 at …\pathlib.py
在给定的路径上执行统计系统调用。
path 要检查的路径;可以是字符串，字节，路径类对象或 open-file-descriptor int。
dir_fd 如果不是None，它应该是打开到目录的文件描述符，path应该是一个相对字符串;Path将相对于该目录。
follow_symlinks 如果为False，路径的最后一个元素是符号链接，Stat将检查符号链接本身，而不是文件链接指向。
dir_fd和follow符号链接可能无法在您的平台上实现。
如果不可用，使用它们将引发NotImplementedError。
当指定path作为打开的文件描述符时，使用dir_fd或遵循符号链接是错误的。
13 symlink(a, b, target_is_directory)
kind=static method class=_NormalAccessor objtype=builtin_function_or_method line:431 at …\pathlib.py
创建一个指向名为dst的src的符号链接。
如果目标被解释为一个目录，在Windows上需要target_is_directory。
(在Windows上，symlink要求Windows 6.0或更高版本，否则会引发NotImplementedError。)
目标的目录在非Windows平台上被忽略。如果dir_fd不是None，它应该是一个打开到目录的文件描述符，path应该是相对的;Path将相对于该目录。
dir_fd可能无法在您的平台上实现。
如果不可用，使用它将引发NotImplementedError。
14 unlink(self)
kind=static method class=_NormalAccessor objtype=builtin_function_or_method line:1302 at …\pathlib.py
删除文件(与Remove()相同)。如果dir_fd不是None，它应该是一个打开到目录的文件描述符，path应该是相对的;Path将相对于该目录。
dir_fd可能无法在您的平台上实现。如果不可用，使用它将引发NotImplementedError。
15 utime()
kind=static method class=_NormalAccessor objtype=builtin_function_or_method
设置路径的访问和修改时间。
Path可以始终指定为字符串。
在某些平台上，path也可以指定为打开的文件描述符。
如果此功能不可用，则使用它将引发异常。
如果times为None且ns未指定，则utime使用当前时间。同时为times和ns指定元组是错误的。
如果dir_fd不是None，它应该是一个打开到目录的文件描述符，path应该是相对的;Path将相对于该目录。
如果follow symlinks为False，并且路径的最后一个元素是符号链接，则utime将修改符号链接本身，而不是链接指向的文件。
当指定path作为打开的文件描述符时，使用dir_fd或遵循符号链接是错误的。dir_fd和follow符号链接可能在您的平台上不可用。
如果不可用，使用它们将引发NotImplementedError。
28 pathlib._Selector
_Selector, pathlib._Selector, module=pathlib
选择器根据给定路径的子路径匹配特定的glob模式部分。
method
1 select_from(self, parent_path)
kind=method class=_Selector objtype=function line:483 at …\pathlib.py
遍历此选择器匹配的' parent_path '的所有子路径。它可以包含父路径本身。
29 pathlib._TerminatingSelector
_TerminatingSelector, pathlib._TerminatingSelector, module=pathlib
30 pathlib._PreciseSelector
_PreciseSelector, pathlib._PreciseSelector, module=pathlib
31 pathlib._WildcardSelector
_WildcardSelector, pathlib._WildcardSelector, module=pathlib
32 pathlib._RecursiveWildcardSelector
_RecursiveWildcardSelector, pathlib._RecursiveWildcardSelector, module=pathlib
33 pathlib._PathParents
_PathParents, pathlib._PathParents, module=pathlib
该对象提供了对路径的逻辑祖先的类似序列的访问。不要试图自己构建它。
34 pathlib.PurePath
PurePath, pathlib.PurePath, module=pathlib
在没有I/O的情况下操作路径的基类。
PurePath表示文件系统路径，并提供不包含任何实际文件系统I/O的操作。
根据您的系统，实例化PurePath将返回PurePosixPath或PureWindowsPath对象。
您也可以直接实例化这些类中的任何一个，而不管您的系统是什么。
property
1 anchor=
kind:property type:property class:
2 drive=kind:property type:property class:
3 name=kind:property type:property class:
4 parent=kind:property type:property class:
5 parents=kind:property type:property class:
6 parts=kind:property type:property class:
7 root=kind:property type:property class:
8 stem=kind:property type:property class:
9 suffix=kind:property type:property class:
10 suffixes=kind:property type:property class:
method
11 as_posix(self)
kind=method class=PurePath objtype=function line:722 at …\pathlib.py
返回路径的字符串表示形式，带有正斜杠(/)。
12 as_uri(self)
kind=method class=PurePath objtype=function line:736 at …\pathlib.py
返回路径为'file' URI。
13 is_absolute(self)
kind=method class=PurePath objtype=function line:945 at …\pathlib.py
如果路径是绝对路径(同时具有根和驱动器(如果适用的话)，则为True。
14 is_reserved(self)
kind=method class=PurePath objtype=function line:952 at …\pathlib.py
如果路径包含系统保留的一个特殊名称(如果有)，则返回True。
15 joinpath(self, *args)
kind=method class=PurePath objtype=function line:916 at …\pathlib.py
将此路径与一个或多个参数组合，并返回一个表示子路径(如果所有参数都是相对路径)或完全不同的路径(如果其中一个参数是锚定的)的新路径。
16 match(self, path_pattern)
kind=method class=PurePath objtype=function line:957 at …\pathlib.py
如果路径与给定模式匹配，则返回True。
17 relative_to(self, *other)
kind=method class=PurePath objtype=function line:872 at …\pathlib.py
返回由传递的参数标识的另一个路径的相对路径。
如果操作不可能(因为这不是另一个路径的子路径)，则引发ValueError。
18 with_name(self, name)
kind=method class=PurePath objtype=function line:840 at …\pathlib.py
返回一个更改了文件名的新路径。
19 with_suffix(self, suffix)
kind=method class=PurePath objtype=function line:851 at …\pathlib.py
返回一个更改了文件后缀的新路径。
如果路径没有后缀，则添加给定后缀。
如果给定的后缀为空字符串，则从路径中删除该后缀。
35 pathlib.PurePosixPath
PurePosixPath, pathlib.PurePosixPath, module=pathlib
非windows系统的PurePath子类。
在POSIX系统中，实例化PurePath应该返回该对象。
但是，您也可以直接在任何系统上实例化它。
36 pathlib.PureWindowsPath
PureWindowsPath, pathlib.PureWindowsPath, module=pathlib
Windows系统的PurePath子类。
在Windows系统上，实例化PurePath应该返回该对象。
但是，您也可以直接在任何系统上实例化它。
37 pathlib.Path
Path, pathlib.Path, module=pathlib
可以进行系统调用的PurePath子类。
Path表示文件系统路径，但与PurePath不同的是，它还提供了对路径对象进行系统调用的方法。
根据您的系统，实例化Path将返回PosixPath或WindowsPath对象。
您也可以直接实例化PosixPath或WindowsPath，但不能在POSIX系统上实例化WindowsPath，反之亦然。
method
1 absolute(self)
kind=method class=Path objtype=function line:1140 at …\pathlib.py
返回该路径的绝对版本。
即使路径不指向任何东西，该函数也可以工作。
没有进行归一化，即全部。'.'和'..'将被保存下来。使用resolve()获取文件的规范路径。
2 chmod(self, mode)
kind=method class=Path objtype=function line:1285 at …\pathlib.py
修改路径的权限，如os.chmod()。
3 exists(self)
kind=method class=Path objtype=function line:1356 at …\pathlib.py
该路径是否存在。
4 expanduser(self)
kind=method class=Path objtype=function line:1480 at …\pathlib.py
返回一个带有扩展的~和~user结构的新路径(由os.path.expanduser返回)
5 glob(self, pattern)
kind=method class=Path objtype=function line:1115 at …\pathlib.py
遍历此子树并生成与给定相对模式匹配的所有现有文件(任何类型的文件，包括目录)。
6 group(self)
kind=method class=Path objtype=function line:1192 at …\pathlib.py
返回文件gid的组名。
7 is_block_device(self)
kind=method class=Path objtype=function line:1428 at …\pathlib.py
该路径是否为块设备。
8 is_char_device(self)
kind=method class=Path objtype=function line:1441 at …\pathlib.py
此路径是否是字符设备。
9 is_dir(self)
kind=method class=Path objtype=function line:1368 at …\pathlib.py
该路径是否为目录。
10 is_fifo(self)
kind=method class=Path objtype=function line:1454 at …\pathlib.py
该路径是否为FIFO。
11 is_file(self)
kind=method class=Path objtype=function line:1381 at …\pathlib.py
此路径是否是常规文件(对于指向常规文件的符号链接也是True)。
12 is_mount(self)
kind=method class=Path objtype=function line:1395 at …\pathlib.py
检查此路径是否是POSIX挂载点
13 is_socket(self)
kind=method class=Path objtype=function line:1467 at …\pathlib.py
该路径是否为套接字。
14 is_symlink(self)
kind=method class=Path objtype=function line:1416 at …\pathlib.py
该路径是否是符号链接。
15 iterdir(self)
kind=method class=Path objtype=function line:1101 at …\pathlib.py
遍历此目录中的文件。对于特殊路径'.'和'..'不会产生任何结果。
16 lchmod(self, mode)
kind=method class=Path objtype=function line:1293 at …\pathlib.py
与chmod()类似，除非路径指向符号链接，否则符号链接的权限将被更改，而不是其目标的权限。
17 lstat(self)
kind=method class=Path objtype=function line:1319 at …\pathlib.py
与stat()类似，除非路径指向符号链接，否则将返回符号链接的状态信息，而不是其目标的状态信息。
18 mkdir(self, mode=0o777, parents=False, exist_ok=False)
kind=method class=Path objtype=function line:1266 at …\pathlib.py
在这个给定的路径上创建一个新目录。
19 open(self, mode=‘r’, buffering=-1, encoding=None,
kind=method class=Path objtype=function line:1199 at …\pathlib.py
打开该路径指向的文件并返回一个文件对象，就像内置的Open()函数所做的那样。
20 owner(self)
kind=method class=Path objtype=function line:1185 at …\pathlib.py
返回文件所有者的登录名。
21 read_bytes(self)
kind=method class=Path objtype=function line:1210 at …\pathlib.py
以字节模式打开文件，读取文件，然后关闭文件。
22 read_text(self, encoding=None, errors=None)
kind=method class=Path objtype=function line:1217 at …\pathlib.py
以文本模式打开文件，读取文件，然后关闭文件。
23 rename(self, target)
kind=method class=Path objtype=function line:1328 at …\pathlib.py
将此路径重命名为给定的路径。
24 replace(self, target)
kind=method class=Path objtype=function line:1336 at …\pathlib.py
将此路径重命名为给定路径，如果存在现有目标，则删除该目标。
25 resolve(self, strict=False)
kind=method class=Path objtype=function line:1158 at …\pathlib.py
将路径设置为绝对路径，解析路径上的所有符号链接，并将其规范化(例如在Windows下将斜杠转换为反斜杠)。
26 rglob(self, pattern)
kind=method class=Path objtype=function line:1128 at …\pathlib.py
递归生成与给定相对模式匹配的所有现有文件(任何类型，包括目录)，位于该子树的任何位置。
27 rmdir(self)
kind=method class=Path objtype=function line:1311 at …\pathlib.py
删除这个目录。目录必须为空。
28 samefile(self, other_path)
kind=method class=Path objtype=function line:1090 at …\pathlib.py
返回其他路径是否与此文件相同(由os.path.samefile()返回)。
29 stat(self)
kind=method class=Path objtype=function line:1178 at …\pathlib.py
返回此路径上的stat()系统调用的结果，就像os.stat()所做的那样。
30 symlink_to(self, target, target_is_directory=False)
kind=method class=Path objtype=function line:1345 at …\pathlib.py
使此路径为指向给定路径的符号链接。注意参数(self, target)的顺序与os.symlink的相反。
31 touch(self, mode=0o666, exist_ok=True)
kind=method class=Path objtype=function line:1243 at …\pathlib.py
如果该文件不存在，则使用给定的访问模式创建该文件。
32 unlink(self)
kind=method class=Path objtype=function line:1302 at …\pathlib.py
删除此文件或链接。如果路径是一个目录，则使用rmdir()。
33 write_bytes(self, data)
kind=method class=Path objtype=function line:1224 at …\pathlib.py
以字节模式打开文件，写入文件，然后关闭文件。
34 write_text(self, data, encoding=None, errors=None)
kind=method class=Path objtype=function line:1233 at …\pathlib.py
以文本模式打开文件，写入文件，然后关闭文件。
class method
35 cwd(cls)
kind=class method class=Path objtype=classmethod line:1077 at …\pathlib.py
classmethod(function) -> method转换函数为类方法。
36 home(cls)
kind=class method class=Path objtype=classmethod line:1084 at …\pathlib.py
classmethod(function) -> method
转换函数为类方法。
类方法接收类作为隐式的第一个参数，就像实例方法接收实例一样。
要声明一个类方法，请使用这个习惯用法:
class C:
@classmethod
def f(cls, arg1, arg2, ...):
...
class C: @classmethod def f(cls, arg1, arg2，…):
它可以在类上(例如C.f())或在实例上(例如C().f())被调用。除了它的类，实例将被忽略。
如果为派生类调用类方法，则派生类对象将作为隐含的第一个参数传递。类方法不同于c++或Java的静态方法。如果你想要这些，请查看内置的staticmethod。
38 pathlib.PosixPath
PosixPath, pathlib.PosixPath, module=pathlib
非windows系统的路径子类。在POSIX系统中，实例化Path应该返回此对象。
39 pathlib.WindowsPath
WindowsPath, pathlib.WindowsPath, module=pathlib
Windows系统的路径子类。在Windows系统上，实例化一个Path应该返回这个对象。
method
1 group(self)
kind=method class=WindowsPath objtype=function line:1509 at …\pathlib.py
2 is_mount(self)
kind=method class=WindowsPath objtype=function line:1512 at …\pathlib.py
3 owner(self)
kind=method class=WindowsPath objtype=function line:1506 at …\pathlib.py
内嵌函数或方法
40 S_ISDIR
41 S_ISLNK
42 S_ISREG
43 S_ISSOCK
44 S_ISBLK
45 S_ISCHR
46 S_ISFIFO
47 _getfinalpathname
私有或局部
48 _getfinalpathname
49 _IGNORED_ERROS (2, 20, 9, 10062)
50 _IGNORED_WINERRORS (21, 1921)
51 _ignore_error
52 _is_wildcard_pattern
53 _Flavour
54 _WindowsFlavour
55 _PosixFlavour
56 _windows_flavour
57 _posix_flavour
58 _Accessor
59 _NormalAccessor
60 _normal_accessor
61 _make_selector
62 _Selector
63 _TerminatingSelector
64 _PreciseSelector
65 _WildcardSelector
66 _RecursiveWildcardSelector
67 _PathParents
剩余
68 doc None
69 loader <_frozen_importlib_external.SourceFileLoader object at 0x0000000003343E88>
70 spec ModuleSpec(name=‘pathlib’, loader=<_frozen_importlib_external.SourceFileLoader object at 0x0000000003343E88>, origin=‘…\lib\pathlib.py’)
71 _windows_flavour
72 _posix_flavour
73 _normal_accessor
74 _make_selector
【fnmatch】
fnmatch, fullname=fnmatch, file=fnmatch.py
与shell模式匹配的文件名。
fnmatch(FILENAME, PATTERN)根据本地约定进行匹配。
fnmatchcase(FILENAME, PATTERN)总是考虑大小写。
这些函数通过将模式转换为正则表达式进行操作。它们缓存已编译的正则表达式以提高速度。
函数translate(PATTERN)返回一个与PATTERN对应的正则表达式。(它不编译它。)
统计
| 序号 | 类别 | 数量 |
|---|---|---|
| 4 | str | 5 |
| 6 | list | 1 |
| 8 | dict | 1 |
| 9 | module | 4 |
| 11 | function | 4 |
| 13 | residual | 3 |
| 14 | system | 9 |
| 15 | private | 1 |
| 16 | all | 18 |
常量
模块
1 os
os, fullname=os, file=os.py
2 posixpath
posixpath, fullname=posixpath, file=posixpath.py
Posix路径名的常用操作。不要直接导入这个模块，而是导入os并将这个模块引用为os.path。
3 re
re, fullname=re, file=re.py
4 functools
functools, fullname=functools, file=functools.py
函数
5 fnmatch(name, pat)
fnmatch(name, pat), module=fnmatch, line:19 at fnmatch.py
测试文件名是否匹配模式。
模式是Unix shell风格:
*匹配所有
?匹配任何单个字符
[seq]匹配seq
[!seq]匹配不在seq中
FILENAME中的初始句点不是特殊的。如果操作系统需要，FILENAME和PATTERN首先进行大小写规范化。
如果你不想要这个，使用fnmatchcase(FILENAME, PATTERN)。
6 filter(names, pat)
filter(names, pat), module=fnmatch, line:48 at fnmatch.py
返回与PAT匹配的列表NAMES的子集。
7 fnmatchcase(name, pat)
fnmatchcase(name, pat), module=fnmatch, line:64 at fnmatch.py
测试文件名是否与PATTERN匹配，包括大小写。这是fnmatch()的一个版本，它没有对参数进行大小写规范化。
8 translate(pat)
translate(pat), module=fnmatch, line:74 at fnmatch.py
将shell PATTERN转换为正则表达式。没有办法引用元角色。
私有或局部
9 _compile_pattern
剩余
10 loader <_frozen_importlib_external.SourceFileLoader object at 0x00000000032033C8>
11 spec ModuleSpec(name=‘fnmatch’, loader=<_frozen_importlib_external.SourceFileLoader object at 0x00000000032033C8>, origin=‘…\lib\fnmatch.py’)
12 _compile_pattern
【functools】
functools, fullname=functools, file=functools.py
【io】
io, fullname=io, file=io.py
【ntpath】
ntpath, fullname=ntpath, file=ntpath.py
【os】
os, fullname=os, file=os.py
【posixpath】
posixpath, fullname=posixpath, file=posixpath.py
Posix路径名的常用操作。不要直接导入这个模块，而是导入os并将这个模块引用为os.path。
统计
| 序号 | 类别 | 数量 |
|---|---|---|
| 2 | bool | 1 |
| 4 | str | 12 |
| 6 | list | 1 |
| 8 | dict | 1 |
| 9 | module | 4 |
| 11 | function | 31 |
| 13 | residual | 5 |
| 14 | system | 9 |
| 15 | private | 4 |
| 16 | all | 55 |
常量
bool
1 supports_unicode_filenames False
str
2 curdir .
3 pardir …
4 extsep .
5 sep /
6 pathsep :
7 defpath /bin:/usr/bin
8 devnull /dev/null
模块
9 os
os, fullname=os, file=os.py
10 sys
sys, fullname=sys, file=
11 stat
stat, fullname=stat, file=stat.py
12 genericpath
genericpath, fullname=genericpath, file=genericpath.py
多个操作系统共用的路径操作请勿直接使用。特定于操作系统的模块从该模块本身导入适当的函数。
函数
13 commonprefix(m)
commonprefix(m), module=genericpath, line:69 at genericpath.py
给定一个路径名列表，返回最长公共前导组件
14 exists(path)
exists(path), module=genericpath, line:16 at genericpath.py
测试路径是否存在。对于断开的符号链接返回False
15 getatime(filename)
getatime(filename), module=genericpath, line:58 at genericpath.py
返回文件的最后一次访问时间，由os.stat()报告。
16 getctime(filename)
getctime(filename), module=genericpath, line:63 at genericpath.py
返回由os.stat()报告的文件元数据更改时间。
17 getmtime(filename)
getmtime(filename), module=genericpath, line:53 at genericpath.py
返回文件的最后一次修改时间，由os.stat()报告。
18 getsize(filename)
getsize(filename), module=genericpath, line:48 at genericpath.py
返回文件的大小，由os.stat()报告。
19 isdir(s)
isdir(s), module=genericpath, line:39 at genericpath.py
如果路径名指向现有目录，则返回true。
20 isfile(path)
isfile(path), module=genericpath, line:27 at genericpath.py
测试路径是否为常规文件
21 samefile(f1, f2)
samefile(f1, f2), module=genericpath, line:94 at genericpath.py
测试两个路径名是否引用相同的实际文件或目录这由设备号和i-node号决定，如果对任意一个路径名的os.stat()调用失败将引发异常。
22 sameopenfile(fp1, fp2)
sameopenfile(fp1, fp2), module=genericpath, line:107 at genericpath.py
测试两个打开的文件对象是否引用同一个文件
23 samestat(s1, s2)
samestat(s1, s2), module=genericpath, line:87 at genericpath.py
测试两个统计缓冲区是否引用同一个文件
24 _get_sep(path)
_get_sep(path), module=posixpath, line:41 at posixpath.py
25 normcase(s)
normcase(s), module=posixpath, line:52 at posixpath.py
规范化路径名的大小写。在Posix下没有效果
26 isabs(s)
isabs(s), module=posixpath, line:64 at posixpath.py
测试路径是否为绝对路径
27 join(a, *p)
join(a, *p), module=posixpath, line:75 at posixpath.py
连接两个或多个路径名组件，根据需要插入'/'。
如果任何组件是绝对路径，则之前的所有路径组件将被丢弃。
空的最后一部分将导致以分隔符结束的路径。
28 split§
split§, module=posixpath, line:104 at posixpath.py
拆分路径名。返回元组“(head, tail)”，其中“tail”是最后一个斜杠之后的所有内容。任何一部分都可能是空的。
29 splitext§
splitext§, module=posixpath, line:121 at posixpath.py
从路径名中分离扩展名。扩展是从最后一个点到最后一个点，忽略前面的点。返回“(root, ext)”;Ext可能为空。
30 splitdrive§
splitdrive§, module=posixpath, line:135 at posixpath.py
将路径名拆分为驱动器和路径。在Posix上，驱动器总是空的。
31 basename§
basename§, module=posixpath, line:144 at posixpath.py
返回路径名的最后一个组件
32 dirname§
dirname§, module=posixpath, line:154 at posixpath.py
返回路径名的目录组件
33 islink(path)
islink(path), module=posixpath, line:168 at posixpath.py
测试路径是否为符号链接
34 lexists(path)
lexists(path), module=posixpath, line:178 at posixpath.py
测试路径是否存在。对于损坏的符号链接返回True
35 ismount(path)
ismount(path), module=posixpath, line:190 at posixpath.py
测试路径是否为挂载点
36 expanduser(path)
expanduser(path), module=posixpath, line:232 at posixpath.py
展开~和~user结构。如果user或$HOME未知，什么都不做。
37 expandvars(path)
expandvars(path), module=posixpath, line:285 at posixpath.py
展开$var和${var}形式的shell变量。未知变量保持不变。
38 normpath(path)
normpath(path), module=posixpath, line:338 at posixpath.py
正常化路径，消除双斜杠等。
39 abspath(path)
abspath(path), module=posixpath, line:376 at posixpath.py
返回一个绝对路径。
40 realpath(filename)
realpath(filename), module=posixpath, line:391 at posixpath.py
返回指定文件名的规范路径，消除路径中遇到的任何符号链接。
41 _joinrealpath(path, rest, seen)
_joinrealpath(path, rest, seen), module=posixpath, line:400 at posixpath.py
42 relpath(path, start=None)
relpath(path, start=None), module=posixpath, line:453 at posixpath.py
返回路径的相对版本
43 commonpath(paths)
commonpath(paths), module=posixpath, line:494 at posixpath.py
给定一个路径名称序列，返回最长公共子路径。
私有或局部
44 _get_sep
45 _varprog None
46 _varprogb None
47 _joinrealpath
剩余
48 loader <_frozen_importlib_external.SourceFileLoader object at 0x00000000030F4188>
49 spec ModuleSpec(name=‘posixpath’, loader=<_frozen_importlib_external.SourceFileLoader object at 0x00000000030F4188>, origin=‘…\lib\posixpath.py’)
50 altsep None
51 _varprog None
52 _varprogb None
【re】
re, fullname=re, file=re.py
【sys】
sys, fullname=sys, file=
【nt】
nt, fullname=nt, file=