之前已弃用 [已完成]

PEP 4 列出了标准库中所有已弃用的模块。指定的动机反映了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
  • 通过允许应用程序指定自己的模块名称、检查是否存在并在找到时导入来轻松处理。
• new
  • 只是来自“types”模块的名称重新绑定。
  • 还可以调用 type 内置函数来轻松获取大多数类型。
  • 文档字符串指出自修订版 27241（2002-06-15）以来，该模块不再有用。
• pure
  • 在 Pure Atria 被 Rational 收购，然后 Rational 被 IBM 收购之前编写（换句话说，非常古老）。
• test.testall
  • 在 regrtest 出现之前的时代。

已过时

变得过时意味着标准库中的另一个模块或广泛分发的第三方库为模块的目的提供了更好的解决方案。

• Bastion/rexec [已完成]
  • 受限执行/安全。
  • 在 Python 2.3 中关闭。
  • 被认为不安全的模块。
• bsddb185 [已完成]
  • 被 bsddb3 取代
  • 默认情况下不构建。
  • 文档说明“模块永远不应该在新的代码中直接使用”。
  • 可从 PyPI 外部获取。
• Canvas [已完成]
  • 自 2000 年以来，Guido 在注释中将其标记为已过时（参见 http://bugs.python.org/issue210677）。
  • 最好使用Tkinter.Canvas类。
• 命令 [已完成]
  • subprocess 模块替换它（PEP 324）。
  • 移除 getstatus()，将其余部分移动到 subprocess。
• 编译器 [已完成]
  • 同时维护内置编译器和标准库包是冗余的 [20]。
  • 编译器创建的 AST 可用 [19]。
  • 需要添加从 AST 编译的机制。
• dircache [已完成]
  • 使用量可忽略不计。
  • 易于复制。
• dl [已完成]
  • ctypes 为相同功能提供了更好的支持。
• fpformat [已完成]
  • 字符串插值支持所有功能。
• htmllib [已完成]
  • 被 HTMLParser 取代。
• ihooks [已完成]
  • 未记录。
  • 用于 rexec，自 Python 2.3 以来已被禁用。
• imageop [已完成]
  • 第三方库（Python 图像库 [13]）提供了更好的支持。

  • 单元测试依赖于 rgbimg 和 imgfile。

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

• linuxaudiodev [已完成]
  • 被 ossaudiodev 替换。
• mhlib [已完成]
  • 应作为单个模块移除；请改用 mailbox。
• popen2 [已完成]
  • subprocess 模块替换它（PEP 324）。
• sgmllib [已完成]
  • 无法完全解析 SGML。
  • 在标准库中用于支持 htmllib，后者计划移除。
• sre [已完成]
  • 之前已弃用；请改用 re 导入。
• stat [待办事项 需要将所有用法迁移到 os.stat()]
  • os.stat() 现在返回一个包含属性的元组。
  • 模块中的函数应转换为由 os.stat 返回的对象的方法。
• statvfs [已完成]
  • os.statvfs 现在返回一个包含属性的元组。
• thread [已完成]
  • 人们应该使用“threading”代替。
    • 将“thread”重命名为 _thread。
    • 弃用 dummy_thread 并重命名为 _dummy_thread。
    • 将 thread.get_ident 移动到 threading。
  • Guido 之前支持弃用 [9]。
• urllib [已完成]
  • 被 urllib2 取代。
  • urllib 独有的功能将保留在 urllib 包中。
• UserDict [已完成：3.0] [待办事项 处理 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 实现作为回退非常棒，但无需在标准库中独立公开这两种实现。对于 Python 3.0，所有具有两种实现的接口都将合并到单个公共接口中。

C 模块将使用前导下划线来表明它不是参考实现（Python 实现是）。这意味着在 Python 3.0 之前必须处理 C 版本和 Python 版本之间的任何语义差异，否则 C 实现将被移除，直到可以修复它为止。

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

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

没有公共的、有文档记录的接口 [已完成]

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

名称选择不佳 [已完成]

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

模块分组 [已完成]

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

问题

与本 PEP 相关的问题

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

对于要移除的模块

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

模块重命名

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

标准库之外维护的模块重命名

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 工具包。

引入新的顶级包

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

引入新的包来包含主题相关的模块

在撰写此 PEP 期间，注意到标准库中出现了一些主题。过去，人们建议引入新的包来帮助收集共享相似主题（例如，音频）的模块。创建了一个开放问题以建议引入一些新包。

但是，最终，没有获得足够的支持来保证推进该想法。相反，名称简化已被选为创建 PEP 的指导原则。