Python 标准库 ¶

While Python 语言参考 描述 Python 语言的精确句法及语义，此库参考手册描述随 Python 分发的标准库。它还描述 Python 分发通常包括的一些可选组件。

Python 标准库很广泛，提供如下文长内容表所示的各种设施。库包含提供访问系统功能的内置模块 (以 C 编写，譬如：文件 I/O，否则 Python 程序员将无法访问这些功能)，及为日常编程出现的许多问题提供标准化解决方案，以 Python 编写的模块。其中一些模块被明确设计为鼓励和增强 Python 程序的可移植性，通过将特定平台抽象成平台中立 API。

Windows 平台 Python 安装程序通常包括整个标准库，且经常还包括许多其它组件。对于像 Unix 操作系统通常将 Python 提供作为包集合，因此可能有必要使用操作系统附带的打包工具来获取部分或全部可选组件。

除标准库外，还有不断增长由数千个组件组成的集合 (从单独的程序和模块到包，及整个应用程序开发框架)，可以获得从 PyPI (Python 包索引) .

• 1. 介绍
• 2. 内置函数
• 3. 非必需内置函数
• 4. 内置常量
  • 4.1. 常量的添加通过 site 模块
• 5. 内置类型
  • 5.1. 真值测试
  • 5.2. 布尔运算 — and , or , not
  • 5.3. 比较
  • 5.4. 数值类型 — int , float , long , complex
  • 5.5. 迭代器类型
  • 5.6. 序列类型 — str , unicode , list , tuple , bytearray , buffer , xrange
  • 5.7. 集类型 — set , frozenset
  • 5.8. 映射类型 — dict
  • 5.9. 文件对象
  • 5.10. memoryview 类型
  • 5.11. 上下文管理器类型
  • 5.12. 其它内置类型
  • 5.13. 特殊属性
• 6. 内置异常
  • 6.1. 异常层次结构
• 7. 字符串服务
  • 7.1. string — 常见字符串操作
  • 7.2. re — 正则表达式运算
  • 7.3. struct — 把字符串解释为打包二进制数据
  • 7.4. difflib — 增量计算帮手
  • 7.5. StringIO — 按文件方式读写字符串
  • 7.6. cStringIO — 更快版本的 StringIO
  • 7.7. textwrap — 文字换行和填充
  • 7.8. codecs — 编解码器注册和基类
  • 7.9. unicodedata — Unicode 数据库
  • 7.10. stringprep — 互联网字符串预备
  • 7.11. fpformat — 浮点转换
• 8. 数据类型
  • 8.1. datetime — 基本日期和时间类型
  • 8.2. calendar — 一般日历相关函数
  • 8.3. collections — 高性能容器数据类型
  • 8.4. heapq — 堆队列算法
  • 8.5. bisect — 数组二分算法
  • 8.6. array — 高效数值数组
  • 8.7. sets — 唯一元素的无序集合
  • 8.8. sched — 事件调度器
  • 8.9. mutex — 相互排斥支持
  • 8.10. Queue — 同步队列类
  • 8.11. weakref — 弱引用
  • 8.12. UserDict — 字典对象的类包裹器
  • 8.13. UserList — 列表对象的类包裹器
  • 8.14. UserString — 字符串对象的类包裹器
  • 8.15. types — 内置类型的名称
  • 8.16. new — 创建运行时内部对象
  • 8.17. copy — 浅拷贝和深拷贝操作
  • 8.18. pprint — 数据美化打印机
  • 8.19. repr — 替代 repr() 实现
• 9. 数值和数学模块
  • 9.1. numbers — 数值抽象基类
  • 9.2. math — 数学函数
  • 9.3. cmath — 用于复数的数学函数
  • 9.4. decimal — 十进制定点和浮点算术
  • 9.5. fractions — 有理数
  • 9.6. random — 生成伪随机数
  • 9.7. itertools — 创建高效循环迭代器的函数
  • 9.8. functools — 可调用对象的高阶函数和操作
  • 9.9. operator — 作为函数的标准运算符
• 10. 文件和目录访问
  • 10.1. os.path — 常见路径名操纵
  • 10.2. fileinput — 遍历来自多个输入流的行
  • 10.3. stat — 解释 stat() 结果
  • 10.4. statvfs — 常量用于 os.statvfs()
  • 10.5. filecmp — 文件和目录比较
  • 10.6. tempfile — 生成临时文件和目录
  • 10.7. glob — Unix 风格路径名模式扩展
  • 10.8. fnmatch — Unix 文件名模式匹配
  • 10.9. linecache — 随机访问文本行
  • 10.10. shutil — 高级文件操作
  • 10.11. dircache — 缓存目录列表
  • 10.12. macpath — Mac OS 9 路径操纵函数
• 11. 数据持久性
  • 11.1. pickle — Python 对象序列化
  • 11.2. cPickle — 更快 pickle
  • 11.3. copy_reg — 注册 pickle 支持函数
  • 11.4. shelve — Python 对象持久性
  • 11.5. marshal — 内部 Python 对象序列化
  • 11.6. anydbm — 对 DBM 样式数据库的一般访问
  • 11.7. whichdb — 猜测哪个 DBM 模块创建数据库
  • 11.8. dbm — 简单数据库接口
  • 11.9. gdbm — dbm 的 GNU 重新解释
  • 11.10. dbhash — DBM 样式 BSD 数据库的库接口
  • 11.11. bsddb — 接口到 Berkeley DB 库
  • 11.12. dumbdbm — 便携式 DBM 实施
  • 11.13. sqlite3 — SQLite 数据库的 DB-API 2.0 接口
• 12. 数据压缩和存档
  • 12.1. zlib — 压缩兼容 gzip
  • 12.2. gzip — 支持 gzip 文件
  • 12.3. bz2 — 压缩兼容 bzip2
  • 12.4. zipfile — 操控 ZIP 存档
  • 12.5. tarfile — 读写 tar 存档文件
• 13. 文件格式
  • 13.1. csv — CSV (逗号分隔值) 文件读写
  • 13.2. ConfigParser — 配置文件剖析器
  • 13.3. robotparser — robots.txt 剖析器
  • 13.4. netrc — netrc 文件处理
  • 13.5. xdrlib — 编码和解码 XDR 数据
  • 13.6. plistlib — 生成和剖析 Mac OS X .plist 文件
• 14. 加密服务
  • 14.1. hashlib — 安全哈希和消息摘要
  • 14.2. hmac — 用于消息身份验证的键哈希
  • 14.3. md5 — MD5 消息摘要算法
  • 14.4. sha — SHA-1 消息摘要算法
• 15. 一般操作系统服务
  • 15.1. os — 杂项操作系统接口
  • 15.2. io — 用于操控流的核心工具
  • 15.3. time — 时间的访问和转换
  • 15.4. argparse — 用于命令行选项、自变量及子命令的剖析器
  • 15.5. optparse — 命令行选项剖析器
  • 15.6. getopt — 命令行选项 C 样式剖析器
  • 15.7. logging — Python 日志设施
  • 15.8. logging.config — 日志配置
  • 15.9. logging.handlers — 日志处理程序
  • 15.10. getpass — 便携式口令输入
  • 15.11. curses — 用于字符单元显示的终端处理
  • 15.12. curses.textpad — 用于 Curses 程序的文本输入 Widget
  • 15.13. curses.ascii — 用于 ASCII 字符的实用程序
  • 15.14. curses.panel — 用于 Curses 的面板堆栈扩展
  • 15.15. platform — 访问底层平台的标识数据
  • 15.16. errno — 标准 errno 系统符号
  • 15.17. ctypes — 用于 Python 的外来函数库
• 16. 可选操作系统服务
  • 16.1. select — 等待 I/O 完成
  • 16.2. threading — 更高级的线程接口
  • 16.3. thread — 多线程控制
  • 16.4. dummy_threading — 直接置换 threading 模块
  • 16.5. dummy_thread — 直接置换 thread 模块
  • 16.6. multiprocessing — 基于进程的 threading 接口
  • 16.7. mmap — 内存映射文件支持
  • 16.8. readline — GNU readline 接口
  • 16.9. rlcompleter — 用于 GNU readline 的补全函数
• 17. 进程间通信和网络
  • 17.1. subprocess — 子进程管理
  • 17.2. socket — 低级网络接口
  • 17.3. ssl — 套接字对象的 TLS/SSL 包裹器
  • 17.4. signal — 为异步事件设置处理程序
  • 17.5. popen2 — 具有可访问 I/O 流的子进程
  • 17.6. asyncore — 异步套接字处理程序
  • 17.7. asynchat — 异步套接字命令/响应处理程序
• 18. 互联网数据处理
  • 18.1. email — Email 和 MIME 处理包
  • 18.2. json — JSON 编码器和解码器
  • 18.3. mailcap — Mailcap 文件处理
  • 18.4. mailbox — 以各种格式操纵邮箱
  • 18.5. mhlib — 访问 MH 邮箱
  • 18.6. mimetools — 用于剖析 MIME 消息的工具
  • 18.7. mimetypes — 将文件名映射到 MIME 类型
  • 18.8. MimeWriter — 一般 MIME 文件写入器
  • 18.9. mimify — 邮件消息的 MIME 处理
  • 18.10. multifile — 支持包含截然不同部分的文件
  • 18.11. rfc822 — 剖析 RFC 2822 邮件头
  • 18.12. base64 — RFC 3548：Base16、Base32、Base64 数据编码
  • 18.13. binhex — 编码和解码 binhex4 文件
  • 18.14. binascii — 在二进制和 ASCII 之间转换
  • 18.15. quopri — 编码和解码 MIME 带引号可打印数据
  • 18.16. uu — 编码和解码 uuencode 文件
• 19. 结构化标记处理工具
  • 19.1. HTMLParser — 简单 HTML 和 XHTML 剖析器
  • 19.2. sgmllib — 简单 SGML 剖析器
  • 19.3. htmllib — HTML 文档剖析器
  • 19.4. htmlentitydefs — HTML 一般实体的定义
  • 19.5. XML 处理模块
  • 19.6. XML 弱点
  • 19.7. xml.etree.ElementTree — ElementTree XML API
  • 19.8. xml.dom — DOM (文档对象模型) API
  • 19.9. xml.dom.minidom — 最小 DOM (文档对象模型) 实现
  • 19.10. xml.dom.pulldom — 支持构建部分 DOM (文档对象模型) 树
  • 19.11. xml.sax — 支持 SAX2 剖析器
  • 19.12. xml.sax.handler — 用于 SAX 处理程序的基类
  • 19.13. xml.sax.saxutils — SAX 实用程序
  • 19.14. xml.sax.xmlreader — 用于 XML 剖析器的接口
  • 19.15. xml.parsers.expat — 使用 Expat 快速剖析 XML
• 20. 互联网协议和支持
  • 20.1. webbrowser — 方便的 Web 浏览器控制器
  • 20.2. cgi — CGI (通用网关接口) 支持
  • 20.3. cgitb — CGI 脚本的回溯管理器
  • 20.4. wsgiref — WSGI 实用程序和参考实现
  • 20.5. urllib — 按 URL 打开任意资源
  • 20.6. urllib2 — 用于打开 URL 的可扩展库
  • 20.7. httplib — HTTP 协议客户端
  • 20.8. ftplib — FTP (文件传输协议) 客户端
  • 20.9. poplib — POP3 协议客户端
  • 20.10. imaplib — IMAP4 协议客户端
  • 20.11. nntplib — NNTP (网络新闻传输协议) 客户端
  • 20.12. smtplib — SMTP (简单邮件传输协议) 客户端
  • 20.13. smtpd — SMTP (简单邮件传输协议) 服务器
  • 20.14. telnetlib — Telnet 客户端
  • 20.15. uuid — UUID 对象根据 RFC 4122
  • 20.16. urlparse — 将 URL 剖析成组件
  • 20.17. SocketServer — 网络服务器框架
  • 20.18. BaseHTTPServer — 基本 HTTP 服务器
  • 20.19. SimpleHTTPServer — 简单 HTTP 请求处理程序
  • 20.20. CGIHTTPServer — 支持 CGI 的 HTTP 请求处理程序
  • 20.21. cookielib — 用于 HTTP 客户端的 Cookie 处理
  • 20.22. Cookie — HTTP 状态管理
  • 20.23. xmlrpclib — XML-RPC 客户端访问
  • 20.24. SimpleXMLRPCServer — 基本 XML-RPC 服务器
  • 20.25. DocXMLRPCServer — 自文档 XML-RPC 服务器
• 21. 多媒体服务
  • 21.1. audioop — 操纵原生音频数据
  • 21.2. imageop — 操纵原生图像数据
  • 21.3. aifc — 读写 AIFF (音频交换文件格式) 和 AIFC 文件
  • 21.4. sunau — 读写 Sun AU 文件
  • 21.5. wave — 读写 WAV 文件
  • 21.6. chunk — 读取 IFF 分块数据
  • 21.7. colorsys — 在颜色系统之间转换
  • 21.8. imghdr — 确定图像类型
  • 21.9. sndhdr — 确定声音文件类型
  • 21.10. ossaudiodev — 访问 OSS (开放声音系统) 兼容音频设备
• 22. 国际化
  • 22.1. gettext — 多语言国际化服务
  • 22.2. locale — 国际化服务
• 23. 程序框架
  • 23.1. cmd — 支持面向行的命令解释器
  • 23.2. shlex — 简单的词法分析
• 24. 采用 Tk 的图形用户界面
  • 24.1. Tkinter — 到 Tcl/Tk 的 Python 接口
  • 24.2. ttk — Tk 主题 Widget
  • 24.3. Tix — 用于 Tk 的扩展 Widget
  • 24.4. ScrolledText — 卷动文本 Widget
  • 24.5. turtle — 用于 Tk 的海龟图形
  • 24.6. IDLE
  • 24.7. 其它 GUI (图形用户界面) 包
• 25. 开发工具
  • 25.1. pydoc — 文档编制生成器和在线帮助系统
  • 25.2. doctest — 测试交互 Python 范例
  • 25.3. unittest — 单元测试框架
  • 25.4. 2to3 - 自动 Python 2 到 3 代码翻译
  • 25.5. test — 用于 Python 的回归测试包
  • 25.6. test.support — 用于测试的实用程序函数
• 26. 调试和剖分析
  • 26.1. bdb — 调试器框架
  • 26.2. pdb — Python 调试器
  • 26.3. 调试器命令
  • 26.4. Python 剖分析器
  • 26.5. hotshot — 高性能日志剖分析器
  • 26.6. timeit — 度量小代码片段的执行时间
  • 26.7. trace — 跟踪或追踪 Python 语句的执行
• 27. 软件打包和分发
  • 27.1. distutils — 构建和安装 Python 模块
  • 27.2. ensurepip — 自引导 pip 安装程序
• 28. Python 运行时服务
  • 28.1. sys — 特定系统参数和函数
  • 28.2. sysconfig — 提供对 Python 配置信息的访问
  • 28.3. __builtin__ — 内置对象
  • 28.4. future_builtins — Python 3 内置
  • 28.5. __main__ — 顶层脚本环境
  • 28.6. warnings — 警告控制
  • 28.7. contextlib — 实用程序为 with 语句上下文
  • 28.8. abc — 抽象基类
  • 28.9. atexit — 退出处理程序
  • 28.10. traceback — 打印或检索堆栈回溯
  • 28.11. __future__ — 未来的语句定义
  • 28.12. gc — 垃圾收集器接口
  • 28.13. inspect — 审查存活对象
  • 28.14. site — 特定站点配置挂钩
  • 28.15. user — 特定用户配置挂钩
  • 28.16. fpectl — 浮点异常控制
• 29. 自定义 Python 解释器
  • 29.1. code — 解释器基类
  • 29.2. codeop — 编译 Python 代码
• 30. 限定执行
  • 30.1. rexec — 限定执行框架
  • 30.2. Bastion — 对象访问限定
• 31. 导入模块
  • 31.1. imp — 访问 import 内部
  • 31.2. importlib — Convenience wrappers for __import__()
  • 31.3. imputil — 导入实用程序
  • 31.4. zipimport — 导入模块从 Zip 存档
  • 31.5. pkgutil — 包扩展实用程序
  • 31.6. modulefinder — 查找用于脚本的模块
  • 31.7. runpy — 定位和执行 Python 模块
• 32. Python 语言服务
  • 32.1. parser — 访问 Python 剖析树
  • 32.2. ast — 抽象句法树
  • 32.3. symtable — 访问编译器的符号表
  • 32.4. symbol — 用于 Python 剖析树的常量
  • 32.5. token — 用于 Python 剖析树的常量
  • 32.6. keyword — 测试 Python 关键词
  • 32.7. tokenize — 用于 Python 源代码的 Tokenizer
  • 32.8. tabnanny — 歧义缩进的检测
  • 32.9. pyclbr — Python 类浏览器支持
  • 32.10. py_compile — 编译 Python 源文件
  • 32.11. compileall — 字节编译 Python 库
  • 32.12. dis — Python 字节码的反汇编程序
  • 32.13. pickletools — 用于腌制开发者的工具
• 33. Python 编译器包
  • 33.1. 基本接口
  • 33.2. 局限性
  • 33.3. Python 抽象句法
  • 33.4. 使用访客演练 AST
  • 33.5. 字节码生成
• 34. 杂项服务
  • 34.1. formatter — 一般输出格式
• 35. MS Windows 特定服务
  • 35.1. msilib — 读写微软安装程序文件
  • 35.2. msvcrt – 来自 MS VC++ 运行时的有用例程
  • 35.3. _winreg — Windows 注册表访问
  • 35.4. winsound — Windows 声音播放接口
• 36. Unix 特定服务
  • 36.1. posix — 最常见的 POSIX 系统调用
  • 36.2. pwd — 口令数据库
  • 36.3. spwd — 影子口令数据库
  • 36.4. grp — 组数据库
  • 36.5. crypt — 用于校验 Unix 口令的函数
  • 36.6. dl — 调用共享对象中的 C 函数
  • 36.7. termios — POSIX 样式 tty 控制
  • 36.8. tty — 终端控制函数
  • 36.9. pty — 伪终端实用程序
  • 36.10. fcntl — fcntl and ioctl 系统调用
  • 36.11. pipes — Shell 管道接口
  • 36.12. posixfile — 具有锁支持的像文件对象
  • 36.13. resource — 资源使用信息
  • 36.14. nis — 接口到 Sun 的 NIS (黄页)
  • 36.15. syslog — Unix syslog 库例程
  • 36.16. commands — 用于运行命令的实用程序
• 37. Mac OS X 特定服务
  • 37.1. ic — 访问 Mac OS X Internet 配置
  • 37.2. MacOS — 访问 Mac OS 解释器特征
  • 37.3. macostools — 用于文件操纵的方便例程
  • 37.4. findertools — finder 的 Apple 事件接口
  • 37.5. EasyDialogs — 基本 Macintosh 对话框
  • 37.6. FrameWork — 交互应用程序框架
  • 37.7. autoGIL — 事件循环中的 GIL (全局解释器锁) 处理
  • 37.8. Mac OS Toolbox 模块
  • 37.9. ColorPicker — 颜色选择对话框
• 38. MacPython OSA (开放脚本体系结构) 模块
  • 38.1. gensuitemodule — 生成 OSA (开放脚本体系结构) stub 包
  • 38.2. aetools — OSA (开放脚本体系结构) 客户端支持
  • 38.3. aepack — 在 Python 变量和 AppleEvent 数据容器之间转换
  • 38.4. aetypes — AppleEvent 对象
  • 38.5. MiniAEFrame — OSA (开放脚本体系结构) 服务器支持
• 39. SGI IRIX 特定服务
  • 39.1. al — SGI 音频函数
  • 39.2. AL — 常量用于 al 模块
  • 39.3. cd — SGI 系统访问 CD-ROM
  • 39.4. fl — 用于图形用户界面的 FORMS 库
  • 39.5. FL — 常量用于 fl 模块
  • 39.6. flp — 加载存储的 FORMS 设计的函数
  • 39.7. fm — 字体管理器 interface
  • 39.8. gl — — 图形库 interface
  • 39.9. DEVICE — 常量用于 gl 模块
  • 39.10. GL — 常量用于 gl 模块
  • 39.11. imgfile — 支持 SGI imglib 文件
  • 39.12. jpeg — 读写 JPEG 文件
• 40. SunOS 特定服务
  • 40.1. sunaudiodev — 访问 Sun 音频硬件
  • 40.2. SUNAUDIODEV — 常量用于 sunaudiodev
• 41. 未文档化模块
  • 41.1. 杂项有用实用程序
  • 41.2. 特定平台模块
  • 41.3. 多媒体
  • 41.4. 未文档化的 Mac OS 模块
  • 41.5. 过时
  • 41.6. SGI 特定扩展模块

上一话题

9. 完整语法规范

下一话题

1. 介绍

本页

• 展示源