Python 3.6 有什么新变化

本文解释了与3.5相比，Python 3.6中的新功能。 Python 3.6于2016年12月23日发布。请参阅 changelog [https://docs.python.org/3.6/whatsnew/changelog.html] 以获取完整的更改列表。

参见

PEP 494 [https://peps.python.org/pep-0494/] - Python 3.6 发布计划

摘要 — 发布重点

新的语法特性：

新的库模块：

CPython 实现的改进：

标准库中的重大改进：

安全改进：

  • 添加了 secrets 模块以简化适用于密码管理的高加密强度伪随机数的生成，例如账户验证、安全凭据等场景。

  • 在 Linux 上，现在 os.urandom() 会阻塞直到系统的 urandom 熵池被初始化以提升安全性。 其理由参见 PEP 524 [https://peps.python.org/pep-0524/]。

  • hashlib 和 ssl 模块现在支持 OpenSSL 1.1.0。

  • ssl 模块的默认设置和特性集已得到改进。

  • hashlib 模块获得了对 BLAKE2, SHA-3 和 SHAKE 哈希算法以及 scrypt() 密钥派生函数的支持。

Windows改进：

  • PEP 528 和 PEP 529, 将Windows文件系统和控制台的编码更改为UTF-8

  • 在交互式地使用 py.exe 启动器时，当用户未（通过命令行参数或配置文件）指定版本时不再优先选择 Python 2 而是选择 Python 3。 对声明行的处理则保持不变 —— 在这种情况下 "python" 还是指 Python 2。

  • python.exe 和 pythonw.exe 已被标记为支持长路径，这意味着不再有 260 个字符的路径长度限制。 详情参见 移除 MAX_PATH 限制。

  • 可以添加一个 ._pth 文件来强制使用隔离模式和完整指定所有搜索路径来避免注册表和环境查找。 更多信息请参阅 相关文档。

  • 现在 python36.zip 文件可以作为推断 PYTHONHOME 的标记物。 请参阅 相关文档 了解详情。

新的特性

PEP 498: 格式化字符串字面值

PEP 498 [https://peps.python.org/pep-0498/] 引入了一种新型的字符串字面值: f-字符串，或称 格式化字符串字面值。

格式化字符串字面值带有 'f' 前缀并且类似于 str.format() 所接受的格式字符串。 其中包含由花括号包围的替换字段。 替换字段属于表达式，它们会在运行时被求值，然后使用 format() 协议进行格式化:

  1. >>> name = "Fred"
  2. >>> f"He said his name is {name}."
  3. 'He said his name is Fred.'
  4. >>> width = 10
  5. >>> precision = 4
  6. >>> value = decimal.Decimal("12.34567")
  7. >>> f"result: {value:{width}.{precision}}"  # nested fields
  8. 'result:      12.35'

参见

特性文档。

PEP 526: 变量标注的语法

PEP 484 [https://peps.python.org/pep-0484/] 引入了函数形参类型标注即类型提示的标准。 这个 PEP 为 Python 添加了标注变量类型的语法，包括类变量和实例变量:

  1. primes: List[int] = []
  2.  
  3. captain: str  # 注意：没有初始值
  4.  
  5. class Starship:
  6.     stats: Dict[str, int] = {}

与函数标注一样，Python 解释器不会为变量标注附加任何特殊含义，仅会将其保存在类或模块的 __annotations__ 属性中。

与静态类型语法的变量声明不同，标注语法的目的是通过抽象语法树和 __annotations__ 属性提供一个简单方式来为第三方工具和库指定结构化类型元数据。

参见

使用或将要使用此新语法的工具有: mypy [https://www.mypy-lang.org/], pytype [https://github.com/google/pytype], PyCharm 等等。

PEP 515: 数字字面值中的下划线。

PEP 515 [https://peps.python.org/pep-0515/] 增加了在数字字面值中使用下划线的能力以改善可读性。 例如:

  1. >>> 1_000_000_000_000_000
  2. 1000000000000000
  3. >>> 0x_FF_FF_FF_FF
  4. 4294967295

单个下划线允许用在数码之间和任何数制指示符之后。 一行内不允许有开头、末尾或多个下划线。

字符串格式化 语言现在也支持以 '_' 选项来表示用下划线作为浮点表示类型和整数表示类型 'd' 的千位分隔符。 对于整数表示类型 'b', 'o', 'x' 和 'X'，将每隔 4 数码插入一个下划线:

  1. >>> '{:_}'.format(1000000)
  2. '1_000_000'
  3. >>> '{:_x}'.format(0xFFFFFFFF)
  4. 'ffff_ffff'

参见

PEP 525: 异步生成器

PEP 492 [https://peps.python.org/pep-0492/] 将对原生协程和 async / await 语法的支持引入到 Python 3.5 中。 但 Python 3.5 实现的一个明显限制是不可能在同一函数体中同时使用 await 和 yield。 在 Python 3.6 中此限制已被解除，这样就就能够定义 异步生成器:

  1. async def ticker(delay, to): """每隔 delay 秒从 0 到 to 产生数字。"""
  2.     for i in range(to):
  3.         yield i
  4.         await asyncio.sleep(delay)

这个新语法允许更快速且更精简的代码。

参见

PEP 530: 异步推导式

PEP 530 [https://peps.python.org/pep-0530/] 添加了对在列表、集合与字典推导式和生成器表达式中使用 async for 的支持:

  1. result = [i async for i in aiter() if i % 2]

此外，await 表达式也在所有种类的推导式中得到支持:

  1. result = [await fun() for fun in funcs if await condition()]

参见

PEP 487: 更简单的自定义类创建

现在可以在不使用元类的情况下自定义子类的创建。 当一个新的子类被创建时将在基类上调用新的 __init_subclass__ 类方法:

  1. class PluginBase:
  2.     subclasses = []
  3.  
  4.     def __init_subclass__(cls, **kwargs):
  5.         super().__init_subclass__(**kwargs)
  6.         cls.subclasses.append(cls)
  7.  
  8. class Plugin1(PluginBase):
  9.     pass
  10.  
  11. class Plugin2(PluginBase):
  12.     pass

为了让来自 __init_subclass__() 实现的零参数 super() 调用能正确工作，自定义元类必须保证新的 __classcell__ 命名空间入口被传播到 type.__new__ (如 创建类对象 中所描述)。

参见

特性文档

PEP 487: 描述器协议的增强

PEP 487 [https://peps.python.org/pep-0487/] 扩展了描述器协议以包括新的可选方法 __set_name__()。 当创建一个新类时，这个新方法将在定义中包括的所有描述器上被调用，为它们提供对所定义类的引用以及在类命名中间中给予描述器的名称。 换句话说，描述器的实例现在能知道描述器在所有者类中的属性名称:

  1. class IntField:
  2.     def __get__(self, instance, owner):
  3.         return instance.__dict__[self.name]
  4.  
  5.     def __set__(self, instance, value):
  6.         if not isinstance(value, int):
  7.             raise ValueError(f'expecting integer in {self.name}')
  8.         instance.__dict__[self.name] = value
  9.  
  10.     # 这是新的初始化器：
  11.     def __set_name__(self, owner, name):
  12.         self.name = name
  13.  
  14. class Model:
  15.     int_field = IntField()

参见

特性文档

PEP 519: 添加文件系统路径协议

文件系统路径历来被表示为 str 或 bytes 对象。 这使得编写对文件系统路径进行操作的代码的人会假定这种对象只能是这两种类型之一（不考虑表示文件描述符的 int 因为它不是文件路径）。 不幸的是，这种假定阻止了像 pathlib 这样的文件系统路径的替代对象表示形式与包括 Python 标准库在内的现有代码协同工作。

为了修正这种情况，一个由 os.PathLike 表示的新接口被定义出来。 通过实现 __fspath__() 方法，对象可以表明它代表一个路径。 这样一个对象就能以 str 或 bytes 对象的形式提供文件系统路径的低层级表示。 这意味着如果一个对象实现了 os.PathLike 或者是表示文件系统路径的 str 或 bytes 对象它就会被当作是 路径型对象。 代码可以使用 os.fspath()、os.fsdecode() 或 os.fsencode() 来显式地获取一个路径型对象的 str 和/或 bytes 表示形式。

内置 open() 函数已被更新为接受 os.PathLike 对象，就像 os 和 os.path 模块中的所有相关函数和标准库中的大多数其他函数和类一样。 os.DirEntry 类和 pathlib 中的相关类也已被更新以实现 os.PathLike。

希望对于针对文件系统路径操作的基本函数的更新将会使得第三方代码都能隐式地支持所有 路径型对象 而无须修改任何代码，或者至少只需极少的修改（例如当对路径型对象进行操作之前在代码的开头调用 os.fspath() 即可）。

下面的这些示例说明了新的接口是如何让 pathlib.Path 被更容易、更透明地用于已有代码的:

  1. >>> import pathlib
  2. >>> with open(pathlib.Path("README")) as f:
  3. ...     contents = f.read()
  4. ...
  5. >>> import os.path
  6. >>> os.path.splitext(pathlib.Path("some_file.txt"))
  7. ('some_file', '.txt')
  8. >>> os.path.join("ab", pathlib.Path("c"))
  9. 'ab/c'
  10. >>> import os
  11. >>> os.fspath(pathlib.Path("some_file.txt"))
  12. 'some_file.txt'

（由 Brett Cannon, Ethan Furman, Dusty Phillips 和 Jelle Zijlstra 实现。）

参见

PEP 495: 消除本地时间的歧义

在世界上大多数地方，过去和将来都会存在本地时钟后移的时候。 在这种时候，本地时钟会在同一天内两次显示相同的时间。 对于这些情况，本地时钟所显示的（或存储在 Python datetime 实例中的）信息将不足以标识某个特定的时间点。

PEP 495 [https://peps.python.org/pep-0495/] 为 datetime.datetime 和 datetime.time 类的实例添加了新的 fold 属性以在本地时间相同的两个时间点之间进行区分:

  1. >>> u0 = datetime(2016, 11, 6, 4, tzinfo=timezone.utc)
  2. >>> for i in range(4):
  3. ...     u = u0 + i*HOUR
  4. ...     t = u.astimezone(Eastern)
  5. ...     print(u.time(), 'UTC =', t.time(), t.tzname(), t.fold)
  6. ...
  7. 04:00:00 UTC = 00:00:00 EDT 0
  8. 05:00:00 UTC = 01:00:00 EDT 0
  9. 06:00:00 UTC = 01:00:00 EST 1
  10. 07:00:00 UTC = 02:00:00 EST 0

fold 属性的值在大多数实例上均为 0，只有在代表存在歧义的时间的第二个（按发生顺序）实例上例外。

参见

PEP 529: 将 Windows 文件系统编码格式更改为 UTF-8

在表示文件系统路径时最好是使用 str (Unicode) 而不是 bytes。 不过，在某些情况下使用 bytes 就是足够而且正确的。

在 Python 3.6 之前，在 Windows 上使用字节串形式的路径可能会导致数据丢失。 通过这一更改，在 Windows 上现在已支持使用字节串来表示路径，前提是这些字节串使用 sys.getfilesystemencoding() 所返回的编码格式来编码，现在该值默认为 'utf-8'。

不使用字符串来表示路径的应用程序应用使用 os.fsencode() 和 os.fsdecode() 来确保字节串被正确地编码。 要恢复到之前版本的行为，请设置 PYTHONLEGACYWINDOWSFSENCODING 或调用 sys._enablelegacywindowsfsencoding()。

有关详细信息和可能需要的代码修改的讨论，请参见 PEP 529 [https://peps.python.org/pep-0529/] 。

PEP 528: 将 Windows 控制台编码格式更改为 UTF-8

现在，Windows 上的默认控制台将接受所有 Unicode 字符并为 Python 代码提供正确读取的 str 对象。sys.stdin, sys.stdout 和 sys.stderr 现在默认使用 utf-8 编码格式。

此更改仅在使用交互式控制台时适用，而不适用于重定向文件或管道。 要恢复以前使用交互式控制台时的行为，请设置 PYTHONLEGACYWINDOWSSTDIO。

参见

PEP 520: 保留类属性定义顺序

类定义体中的属性具有自然的排序：与名称在源代码中出现的顺序相同。 现在此排序会保留在新类的 __dict__ 属性中。

并且，实际的默认类 execution 命名空间 (从 type.prepare() 返回) 现在将是一个保留插入顺序的映射对象。

参见

PEP 468: 保留关键字参数顺序

函数签名中的 **kwargs 现在将保证是一个保留插入顺序的映射对象。

参见

新的 dict 实现

dict 类型现在会使用一种基于 Raymond Hettinger 的提议 [https://mail.python.org/pipermail/python-dev/2012-December/123028.html] 的“紧凑”表示形式，该表示形式 最初由 PyPy 实现 [https://morepypy.blogspot.com/2015/01/faster-more-memory-efficient-and-more.html]。 新的The memory usage of the new dict() 的内存占用相比 Python 3.5 减少了 20% 到 25%。

这个新实现对原始顺序的保留被认为是一个实现细节而不应当被依赖（这在将来可能会改变，但我们希望在改变语言规范以强制所有当前和将来的 Python 实现都使用保留顺序的语义之前先在几个发布版的语言内部使用这个新的 dict 实现；这也有助于让仍在使用随机迭代顺序的旧版本语言例如 Python 3.5 保持向下兼容性）。

（由 INADA Naoki 在 bpo-27350 [https://bugs.python.org/issue?@action=redirect&bpo=27350] 中贡献。 该特性 最初由 Raymond Hettinger 提议 [https://mail.python.org/pipermail/python-dev/2012-December/123028.html]。）

PEP 523: 向 CPython 添加帧求值 API

虽然 Python 为自定义代码执行方式提供了广泛的支持，但有一个地方它没有这样做，那就是帧对象的求值。 如果您想在 Python 中拦截帧的求值，那么确实没有除了直接操纵自定义函数的函数指针以外的任何办法。

PEP 523 [https://peps.python.org/pep-0523/] 通过提供使帧求值在 C 语言层级上可插入的 API 从而改变了这一状况。 这将允许调试器和 JIT 等工具在 Python 代码开始执行之前拦截帧求值。 这样就能允许 Python 代码使用替代性求值实现，跟踪帧求值等做法。

这个 API 并不是受限 C API 的组成部分，它被标记为私有以表明该 API 的使用受到限制并且只适用于非常少的、低层级的用例。 这个 API 的语义将根据需要随 Python 的一起发生变化。

参见

PYTHONMALLOC 环境变量

新的 PYTHONMALLOC 环境变量允许设置 Python 内存分配器并安装调试钩子。

现在将可以使用 PYTHONMALLOC=debug 在以发布模式编译的 Python 上为 Python 内存分配器安装调试钩子。 调试钩子的效果:

  • 新分配的内存中填充字节 0xCB

  • 释放的内存中填充了字节 0xDB

  • 检测违反 Python 内存分配器 API 的操作。 例如，PyObject_Free() 在 PyMem_Malloc() 所分配的内存块上被调用。

  • 在缓冲区开始之前检测写操作（缓冲区下溢）

  • 在缓冲区结束后检测写操作（缓冲区溢出）

  • 检测当调用 PYMEM_DOMAIN_OBJ (如: PyObject_Malloc()) 和 PYMEM_DOMAIN_MEM (如: PyMem_Malloc()) 域的分配器函数时是否持有 GIL。

检查是否保留了 GIL 也是Python 3.6 的新特性。

请参阅 PyMem_SetupDebugHooks() 函数来了解 Python 内存分配器上的调试钩子。

现在还可以使用 PYTHONMALLOC=malloc 为所有的 Python 内存分配强制使用 C 库的 malloc() 分配器。 这在以发布模式编译的 Python 上使用外部内存调试器如 Valgrind 时会很有用处。

发生错误时，Python 内存分配器上的调试钩子现在会使用 tracemalloc 模块来获取内存块被分配所在位置上的回溯。

使用 python3.6 -X tracemalloc=5 (在回溯中存储 5 帧) 的缓冲区溢出的致命错误示例:

  1. Debug memory block at address p=0x7fbcd41666f8: API 'o'
  2.     4 bytes originally requested
  3.     The 7 pad bytes at p-7 are FORBIDDENBYTE, as expected.
  4.     The 8 pad bytes at tail=0x7fbcd41666fc are not all FORBIDDENBYTE (0xfb):
  5.         at tail+0: 0x02 *** OUCH
  6.         at tail+1: 0xfb
  7.         at tail+2: 0xfb
  8.         at tail+3: 0xfb
  9.         at tail+4: 0xfb
  10.         at tail+5: 0xfb
  11.         at tail+6: 0xfb
  12.         at tail+7: 0xfb
  13.     The block was made by call #1233329 to debug malloc/realloc.
  14.     Data at p: 1a 2b 30 00
  15.  
  16. Memory block allocated at (most recent call first):
  17.   File "test/test_bytes.py", line 323
  18.   File "unittest/case.py", line 600
  19.   File "unittest/case.py", line 648
  20.   File "unittest/suite.py", line 122
  21.   File "unittest/suite.py", line 84
  22.  
  23. Fatal Python error: bad trailing pad byte
  24.  
  25. Current thread 0x00007fbcdbd32700 (most recent call first):
  26.   File "test/test_bytes.py", line 323 in test_hex
  27.   File "unittest/case.py", line 600 in run
  28.   File "unittest/case.py", line 648 in __call__
  29.   File "unittest/suite.py", line 122 in run
  30.   File "unittest/suite.py", line 84 in __call__
  31.   File "unittest/suite.py", line 122 in run
  32.   File "unittest/suite.py", line 84 in __call__
  33.   ...

（由 Victor Stinner 在 bpo-26516 [https://bugs.python.org/issue?@action=redirect&bpo=26516] 和 bpo-26564 [https://bugs.python.org/issue?@action=redirect&bpo=26564] 中贡献。）

DTrace 和 SystemTap 探测支持

Python 现在可以附带 --with-dtrace 来构建以便为解释器中的下列事件启用静态标记:

  • 函数调用/返回

  • 垃圾收集开始/完成

  • 执行的代码行。

这可被用来在生产环境中控制正在运行的解释器，而无需重新编译特定的 调试版本 或提供应用专属的性能分析/调试代码。

更多信息，请参见 使用 DTrace 和 SystemTap 检测CPython 。

当前的实现已在 Linux 和 macOS 上进行了测试。将来可能会添加其他标记。

（由 Łukasz Langa 在 bpo-21590 [https://bugs.python.org/issue?@action=redirect&bpo=21590] 中贡献，基于 Jesús Cea Avión, David Malcolm 和 Nikhil Benesch 的补丁。）

其他语言特性修改

对Python 语言核心进行的小改动：

新增模块

secrets

新的 secrets 模块的主要目的是提供一种直观的方式来可靠地生成适用于密码管理的高加密强度的伪随机值，如账户验证、安全凭据等等。

警告

请注意 random 模块中的伪随机数发生器 不应 被用于安全目的。 请在 Python 3.6+ 上使用 secrets 而在 Python 3.5 及更早的版本上使用 os.urandom()。

参见

改进的模块

array

现在已被耗尽的输出 array.array 的迭代器将保持耗尽状态，即使迭代后的数组被扩展时也是如此。 这将与其他可变序列的行为保持一致。

由 Serhiy Storchaka 在 bpo-26492 [https://bugs.python.org/issue?@action=redirect&bpo=26492] 中贡献。

ast

新增了 ast.Constant AST 节点。 它可被外部 AST 优化器用于常量折叠操作。

由 Victor Stinner 在 bpo-26146 [https://bugs.python.org/issue?@action=redirect&bpo=26146] 中贡献。

asyncio

从 Python 3.6 开始 asyncio 模块不再处于暂定状态，其 API 被认为已经稳定。

自 Python 3.5.0 以来 asyncio 模块中值得注意的变化（由于暂定状态所有变化都已反向移植到 3.5.x）:

binascii

b2a_base64() 函数现在接受可选的 newline 关键字参数用来控制是否要在返回值中添加换行符。 （由 Victor Stinner 在 bpo-25357 [https://bugs.python.org/issue?@action=redirect&bpo=25357] 中贡献。）

cmath

新增 cmath.tau (τ) 常量。 （由 Lisa Roach 在 bpo-12345 [https://bugs.python.org/issue?@action=redirect&bpo=12345] 中贡献，详情见 PEP 628 [https://peps.python.org/pep-0628/]。）

新增常量: cmath.inf 和 cmath.nan 用于匹配 math.inf 和 math.nan，以及 cmath.infj 和 cmath.nanj 用于匹配由 complex 的 repr 所使用的格式。 （由 Mark Dickinson 在 bpo-23229 [https://bugs.python.org/issue?@action=redirect&bpo=23229] 中贡献。）

collections

添加了新的 Collection 抽象基类用于表示有具体大小的可迭代容器类。 （由 Ivan Levkivskyi 在 bpo-27598 [https://bugs.python.org/issue?@action=redirect&bpo=27598] 中贡献并由 Neil Girdhar 撰写文档。）

添加了新的 Reversible 抽象基类用于表示同时提供 __reversed__() 方法的可迭代类。 （由 Ivan Levkivskyi 在 bpo-25987 [https://bugs.python.org/issue?@action=redirect&bpo=25987] 中贡献。）

新增代表异步生成器的 AsyncGenerator 抽象基类。 （由 Yury Selivanov 在 bpo-28720 [https://bugs.python.org/issue?@action=redirect&bpo=28720] 中贡献。）

现在 namedtuple() 函数接受可选的关键字参数 module，当指定该参数时，它将被用作所返回的具名元组类的 __module__ 属性。 （由 Raymond Hettinger 在 bpo-17941 [https://bugs.python.org/issue?@action=redirect&bpo=17941] 中贡献。）

namedtuple() 的 verbose 和 rename 参数现在是仅限关键字参数。 （由 Raymond Hettinger 在 bpo-25628 [https://bugs.python.org/issue?@action=redirect&bpo=25628] 中贡献。）

递归的 collections.deque 实例现在可以被 pickle。 （由 Serhiy Storchaka 在 bpo-26482 [https://bugs.python.org/issue?@action=redirect&bpo=26482] 中贡献。）

concurrent.futures

ThreadPoolExecutor 类构造器现在接受可选的 thread_name_prefix 参数以便能够自定义由线程池所创建的线程的名称。 （由 Gregory P. Smith 在 bpo-27664 [https://bugs.python.org/issue?@action=redirect&bpo=27664] 中贡献。）

contextlib

增加了 contextlib.AbstractContextManager 类用来提供上下文管理器的抽象基类。 它为 __enter__() 提供了一个合理的默认实现，该实现将返回 self 并将 __exit__() 设为抽象方法。 在 typing 中增加了对应的类 typing.ContextManager。 （由 Brett Cannon 在 bpo-25609 [https://bugs.python.org/issue?@action=redirect&bpo=25609] 中贡献。）

datetime

datetime 和 time 类新增了 fold 属性用来在必要时消除本地时间的歧义。 在 datetime 中的许多函数已被更新为支持本地时间的消除歧义。 请参阅 本地时间消歧义 一节了解更多信息。 （由 Alexander Belopolsky 在 bpo-24773 [https://bugs.python.org/issue?@action=redirect&bpo=24773] 中贡献。）

现在 datetime.strftime() 和 date.strftime() 方法将支持 ISO 8601 日期指令符 %G, %u 和 %V。 （由 Ashley Anderson 在 bpo-12006 [https://bugs.python.org/issue?@action=redirect&bpo=12006] 中贡献。）.) datetime.isoformat() 函数现在接受可选的 timespec 参数用来指定时间值要包括的额外组件数量。 （由 Alessandro Cucci 和 Alexander Belopolsky 在 bpo-19475 [https://bugs.python.org/issue?@action=redirect&bpo=19475] 中贡献。）

datetime.combine() 现在接受可选的 tzinfo 参数。 （由 Alexander Belopolsky 在 bpo-27661 [https://bugs.python.org/issue?@action=redirect&bpo=27661] 中贡献。）

decimal

新增 Decimal.as_integer_ratio() 方法，它返回一对整数 (n, d) 将给定的 Decimal 实例表示为一个最简形式且分母为正值的分数:

  1. >>> Decimal('-3.14').as_integer_ratio()
  2. (-157, 50)

（由 Stefan Krah 和 Mark Dickinson 在 bpo-25928 [https://bugs.python.org/issue?@action=redirect&bpo=25928] 中贡献。）

distutils

distutils.command.sdist.sdist 的 default_format 属性已被移除且 formats 属性默认为 ['gztar']。 虽然不作要求，但任何依赖于 default_format 的存在的代码都可能需要修改。 请参阅 bpo-27819 [https://bugs.python.org/issue?@action=redirect&bpo=27819] 了解更多细节。

email

通过多个构造器的 policy 关键字来启用的新 email API 已不再为暂定状态。 email 文档已被重新组织并重新撰写以聚集新 API，同时保留旧式 API 的原有文档。 （由 R. David Murray 在 bpo-24277 [https://bugs.python.org/issue?@action=redirect&bpo=24277] 中贡献。）

email.mime 中的类现在都接受可选的 policy 关键字参数。 （由 Berker Peksag 在 bpo-27331 [https://bugs.python.org/issue?@action=redirect&bpo=27331] 中贡献。）.) DecodedGenerator 现在支持 policy 关键字。

新增 policy 属性，message_factory 控制当解析器新建消息对象时默认要使用的类。 对于 email.policy.compat32 策略来说将为 Message，对于新策略来说将为 EmailMessage。 （由 R. David Murray 在 bpo-20476 [https://bugs.python.org/issue?@action=redirect&bpo=20476] 中贡献。）

encodings

在 Windows 上，增加了 'oem' 编码格式用于 CP_OEMCP，以及 'ansi' 别名用于现有的 'mbcs' 编码格式，它使用 CP_ACP 代码页。 （由 Steve Dower 在 bpo-27959 [https://bugs.python.org/issue?@action=redirect&bpo=27959] 中贡献。）

enum

在 enum 模块中新增了两个枚举基类: Flag 和 IntFlags。 两者均被用于定义可使用按位运算符进行组合的常量。 （由 Ethan Furman 在 bpo-23591 [https://bugs.python.org/issue?@action=redirect&bpo=23591] 中贡献。）

许多标准库模块已被更新以使用 IntFlags 类作为其常量。

新增的 enum.auto 值可被用于自动为枚举成员赋值:

  1. >>> from enum import Enum, auto
  2. >>> class Color(Enum):
  3. ...     red = auto()
  4. ...     blue = auto()
  5. ...     green = auto()
  6. ...
  7. >>> list(Color)
  8. [<Color.red: 1>, <Color.blue: 2>, <Color.green: 3>]

faulthandler

在 Windows 上，faulthandler 模块现在会为 Windows 异常安装处理器：参见 faulthandler.enable()。 （由 Victor Stinner 在 bpo-23848 [https://bugs.python.org/issue?@action=redirect&bpo=23848] 中贡献。）

fileinput

hook_encoded() 现在支持 errors 参数。 （由 Joseph Hackman 在 bpo-25788 [https://bugs.python.org/issue?@action=redirect&bpo=25788] 中贡献。）

hashlib

hashlib 已支持 OpenSSL 1.1.0。 最低的建议版本为 1.0.2。 （由 Christian Heimes 在 bpo-26470 [https://bugs.python.org/issue?@action=redirect&bpo=26470] 中贡献。）

本模块增加了 BLAKE2 哈希函数。 blake2b() 和 blake2s() 将始终可用并支持 BLAKE2 的完整特性集。 （由 Christian Heimes 在 bpo-26798 [https://bugs.python.org/issue?@action=redirect&bpo=26798] 中基于 Dmitry Chestnykh 和 Samuel Neves 的代码贡献。 文档由 Dmitry Chestnykh 撰写。）

增加了 SHA-3 哈希函数 sha3_224(), sha3_256(), sha3_384(), sha3_512()，以及 SHAKE 哈希函数 shake_128() 和 shake_256()。 （由 Christian Heimes 在 bpo-16113 [https://bugs.python.org/issue?@action=redirect&bpo=16113] 中贡献。 Keccak 代码包由 Guido Bertoni, Joan Daemen, Michaël Peeters, Gilles Van Assche 和 Ronny Van Keer 编写。）

基于密码的密钥推导函数 scrypt() 现可用于 OpenSSL 1.1.0 及更新版本。 （由 Christian Heimes 在 bpo-27928 [https://bugs.python.org/issue?@action=redirect&bpo=27928] 中贡献。）

http.client

HTTPConnection.request() 和 endheaders() 现在都支持分块编码格式请求体。 （由 Demian Brecht 和 Rolf Krahl 在 bpo-12319 [https://bugs.python.org/issue?@action=redirect&bpo=12319] 中贡献。）

idlelib 与 IDLE

对 idlelib 包执行现代化和重构以使 IDLE 的外观和功能更好并使代码更易于理解、测试和改进。 让 IDLE 外观更好的部分工作，尤其是在 Linux 和 Mac 上，在于使用了 ttk 部件，主要是在对话框中。 因此，IDLE 不再使用 tcl/tk 8.4。 现在它需要 tcl/tk 8.5 或 8.6。 我们建议运行这两个软件的最新发布版。

‘现代化’包括 idlelib 模块的重命名与合并。 对具有部分大写名称的文件的重命名类似于 3.0 中将 Tkinter 和 TkFont 重命名为 tkinter 和 tkinter.font。 因此，在 3.5 中可用的 idlelib 文件导入在 3.6 中通常将不再可用。 至少需要修改模块名称（参见 idlelib/README.txt），有时还需要更多修改。 （名称更改由 Al Swiegart 和 Terry Reedy 在 bpo-24225 [https://bugs.python.org/issue?@action=redirect&bpo=24225] 中贡献。 大多数 idlelib 补丁都是已经是或即将纳入该处理过程。）

作为补偿，最终的结果是一些 idlelib 类将更会易于使用，并有更好的 API 和文档字符串加以说明。 附加的有用信息准备好后将被添加到 idlelib 中。

在 3.6.2 中新增:

多个对自动补全的修正。 （由 Louie Lu 在 bpo-15786 [https://bugs.python.org/issue?@action=redirect&bpo=15786] 中贡献。）

在 3.6.3 中新增:

Module Browser (在 File 菜单中，之前称为 Class Browser) 现在会在最高层级函数和类之外显示嵌套的函数和类。 （由 Guilherme Polo, Cheryl Sabella 和 Terry Jan Reedy 在 bpo-1612262 [https://bugs.python.org/issue?@action=redirect&bpo=1612262] 中贡献。）

之前以扩展形式实现的 IDLE 特性已作为正常特性重新实现。 它们的设置已从 Extensions 选项卡移至其他对话框选项卡。 （由 Charles Wohlganger 和 Terry Jan Reedy 在 bpo-27099 [https://bugs.python.org/issue?@action=redirect&bpo=27099] 中实现。）

Settings 对话框 (Options 中的 Configure IDLE) 已经被部分重写以改进外观和功能。 （由 Cheryl Sabella 和 Terry Jan Reedy 在多个问题项中贡献。）

在 3.6.4 中新增:

字体样本现在包括一组非拉丁字符以便用户能更好地查看所选特定字体的效果。 （由 Terry Jan Reedy 在 bpo-13802 [https://bugs.python.org/issue?@action=redirect&bpo=13802] 中贡献。） 样本可以被修改以包括其他字符。 （由 Serhiy Storchaka 在 bpo-31860 [https://bugs.python.org/issue?@action=redirect&bpo=31860] 中贡献。）

在 3.6.6 中新增:

编辑器代码上下文选项已经过修改。 Box 会显示所有上下文行直到最大行数。 点击一个上下文行会使编辑器跳转到该行。 自定义主题的上下文颜色已添加到 Settings 对话框的 Highlights 选项卡。 （由 Cheryl Sabella 和 Terry Jan Reedy 在 bpo-33642 [https://bugs.python.org/issue?@action=redirect&bpo=33642], bpo-33768 [https://bugs.python.org/issue?@action=redirect&bpo=33768] 和 bpo-33679 [https://bugs.python.org/issue?@action=redirect&bpo=33679] 中贡献。）

在 Windows 上，会有新的 API 调用将 tk 对 DPI 的调整告知 Windows。 在 Windows 8.1+ 或 10 上，如果 Python 二进制码的 DPI 兼容属性未改变，并且监视器分辨率大于 96 DPI，这应该会令文本和线条更清晰。 否则的话它应该不造成影响。 （由 Terry Jan Reedy 在 bpo-33656 [https://bugs.python.org/issue?@action=redirect&bpo=33656] 中贡献。）

在 3.6.7 中新增:

超过 N 行（默认值为 50）的输出将被折叠为一个按钮。 N 可以在 Settings 对话框的 General 页的 PyShell 部分中进行修改。 数量较少但是超长的行可以通过在输出上右击来折叠。 被折叠的输出可通过双击按钮来展开，或是通过右击按钮来放入剪贴板或是单独的窗口。 （由 Tal Einat 在 bpo-1529353 [https://bugs.python.org/issue?@action=redirect&bpo=1529353] 中贡献。）

importlib

现在导入操作在无法找到模块时将引发新的异常 ModuleNotFoundError (ImportError 的子类)。 目前 (在 try-except 中) 检测 ImportError 的代码仍将有效。 （由 Eric Snow 在 bpo-15767 [https://bugs.python.org/issue?@action=redirect&bpo=15767] 中贡献。）

importlib.util.LazyLoader 现在将调用被包装的加载器上的 create_module()，移除了 importlib.machinery.BuiltinImporter 和 importlib.machinery.ExtensionFileLoader 不能用于 importlib.util.LazyLoader 的限制。

importlib.util.cache_from_source(), importlib.util.source_from_cache() 和 importlib.util.spec_from_file_location() 现在将接受 path-like object。

inspect

inspect.signature() 函数现在会报告编译器为推导式和生成器表达式作用域生成的隐式 .0 形参，就像它们是调用implicit0 时的仅限位置形参一样。 （由 Jelle Zijlstra 在 bpo-19611 [https://bugs.python.org/issue?@action=redirect&bpo=19611] 中贡献。）

为了减少从 Python 2.7 和旧式 inspect.getargspec() API 升级时的代码问题，先前被写入文档的对 inspect.getfullargspec() 的弃用已被撤销。 虽然这个函数对于单/源 Python 2/3 代码库来说很方便，但对于新代码来说功能更丰富的 inspect.signature() 接口仍然是推荐的方式。 （由 Nick Coghlan 在 bpo-27172 [https://bugs.python.org/issue?@action=redirect&bpo=27172] 中贡献。）

json

现在 json.load() 和 json.loads() 均支持二进制输入。 已编码的 JSON 应当使用 UTF-8, UTF-16 或 UTF-32 来表示。 （由 Serhiy Storchaka 在 bpo-17909 [https://bugs.python.org/issue?@action=redirect&bpo=17909] 中贡献。）

logging

新增 WatchedFileHandler.reopenIfNeeded() 方法以添加检测日志文件是否需要被重新打开的能力。 （由 Marian Horban 在 bpo-24884 [https://bugs.python.org/issue?@action=redirect&bpo=24884] 中贡献。）.)

math

为 math 和 cmath 模块增加了 tau (τ) 常量。 （由 Lisa Roach 在 bpo-12345 [https://bugs.python.org/issue?@action=redirect&bpo=12345] 中贡献，详情见 PEP 628 [https://peps.python.org/pep-0628/]。）

multiprocessing

由 multiprocessing.Manager() 返回的 代理对象 现在可以被嵌套。 （由 Davin Potts 在 bpo-6766 [https://bugs.python.org/issue?@action=redirect&bpo=6766] 中贡献。）

os

请参阅 PEP 519 的概览了解现在 os 和 os.path 模块如何支持 路径型对象 的详情。

现在 scandir() 支持 Windows 上的 bytes 路径。

新增的 close() 方法允许显式地关闭 scandir() 迭代器。 scandir() 迭代器现在支持 context manager 协议。 如果一个 scandir() 迭代器既没有被耗尽也没有被显式地关闭则会在其析构器中发出 ResourceWarning。 （由 Serhiy Storchaka 在 bpo-25994 [https://bugs.python.org/issue?@action=redirect&bpo=25994] 中贡献。）

在 Linux 上，现在 os.urandom() 会阻塞直到系统的 urandom 熵池被初始化以提升安全性。 其理由参见 PEP 524 [https://peps.python.org/pep-0524/]。

Linux getrandom() 系统调用（获取随机字节数据）现在被暴露为新的 os.getrandom() 函数。 （由 Victor Stinner 贡献，为 PEP 524 [https://peps.python.org/pep-0524/] 的一部分）

pathlib

pathlib 现在支持 路径型对象。 （由 Brett Cannon 在 bpo-27186 [https://bugs.python.org/issue?@action=redirect&bpo=27186] 中贡献。）

请参阅 PEP 519 的概览了解详情。

pdb

Pdb 类构造器新增可选的 readrc 参数用来控制是否应当读取 .pdbrc 文件。

pickle

需要附带关键字参数调用 __new__ 的对象现在可以使用早于协议版本 4 的 pickle 协议 来 pickle。 协议版本 4 之前已支持此场景。 （由 Serhiy Storchaka 在 bpo-24164 [https://bugs.python.org/issue?@action=redirect&bpo=24164] 中贡献。）

pickletools

现在 pickletools.dis() 将为 MEMOIZE 操作码输出隐式的 memo 索引。 （由 Serhiy Storchaka 在 bpo-25382 [https://bugs.python.org/issue?@action=redirect&bpo=25382] 中贡献。）

pydoc

pydoc 模块将能遵守 MANPAGER 环境变量的设置。 （由 Matthias Klose 在 bpo-8637 [https://bugs.python.org/issue?@action=redirect&bpo=8637] 中贡献。）

help() 和 pydoc 现在将以具名元组字段被定义的顺序而非字母顺序列出它们。 （由 Raymond Hettinger 在 bpo-24879 [https://bugs.python.org/issue?@action=redirect&bpo=24879] 中贡献。）

random

新增 choices() 函数用于从给定的总体中返回指定大小的元素列表并有可选权重。 （由 Raymond Hettinger 在 bpo-18844 [https://bugs.python.org/issue?@action=redirect&bpo=18844] 中贡献。）

re

在正则表达式中增加了对修饰符区段的支持。 示例: '(?i:p)ython' 匹配 'python' 和 'Python'，但不匹配 'PYTHON'；'(?i)g(?-i:v)r' 匹配 'GvR' 和 'gvr'，但不匹配 'GVR'。 （由 Serhiy Storchaka 在 bpo-433028 [https://bugs.python.org/issue?@action=redirect&bpo=433028] 中贡献。）

Match 对象分组可通过 __getitem__ 来访问，这等价于 group()。 因此 mo['name'] 现在将等价于 mo.group('name')。 （由 Eric Smith 在 bpo-24454 [https://bugs.python.org/issue?@action=redirect&bpo=24454] 中贡献。）

Match 对象现在支持将 索引型对象 作为分组索引。 （由 Jeroen Demeyer 和 Xiang Zhang 在 bpo-27177 [https://bugs.python.org/issue?@action=redirect&bpo=27177] 中贡献。）

readline

新增 set_auto_history() 来启用或禁用历史列表输入的自动添加。 （由 Tyler Crompton 在 bpo-26870 [https://bugs.python.org/issue?@action=redirect&bpo=26870] 中贡献。）

rlcompleter

私有和特殊属性名称现在会被省略除非带有以下划线开头的前缀。 在某些已完成的关键字后会加上空格或冒号。 （由 Serhiy Storchaka 在 bpo-25011 [https://bugs.python.org/issue?@action=redirect&bpo=25011] 和 bpo-25209 [https://bugs.python.org/issue?@action=redirect&bpo=25209] 中贡献。）

shlex

shlex 通过新的 punctuation_chars 参数来控制哪些字符会被当作标点符号大幅度地 改进了 shell 兼容性。 （由 Vinay Sajip 在 bpo-1521950 [https://bugs.python.org/issue?@action=redirect&bpo=1521950] 中贡献。）

site

当在 .pth 文件中指定要添加到 sys.path 的路径时，现在你可以指定位于目录顶部的文件路径（例如 zip 文件）。 （由 Wolfgang Langner 在 bpo-26587 [https://bugs.python.org/issue?@action=redirect&bpo=26587] 中贡献。）

sqlite3

sqlite3.Cursor.lastrowid 现在支持 REPLACE 语句。 （由 Alex LordThorsen 在 bpo-16864 [https://bugs.python.org/issue?@action=redirect&bpo=16864] 中贡献。）

socket

ioctl() 函数现在支持 SIO_LOOPBACK_FAST_PATH 控制码。 （由 Daniel Stokes 在 bpo-26536 [https://bugs.python.org/issue?@action=redirect&bpo=26536] 中贡献。）

getsockopt() 常量 SO_DOMAIN, SO_PROTOCOL, SO_PEERSEC 和 SO_PASSSEC 现在已得到支持。 （由 Christian Heimes 在 bpo-26907 [https://bugs.python.org/issue?@action=redirect&bpo=26907] 中贡献。）

setsockopt() 现在支持 setsockopt(level, optname, None, optlen: int) 的形式。 （由 Christian Heimes 在 bpo-27744 [https://bugs.python.org/issue?@action=redirect&bpo=27744] 中贡献。）

现在 socket 模块已支持地址族 AF_ALG 到 Linux Kernel crypto API 的接口。 增加了 ALG_*, SOL_ALG 和 sendmsg_afalg()。 （由 Christian Heimes 在 bpo-27744 [https://bugs.python.org/issue?@action=redirect&bpo=27744] 中贡献并得到 Victor Stinner 的协助。）

新增 Linux 常量 TCP_USER_TIMEOUT 和 TCP_CONGESTION。 （由 Omar Sandoval 在 bpo-26273 [https://bugs.python.org/issue?@action=redirect&bpo=26273] 中贡献。）

socketserver

基于 socketserver 模块的服务器，包括在 http.server、xmlrpc.server 和 wsgiref.simple_server 中定义的服务器，现在都支持 context manager 协议。（由 Aviv Palivoda 在 bpo-26404 [https://bugs.python.org/issue?@action=redirect&bpo=26404] 中贡献。）

StreamRequestHandler 类的 wfile 属性现在实现了 io.BufferedIOBase 可写接口。 特别地，现在调用 write() 会保证完整地发送数据。 （由 Martin Panter 在 bpo-26721 [https://bugs.python.org/issue?@action=redirect&bpo=26721] 中贡献。）

ssl

ssl 已支持 OpenSSL 1.1.0。 最低的建议版本为 1.0.2。 （由 Christian Heimes 在 bpo-26470 [https://bugs.python.org/issue?@action=redirect&bpo=26470] 中贡献。）

已从默认的密码套件中删除 3DES 并添加了 ChaCha20 Poly1305 密码套件。 （由 Christian Heimes 在 bpo-27850 [https://bugs.python.org/issue?@action=redirect&bpo=27850] 和 bpo-27766 [https://bugs.python.org/issue?@action=redirect&bpo=27766] 中贡献。）

SSLContext 已具有更好的选项和密码配置。 （由 Christian Heimes 在 bpo-28043 [https://bugs.python.org/issue?@action=redirect&bpo=28043] 中贡献。）.) SSL 会话可以通过新的 SSLSession 类从一个客户端连接复制到另一个。 TLS 会话恢复可以加快初始握手过程、减少延迟并提升性能。 （由 Christian Heimes 根据 Alex Warhawk 的草案在 bpo-19500 [https://bugs.python.org/issue?@action=redirect&bpo=19500] 中贡献。）

新的 get_ciphers() 方法可被用来获取按密码优先级排序的已启用密码列表。

所有常量和旗标都已被转换为 IntEnum 和 IntFlags。 （由 Christian Heimes 在 bpo-28025 [https://bugs.python.org/issue?@action=redirect&bpo=28025] 中贡献。）

为 SSLContext 添加了服务器和客户端专属的 TLS 协议。 （由 Christian Heimes 在 bpo-28085 [https://bugs.python.org/issue?@action=redirect&bpo=28085] 中贡献。）

增加了 ssl.SSLContext.post_handshake_auth 以启用并通过 ssl.SSLSocket.verify_client_post_handshake() 来初始化 TLS 1.3 握手后验证。 （由 Christian Heimes 在 gh-78851 [https://github.com/python/cpython/issues/78851] 中贡献。）

statistics

新增 harmonic_mean() 函数。 （由 Steven D'Aprano 在 bpo-27181 [https://bugs.python.org/issue?@action=redirect&bpo=27181] 中贡献。）

struct

现在 struct 可通过 'e' 格式说明符支持 IEEE 754 半精度浮点数。 （由 Eli Stevens 和 Mark Dickinson 在 bpo-11734 [https://bugs.python.org/issue?@action=redirect&bpo=11734] 中贡献。）

subprocess

现在 subprocess.Popen 析构器会在子进程仍然运行时发出 ResourceWarning 警告。 请使用上下文管理器协议 (with proc: …) 或显式地调用 wait() 方法来读取子进程的退出状态。 （由 Victor Stinner 在 bpo-26741 [https://bugs.python.org/issue?@action=redirect&bpo=26741] 中贡献。）

subprocess.Popen 构造器以及所有会向其传递参数的函数现在可接受 encoding 和 errors 参数。 指定这两者中的任何一个都将为 stdin, stdout 和 stderr 流启用文本模式。 （由 Steve Dower 在 bpo-6135 [https://bugs.python.org/issue?@action=redirect&bpo=6135] 中贡献。）

sys

新的 getfilesystemencodeerrors() 函数可返回在 Unicode 文件名和 bytes 文件名之间进行转换时使用的错误模式的名称。 （由 Steve Dower 在 bpo-27781 [https://bugs.python.org/issue?@action=redirect&bpo=27781] 中贡献。）

在 Windows 上 getwindowsversion() 函数的返回值现在将包括 platform_version 字段，该字段包含当前操作系统准确的主版本、次版本和构建版本号，而不是进行所模拟的版本信息。 （由 Steve Dower 在 bpo-27932 [https://bugs.python.org/issue?@action=redirect&bpo=27932] 中提供贡献。）

telnetlib

现在 telnetlib.Telnet 是一个上下文管理器。 （由 Stéphane Wirtel 在 bpo-25485 [https://bugs.python.org/issue?@action=redirect&bpo=25485] 中贡献。）

time

现在 struct_time 的属性 tm_gmtoff 和 tm_zone 在所有平台上均可用。

timeit

新增的 Timer.autorange() 便捷方法会重复调用 Timer.timeit() 以使总运行时间大于等于 200 毫秒。 （由 Steven D'Aprano 在 bpo-6422 [https://bugs.python.org/issue?@action=redirect&bpo=6422] 中贡献。）

现在 timeit 在最佳时间和最差时间之间存在显著（4 倍）差异时将会发出警告。 （由 Serhiy Storchaka 在 bpo-23552 [https://bugs.python.org/issue?@action=redirect&bpo=23552] 中贡献。）

tkinter

在 tkinter.Variable 类中添加了方法 trace_add(), trace_remove() 和 trace_info()。 它们取代了使用过时 Tcl 命令的旧方法 trace_variable(), trace(), trace_vdelete() 和 trace_vinfo()，旧方法在未来版本的 Tcl 中可能会无法使用。 （由 Serhiy Storchaka 在 bpo-22115 [https://bugs.python.org/issue?@action=redirect&bpo=22115] 中贡献。）

回溯

traceback 模块和解释器的内置异常显示现在都会对回溯中重复行的长序列进行缩写，如下面的例子所示:

  1. >>> def f(): f()
  2. ...
  3. >>> f()
  4. Traceback (most recent call last):
  5.   File "<stdin>", line 1, in <module>
  6.   File "<stdin>", line 1, in f
  7.   File "<stdin>", line 1, in f
  8.   File "<stdin>", line 1, in f
  9.   [Previous line repeated 995 more times]
  10. RecursionError: maximum recursion depth exceeded

（由 Emanuel Barry在 bpo-26823 [https://bugs.python.org/issue?@action=redirect&bpo=26823] 中贡献。）

tracemalloc

tracemalloc 模块现在支持跟踪在多个不同地址空间中的内存分配情况。

新增 DomainFilter 过滤器类用于按地址空间（域）过滤块跟踪信息。

（由 Victor Stinner 在 bpo-26588 [https://bugs.python.org/issue?@action=redirect&bpo=26588] 中贡献。）

typing

由于 typing 模块处于 暂定状态，在 Python 3.6 中引入的所有改变都已被反向移植到 Python 3.5.x。

typing 模块对泛型类别名的支持得到大幅改进。 例如 Dict[str, Tuple[S, T]] 现在将是有效的类型标注。 （由 Guido van Rossum 在 Github #195 中贡献 [https://github.com/python/typing/pull/195]。）

增加 typing.ContextManager 类用来表示 contextlib.AbstractContextManager。 （由 Brett Cannon 在 bpo-25609 [https://bugs.python.org/issue?@action=redirect&bpo=25609] 中贡献。）

增加 typing.Collection 类用来表示 collections.abc.Collection。 （由 Ivan Levkivskyi 在 bpo-27598 [https://bugs.python.org/issue?@action=redirect&bpo=27598] 中贡献。）

增加 typing.ClassVar 类型结构体用来标记类变量。 变量标注在 PEP 526 [https://peps.python.org/pep-0526/] 中被引入，包装在 ClassVar 中的变量标注表示给定的属性将被用作类变量而不应在该类的实例上设置。 （由 Ivan Levkivskyi 在 Github #280 中贡献 [https://github.com/python/typing/pull/280]。) 新增 TYPE_CHECKING 常量将被静态类型检查器视为 True，但在运行时将为 False。 （由 Guido van Rossum 在 Github #230 中贡献 [https://github.com/python/typing/issues/230]。）

新增 NewType() 辅助函数用来创建针对标注的轻量级单独类型:

  1. from typing import NewType
  2.  
  3. UserId = NewType('UserId', int)
  4. some_id = UserId(524313)

静态类型检查器将把新类型当作原始类型的子类来处理。 （由 Ivan Levkivskyi 在 Github #189 中贡献 [https://github.com/python/typing/issues/189]。）

unicodedata

unicodedata 模块现在使用来自 Unicode 9.0.0 [https://unicode.org/versions/Unicode9.0.0/] 的数据。 （由 Benjamin Peterson 贡献。）

unittest.mock

Mock 类具有以下改进：

urllib.request

如果一个 HTTP 请求具有文件或可迭代对象请求体（而不是 bytes 对象）但没有 Content-Length 标头，AbstractHTTPHandler 现在将不会抛出错误，而是回退为使用分块传输编码格式。 （由 Demian Brecht 和 Rolf Krahl 在 bpo-12319 [https://bugs.python.org/issue?@action=redirect&bpo=12319] 中贡献。）

urllib.robotparser

RobotFileParser 现在将支持 Crawl-delay 和 Request-rate 扩展。 （由 Nikolay Bogoychev 在 bpo-16099 [https://bugs.python.org/issue?@action=redirect&bpo=16099] 中贡献。）

venv

venv 接受一个新的形参 --prompt。 此形参提供了用于虚拟环境的替代前缀。 （由 Łukasz Balcerzak 提议并由 Stéphane Wirtel 在 bpo-22829 [https://bugs.python.org/issue?@action=redirect&bpo=22829] 中移植到 3.6。）

warnings

为 warnings.warn_explicit() 新增可选的 source 形参：被销毁的对象将发出 ResourceWarning。 还为 warnings.WarningMessage 增加了 source 属性。 （由 Victor Stinner 在 bpo-26568 [https://bugs.python.org/issue?@action=redirect&bpo=26568] 和 bpo-26567 [https://bugs.python.org/issue?@action=redirect&bpo=26567] 中贡献。）

当一个 ResourceWarning 警告被记入日志时，现在会使用 tracemalloc 模块来尝试提取分配给已销毁对象的回溯信息。

使用 example.py 脚本的示例:

  1. import warnings
  2.  
  3. def func():
  4.     return open(__file__)
  5.  
  6. f = func()
  7. f = None

命令 python3.6 -Wd -X tracemalloc=5 example.py 的输出:

  1. example.py:7: ResourceWarning: unclosed file <_io.TextIOWrapper name='example.py' mode='r' encoding='UTF-8'>
  2.   f = None
  3. Object allocated at (most recent call first):
  4.   File "example.py", lineno 4
  5.     return open(__file__)
  6.   File "example.py", lineno 6
  7.     f = func()

"Object allocated at" 回溯信息是新增的并且仅当 tracemalloc 在跟踪 Python 内存分配且 warnings 模块已被导入时才会显示。

winreg

增加了 64 位整数类型 REG_QWORD。 （由 Clement Rouault 在 bpo-23026 [https://bugs.python.org/issue?@action=redirect&bpo=23026] 中贡献。）

winsound

允许将关键字参数传给 Beep, MessageBeep 和 PlaySound (bpo-27982 [https://bugs.python.org/issue?@action=redirect&bpo=27982])。

xmlrpc.client

xmlrpc.client 模块现在支持反 marshall 由 Apache XML-RPC 的数字和 None 实现所使用的附加数据类型。 （由 Serhiy Storchaka 在 bpo-26885 [https://bugs.python.org/issue?@action=redirect&bpo=26885] 中贡献。）

zipfile

新增的 ZipInfo.from_file() 类方法允许基于文件系统中的文件创建 ZipInfo 实例。 新增的 ZipInfo.is_dir() 方法可被用来检测 ZipInfo 实例是否代表一个目录。 （由 Thomas Kluyver 在 bpo-26039 [https://bugs.python.org/issue?@action=redirect&bpo=26039] 中贡献。）

现在 ZipFile.open() 方法可被用来将数据写入 ZIP 文件，以及提取数据。 （由 Thomas Kluyver 在 bpo-26039 [https://bugs.python.org/issue?@action=redirect&bpo=26039] 中贡献。）

zlib

现在 compress() 和 decompress() 函数均可接受关键字参数。 （分别由 Aviv Palivoda 在 bpo-26243 [https://bugs.python.org/issue?@action=redirect&bpo=26243] 以及 Xiang Zhang 在 bpo-16764 [https://bugs.python.org/issue?@action=redirect&bpo=16764] 中贡献。）

性能优化

构建和 C API 的改变

其他改进

  1. $ ./python -VV
  2. Python 3.6.0b4+ (3.6:223967b49e49+, Nov 21 2016, 20:55:04)
  3. [GCC 4.2.1 Compatible Apple LLVM 8.0.0 (clang-800.0.42.1)]

弃用

新关键字

不建议将 async 和 await 作为变量、类、函数或模块的名称。 它们通过 PEP 492 [https://peps.python.org/pep-0492/] 在 Python 3.5 中被引入，并将在 Python 3.7 成为保留关键字。 从 Python 3.6 开始，使用 async 或 await 作为名称将会产生 DeprecationWarning。

已弃用的 Python 行为

在生成器内部引发 StopIteration 异常现在将产生 DeprecationWarning，并将在 Python 3.7 中触发 RuntimeError。 详情参见 PEP 479：更改生成器内部的 StopIteration 处理。

现在 __aiter__() 方法应当直接返回一个异步迭代器而非如之前那样返回一个可等待对象。 继续返回可等待对象将触发 DeprecationWarning。 向下兼容将在 Python 3.7 中被移除。 （由 Yury Selivanov 在 bpo-27243 [https://bugs.python.org/issue?@action=redirect&bpo=27243] 中贡献。）

现在如果一个反斜杠-字符对不是有效的转义序列则会产生 DeprecationWarning。 虽然这最终会改为 SyntaxError，但在近几个 Python 发布版都不会实施。 （由 Emanuel Barry 在 bpo-27364 [https://bugs.python.org/issue?@action=redirect&bpo=27364] 中贡献。）

当执行相对导入时，现在当 __spec__ 或 __package__ 未被定义时从调用方模块回退到 __name__ 和 __path__ 会引发 ImportWarning。 （由 Rose Ames 在 bpo-25791 [https://bugs.python.org/issue?@action=redirect&bpo=25791] 中贡献。）

已弃用的 Python 模块、函数和方法

asynchat

asynchat 已被弃用而应改用 asyncio。 （由 Mariatta 在 bpo-25002 [https://bugs.python.org/issue?@action=redirect&bpo=25002] 中贡献。）

asyncore

asyncore 已被弃用而应改用 asyncio。 （由 Mariatta 在 bpo-25002 [https://bugs.python.org/issue?@action=redirect&bpo=25002] 中贡献。）

dbm

与其他 dbm 实现不同，dbm.dumb 模块会以 'rw' 模式创建数据库并允许修改以 'r' 模式打开的数据库。 此行为现在已被弃用并将在 3.8 中移除。 （由 Serhiy Storchaka 在 bpo-21708 [https://bugs.python.org/issue?@action=redirect&bpo=21708] 中贡献。）

distutils

未写入文档的传给 distutils.Distribution 构造器的 extra_path 参数现在已被弃用，如果设置将会引发警告。 未来的 Python 发布版将会移除对此形参的支持。 详情参见 bpo-27919 [https://bugs.python.org/issue?@action=redirect&bpo=27919]。

grp

在 getgrgid() 中对非整数参数的支持已被弃用。 （由 Serhiy Storchaka 在 bpo-26129 [https://bugs.python.org/issue?@action=redirect&bpo=26129] 中贡献。）

importlib

现在 importlib.machinery.SourceFileLoader.load_module() 和 importlib.machinery.SourcelessFileLoader.load_module() 方法已被弃用。 它们是 importlib 中仅存的尚未在之前的 Python 版本中被弃用并改为 importlib.abc.Loader.exec_module() 的 importlib.abc.Loader.load_module() 实现。

现在 importlib.machinery.WindowsRegistryFinder 类已被弃用。 在 3.6.0 中，默认它仍会被添加到 sys.meta_path (对于 Windows)，但这可能在未来发生改变。

os

未写入文档的对于将普通 字节型对象 作为 os 的函数, compile() 及类似函数中的路径的支持现已被弃用。 （由 Serhiy Storchaka 在 bpo-25791 [https://bugs.python.org/issue?@action=redirect&bpo=25791] 和 bpo-26754 [https://bugs.python.org/issue?@action=redirect&bpo=26754] 中贡献。）

re

对于在正则表达式中间使用内联旗标 (?letters) 的支持已被弃用并将在未来的 Python 版本中移除。 在正则表达式开头的旗标仍然被允许。 （由 Serhiy Storchaka 在 bpo-22493 [https://bugs.python.org/issue?@action=redirect&bpo=22493] 中贡献。）

ssl

OpenSSL 0.9.8, 1.0.0 和 1.0.1 已被弃用并不再受支持。 未来的 ssl 模块将至少需要 OpenSSL 1.0.2 或 1.1.0。

ftplib, http.client, imaplib, poplib 和 smtplib 中的 SSL 相关参数如 certfile, keyfile 和 check_hostname 已被弃用而应改用 context。 （由 Christian Heimes 在 bpo-28022 [https://bugs.python.org/issue?@action=redirect&bpo=28022] 中贡献。）

ssl 模块中的多个协议和函数现已被弃用。 某些特性在未来的 OpenSSL 版本中将不再可用。 另一些特性则因建议使用不同的 API 而被弃用。 （由 Christian Heimes 在 bpo-28022 [https://bugs.python.org/issue?@action=redirect&bpo=28022] 和 bpo-26470 [https://bugs.python.org/issue?@action=redirect&bpo=26470] 中贡献。）

tkinter

现在 tkinter.tix 模块已被弃用。 tkinter 用户应当改用 tkinter.ttk。

venv

pyvenv 脚本已被弃用而应改用 python3 -m venv。 这可以避免 pyvenv 容易混淆所连接的 Python 解释器从而导致弄错虚拟环境所使用的 Python 解释器这样的问题。 （由 Brett Cannon 在 bpo-25154 [https://bugs.python.org/issue?@action=redirect&bpo=25154] 中贡献。）

xml

已弃用的 C API 函数和类型

未写入文档的函数 PyUnicode_AsEncodedObject(), PyUnicode_AsDecodedObject(), PyUnicode_AsEncodedUnicode() 和 PyUnicode_AsDecodedUnicode() 现已被弃用。 请改用 基于泛型编解码器的 API。

弃用的构建选项

现在 --with-system-ffi 配置旗标在非 macOS UNIX 平台上将默认启用。 它可以通过 --without-system-ffi 来禁用，但该旗标已被弃用并将在 Python 3.7 中不再被接受。 macOS 不会受此变化的影响。 请注意许多 OS 发布方在构建它们的系统 Python 时已经使用了 --with-system-ffi 旗标。

移除

API 与特性的移除

  • 正则表达式中由 '\' 和一个 ASCII 字母组成的未知转义序列现在将导致报错。 它们在 re.sub() 的替换模板中仍被允许，但已被弃用。 现在 re.LOCALE 旗标只能用于二进制模式。

  • inspect.getmoduleinfo() 已被移除（自 CPython 3.3 起已被弃用）。 应当使用 inspect.getmodulename() 来获取对应于给定路径的模块名称。 （由 Yury Selivanov 在 bpo-13248 [https://bugs.python.org/issue?@action=redirect&bpo=13248] 中贡献。）

  • traceback.Ignore 类和 traceback.usage, traceback.modname, traceback.fullmodname, traceback.find_lines_from_code, traceback.find_lines, traceback.find_strings, traceback.find_executable_lines 等方法已从 traceback 模块中移除。 它们是自 Python 3.2 起即已被弃用的未写入文档的方法并可通过私有方法使用等价的功能。

  • tkinter 控件类中的 tk_menuBar() 和 tk_bindForTraversal() 虚拟方法已被移除（相应的 Tk 命令自 Tk 4.0 起即已过时）。

  • zipfile.ZipFile 类的 open() 方法已不再支持 'U' 模式（自 Python 3.4 起已被弃用）。 请使用 io.TextIOWrapper 以 universal newlines 模式读取压缩文本文件。

  • 未写入文档的 IN, CDROM, DLFCN, TYPES, CDIO 和 STROPTS 模块已被移除。 它们在平台专属的 Lib/plat-*/ 目录下可用，但是早已过时，在各平台上访问方式不一致，并且无人维护。 创建这些模块的脚本仍可在源代码发布包的 Tools/scripts/h2py.py [https://github.com/python/cpython/blob/v3.6.15/Tools/scripts/h2py.py] 中获取。

  • 已弃用的 asynchat.fifo 类现已被移除。

移植到Python 3.6

本节列出了先前描述的更改以及可能需要更改代码的其他错误修正.

'python' 命令行为的变化

  • 带有 COUNT_ALLOCS, SHOW_ALLOC_COUNT 或 SHOW_TRACK_COUNT 宏定义的特殊 Python 编译版的输出现在默认被关闭。 可以使用 -X showalloccount 选项重新启用它。 现在它将输出到 stderr 而不是 stdout。 （由 Serhiy Storchaka 在 bpo-23034 [https://bugs.python.org/issue?@action=redirect&bpo=23034] 中贡献。）

Python API 的变化

  1. [sdist]
  2. formats=zip

此行为已通过 Setuptools 26.0.0 反向移植到更早的 Python 版本中。

C API 的变化

CPython 字节码的改变

在 Python 3.6 中对 bytecode 进行了一些重大修改。

Python 3.6.2 中的重要变化

新增 make regen-all 构建目标

为了简化交叉编译，并确保 CPython 能够可靠地编译而不需要已存在可用的 Python 版本，基于 autotools 的构建系统将不再尝试根据文件修改时间隐式地重新编译已生成的文件。

取而代之的是，新增了一个 make regen-all 命令以便在需要时强制重新生成这些文件（例如在基于预生成版本构建了 Python 的初始版本之后）。

还定义了其他一些更具选择性的重生成目标 —— 详情参见 Makefile.pre.in [https://github.com/python/cpython/tree/3.13/Makefile.pre.in]。

（由 Victor Stinner 在 bpo-23404 [https://bugs.python.org/issue?@action=redirect&bpo=23404] 中贡献。）

Added in version 3.6.2.

移除了 make touch 构建目标

之前用于通过更新生成文件的修改时间来请求隐式的重新生成这些文件的 make touch 构建目标已被移除。

它已被新的 make regen-all 目标所替代。

（由 Victor Stinner 在 bpo-23404 [https://bugs.python.org/issue?@action=redirect&bpo=23404] 中贡献。）

在 3.6.2 版本发生变更.

Python 3.6.4 中的重要变化

曾经作为 API 一部分的 PyExc_RecursionErrorInst 单例已被移除，因为它的成员永远不会被清理，可能在解释器的最终化过程中导致段错误。 （由 Xavier de Gaye 在 bpo-22898 [https://bugs.python.org/issue?@action=redirect&bpo=22898] 和 bpo-30697 [https://bugs.python.org/issue?@action=redirect&bpo=30697] 中贡献。）

Python 3.6.5 中的重要变化

在某些情况下 locale.localeconv() 函数现在会临时将 LC_CTYPE 语言区域设为 LC_NUMERIC 语言区域。 （由 Victor Stinner 在 bpo-31900 [https://bugs.python.org/issue?@action=redirect&bpo=31900] 中贡献。）

Python 3.6.7 中的重要变化

在默认情况下 xml.dom.minidom 和 xml.sax 模块将不再处理外部实例。 另请参阅 gh-61441 [https://github.com/python/cpython/issues/61441]。

在 3.6.7 中当提供不带末尾换行符的输入时 tokenize 模块现在会隐式地发出 NEWLINE 形符。 此行为现在已与 C 分词器的内部行为相匹配。 （由 Ammar Askar 在 bpo-33899 [https://bugs.python.org/issue?@action=redirect&bpo=33899] 中贡献。）

Python 3.6.10 中的重要变化

出于重要的安全性考量，asyncio.loop.create_datagram_endpoint() 的 reuse_address 形参不再被支持。 这是由 UDP 中的套接字选项 SO_REUSEADDR 的行为导致的。 更多细节请参阅 loop.create_datagram_endpoint() 的文档。 （由 Kyle Stanley, Antoine Pitrou 和 Yury Selivanov 在 bpo-37228 [https://bugs.python.org/issue?@action=redirect&bpo=37228] 中贡献。。）

Python 3.6.13 中的重要变化

较早的 Python 版本允许同时使用 ; 和 & 作为 urllib.parse.parse_qs() 和 urllib.parse.parse_qsl() 中查询形参的分隔符。 出于安全考虑，并遵循新版的 W3C 建议，这已被更改为只允许一种分隔符，默认为 &。 这一改变也会影响 cgi.parse() 和 cgi.parse_multipart() 因为它们在内部使用了受影响的函数。 要了解更多细节，请参阅相应的文档。 （由 Adam Goldschmidt, Senthil Kumaran 和 Ken Jin 在 bpo-42967 [https://bugs.python.org/issue?@action=redirect&bpo=42967] 中贡献。）

Python 3.6.14 中的重要变化

新的安全修正将 ftplib.FTP 的行为改成当设置被动数据通道时不信任远程服务器所发送的 IPv4 地址。 我们会改为重用 ftp 服务器的 IP 地址。 对于需要原先的行为的不常见代码，请在你的 FTP 实例上将 trust_server_pasv_ipv4_address 属性设为 True。 （参见 gh-87451 [https://github.com/python/cpython/issues/87451]。）

在 URL 中存在换行符或制表符可能会导致某种形式的攻击。 根据更新了 RFC 3986 的 WHATWG 规范，解析器 urllib.parse() 将从 URL 中去除 ASCII 换行符 \n, \r 和制表符 \t 以防止这种攻击。 移除的字符将由一个新的模块层级变量 urllib.parse._UNSAFE_URL_BYTES_TO_REMOVE 来控制。 （参见 gh-88048 [https://github.com/python/cpython/issues/88048]。）