一图看懂 pathlib 模块：面向对象的文件系统路径, 资料整理+笔记（大全）

本文由 大侠(AhcaoZhu)原创，转载请声明。
链接: https://blog.csdn.net/Ahcao2008

摘要

全文介绍系统内置 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.Sequencepathlib._PathParents◆functools._lru_cache_wrapper◆functools.partial◆functools.partialmethod◆list◆functools._HashedSeq◆nt.DirEntry◆operator.attrgetter◆os._wrap_closepathlib.PurePathpathlib.Pathpathlib.PosixPathpathlib.WindowsPathpathlib.PurePosixPathpathlib.Pathpathlib.PureWindowsPathpathlib.Pathpathlib._Accessorpathlib._NormalAccessorpathlib._Flavourpathlib._PosixFlavourpathlib._WindowsFlavourpathlib._Selectorpathlib._PreciseSelectorpathlib._RecursiveWildcardSelectorpathlib._WildcardSelectorpathlib._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:<class ‘pathlib._WindowsFlavour’>
2 drive_letters={‘d’, ‘e’, ‘t’, ‘s’, ‘o’, ‘x’, ‘h’, ‘H’, ‘a’, ‘S’, ‘E’, ‘I’, ‘C’, ‘f’, ‘A’, ‘U’,… kind:data type:set class:<class ‘pathlib._WindowsFlavour’>
3 ext_namespace_prefix=\?\ kind:data type:str class:<class ‘pathlib._WindowsFlavour’>
4 has_drv=True kind:data type:bool class:<class ‘pathlib._WindowsFlavour’>
5 is_supported=True kind:data type:bool class:<class ‘pathlib._WindowsFlavour’>
6 pathmod=<module ‘ntpath’ from ‘…\lib\ntpath.py’> kind:data type:module class:<class ‘pathlib._WindowsFlavour’>
7 reserved_names={‘PRN’, ‘COM3’, ‘AUX’, ‘LPT6’, ‘COM6’, ‘CON’, ‘LPT3’, ‘LPT8’, ‘COM1’, ‘LPT2’, 'L… kind:data type:set class:<class ‘pathlib._WindowsFlavour’>
8 sep=\ kind:data type:str class:<class ‘pathlib._WindowsFlavour’>

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:<class ‘pathlib._PosixFlavour’>
2 has_drv=False kind:data type:bool class:<class ‘pathlib._PosixFlavour’>
3 is_supported=False kind:data type:bool class:<class ‘pathlib._PosixFlavour’>
4 pathmod=<module ‘posixpath’ from ‘…\lib\posixpath.py’> kind:data type:module class:<class ‘pathlib._PosixFlavour’>
5 sep=/ kind:data type:str class:<class ‘pathlib._PosixFlavour’>

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=<property object at 0x000000000336E048> kind:property type:property class:<class ‘pathlib.PurePath’>
2 drive=<property object at 0x0000000003367F48> kind:property type:property class:<class ‘pathlib.PurePath’>
3 name=<property object at 0x000000000336E098> kind:property type:property class:<class ‘pathlib.PurePath’>
4 parent=<property object at 0x000000000336E228> kind:property type:property class:<class ‘pathlib.PurePath’>
5 parents=<property object at 0x000000000336E278> kind:property type:property class:<class ‘pathlib.PurePath’>
6 parts=<property object at 0x000000000336E1D8> kind:property type:property class:<class ‘pathlib.PurePath’>
7 root=<property object at 0x0000000003367F98> kind:property type:property class:<class ‘pathlib.PurePath’>
8 stem=<property object at 0x000000000336E188> kind:property type:property class:<class ‘pathlib.PurePath’>
9 suffix=<property object at 0x000000000336E0E8> kind:property type:property class:<class ‘pathlib.PurePath’>
10 suffixes=<property object at 0x000000000336E138> kind:property type:property class:<class ‘pathlib.PurePath’>

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:@classmethoddef 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 <function _ignore_error at 0x0000000003344048>
52 _is_wildcard_pattern <function _is_wildcard_pattern at 0x0000000003344CA8>
53 _Flavour <class ‘pathlib._Flavour’>
54 _WindowsFlavour <class ‘pathlib._WindowsFlavour’>
55 _PosixFlavour <class ‘pathlib._PosixFlavour’>
56 _windows_flavour <pathlib._WindowsFlavour object at 0x0000000003363988>
57 _posix_flavour <pathlib._PosixFlavour object at 0x00000000033639C8>
58 _Accessor <class ‘pathlib._Accessor’>
59 _NormalAccessor <class ‘pathlib._NormalAccessor’>
60 _normal_accessor <pathlib._NormalAccessor object at 0x0000000003363AC8>
61 _make_selector <functools._lru_cache_wrapper object at 0x000000000333AEA8>
62 _Selector <class ‘pathlib._Selector’>
63 _TerminatingSelector <class ‘pathlib._TerminatingSelector’>
64 _PreciseSelector <class ‘pathlib._PreciseSelector’>
65 _WildcardSelector <class ‘pathlib._WildcardSelector’>
66 _RecursiveWildcardSelector <class ‘pathlib._RecursiveWildcardSelector’>
67 _PathParents <class ‘pathlib._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 <pathlib._WindowsFlavour object at 0x0000000003363988>
72 _posix_flavour <pathlib._PosixFlavour object at 0x00000000033639C8>
73 _normal_accessor <pathlib._NormalAccessor object at 0x0000000003363AC8>
74 _make_selector <functools._lru_cache_wrapper object at 0x000000000333AEA8>

【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 <functools._lru_cache_wrapper object at 0x00000000032012C8>

剩余

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._lru_cache_wrapper object at 0x00000000032012C8>

【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 <function _get_sep at 0x00000000030EBAF8>
45 _varprog None
46 _varprogb None
47 _joinrealpath <function _joinrealpath at 0x00000000030F9678>

剩余

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=