Python 3.10 有什么新變化?

帶圓括號的上下文管理器?

現(xiàn)在已支持使用外層圓括號來使多個上下文管理器可以連續(xù)多行地書寫。 這允許將過長的上下文管理器集能夠以與之前 import 語句類似的方式格式化為多行的形式。 例如，以下這些示例寫法現(xiàn)在都是有效的:

with (CtxManager() as example):
    ...

with (
    CtxManager1(),
    CtxManager2()
):
    ...

with (CtxManager1() as example,
      CtxManager2()):
    ...

with (CtxManager1(),
      CtxManager2() as example):
    ...

with (
    CtxManager1() as example1,
    CtxManager2() as example2
):
    ...

在被包含的分組末尾過可以使用一個逗號作為結束：

with (
    CtxManager1() as example1,
    CtxManager2() as example2,
    CtxManager3() as example3,
):
    ...

這個新語法使用了新解析器的非 LL(1) 功能。 請查看 PEP 617 來了解更多細節(jié)。

（由 Guido van Rossum, Pablo Galindo 和 Lysandros Nikolaou 在 bpo-12782 和 bpo-40334 中貢獻。）

更清楚的錯誤消息?

expected = {9: 1, 18: 2, 19: 2, 27: 3, 28: 3, 29: 3, 36: 4, 37: 4,
            38: 4, 39: 4, 45: 5, 46: 5, 47: 5, 48: 5, 49: 5, 54: 6,
some_other_code = foo()

File "example.py", line 3
    some_other_code = foo()
                    ^
SyntaxError: invalid syntax

File "example.py", line 1
    expected = {9: 1, 18: 2, 19: 2, 27: 3, 28: 3, 29: 3, 36: 4, 37: 4,
               ^
SyntaxError: '{' was never closed

>>> foo(x, z for z in range(10), t, w)
  File "<stdin>", line 1
    foo(x, z for z in range(10), t, w)
           ^
SyntaxError: Generator expression must be parenthesized

>>> foo(x, z for z in range(10), t, w)
  File "<stdin>", line 1
    foo(x, z for z in range(10), t, w)
           ^^^^^^^^^^^^^^^^^^^^
SyntaxError: Generator expression must be parenthesized

>>> def foo():
...    if lel:
...    x = 2
  File "<stdin>", line 3
    x = 2
    ^
IndentationError: expected an indented block after 'if' statement in line 2

>>> collections.namedtoplo
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
AttributeError: module 'collections' has no attribute 'namedtoplo'. Did you mean: namedtuple?

>>> schwarzschild_black_hole = None
>>> schwarschild_black_hole
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
NameError: name 'schwarschild_black_hole' is not defined. Did you mean: schwarzschild_black_hole?

PEP 626：在調(diào)試和其他工具中使用精確的行號?

PEP 626 帶來了更精確可靠的行號用于調(diào)試、性能分析和測試工具。 所有被執(zhí)行的代碼行都會并且只有被執(zhí)行的代碼行才會生成帶有正確行號的追蹤事件。

幀對象的 f_lineno 屬性將總是包含預期的行號。

代碼對象的 co_lnotab 屬性已被棄用并將在 3.12 中被移除。 需要從偏移量轉換為行號的代碼應改用新的 co_lines() 方法。

PEP 634：結構化模式匹配?

增加了采用模式加上相應動作的 match 語句 和 case 語句 的形式的結構化模式匹配。 模式由序列、映射、基本數(shù)據(jù)類型以及類實例構成。 模式匹配使得程序能夠從復雜的數(shù)據(jù)類型中提取信息、根據(jù)數(shù)據(jù)結構實現(xiàn)分支，并基于不同的數(shù)據(jù)形式應用特定的動作。

match subject:
    case <pattern_1>:
        <action_1>
    case <pattern_2>:
        <action_2>
    case <pattern_3>:
        <action_3>
    case _:
        <action_wildcard>

def http_error(status):
    match status:
        case 400:
            return "Bad request"
        case 404:
            return "Not found"
        case 418:
            return "I'm a teapot"
        case _:
            return "Something's wrong with the internet"

case 401 | 403 | 404:
    return "Not allowed"

def http_error(status):
    match status:
        case 400:
            return "Bad request"
        case 404:
            return "Not found"
        case 418:
            return "I'm a teapot"

# point is an (x, y) tuple
match point:
    case (0, 0):
        print("Origin")
    case (0, y):
        print(f"Y={y}")
    case (x, 0):
        print(f"X={x}")
    case (x, y):
        print(f"X={x}, Y={y}")
    case _:
        raise ValueError("Not a point")

class Point:
    x: int
    y: int

def location(point):
    match point:
        case Point(x=0, y=0):
            print("Origin is the point's location.")
        case Point(x=0, y=y):
            print(f"Y={y} and the point is on the y-axis.")
        case Point(x=x, y=0):
            print(f"X={x} and the point is on the x-axis.")
        case Point():
            print("The point is located somewhere else on the plane.")
        case _:
            print("Not a point")

Point(1, var)
Point(1, y=var)
Point(x=1, y=var)
Point(y=var, x=1)

match points:
    case []:
        print("No points in the list.")
    case [Point(0, 0)]:
        print("The origin is the only point in the list.")
    case [Point(x, y)]:
        print(f"A single point {x}, {y} is in the list.")
    case [Point(0, y1), Point(0, y2)]:
        print(f"Two points on the Y axis at {y1}, {y2} are in the list.")
    case _:
        print("Something else is found in the list.")

match test_variable:
    case ('warning', code, 40):
        print("A warning has been received.")
    case ('error', code, _):
        print(f"An error {code} occurred.")

match point:
    case Point(x, y) if x == y:
        print(f"The point is located on the diagonal Y=X at {x}.")
    case Point(x, y):
        print(f"Point is not on the diagonal.")

可選的 EncodingWarning 和 encoding="locale" 選項?

TextIOWrapper 和 open() 的默認編碼格式取決于具體的平臺和語言區(qū)域設置。 由于 UTF-8 被用于大多數(shù) Unix 平臺，當打開 UTF-8 文件 (例如 JSON, YAML, TOML, Markdown) 時省略 encoding 選項是一個非常常見的錯誤。 例如:

# BUG: "rb" mode or encoding="utf-8" should be used.
with open("data.json") as f:
    data = json.load(f)

為了便于查找此類錯誤，增加了可選的 EncodingWarning。 它會在 sys.flags.warn_default_encoding 為真值并使用了語言區(qū)域指定的默認編碼格式時被發(fā)出。

增加了 -X warn_default_encoding 選項和 PYTHONWARNDEFAULTENCODING 來啟用相應警告。

請參閱 文本編碼格式 了解更多信息。

PEP 604: 新的類型聯(lián)合運算符?

引入了啟用 X | Y 語法的類型聯(lián)合運算符。 這提供了一種表示 '類型 X 或類型 Y' 的相比使用 typing.Union 更清晰的方式，特別是在類型提示中。

在之前的 Python 版本中，要為可接受多種類型參數(shù)的函數(shù)應用類型提示，使用的是 typing.Union:

def square(number: Union[int, float]) -> Union[int, float]:
    return number ** 2

類型提示現(xiàn)在可以使用更簡潔的寫法:

def square(number: int | float) -> int | float:
    return number ** 2

這個新增語法也被接受作為 isinstance() 和 issubclass() 的第二個參數(shù):

>>> isinstance(1, int | str)
True

詳情參見 union 類型 和 PEP 604。

（由 Maggie Moss 和 Philippe Prados 在 bpo-41428 中貢獻，并由 Yurii Karabas 和 Serhiy Storchaka 在 bpo-44490 中補充。）

PEP 612: 形參規(guī)格變量?

在 typing 模塊中新增了兩個選項以改進用于 PEP 484 的 Callable 提供給靜態(tài)類型檢查器的信息。

第一個選項是形參規(guī)格變量。 它們被用來將一個可調(diào)用對象的形參類型轉發(fā)給另一個可調(diào)用對象 —— 這種模式常見于高階函數(shù)和裝飾器。 使用示例可在 typing.ParamSpec 中找到。 在之前版本中，沒有一種簡單辦法能以如此精確的方式對形參類型的依賴性進行類型標注。

第二個選項是新的 Concatenate 運算符。 它與形參規(guī)格變量一起使用以便對增加或移除了其他可調(diào)用對象的高階可調(diào)用對象進行類型標注。 使用示例可以在 typing.Concatenate 中找到。

請參閱 typing.Callable, typing.ParamSpec, typing.Concatenate, typing.ParamSpecArgs, typing.ParamSpecKwargs 和 PEP 612 來了解更多細節(jié)。

（由 Ken Jin 在 bpo-41559 中貢獻，并由 Jelle Zijlstra 在 bpo-43783 中加以少量改進。 PEP 由 Mark Mendoza 撰寫。）

PEP 613: 類型別名?

PEP 484 引入了類型別名的概念，只要求它們是不帶標注的最高層級賦值。 這種簡單性有時會使得類型檢查器難以區(qū)分類型別名和普通賦值，特別是當涉及到前向引用或無效類型的時候。 例如在比較:

StrCache = 'Cache[str]'  # a type alias
LOG_PREFIX = 'LOG[DEBUG]'  # a module constant

現(xiàn)在 typing 模塊具有一個特殊值 TypeAlias 可讓你更明確地聲明類型別名:

StrCache: TypeAlias = 'Cache[str]'  # a type alias
LOG_PREFIX = 'LOG[DEBUG]'  # a module constant

請參閱 PEP 613 了解詳情。

（由 Mikhail Golubev 在 bpo-41923 中貢獻。）

PEP 647: 用戶自定義的類型保護器?

TypeGuard 已被添加到 typing 模塊用來標注類型保護器函數(shù)并改進在類型細化期間提供給靜態(tài)類型分析器的信息。 要了解更多信息，請參閱 TypeGuard 的文檔以及 PEP 647。

（由 Ken Jin 和 Guido van Rossum 在 bpo-43766 中貢獻。 PEP 由 Eric Traut 撰寫。）

asyncio?

加入了缺失的 connect_accepted_socket() 方法。（由 Alex Gr?nholm 在 bpo-41332 中貢獻）

argparse?

在 argparse 的幫助中，將“可選參數(shù)”這一誤導性短語改為“可選項”。某些測試代碼如果依賴精確的輸出匹配，可能需要調(diào)整。（由 Raymond Hettinger 在 bpo-9694 中貢獻）

array?

現(xiàn)在， array.array 的 index() 方法擁有可選的 start 和 stop 參數(shù)。（由 Anders Lorentsen 和 Zackery Spytz 在 bpo-31956 中貢獻）

asynchat、asyncore 和 smtpd?

從 Python 3.6 開始，這些模塊在其文檔中已被標為廢棄?，F(xiàn)在這三個模塊都增加了一個導入時警告 DeprecationWarning。

base64?

增加 base64.b32hexencode() 和 base64.b32hexdecode() 以支持帶有擴展十六進制字母的 Base32 編碼。

bdb?

增加 clearBreakpoints() ，用于重置所有已設斷點。（由 Irit Katriel 在 bpo-24160 中貢獻）

bisect?

Added the possibility of providing a key function to the APIs in the bisect module. (Contributed by Raymond Hettinger in bpo-4356.)

編碼器?

增加一個 codecs.unregister() 函數(shù)，用于取消對編解碼器搜索函數(shù)的注冊。（由 Hai Shi 在 bpo-41842 中貢獻）

collections.abc?

現(xiàn)在， parameterized generic 的 collections.abc.Callable 的 __args__ 與 typing.Callable 一致了。 collections.abc.Callable generic 現(xiàn)在將類型參數(shù)扁平化了，類似于 typing.Callable 當前的做法。這意味著 collections.abc.Callable[[int, str], str] 將帶有 (int, str, str) 的參數(shù) __args__；以前是 ([int, str], str) 。為了做到這一變化， types.GenericAlias 現(xiàn)在可以被子類化，當對 collections.abc.Callable 類型進行下標訪問時，將返回一個子類。注意，collections.abc.Callable 非法的參數(shù)化形式可能會觸發(fā) TypeError ，而在 Python 3.9 中可能就靜默了。（由 Ken Jin 在 bpo-42195 中貢獻）

contextlib?

增加了一個上下文管理器 contextlib.aclosing() ，以便能安全關閉異步生成器和代表異步釋放資源的對象。（由 Joongi Kim 和 John Belmonte 在 bpo-41229 中貢獻）

為 contextlib.nullcontext() 加入異步上下文管理器支持。由 Tom Gringauz 在 bpo-41543 中貢獻）

加入 AsyncContextDecorator，以便支持用異步上下文管理器作為裝飾器。

curses?

在 ncurses 6.1 中增加的擴展顏色函數(shù)將會由 curses.color_content() 、 curses.init_color() 、 curses.init_pair() 和 curses.pair_content() 透明地使用。新增的函數(shù) curses.has_extended_color_support() 將指明下層的 ncurses 庫是否提供了擴展顏色支持。（由 Jeffrey Kintscher 和 Hans Petter Jansson 在 bpo-36982 中貢獻）

現(xiàn)在常量 BUTTON5_* 如果是由底層的 curses 庫提供的，則會在 curses 模塊中體現(xiàn)。（由 Zackery Spytz 在 bpo-39273 中貢獻）

dataclasses?

from dataclasses import dataclass

@dataclass(kw_only=True)
class Birthday:
    name: str
    birthday: datetime.date

from dataclasses import dataclass, field

@dataclass
class Birthday:
    name: str
    birthday: datetime.date = field(kw_only=True)

from dataclasses import dataclass, KW_ONLY

@dataclass
class Point:
    x: float
    y: float
    _: KW_ONLY
    z: float = 0.0
    t: float = 0.0

distutils?

整個 distutils 包已被廢棄，將在 Python 3.12 中移除。其用指定包構建程序的功能已被第三方軟件包 setuptools 和 packaging 完全取代，而且大多數(shù)其他常用的 API 在標準庫的其他地方都可以調(diào)用（如 platform 、 shutil 、 subprocess 或 sysconfig）。目前沒有遷移 distutils 其他功能的計劃，用到其他功能的應用程序應該準備好自己保留一份拷貝。請參考 PEP 632 。

在 Python 3.8 中廢棄的 bdist_wininst 命令已被移除?，F(xiàn)在在 Windows 中發(fā)布二進制包推薦采用 bdist_wheel 命令。（由 Victor Stinner 在 bpo-42802 中貢獻）

doctest?

若模塊中沒有定義 __loader__ ，則回退至使用 __spec__.loader 。（由 Brett Cannon 在 bpo-42133 中貢獻）

encodings?

現(xiàn)在 encodings.normalize_encoding() 會忽略非 ASCII 字符。（由 Hai Shi 在 bpo-39337 中貢獻）

enum?

Enum __repr__() now returns enum_name.member_name and __str__() now returns member_name. Stdlib enums available as module constants have a repr() of module_name.member_name. (Contributed by Ethan Furman in bpo-40066.)

Add enum.StrEnum for enums where all members are strings. (Contributed by Ethan Furman in bpo-41816.)

fileinput?

在 fileinput.input() 和 fileinput.FileInput 中增加了 encoding 和 errors 形參。 （由 Inada Naoki 在 bpo-43712 中貢獻。）

現(xiàn)在 fileinput.hook_compressed() 會在 mode 為 "r" 且文件被壓縮時返回 TextIOWrapper，與未壓縮文件一致。 （由 Inada Naoki 在 bpo-5758 中貢獻。）

faulthandler?

現(xiàn)在 faulthandler 模塊會檢測在垃圾回收期間是否發(fā)生嚴重錯誤。 （由 Victor Stinner 在 bpo-44466 中貢獻）

gc?

為 gc.get_objects(), gc.get_referrers() 和 gc.get_referents() 添加了審計鉤子。 （由 Pablo Galindo 在 bpo-43439 中貢獻。）

glob?

在 glob() 和 iglob() 中增加了 root_dir 和 dir_fd 形參，用于指定搜索的根目錄。（由 Serhiy Storchaka 在 bpo-38144 中貢獻）

hashlib?

hashlib 模塊要求 OpenSSL 1.1.1 或更新版本。 （由 Christian Heimes 在 PEP 644 和 bpo-43669 中貢獻。）

hashlib 模塊已初步支持 OpenSSL 3.0.0。 （由 Christian Heimes 在 bpo-38820 及其他問題事項中貢獻。）

純 Python 的回退版 pbkdf2_hmac() 已被棄用。 未來 PBKDF2-HMAC 將僅在 Python 帶有 OpenSSL 編譯時才可用。（由 Christian Heimes 在 bpo-43880 中貢獻）

hmac?

現(xiàn)在 hmac 模塊會在內(nèi)部使用 OpenSSL 的 HMAC 實現(xiàn)。 （由 Christian Heimes 在 bpo-40645 中貢獻。）

IDLE 與 idlelib?

Make IDLE invoke sys.excepthook() (when started without '-n'). User hooks were previously ignored. (Contributed by Ken Hilton in bpo-43008.)

Rearrange the settings dialog. Split the General tab into Windows and Shell/Ed tabs. Move help sources, which extend the Help menu, to the Extensions tab. Make space for new options and shorten the dialog. The latter makes the dialog better fit small screens. (Contributed by Terry Jan Reedy in bpo-40468.) Move the indent space setting from the Font tab to the new Windows tab. (Contributed by Mark Roseman and Terry Jan Reedy in bpo-33962.)

The changes above were backported to a 3.9 maintenance release.

增加了 Shell 側欄。 將主提示符（“>>>”）移至側欄。二級提示符（“...”）也加入側欄。在編輯器的行號側欄上鼠標單擊和可選的拖動，會選定一行或多行文本。在選定文本行后右擊將顯示包含“copy with prompts”的上下文菜單。這會將側欄的提示符與選定文本行合并。該選項也會在文本的上下文菜單中顯示。（由 Tal Einat 在 bpo-37903 中貢獻）

Use spaces instead of tabs to indent interactive code. This makes interactive code entries 'look right'. Making this feasible was a major motivation for adding the shell sidebar. (Contributed by Terry Jan Reedy in bpo-37892.)

Highlight the new soft keywords match, case, and _ in pattern-matching statements. However, this highlighting is not perfect and will be incorrect in some rare cases, including some _-s in case patterns. (Contributed by Tal Einat in bpo-44010.)

New in 3.10 maintenance releases.

Apply syntax highlighting to .pyi files. (Contributed by Alex Waygood and Terry Jan Reedy in bpo-45447.)

importlib.metadata?

與 importlib_metadata 4.6（history）的功能一致。

importlib.metadata entry points now provide a nicer experience for selecting entry points by group and name through a new importlib.metadata.EntryPoints class. See the Compatibility Note in the docs for more info on the deprecation and usage.

添加了 importlib.metadata.packages_distributions()，用于將頂級 Python 模塊和包解析為其 importlib.metadata.Distributions。

inspect?

若模塊中沒有定義 __loader__ ，則回退至使用 __spec__.loader 。（由 Brett Cannon 在 bpo-42133 中貢獻）

加入了 inspect.get_annotations()，以便安全地對對象中定義的注解進行求值。inspect.get_annotations() 也可以正確地解析字符串化的注解。 inspect.get_annotations() 現(xiàn)在應是訪問任何 Python 對象注解字典的最佳實踐；關于注解最佳用法的更多信息，請參見 對象注解屬性的最佳實踐。與之關聯(lián)的， inspect.signature() 、 inspect.Signature.from_callable() 和 inspect.Signature.from_function() 現(xiàn)在也調(diào)用 inspect.get_annotations() 來獲取注解信息。這意味著 inspect.signature() 和 inspect.Signature.from_callable() 現(xiàn)在也可以解析字符串化的注解了。（由 Larry Hastings 在 bpo-43817 中貢獻）

itertools?

Add itertools.pairwise(). (Contributed by Raymond Hettinger in bpo-38200.)

linecache?

若模塊中沒有定義 __loader__ ，則回退至使用 __spec__.loader 。（由 Brett Cannon 在 bpo-42133 中貢獻）

os?

為 VxWorks 實時操作系統(tǒng)加入 os.cpu_count() 的支持。（由 Peixing Xin 在:issue:41440 中貢獻）

加入一個新函數(shù) os.eventfd() 及其助手函數(shù)，以封裝 Linux 的系統(tǒng)調(diào)用 eventfd2 。(由 Christian Heimes 在 bpo-41001 中貢獻）

加入 os.splice()，以便在兩個文件描述符之間移動數(shù)據(jù)，而無需在內(nèi)核地址空間和用戶地址空間之間進行復制，其中一個文件描述符必須指向某個管道。（由 Pablo Galindo 在 bpo-41625 中貢獻）

為 macOS 加入 O_EVTONLY 、O_FSYNC 、 O_SYMLINK 和 O_NOFOLLOW_ANY 。（由 Dong-hee Na 在 bpo-43106 中貢獻）

os.path?

現(xiàn)在 os.path.realpath() 可接受一個關鍵字參數(shù) strict。 若設為 True ，則在路徑不存在或遭遇循環(huán)符號鏈接時，會觸發(fā) OSError。 （由 Barney Gale 在 bpo-43757 中貢獻。）

pathlib?

為 PurePath.parents 加入切片支持。（由Joshua Cannon 貢獻于 bpo-35498）

為 PurePath.parents 加入負數(shù)索引支持。（由 Yaroslav Pankovych 貢獻于 bpo-21041 ）

加入 Path.hardlink_to 方法，取代 link_to()。該新方法的參數(shù)順序與 symlink_to() 相同。（由 Barney Gale 貢獻于 bpo-39950 中）

現(xiàn)在 pathlib.Path.stat() 和 chmod() 接受一個關鍵字參數(shù) follow_symlinks ，以便與 os 模塊中的對應函數(shù)保持一致。（由 Barney Gale 貢獻于 bpo-39906 ）

平臺?

加入 platform.freedesktop_os_release()，從標準文件 freedesktop.org os-release 中獲取操作系統(tǒng)標識。（由 Christian Heimes 貢獻于 bpo-28468 ）

pprint?

現(xiàn)在 pprint.pprint() 接受一個新的關鍵字參數(shù) underscore_numbers。（由 sblondon 貢獻于 bpo-42914 ）

現(xiàn)在 pprint 可以完美打印 dataclasses.dataclass 實例。（由 Lewis Gaul 貢獻于 bpo-43080 ）

py_compile?

py_compile' 的命令行界面加入 `--quiet`` 選項。（由 Gregory Schevchenko 貢獻于 bpo-38731 ）

pyclbr?

在 pyclbr.readline() 和 pyclbr.readline_ex() 返回的結果樹中的``Function`` 和 Class 對象上增加一個 end_lineno 屬性。與現(xiàn)有的（開始）``lineno`` 相匹配。（由 Aviral Srivastava 貢獻于 bpo-38307）

shelve?

現(xiàn)在 shelve 模塊在創(chuàng)建打包時，默認采用 pickle.DEFAULT_PROTOCOL，而不是 pickle 協(xié)議 3 。（由 Zackery Spytz 貢獻于 bpo-34204 ）

statistics?

加入 covariance() 、Pearson 的 correlation() 和簡單的 linear_regression() 函數(shù)。（由 Tymoteusz Wo?od?ko 貢獻于 bpo-38490 ）

site?

若模塊中沒有定義 __loader__ ，則回退至使用 __spec__.loader 。（由 Brett Cannon 在 bpo-42133 中貢獻）

socket?

現(xiàn)在異常 socket.timeout 是 TimeoutError 的別名。（由 Christian Heimes 在 bpo-42413 中貢獻。）

加入用 IPPROTO_MPTCP 創(chuàng)建 MPTCP 套接字的選項（由 Rui Cunha 貢獻于 bpo-43571 ）

加入 IP_RECVTOS 選項，以便接收服務類型（ToS）或 DSCP/ECN 字段（由 Georg Sauthoff 貢獻于 bpo-44077 ）

ssl?

ssl 模塊要求 OpenSSL 1.1.1 或更新版本。 （由 Christian Heimes 在 PEP 644 和 bpo-43669 中貢獻。）

ssl 模塊已初步支持 OpenSSL 3.0.0 和新選項 OP_IGNORE_UNEXPECTED_EOF。 （由 Christian Heimes 在 bpo-38820, bpo-43794, bpo-43788, bpo-43791, bpo-43799, bpo-43920, bpo-43789 和 bpo-43811 中貢獻。）

現(xiàn)在，已棄用函數(shù)和使用已棄用常量會導致 DeprecationWarning。 ssl.SSLContext.options 默認設置了 OP_NO_SSLv2 和 OP_NO_SSLv3 ，因而設置此標記無法再次發(fā)出警告了。 棄用部分 列出了已棄用的特性。 （由 Christian Heimes 貢獻于 bpo-43880 ）

現(xiàn)在，ssl 模塊默認設置的安全性提高了。默認情況下，不具備前向安全性或 SHA-1 MAC 的加密算法會被禁用。二級安全禁止安全性低于 112 位的弱 RSA、DH 和 ECC 密鑰。 SSLContext 默認的最低版本協(xié)議為 TLS 1.2。這些設置是基于 Hynek Schlawack 的研究。（由 Christian Heimes 貢獻于 bpo-43998 ）

已棄用的協(xié)議 SSL 3.0, TLS 1.0 和 TLS 1.1 不再受到官方支持。Python 不會直接禁用。但 OpenSSL 編譯選項、發(fā)行版配置、廠商補丁和加密套件可能會阻止握手成功。

為 ssl.get_server_certificate() 函數(shù)加入 timeout 形參。（由 Zackery Spytz 貢獻于 bpo-31870 ）

ssl 模塊用到了堆類型和多階段初始化。（由 Christian Heimes 貢獻于 bpo-42333 ）

加入一個新的校驗標記 VERIFY_X509_PARTIAL_CHAIN。（由 l0x 貢獻于 bpo-40849 ）

sqlite3?

為 connect/handle() 、 enable_load_extension() 和 load_extension() 加入審計事件。（由 Erlend E. Aasland 貢獻于 bpo-43762）

sys?

加入了 sys.orig_argv 屬性：傳給 Python 可執(zhí)行文件的初始命令行參數(shù)列表。（由 Victor Stinner 貢獻于 bpo-23427 ）

添加了 sys.stdlib_module_names，包含標準庫模塊名稱的列表。 （由 Victor Stinner 在 bpo-42955 中貢獻。）

_thread?

現(xiàn)在， _thread.interrupt_main() 接受一個可選的信號值參數(shù)進行模擬（默認仍為 signal.SIGINT）。（由 Antoine Pitrou 貢獻于 bpo-43356 ）

threading?

加入 threading.gettrace() 和 threading.getprofile() ，分別用于獲取 threading.settrace() 和 threading.setprofile() 設置的函數(shù)。（由Mario Corchero 貢獻于 bpo-42251 ）

加入 threading.__excepthook__ ，用于獲取 threading.excepthook() 的初始值，以防被設為一個差勁或其他的值。（由 Mario Corchero 貢獻于 bpo-42308 ）

traceback?

現(xiàn)在，format_exception() 、 format_exception_only() 和 print_exception() 函數(shù)可以接受一個異常對象，作為唯一的位置參數(shù)。（由 Zackery Spytz 和 Matthias Bussonnier 貢獻于 bpo-26389）

types?

重新引入 types.EllipsisType 、 types.NoneType 和 types.NotImplementedType 類，以提供一套新的類型，可供類型檢查程序解釋。（由 Bas van Beek 貢獻于 bpo-41810）

typing?

For major changes, see 有關類型提示的新增特性.

typing.Literal 的行為被改為遵循 PEP 586 并匹配該 PEP 所描述的靜態(tài)類型檢查器的行為。

1. Literal 現(xiàn)在將是去重后的形參。

2. Literal 對象的相等性比較現(xiàn)在將與順序無關。

3. Literal comparisons now respect types. For example, Literal[0] == Literal[False] previously evaluated to True. It is now False. To support this change, the internally used type cache now supports differentiating types.

4. 現(xiàn)在，如果 Literal 對象的任何參數(shù)都不是 hashable ，在相等性比較時將引發(fā) TypeError 異常。請注意，在聲明 Literal 時，參數(shù)不可哈希不會拋出錯誤：

   >>>

   >>> from typing import Literal
   >>> Literal[{0}]
   >>> Literal[{0}] == Literal[{False}]
   Traceback (most recent call last):
     File "<stdin>", line 1, in <module>
   TypeError: unhashable type: 'set'
   

（由 Yurii Karabas 在 bpo-42345 中貢獻。）

加入新函數(shù) typing.is_typeddict()，以內(nèi)部檢查注解是否為 typing.TypedDict。（由 Patrick Reader 貢獻于 bpo-41792 ）

現(xiàn)在，如果 typing.Protocol 的子類只聲明了數(shù)據(jù)變量，那么在用 isinstance 檢查時會引發(fā) TypeError，除非是用 runtime_checkable() 裝飾的。以前，這是靜默通過檢查的。如果用戶需要運行時協(xié)議，應該用 runtime_checkable() 裝飾器來裝飾其子類。（由 Yurii Karabas 貢獻于 bpo-38908 ）

Importing from the typing.io and typing.re submodules will now emit DeprecationWarning. These submodules have been deprecated since Python 3.8 and will be removed in a future version of Python. Anything belonging to those submodules should be imported directly from typing instead. (Contributed by Sebastian Rittau in bpo-38291)

unittest?

加入新方法 assertNoLogs() ，以補充現(xiàn)有的 assertLogs()。（由 Kit Yan Choi 貢獻于 bpo-39385 ）

urllib.parse?

Python 3.10 以下版本允許在 urllib.parse.parse_qs() 和 urllib.parse.parse_qsl() 中同時使用 ; 和 & 作為查詢參數(shù)分隔符。出于安全考慮，并符合 W3C 最新的建議，這已經(jīng)被修改為只允許用一種分隔符，默認值為 &。 這一改變也影響到了 cgi.parse() 和 cgi.parse_multipart()，因為他們內(nèi)部用到了這些函數(shù)。更多細節(jié)，請參閱各自的文檔。（由 Adam Goldschmidt 、 Senthil Kumaran 和 Ken Jin 貢獻于 bpo-42967 ）

xml?

在 xml.sax.handler 模塊中加入一個 LexicalHandler 類。（由 Jonathan Gossage 和 Zackery Spytz 貢獻于 bpo-35018 ）

zipimport?

加入 PEP 451 相關的方法： find_spec() 、zipimport.zipimporter.create_module() 和 zipimport.zipimporter.exec_module()。（由 Brett Cannon 貢獻于 bpo-42131 ）

加入 invalidate_caches() 方法。（由 Desmond Cheong 貢獻于 bpo-14678 ）

Python 語法中的變化?

• Deprecation warning is now emitted when compiling previously valid syntax if the numeric literal is immediately followed by a keyword (like in 0in x). In future releases it will be changed to syntax warning, and finally to a syntax error. To get rid of the warning and make the code compatible with future releases just add a space between the numeric literal and the following keyword. (Contributed by Serhiy Storchaka in bpo-43833).

Python API 的變化?

• traceback 模塊中的 format_exception() 、 format_exception_only() 和 print_exception() 函數(shù)的 etype 參數(shù)已更名為 exc 。（由 Zackery Spytz 和 Matthias Bussonnier 貢獻于 bpo-26389 ）

• atexit ： 在 Python 退出時，若用 atexit.register() 注冊的回調(diào)失敗，現(xiàn)在會記錄其異常。以前，只有部分異常被記錄，最后一個異常總是被靜默忽略。（由 Victor Stinner 貢獻于 bpo-42639 ）

• 現(xiàn)在，泛型 collections.abc.Callable 的類型參數(shù)扁平化了，類似于 typing.Callable 目前的做法。這意味著 collections.abc.Callable[[int, str], str] 的 __args__ 將為 (int, str, str)；而以前是 ([int, str], str)。 通過 typing.get_args() 或 __args__ 訪問參數(shù)的代碼需要考慮到這一變化。此外，為 collections.abc.Callable 給出無效參數(shù)可能會引發(fā) TypeError ，而在 Python 3.9 中則可能會靜默傳入。（由 Ken Jin 貢獻于 bpo-42195）

• 現(xiàn)在，如果給定的形參不是 16 位無符號整數(shù)， socket.htons() 和 socket.ntohs() 會引發(fā) OverflowError 而非 DeprecationWarning。 （由 Erlend E. Aasland 在 bpo-42393 中貢獻。）

• The loop parameter has been removed from most of asyncio's high-level API following deprecation in Python 3.8.

  現(xiàn)在如下協(xié)程：

  async def foo(loop):
      await asyncio.sleep(1, loop=loop)
  

  應替換為：

  async def foo():
      await asyncio.sleep(1)
  

  如果 foo() 被特別設計成 不 運行于當前線程的運行事件循環(huán)中（比如運行在另一個線程的事件循環(huán)中），請考慮使用 asyncio.run_coroutine_threadsafe() 來代替。

  （由 Yurii Karabas, Andrew Svetlov, Yury Selivanov 和 Kyle Stanley 在 bpo-42392 中貢獻。）

• The types.FunctionType constructor now inherits the current builtins if the globals dictionary has no "__builtins__" key, rather than using {"None": None} as builtins: same behavior as eval() and exec() functions. Defining a function with def function(...): ... in Python is not affected, globals cannot be overridden with this syntax: it also inherits the current builtins. (Contributed by Victor Stinner in bpo-42990.)

C API 的變化?

• 由于換成了新的 PEG 解析程序，C 語言 API 函數(shù)``PyParser_SimpleParseStringFlags``、PyParser_SimpleParseStringFlagsFilename、PyParser_SimpleParseFileFlags、PyNode_Compile``以及這些函數(shù)用到的類型 ``struct _node 已被刪除。

  現(xiàn)在應該用 Py_CompileString() 將源代碼直接編譯為代碼對象。然后可以用 PyEval_EvalCode() 之類的東西來對其求值。

  特別地：

  • 先 PyParser_SimpleParseStringFlags 再 PyNode_Compile 的調(diào)用，可以由 Py_CompileString() 代替。

  • PyParser_SimpleParseFileFlags 沒有直接替代品。要從 FILE * 參數(shù)編譯代碼，需要先用 C 語言讀取文件，然后將結果緩沖區(qū)傳給 Py_CompileString()。

  • 要編譯一個 char * 給定文件名的文件，先顯式打開該文件，再讀取并進行編譯。一種方法是利用 io 模塊的 PyImport_ImportModule() 、 PyObject_CallMethod() 、 PyBytes_AsString() 和 Py_CompileString()，如下圖所示。（省略了聲明和錯誤處理部分）

    io_module = Import_ImportModule("io");
    fileobject = PyObject_CallMethod(io_module, "open", "ss", filename, "rb");
    source_bytes_object = PyObject_CallMethod(fileobject, "read", "");
    result = PyObject_CallMethod(fileobject, "close", "");
    source_buf = PyBytes_AsString(source_bytes_object);
    code = Py_CompileString(source_buf, filename, Py_file_input);
    

  • For FrameObject objects, the f_lasti member now represents a wordcode offset instead of a simple offset into the bytecode string. This means that this number needs to be multiplied by 2 to be used with APIs that expect a byte offset instead (like PyCode_Addr2Line() for example). Notice as well that the f_lasti member of FrameObject objects is not considered stable: please use PyFrame_GetLineNumber() instead.

PEP 652：穩(wěn)定版 ABI 的維護?

現(xiàn)在，用于擴展模塊或嵌入 Python 的穩(wěn)定版 ABI （應用程序二進制接口）已有顯式的定義。 C API Stability 描述了 C API 和 ABI 穩(wěn)定性保證和穩(wěn)定版 ABI 的最佳實踐。

（由 Petr Viktorin 在 PEP 652 和 bpo-43795 中貢獻。）.)

新的特性?

• 現(xiàn)在 PyNumber_Index() 的結果一定是 int 類型。此前可能是 int 的子類實例。（由 Serhiy Storchaka 貢獻于 bpo-40792 ）

• Add a new orig_argv member to the PyConfig structure: the list of the original command line arguments passed to the Python executable. (Contributed by Victor Stinner in bpo-23427.)

• 加入宏 PyDateTime_DATE_GET_TZINFO() 和 PyDateTime_TIME_GET_TZINFO() ，用于訪問 datetime.datetime 和 datetime.time 對象的 tzinfo 屬性。 （由 Zackery Spytz 貢獻于 bpo-30155 ）

• 加入 PyCodec_Unregister() 函數(shù)，用于注銷編解碼器檢索函數(shù)。（由 Hai Shi 貢獻于 bpo-41842 ）

• 加入 PyIter_Send() 函數(shù)，可不觸發(fā) StopIteration 異常地向迭代器發(fā)送數(shù)據(jù)。（由 Vladimir Matveev 貢獻于 bpo-41756 ）

• 受限 C API 中加入了 PyUnicode_AsUTF8AndSize() 。（由 Alex Gaynor 貢獻于 bpo-41784 ）

• 加入 PyModule_AddObjectRef() 函數(shù)：類似于 PyModule_AddObject() 但在成功后不會偷取參數(shù)對象的引用計數(shù)。（由 Victor Stinner 貢獻于 bpo-1635741 ）

• 加入 Py_NewRef() 和 Py_XNewRef() 函數(shù)，用于遞增指定對象的引用計數(shù)并返回該對象。（由 Victor Stinner 貢獻于 bpo-42262 ）

• 現(xiàn)在， PyType_FromSpecWithBases() 和 PyType_FromModuleAndSpec() 函數(shù)可接受一個類作為 bases 參數(shù)。（由 Serhiy Storchaka 貢獻于 bpo-42423 ）

• PyType_FromModuleAndSpec() 函數(shù)現(xiàn)在接受 NULL tp_doc 槽位。 （由 Hai Shi 在 bpo-41832 中貢獻。）

• PyType_GetSlot() 函數(shù)現(xiàn)在可以接受 靜態(tài)類型。 （由 Hai Shi 和 Petr Viktorin 在 bpo-41073 中貢獻。）

• 新增 PySet_CheckExact() 函數(shù)到 C-API 用于檢查一個對象是否是 set 的實例但不是其子類型的實例。 （由 Pablo Galindo 在 bpo-43277 中貢獻。）

• 增加了 PyErr_SetInterruptEx()，它允許傳入一個信號序號用于進行模擬。 （由 Antoine Pitrou 在 bpo-43356 中貢獻。）

• 現(xiàn)在，Python 以調(diào)試模式編譯 時也支持受限 C API 的使用了（需先定義 Py_DEBUG 宏）。在受限 C API 中，如果 Python 是以調(diào)試模式編譯的，且 Py_LIMITED_API 宏以 Python 3.10 以上版本為目標，那么現(xiàn)在 Py_INCREF() 和 Py_DECREF() 函數(shù)實現(xiàn)為非透明的函數(shù)調(diào)用，而非直接訪問 PyObject.ob_refcnt 成員。在調(diào)試模式下支持受限 C API 成為可能，是因為自 Python 3.8 起 PyObject 結構體在發(fā)布模式和調(diào)試模式下是相同的（參見 bpo-36465 ）。

  在 --with-trace-refs 特殊編譯方式下（Py_TRACE_REFS 宏），仍不支持使用受限 C API 。（由 Victor Stinner 貢獻于 bpo-43688 ）

• 加入 Py_Is(x, y) 函數(shù)，用于測試 x 對象是否是 y 對象，等價于 Python 中的 x is y。還加入了 Py_IsNone() 、 Py_IsTrue() 、 Py_IsFalse() 函數(shù)，分別用于測試某對象是否為 None 單例、True 單例或 False 單例。（由 Victor Stinner 貢獻于 bpo-43753 ）

• 新增由 C 代碼控制垃圾回收器的函數(shù): PyGC_Enable(), 、PyGC_Disable() 、 PyGC_IsEnabled()。這些函數(shù)允許從 C 代碼激活、停止和查詢垃圾回收器的狀態(tài)，而不必導入 gc 模塊。

• 新增 Py_TPFLAGS_DISALLOW_INSTANTIATION 類型標記，用于禁止創(chuàng)建類型實例。（由 Victor Stinner 貢獻于 bpo-43916 ）

• 新增 Py_TPFLAGS_IMMUTABLETYPE 類型標記，用于創(chuàng)建不可變類型對象：類型的屬性不可設置或刪除。（由 Victor Stinner 和 Erlend E. Aasland 貢獻于 bpo-43908 ）

移植到 Python 3.10?

• 現(xiàn)在必須定義 PY_SSIZE_T_CLEAN 才能使用 PyArg_ParseTuple() 和 Py_BuildValue()，該格式會使用 #: es#, et#, s#, u#, y#, z#, U# 和 Z#。 參見 解析參數(shù)和構造值 以及 PEP 353。 （由 Victor Stinner 在 bpo-40943 中貢獻。）

• 由于 Py_REFCNT() 已改為內(nèi)聯(lián)靜態(tài)函數(shù)，Py_REFCNT(obj) = new_refcnt 必須換成 Py_SET_REFCNT(obj, new_refcnt): 參見 Py_SET_REFCNT() （自 Python 3.9 起提供）。為保持向下兼容，可用此宏：

  #if PY_VERSION_HEX < 0x030900A4
  #  define Py_SET_REFCNT(obj, refcnt) ((Py_REFCNT(obj) = (refcnt)), (void)0)
  #endif
  

  （由 Victor Stinner 在 bpo-39573 中貢獻。）

• 由于歷史原因，曾經(jīng)允許調(diào)用 PyDict_GetItem() 時不帶 GIL 。 現(xiàn)在則不行了。（由 Victor Stinner 貢獻于 bpo-40839 ）

• 現(xiàn)在， PyUnicode_FromUnicode(NULL, size) 和 PyUnicode_FromStringAndSize(NULL, size) 會引發(fā) DeprecationWarning。 請利用 PyUnicode_New() 獲得不帶初始數(shù)據(jù)的 Unicode 對象。（由 Inada Naoki 貢獻于 bpo-36346 ）

• 私有結構體 _PyUnicode_Name_CAPI （PyCapsule API unicodedata.ucnhash_CAPI ）已被移入內(nèi)部 C API。（由 Victor Stinner 貢獻于 bpo-42157 ）

• 現(xiàn)在，若是在 Py_Initialize() 之前去調(diào)用（在 Python 被初始化之前）， Py_GetPath(), Py_GetPrefix() 、 Py_GetExecPrefix() 、 Py_GetProgramFullPath() 、 Py_GetPythonHome() 和 Py_GetProgramName() 將返回 NULL。 請用新的 Python 初始化配置 API 來獲取 Python 路徑配置。（由 Victor Stinner 貢獻于 bpo-42260 ）

• 宏 PyList_SET_ITEM() 、 PyTuple_SET_ITEM() 和 PyCell_SET() 不可再用作左值或右值。例如，現(xiàn)在``x = PyList_SET_ITEM(a, b, c)`` 和 PyList_SET_ITEM(a, b, c) = x 會失敗并提示編譯器錯誤。 這可以防止 if (PyList_SET_ITEM (a, b, c) < 0) ... 之類的檢測發(fā)生問題。（由 Zackery Spytz 和 Victor Stinner 貢獻于 bpo-30459 ）

• 非受限 API 文件 odictobject.h 、 parser_interface.h 、 picklebufobject.h 、 pyarena.h 、 pyctype.h、 pydebug.h、 pyfpe.h 和 pytime.h 已被移至 Include/cpython 目錄。這些文件不能被直接包含，因為 Python.h 中已包含過了： Include 文件。 如果已被直接包含，請考慮改為包含 Python.h。（由 Nicholas Sim 貢獻于 bpo-35134 ）

• 請用 Py_TPFLAGS_IMMUTABLETYPE 類型標記來創(chuàng)建不可變對象。 不要依賴 Py_TPFLAGS_HEAPTYPE 來確定類型對象是否可變；請改為檢查是否設置了 Py_TPFLAGS_IMMUTABLETYPE。（由 Victor Stinner 和 Erlend E. Aasland 貢獻于 bpo-43908 ）

• 未記入文檔的函數(shù) Py_FrozenMain 已從受限 API 中移除。該函數(shù)主要適用于 Python 的定制版。（由 Petr Viktorin 貢獻于 bpo-26241 ）

棄用?

• 現(xiàn)在 PyUnicode_InternImmortal() 函數(shù)已被棄用，并將在 Python 3.12 中移除：請改用 PyUnicode_InternInPlace()。（由 Victor Stinner 貢獻于 bpo-41692 ）

移除?

• 移除了 Py_UNICODE_str* 函數(shù)，它被用于控制 Py_UNICODE* 字符串。 （由 Inada Naoki 在 bpo-41123 中貢獻。）

  • Py_UNICODE_strlen: 使用 PyUnicode_GetLength() 或 PyUnicode_GET_LENGTH

  • Py_UNICODE_strcat: 使用 PyUnicode_CopyCharacters() 或 PyUnicode_FromFormat()

  • Py_UNICODE_strcpy, Py_UNICODE_strncpy: 使用 PyUnicode_CopyCharacters() 或 PyUnicode_Substring()

  • Py_UNICODE_strcmp: 使用 PyUnicode_Compare()

  • Py_UNICODE_strncmp: 使用 PyUnicode_Tailmatch()

  • Py_UNICODE_strchr, Py_UNICODE_strrchr: 使用 PyUnicode_FindChar()

• 移除了 PyUnicode_GetMax()。 請遷移到新的 (PEP 393) API。 （由 Inada Naoki 在 bpo-41103 中貢獻。）

• 移除了 PyLong_FromUnicode()。 請遷移到 PyLong_FromUnicodeObject()。 （由 Inada Naoki 在 bpo-41103 中貢獻。）

• 移除了 PyUnicode_AsUnicodeCopy()。 請使用 PyUnicode_AsUCS4Copy() 或 PyUnicode_AsWideCharString() （由 Inada Naoki 在 bpo-41103 中貢獻。）

• 移除了 _Py_CheckRecursionLimit 變量：它已被 PyInterpreterState 結構體的 ceval.recursion_limit 所取代。 （由 Victor Stinner 在 bpo-41834 中貢獻。）

• 移除了未記入文檔的宏 Py_ALLOW_RECURSION 和 Py_END_ALLOW_RECURSION 以及 PyInterpreterState 結構體的 recursion_critical 字段。 （由 Serhiy Storchaka 在 bpo-41936 中貢獻。）

• 移除了未記入文檔的 PyOS_InitInterrupts() 函數(shù)。Python 初始化時已隱式安裝了信號處理 handler：參見 PyConfig.install_signal_handlers。（由 Victor Stinner 貢獻于 bpo-41713 ）

• 移除了 PyAST_Validate() 函數(shù)。不能再使用公有 C API 來構建 AST 對象（mod_ty 類型）了。該函數(shù)已不屬于受限 C API（PEP 384 ）。（由 Victor Stinner 貢獻于 bpo-43244 ）

• 移除了 symtable.h 頭文件及未寫入文檔的函數(shù):

  • PyST_GetScope()

  • PySymtable_Build()

  • PySymtable_BuildObject()

  • PySymtable_Free()

  • Py_SymtableString()

  • Py_SymtableStringObject()

  Py_SymtableString() 函數(shù)誤為穩(wěn)定版 ABI 卻無法使用，因為 symtable.h 頭文件不屬于受限 C API。

  請改用 Python symtable 模塊。 （由 Victor Stinner 在 bpo-43244 中貢獻。）

• PyOS_ReadlineFunctionPointer() 已從受限 C API 頭文件和 python3.dll 中移除，此 dll 為 Windows 中的穩(wěn)定版 ABI 庫。由于該函數(shù)可接受一個 FILE* 參數(shù)，所以無法保證其 ABI 穩(wěn)定性。（由 Petr Viktorin 貢獻于 bpo-43868 ）

• 移除了 ast.h, asdl.h 和 Python-ast.h 頭文件。 這些函數(shù)未入文檔且不屬于受限 C API。這些頭文件中定義的大多數(shù)名稱都不帶 Py 前綴，因此可能會造成命名沖突。比如 Python-ast.h 定義了一個 Yield 宏，就會與另一個Windows <winbase.h> 頭文件中的 Yield 沖突。請改用 Python ast 模塊。（由 Victor Stinner 貢獻于 bpo-43244 ）

• 移除了用到 struct _mod 類型的編譯器和解析器函數(shù)，因為公共的 AST C API 已被移除：

  • PyAST_Compile()

  • PyAST_CompileEx()

  • PyAST_CompileObject()

  • PyFuture_FromAST()

  • PyFuture_FromASTObject()

  • PyParser_ASTFromFile()

  • PyParser_ASTFromFileObject()

  • PyParser_ASTFromFilename()

  • PyParser_ASTFromString()

  • PyParser_ASTFromStringObject()

  這些函數(shù)未入文檔且不屬于受限 C API。（由 Victor Stinner 貢獻于 bpo-43244 ）

• 移除了包含下列函數(shù)的頭文件 pyarena.h ：

  • PyArena_New()

  • PyArena_Free()

  • PyArena_Malloc()

  • PyArena_AddPyObject()

  這些函數(shù)未記入文檔，且不屬于受限 C API，僅由編譯器內(nèi)部使用。（由 Victor Stinner 貢獻于 bpo-43244 ）

• The PyThreadState.use_tracing member has been removed to optimize Python. (Contributed by Mark Shannon in bpo-43760.)