此前已弃用 [完成]

PEP 4 列出了 stdlib 中所有已弃用的模块。指定的动机与 PEP 4 中列出的动机相同。在 Python 3.0 的第一个 Alpha 版本发布时，PEP 中列出的所有模块都将被移除。

lib-old 的全部内容也将被移除。这些模块已从导入中移除，但为了依赖这些代码的用户，仍保留在 Python 发行版中。

• cfmfile
  • 自 Python 2.4 起已文档化为已弃用，无明确原因。
• cl
  • 自 Python 2.0 或更早版本起已文档化为过时。
  • SGI 硬件接口。
• md5
  • 已被 hashlib 模块取代。
• mimetools
  • 在以前的版本中已文档化为过时。
  • 已被 email 包取代。
• MimeWriter
  • 已被 email 包取代。
• mimify
  • 已被 email 包取代。
• multifile
  • 已被 email 包取代。
• posixfile
  • 使用 fcntl.lockf() 进行锁定效果更好。
• rfc822
  • 已被 email 包取代。
• sha
  • 已被 hashlib 包取代。
• sv
  • 自 Python 2.0 或更早版本起已文档化为过时。
  • 已过时的 SGI Indigo 硬件接口。
• timing
  • 自 Python 2.0 或更早版本起已文档化为过时。
  • time.clock() 提供更好的时间分辨率。

平台特定且使用量极少 [完成]

Python 支持许多平台，其中一些平台并未广泛使用或维护。在这些平台中的某些平台上，有些模块对这些平台上的用户用途有限。由于其用途有限，最好不再给 Python 开发团队增加维护负担。

下面提到的模块已文档化。所有指定平台的未文档化模块也将被移除。

极少使用 [完成]

一些平台无关模块很少使用。这有许多可能的解释，包括：重新实现简单、受众很小或不遵守更现代的标准。

• audiodev
  • 未文档化。
  • 五年未编辑。
• imputil
  • 未文档化。
  • 从未更新以支持绝对导入。
• mutex
  • 使用信号量和队列易于实现。
  • 无法在尝试锁定时阻塞。
  • 自 15 年前添加以来未被唯一编辑过。
  • 仅对“sched”模块有用。
  • 非线程安全。
• stringold
  • 字符串对象方法的函数版本。
  • 自 Python 1.6 起已过时。
  • 字符串对象或模块中不存在的任何功能将移至字符串模块（主要是常量）。
• sunaudio
  • 未文档化。
  • 七年多未编辑。
  • sunau 模块提供类似功能。
• toaiff
  • 未文档化。
  • 要求在系统上安装 sox 库。
• user
  • 通过允许应用程序指定自己的模块名称、检查是否存在并找到后导入来轻松处理。
• 新
  • 只是“types”模块中名称的重新绑定。
  • 也可以调用 type 内置函数以轻松获取大多数类型。
  • 文档字符串声明该模块自修订版 27241 (2002-06-15) 起不再有用。
• pure
  • 在 Pure Atria 被 Rational 收购，然后又被 IBM 收购之前编写（换句话说，非常旧）。
• test.testall
  • 在 regrtest 之前的时代。

已过时

过时意味着 stdlib 中的另一个模块或广泛分发的第三方库为该模块旨在实现的功能提供了更好的解决方案。

• Bastion/rexec [完成]
  • 受限执行/安全。
  • 在 Python 2.3 中已关闭。
  • 被认为不安全的模块。
• bsddb185 [完成]
  • 被 bsddb3 取代
  • 默认不构建。
  • 文档中明确指出“在新代码中不应直接使用该模块”。
  • 可从 PyPI 外部获取。
• Canvas [完成]
  • 自 2000 年起 Guido 在注释中标记为过时（参见 http://bugs.python.org/issue210677）。
  • 最好使用 Tkinter.Canvas 类。
• commands [完成]
  • subprocess 模块取代了它 (PEP 324)。
  • 移除 getstatus()，其余移至 subprocess。
• compiler [完成]
  • 维护内置编译器和 stdlib 包是多余的 [17]。
  • 编译器创建的 AST 可用 [16]。
  • 需要添加从 AST 编译的机制。
• dircache [完成]
  • 使用量微乎其微。
  • 易于复制。
• dl [完成]
  • ctypes 为相同功能提供更好的支持。
• fpformat [完成]
  • 所有功能都由字符串插值支持。
• htmllib [完成]
  • 被 HTMLParser 取代。
• ihooks [完成]
  • 未文档化。
  • 用于 rexec，而 rexec 自 Python 2.3 起已关闭。
• imageop [完成]
  • 第三方库提供更好的支持 (Python Imaging Library [11])。

  • 单元测试依赖 rgbimg 和 imgfile。

    • rgbimg 在 Python 2.6 中已移除。
    • imgfile 在本 PEP 中计划移除。

• linuxaudiodev [完成]
  • 被 ossaudiodev 取代。
• mhlib [完成]
  • 应作为单独模块移除；改用 mailbox。
• popen2 [完成]
  • subprocess 模块取代了它 (PEP 324)。
• sgmllib [完成]
  • 无法完全解析 SGML。
  • 在 stdlib 中用于支持 htmllib，而 htmllib 计划移除。
• sre [完成]
  • 此前已弃用；改用导入 re。
• stat [TODO 需要将所有使用移至 os.stat()]
  • os.stat() 现在返回一个带有属性的元组。
  • 模块中的函数应作为 os.stat 返回的对象的方法。
• statvfs [完成]
  • os.statvfs 现在返回一个带有属性的元组。
• thread [完成]
  • 人们应该改用“threading”。
    • 将“thread”重命名为 _thread。
    • 弃用 dummy_thread 并重命名为 _dummy_thread。
    • 将 thread.get_ident 移至 threading。
  • Guido 此前曾支持弃用 [8]。
• urllib [完成]
  • 被 urllib2 取代。
  • urllib 独有的功能将保留在 urllib 包中。
• UserDict [完成: 3.0] [TODO 处理 2.6]
  • 由于类型可以成为超类，因此不再那么有用。
  • 有用的部分移至“collections”模块。
• UserList/UserString [完成]
  • 由于类型可以成为超类，因此不再有用。
  • 移至“collections”模块。

维护负担

多年来，某些模块已成为 python-dev 维护的沉重负担。在这种情况下，最好将模块交给社区维护，以使 python-dev 能够更多地关注语言支持和标准库中不会占用过多时间和精力的其他模块。

• bsddb3
  • 在 http://www.jcea.es/programacion/pybsddb.htm 外部维护。
  • 持续的测试不稳定。
  • Berkeley DB 遵循与 Python 不同的发布计划，导致绑定不一定与可用内容同步。

违反 PEP 8 [完成]

PEP 8 规定模块“应该有简短、全小写的名称”，其中“如果能提高可读性，可以使用下划线”。包名中不鼓励使用下划线。以下模块违反了 PEP 8，并且不会通过移动到包中而以某种方式重命名。

合并相同接口的 C 和 Python 实现

一些接口同时具有 Python 和 C 实现。虽然拥有 C 实现以提高速度并将 Python 实现作为备用是很好的，但没有必要在 stdlib 中独立公开这两种实现。对于 Python 3.0，所有具有两种实现的接口将合并为一个公共接口。

C 模块将添加一个前导下划线，以区分它不是参考实现（Python 实现是）。这意味着 C 和 Python 版本之间的任何语义差异都必须在 Python 3.0 之前处理，否则 C 实现将被移除，直到可以修复。

下面未列出的一个接口是 xml.etree.ElementTree。这是一个外部维护的模块，因此不在 Python 开发团队的直接重命名控制之下。有关此问题的讨论，请参阅开放问题。

• pickle/cPickle [完成]
  • 将 cPickle 重命名为 _pickle。
  • C 实现的语义完整性 未 验证。
• profile/cProfile [TODO]
  • 将 cProfile 重命名为 _profile。
  • C 实现的语义完整性 未 验证。
• StringIO/cStringIO [完成]
  • 将该类添加到“io”模块。

无公共、已文档化接口 [完成]

stdlib 中有几个模块没有定义公共接口。这些模块作为其他公开模块的支持代码存在。因为它们不应直接使用，所以应该重命名以反映这一事实。

命名不佳 [完成]

事后看来，有些模块的命名选择不佳。它们应该重命名，以防止其不良名称在 2.x 系列之后继续存在。

模块分组 [完成]

随着 stdlib 的发展，其中几个领域已扩展到包含多个模块（例如，对数据库文件的支持）。因此，将相关模块分组到包中是有意义的。

问题

与本 PEP 相关的问题

• 问题 2775: 主要跟踪问题
• 问题 2828: 清理 undoc.rst

关于待移除模块

对于模块移除，最简单的方法是首先在 Python 3.0 中移除模块，以查看依赖关系是否存在。这使得查找（可能）需要抑制 DeprecationWarning 的代码变得更容易。

模块重命名

2to3 重构工具中对重命名的支持将用于帮助人们过渡到新的模块名称 [9]。import 语句将被重写，以便只需更改 import 语句，而不需要更改其余代码。这将通过在 import 语句中使用 as 关键字将模块命名空间绑定到旧名称，同时根据新名称进行导入（当关键字尚未被使用时，否则应保留重新分配的名称，并且只更改被导入的模块）。fix_imports 修复器是如何实现这一点的示例。

在 stdlib 之外维护的模块重命名

xml.etree.ElementTree 不仅不符合 PEP 8 命名标准，而且还公开了 C 实现。它是一个外部维护的包，尽管有 PEP 360。将请求维护者更改名称，使其符合 PEP 8 并隐藏 C 实现。

最初建议移除的模块

• asynchat/asyncore
  • Josiah Carlson 表示他将维护这些模块。
• audioop/sunau/aifc
  • 仍然使用这些格式的音频模块。
• base64/quopri/uu
  • 都仍然广泛使用。
  • “codecs”模块对于基本使用不提供那么好的 API。
• fileinput
  • 在处理标准输入时很有用。
• linecache
  • 在多个地方内部使用。
• nis
  • 有证词表明 NIS 新安装仍在发生
• getopt
  • 比 optparse 更简单。
• repr
  • 作为重写的基础很有用。
  • 内部使用。
• sched
  • 对模拟很有用。
• symtable/_symtable
  • 已编写文档。
• telnetlib
  • 对于快速简单的远程访问非常方便。
  • 某些硬件支持使用 telnet 进行配置和查询。
• Tkinter
  • 将阻止 IDLE 的存在。
  • 开箱即用将没有 GUI 工具包。

引入新的顶层包

有人建议将整个 stdlib 放置在自己的包中。本 PEP 不会解决此问题，因为它有自己的设计问题（命名，它是否值得在导入语义中特别考虑等）。如果引入新的顶层包，本 PEP 中的所有内容都可以轻松处理。

引入新包以包含主题相关模块

在编写本 PEP 期间，注意到 stdlib 中出现了某些主题。过去有人建议引入新包以帮助收集具有相似主题的模块（例如，音频）。已创建一个开放问题来建议引入一些新包。

然而，最终未能获得足够的支持来推动该想法。相反，名称简化已被选为 PEPs 创建的主导力量。