The Python Library Reference

【实例简介】Python 3.7.4官方实例 中文版

【实例截图】

【核心代码】Contents
1 概述 3
1.1 可用性注释 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
2 内置函数 5
3 内置常量 25
3.1 由 site 模块添加的常量 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
4 内置类型 27
4.1 逻辑值检测 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
4.2 布尔运算 — and, or, not . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
4.3 比较 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
4.4 数字类型 — int, float, complex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
4.5 迭代器类型 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
4.6 序列类型 — list, tuple, range . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
4.7 文本序列类型 — str . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
4.8 二进制序列类型 — bytes, bytearray, memoryview . . . . . . . . . . . . . . . . . . . . . . 49
4.9 集合类型 — set, frozenset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
4.10 映射类型 — dict . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
4.11 上下文管理器类型 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
4.12 其他内置类型 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
4.13 特殊属性 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
5 内置异常 79
5.1 基类 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
5.2 具体异常 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
5.3 警告 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
5.4 异常层次结构 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
6 文本处理服务 89
6.1 string — 常见的字符串操作 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
6.2 re — 正则表达式操作 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
6.3 difflib — 计算差异的辅助工具 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
6.4 textwrap — 文本自动换行与填充 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
6.5 unicodedata — Unicode 数据库 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
6.6 stringprep — 因特网字符串预备 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
6.7 readline — GNU readline 接口 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
i
6.8 rlcompleter — GNU readline 的补全函数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
7 二进制数据服务 139
7.1 struct — 将字节串解读为打包的二进制数据 . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
7.2 codecs — 编解码器注册和相关基类 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
8 数据类型 161
8.1 datetime — 基础日期和时间数据类型 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
8.2 calendar — 日历相关函数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
8.3 collections — 容器数据类型 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
8.4 collections.abc — 容器的抽象基类 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
8.5 heapq — 堆队列算法 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
8.6 bisect — 数组二分查找算法 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
8.7 array — Efficient arrays of numeric values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
8.8 weakref — 弱引用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
8.9 types — Dynamic type creation and names for built-in types . . . . . . . . . . . . . . . . . . . . . 232
8.10 copy — 浅层 (shallow) 和深层 (deep) 复制操作 . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
8.11 pprint — 数据美化输出 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
8.12 reprlib — Alternate repr() implementation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
8.13 enum — Support for enumerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
9 数字和数学模块 263
9.1 numbers — 数字的抽象基类 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
9.2 math — 数学函数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
9.3 cmath ——关于复数的数学函数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
9.4 decimal — 十进制定点和浮点运算 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
9.5 fractions — 分数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300
9.6 random — 生成伪随机数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
9.7 statistics — Mathematical statistics functions . . . . . . . . . . . . . . . . . . . . . . . . . . . 309
10 函数式编程模块 315
10.1 itertools — 为高效循环而创建迭代器的函数 . . . . . . . . . . . . . . . . . . . . . . . . . . 315
10.2 functools — 高阶函数和可调用对象上的操作 . . . . . . . . . . . . . . . . . . . . . . . . . . 329
10.3 operator — 标准运算符替代函数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
11 文件和目录访问 343
11.1 pathlib — 面向对象的文件系统路径 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343
11.2 os.path — 常见路径操作 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359
11.3 fileinput — Iterate over lines from multiple input streams . . . . . . . . . . . . . . . . . . . . . 364
11.4 stat — Interpreting stat() results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366
11.5 filecmp — 文件及目录的比较 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371
11.6 tempfile — Generate temporary files and directories . . . . . . . . . . . . . . . . . . . . . . . . . 373
11.7 glob — Unix style pathname pattern expansion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 377
11.8 fnmatch — Unix filename pattern matching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378
11.9 linecache — Random access to text lines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379
11.10 shutil — High-level file operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380
11.11 macpath — Mac OS 9 路径操作函数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388
12 数据持久化 389
12.1 pickle ——Python 对象序列化 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389
12.2 copyreg — Register pickle support functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402
12.3 shelve — Python object persistence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402
12.4 marshal — Internal Python object serialization . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405
12.5 dbm — Interfaces to Unix ”databases” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406
12.6 sqlite3 — SQLite 数据库 DB-API 2.0 接口模块 . . . . . . . . . . . . . . . . . . . . . . . . . . 410
ii
13 数据压缩和存档 433
13.1 zlib — 与 gzip 兼容的压缩 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433
13.2 gzip — 对 gzip 格式的支持 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436
13.3 bz2 — 对 bzip2 压缩算法的支持 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439
13.4 lzma — 用 LZMA 算法压缩 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443
13.5 zipfile — 使用 ZIP 存档 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 448
13.6 tarfile — 读写 tar 归档文件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456
14 文件格式 467
14.1 csv — CSV 文件读写 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467
14.2 configparser — Configuration file parser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473
14.3 netrc — netrc file processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 490
14.4 xdrlib — Encode and decode XDR data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 491
14.5 plistlib — Generate and parse Mac OS X .plist files . . . . . . . . . . . . . . . . . . . . . . 494
15 加密服务 499
15.1 hashlib — 安全哈希与消息摘要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 499
15.2 hmac — 基于密钥的消息验证 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 509
15.3 secrets — Generate secure random numbers for managing secrets . . . . . . . . . . . . . . . . . . 511
16 通用操作系统服务 515
16.1 os — 操作系统接口模块 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 515
16.2 io — 处理流的核心工具 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 562
16.3 time — 时间的访问和转换 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 574
16.4 argparse — 命令行选项、参数和子命令解析器 . . . . . . . . . . . . . . . . . . . . . . . . . . 583
16.5 getopt — C-style parser for command line options . . . . . . . . . . . . . . . . . . . . . . . . . . 613
16.6 模块 logging — Python 的日志记录工具 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 615
16.7 logging.config — 日志记录配置 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 631
16.8 logging.handlers — Logging handlers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 641
16.9 getpass — 便携式密码输入工具 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 653
16.10 curses — 终端字符单元显示的处理 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 654
16.11 curses.textpad — Text input widget for curses programs . . . . . . . . . . . . . . . . . . . . . 671
16.12 curses.ascii — Utilities for ASCII characters . . . . . . . . . . . . . . . . . . . . . . . . . . . 673
16.13 curses.panel — A panel stack extension for curses . . . . . . . . . . . . . . . . . . . . . . . . . 675
16.14 platform — 获取底层平台的标识数据 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 676
16.15 errno — Standard errno system symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 679
16.16 ctypes — Python 的外部函数库 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 685
17 并发执行 719
17.1 threading — 基于线程的并行 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 719
17.2 multiprocessing — 基于进程的并行 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 730
17.3 concurrent 包 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 771
17.4 concurrent.futures — 启动并行任务 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 772
17.5 subprocess — 子进程管理 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 777
17.6 sched — 事件调度器 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 794
17.7 queue — 一个同步的队列类 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 795
17.8 _thread — 底层多线程 API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 799
17.9 _dummy_thread — _thread 的替代模块 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 800
17.10 dummy_threading — 可直接替代 threading 模块。 . . . . . . . . . . . . . . . . . . . . . 801
18 contextvars — Context Variables 803
18.1 Context Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 803
18.2 Manual Context Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 804
18.3 asyncio support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 806
iii
19 网络和进程间通信 809
19.1 asyncio — 异步 I/O . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 809
19.2 socket — 底层网络接口 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 890
19.3 ssl — TLS/SSL wrapper for socket objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 912
19.4 select — Waiting for I/O completion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 947
19.5 selectors — 高级 I/O 复用库 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 954
19.6 asyncore — 异步 socket 处理器 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 957
19.7 asynchat — 异步 socket 指令/响应处理器 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 962
19.8 signal — 设置异步事件处理程序 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 964
19.9 mmap — 内存映射文件支持 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 970
20 互联网数据处理 975
20.1 email — 电子邮件与 MIME 处理包 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 975
20.2 json — JSON 编码和解码器 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1032
20.3 mailcap — Mailcap file handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1041
20.4 mailbox — Manipulate mailboxes in various formats . . . . . . . . . . . . . . . . . . . . . . . . . 1042
20.5 mimetypes — Map filenames to MIME types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1060
20.6 base64 — Base16, Base32, Base64, Base85 数据编码 . . . . . . . . . . . . . . . . . . . . . . . . 1062
20.7 binhex — 对 binhex4 文件进行编码和解码 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1065
20.8 binascii — 二进制和 ASCII 码互转 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1066
20.9 quopri — Encode and decode MIME quoted-printable data . . . . . . . . . . . . . . . . . . . . . . 1068
20.10 uu — Encode and decode uuencode files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1068
21 结构化标记处理工具 1071
21.1 html — 超文本标记语言支持 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1071
21.2 html.parser — 简单的 HTML 和 XHTML 解析器 . . . . . . . . . . . . . . . . . . . . . . . . 1072
21.3 html.entities — HTML 一般实体的定义 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1076
21.4 XML 处理模块 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1076
21.5 xml.etree.ElementTree — The ElementTree XML API . . . . . . . . . . . . . . . . . . . . 1078
21.6 xml.dom — The Document Object Model API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1093
21.7 xml.dom.minidom — Minimal DOM implementation . . . . . . . . . . . . . . . . . . . . . . . . 1104
21.8 xml.dom.pulldom — Support for building partial DOM trees . . . . . . . . . . . . . . . . . . . 1108
21.9 xml.sax — Support for SAX2 parsers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1110
21.10 xml.sax.handler — Base classes for SAX handlers . . . . . . . . . . . . . . . . . . . . . . . . 1111
21.11 xml.sax.saxutils — SAX Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1116
21.12 xml.sax.xmlreader — Interface for XML parsers . . . . . . . . . . . . . . . . . . . . . . . . . 1117
21.13 xml.parsers.expat — Fast XML parsing using Expat . . . . . . . . . . . . . . . . . . . . . . 1121
22 互联网协议和支持 1131
22.1 webbrowser — 方便的 Web 浏览器控制器 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1131
22.2 cgi — Common Gateway Interface support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1134
22.3 cgitb — Traceback manager for CGI scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1140
22.4 wsgiref — WSGI Utilities and Reference Implementation . . . . . . . . . . . . . . . . . . . . . . 1141
22.5 urllib — URL 处理模块 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1150
22.6 urllib.request — 用于打开 URL 的可扩展库 . . . . . . . . . . . . . . . . . . . . . . . . . . 1151
22.7 urllib.response — urllib 使用的 Response 类 . . . . . . . . . . . . . . . . . . . . . . . . . . 1168
22.8 urllib.parse — Parse URLs into components . . . . . . . . . . . . . . . . . . . . . . . . . . . 1169
22.9 urllib.error — urllib.request 引发的异常类 . . . . . . . . . . . . . . . . . . . . . . . . . . . 1176
22.10 urllib.robotparser — robots.txt 语法分析程序 . . . . . . . . . . . . . . . . . . . . . . . . 1177
22.11 http — HTTP 模块 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1178
22.12 http.client — HTTP 协议客户端 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1180
22.13 ftplib — FTP protocol client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1186
22.14 poplib — POP3 protocol client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1191
22.15 imaplib — IMAP4 protocol client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1194
iv
22.16 nntplib — NNTP protocol client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1200
22.17 smtplib —SMTP 协议客户端 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1207
22.18 smtpd — SMTP Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1214
22.19 telnetlib — Telnet client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1217
22.20 uuid — UUID objects according to RFC 4122 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1220
22.21 socketserver — A framework for network servers . . . . . . . . . . . . . . . . . . . . . . . . . 1223
22.22 http.server — HTTP 服务器 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1231
22.23 http.cookies — HTTP state management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1237
22.24 http.cookiejar — Cookie handling for HTTP clients . . . . . . . . . . . . . . . . . . . . . . . 1240
22.25 xmlrpc — XMLRPC 服务端与客户端模块 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1249
22.26 xmlrpc.client — XML-RPC client access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1249
22.27 xmlrpc.server — Basic XML-RPC servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1257
22.28 ipaddress — IPv4/IPv6 manipulation library . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1263
23 多媒体服务 1277
23.1 audioop — Manipulate raw audio data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1277
23.2 aifc — Read and write AIFF and AIFC files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1280
23.3 sunau — 读写 Sun AU 文件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1282
23.4 wave — 读写 WAV 格式文件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1285
23.5 chunk — Read IFF chunked data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1288
23.6 colorsys — 颜色系统间的转换 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1289
23.7 imghdr — 推测图像类型 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1290
23.8 sndhdr — 推测声音文件的类型 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1291
23.9 ossaudiodev — Access to OSS-compatible audio devices . . . . . . . . . . . . . . . . . . . . . . 1291
24 国际化 1297
24.1 gettext — 多语种国际化服务 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1297
24.2 locale — 国际化服务 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1305
25 程序框架 1313
25.1 turtle — 海龟绘图 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1313
25.2 cmd — 支持面向行的命令解释器 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1346
25.3 shlex — Simple lexical analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1351
26 Tk 图形用户界面 (GUI) 1357
26.1 tkinter — Tcl/Tk 的 Python 接口 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1357
26.2 tkinter.ttk — Tk themed widgets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1368
26.3 tkinter.tix — Extension widgets for Tk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1386
26.4 tkinter.scrolledtext — 滚动文字控件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1391
26.5 IDLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1391
26.6 其他图形用户界面（GUI）包 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1401
27 开发工具 1403
27.1 typing — 类型标注支持 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1403
27.2 pydoc — Documentation generator and online help system . . . . . . . . . . . . . . . . . . . . . . . 1419
27.3 doctest — 测试交互性的 Python 示例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1421
27.4 unittest — 单元测试框架 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1444
27.5 unittest.mock — mock object library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1472
27.6 unittest.mock 上手指南 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1507
27.7 2to3 - 自动将 Python 2 代码转为 Python 3 代码 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1527
27.8 test — Regression tests package for Python . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1532
27.9 test.support — Utilities for the Python test suite . . . . . . . . . . . . . . . . . . . . . . . . . . 1535
27.10 test.support.script_helper — Utilities for the Python execution tests . . . . . . . . . . . 1546
28 调试和分析 1549
v
28.1 bdb — Debugger framework . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1549
28.2 faulthandler — Dump the Python traceback . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1553
28.3 pdb — Python 的调试器 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1556
28.4 The Python Profilers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1562
28.5 timeit — 测量小代码片段的执行时间 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1570
28.6 trace — Trace or track Python statement execution . . . . . . . . . . . . . . . . . . . . . . . . . . 1575
28.7 tracemalloc — Trace memory allocations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1577
29 软件打包和分发 1587
29.1 distutils — 构建和安装 Python 模块 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1587
29.2 ensurepip — Bootstrapping the pip installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1588
29.3 venv — 创建虚拟环境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1589
29.4 zipapp — Manage executable Python zip archives . . . . . . . . . . . . . . . . . . . . . . . . . . . 1598
30 Python 运行时服务 1605
30.1 sys — 系统相关的参数和函数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1605
30.2 sysconfig — Provide access to Python’s configuration information . . . . . . . . . . . . . . . . . 1623
30.3 builtins — 内建对象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1626
30.4 __main__ — 顶层脚本环境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1627
30.5 warnings — Warning control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1627
30.6 dataclasses — 数据类 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1633
30.7 contextlib — Utilities for with-statement contexts . . . . . . . . . . . . . . . . . . . . . . . . 1641
30.8 abc — 抽象基类 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1653
30.9 atexit — 退出处理器 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1658
30.10 traceback — 打印或检索堆栈回溯 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1659
30.11 __future__ — Future 语句定义 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1665
30.12 gc — 垃圾回收器接口 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1667
30.13 inspect — 检查对象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1670
30.14 site — Site-specific configuration hook . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1685
31 自定义 Python 解释器 1689
31.1 code — Interpreter base classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1689
31.2 codeop — 编译 Python 代码 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1691
32 导入模块 1693
32.1 zipimport — Import modules from Zip archives . . . . . . . . . . . . . . . . . . . . . . . . . . . 1693
32.2 pkgutil — Package extension utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1695
32.3 modulefinder — 查找脚本使用的模块 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1697
32.4 runpy — Locating and executing Python modules . . . . . . . . . . . . . . . . . . . . . . . . . . . 1699
32.5 importlib — import 的实现 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1701
33 Python 语言服务 1721
33.1 parser — Access Python parse trees . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1721
33.2 ast — 抽象语法树 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1725
33.3 symtable — Access to the compiler’s symbol tables . . . . . . . . . . . . . . . . . . . . . . . . . . 1730
33.4 symbol — 与 Python 解析树一起使用的常量 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1733
33.5 token — 与 Python 解析树一起使用的常量 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1733
33.6 keyword — 检验 Python 关键字 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1735
33.7 tokenize — Tokenizer for Python source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1735
33.8 tabnanny — 模糊缩进检测 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1738
33.9 pyclbr — Python class browser support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1739
33.10 py_compile — Compile Python source files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1741
33.11 compileall — Byte-compile Python libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1742
33.12 dis — Python 字节码反汇编器 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1745
33.13 pickletools — Tools for pickle developers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1759
vi
34 杂项服务 1761
34.1 formatter — Generic output formatting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1761
35 Windows 系统相关模块 1767
35.1 msilib — Read and write Microsoft Installer files . . . . . . . . . . . . . . . . . . . . . . . . . . . 1767
35.2 msvcrt — Useful routines from the MS VC runtime . . . . . . . . . . . . . . . . . . . . . . . . 1773
35.3 winreg — Windows 注册表访问 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1774
35.4 winsound — Sound-playing interface for Windows . . . . . . . . . . . . . . . . . . . . . . . . . . 1782
36 Unix 专有服务 1785
36.1 posix — The most common POSIX system calls . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1785
36.2 pwd — 用户密码数据库 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1786
36.3 spwd — The shadow password database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1787
36.4 grp — The group database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1788
36.5 crypt — Function to check Unix passwords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1788
36.6 termios — POSIX style tty control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1790
36.7 tty — 终端控制功能 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1792
36.8 pty — Pseudo-terminal utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1792
36.9 fcntl — The fcntl and ioctl system calls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1793
36.10 pipes — Interface to shell pipelines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1795
36.11 resource — Resource usage information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1796
36.12 nis — Interface to Sun’s NIS (Yellow Pages) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1800
36.13 Unix syslog 库例程 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1801
37 被取代的模块 1803
37.1 optparse — Parser for command line options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1803
37.2 imp — Access the import internals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1829
38 未创建文档的模块 1835
38.1 平台特定模块 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1835
A 术语对照表 1837
B 文档说明 1849
B.1 Python 文档贡献者 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1849
C 历史和许可证 1851
C.1 该软件的历史 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1851
C.2 获取或以其他方式使用 Python 的条款和条件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1852
C.3 被收录软件的许可证与鸣谢 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1855
D 版权 1867
Bibliography 1869
Python 模块索引 1871
索引 1875
vi