PEP 563：延遲的標注求值?

隨著(zhù) PEP 3107 加入標注功能并在 PEP 526 進(jìn)一步細化，Python 中類(lèi)型提示的出現揭示了兩個(gè)明顯的可用性問(wèn)題：

• 標注只能使用在當前作用域中已經(jīng)存在的名稱(chēng)，也就是說(shuō)，它們不支持任何形式的前向引用；而且——

• 標注源碼對 Python 程序的啟動(dòng)時(shí)間有不利的影響。

這兩個(gè)問(wèn)題都可以通過(guò)延遲標注求值來(lái)解決。在定義標注的時(shí)候，編譯器并不會(huì )編譯執行相應表達式的代碼，而是保存與相應表達式的 AST 等價(jià)的字符串形式。如果有需要，標注可以在運行時(shí)使用 typing.get_type_hints() 進(jìn)行解析。在不需要這種解析的通常情況下，標注的存儲成本更低（因為解析器只需處理較短的字符串）且啟動(dòng)時(shí)間更短。

在可用性方面，標注現在支持向前引用，以使以下句法有效:

class C:
    @classmethod
    def from_string(cls, source: str) -> C:
        ...

    def validate_b(self, obj: B) -> bool:
        ...

class B:
    ...

由于此修改會(huì )破壞兼容性，在 Python 3.7 中此種新的行為需要在每個(gè)模塊層級上使用 __future__ 導入來(lái)啟用:

from __future__ import annotations

它將在 Python 3.10 中成為默認行為。

PEP 538: 傳統 C 區域強制轉換?

Python 3 系列有一個(gè)持續的挑戰就是為處理 7 比特位 ASCII 文本的假定編碼確定合理的默認策略，目前的設定是在非 Windows 平臺上使用默認的 C 或 POSIX 區域設置。

PEP 538 更新了默認的解釋器命令行接口，以自動(dòng)將上述區域強制轉換為可用的基于 UTF-8 的區域，具體描述可參見(jiàn)有關(guān)新增環(huán)境變量 PYTHONCOERCECLOCALE 的文檔。 以這種方式自動(dòng)設置 LC_CTYPE 意味著(zhù)核心解釋器和能感知區域的 C 擴展 (例如 readline) 都將會(huì )假定 UTF-8 已被用作默認的文本編碼，而不再是 ASCII。

PEP 11 中的平臺支持定義也已被更新以限制完整文本處理支持適當配置的基于非 ASCII 的語(yǔ)言區域。

作為此更改的一部分，當使用任何已定義的強制轉換目標區域時(shí) (目前為 C.UTF-8, C.utf8 和 UTF-8) stdin 和 stdout 默認的處理器現在將為 surrogateescape (而不是 strict)。 而無(wú)論是什么區域，stderr 默認的處理器仍為 backslashreplace。

默認情況下區域強制轉換會(huì )靜默進(jìn)行，但為了輔助調試潛在的區域相關(guān)集成問(wèn)題，可以通過(guò)設置 PYTHONCOERCECLOCALE=warn 來(lái)請求顯式地啟用警告信息（直接在 stderr 上發(fā)出）。 此設置還會(huì )使得 Python 運行時(shí)在核心解釋器初始化時(shí)如果傳統 C 區域仍然處于激活狀態(tài)時(shí)發(fā)出警告。

雖然 PEP 538 的區域強制轉換的好處在于它還會(huì )同時(shí)影響擴展模塊 (例如 GNU readline) 以及子進(jìn)程 (包括運行非 Python 應用和舊版本 Python 的子進(jìn)程)，但它也存在需要所運行系統必須存在適合的目標區域的缺點(diǎn)。 為了更好地處理沒(méi)有可用適合的目標區域的情況 (例如在 RHEL/CentOS 7 上就會(huì )出現此情況)，Python 3.7 還實(shí)現了 PEP 540: 強制 UTF-8 運行時(shí)模式。

PEP 540: 強制 UTF-8 運行時(shí)模式?

新的 -X utf8 命令行選項和 PYTHONUTF8 環(huán)境變量可被用來(lái)啟用 Python UTF-8 模式。

當處于 UTF-8 模式時(shí)，CPython 會(huì )忽略區域設置，并默認使用 UTF-8 編碼。 用于 sys.stdin 和 sys.stdout 流的錯誤處理器將設置為 surrogateescape。

強制 UTF-8 模式可被用來(lái)在嵌入的 Python 解釋器中改變文本處理行為，而不會(huì )改變嵌入方應用的區域設置。

PEP 540 的 UTF-8 模式的好處是不必關(guān)心運行所在系統中有哪些可用區域即可工作，但它也存在對擴展模塊 (例如 GNU readline)、運行非 Python 應用的子進(jìn)程以及運行舊版本 Python 的子進(jìn)程不起作用的缺點(diǎn)。 為了減小與這些組件通信時(shí)破壞文本數據的風(fēng)險，Python 3.7 還實(shí)現了 PEP 540: 強制 UTF-8 運行時(shí)模式)。

UTF-8 模式在語(yǔ)言區域為 C 或 POSIX 并且 PEP 538 區域強制轉換特性無(wú)法將其修改為某種基于 UTF-8 的替代項時(shí)會(huì )被默認啟用（無(wú)論修改失敗是由于設置了 PYTHONCOERCECLOCALE=0, LC_ALL 還是由于缺少適合的目標區域）。

PEP 553: 內置的 breakpoint()?

Python 3.7 包含了新的內置 breakpoint() 函數，作為一種簡(jiǎn)單方便地進(jìn)入 Python 調試器的方式。

內置 breakpoint() 會(huì )調用 sys.breakpointhook()。 在默認情況下后者會(huì )導入 pdb 然后再調用 pdb.set_trace()，但是通過(guò)將 sys.breakpointhook() 綁定到你選定的函數，breakpoint() 可以進(jìn)入任何調試器。 此外，環(huán)境變量 PYTHONBREAKPOINT 可被設置為你選定的調試器的可調用對象。 設置 PYTHONBREAKPOINT=0 會(huì )完全禁用內置 breakpoint()。

PEP 539: 用于線(xiàn)程局部存儲的新 C API?

雖然 Python 已提供了用于線(xiàn)程局部存儲支持的 C API；但原有的 線(xiàn)程局部存儲 (TLS) API 使用 int 來(lái)表示所有平臺上的 TLS 密鑰。 對于官方支持的平臺而言這通常不是問(wèn)題，但這既不符合 POSIX 標準，也不具備任何實(shí)際意義上的可移植性。

PEP 539 通過(guò)向 CPython 提供了一個(gè)新的 線(xiàn)程特定存儲 (TSS) API 來(lái)改變這一點(diǎn)，它取代了原有的 CPython 內部 TLS API 的使用，并且原有 API 已棄用。 TSS API 使用一種新類(lèi)型 Py_tss_t 而非 int 來(lái)表示 TSS 密鑰 -- 這是一種不透明類(lèi)型，其定義可能依賴(lài)于下層的 TLS 實(shí)現。 因此，這將允許在以無(wú)法安全地轉換為 int 的方式定義原生 TLS 密鑰的平臺上構建 CPython。

請注意在原生 TLS 密鑰定義方式無(wú)法被安全地轉換為 int 的平臺上，原有 TLS API 中的全部函數將無(wú)法執行并會(huì )立即返回失敗信息。 這樣能清楚地表明原有 API 在無(wú)法可靠使用的平臺上不受支持，并且不會(huì )再?lài)L試添加此類(lèi)支持。

PEP 562: 定制對模塊屬性的訪(fǎng)問(wèn)?

Python 3.7 允許在模塊上定義 __getattr__() 并且當以其他方式找不到某個(gè)模塊屬性時(shí)將會(huì )調用它。 在模塊上定義 __dir__() 現在也是允許的。

一個(gè)典型的可能有用的例子是已棄用模塊屬性和惰性加載。

PEP 564: 具有納秒級精度的新時(shí)間函數?

現代系統的時(shí)鐘精度可以超過(guò)由 time.time() 函數及其變化形式所返回的浮點(diǎn)數的有限精度。 為了避免精度損失，PEP 564 在 time 模塊中增加了原有計時(shí)器函數的六個(gè)新“納秒版”變化形式:

• time.clock_gettime_ns()

• time.clock_settime_ns()

• time.monotonic_ns()

• time.perf_counter_ns()

• time.process_time_ns()

• time.time_ns()

這些新函數會(huì )以整數值的形式返回納秒數。

Measurements show that on Linux and Windows the resolution of time.time_ns() is approximately 3 times better than that of time.time().

PEP 565: 在 __main__ 中顯示 DeprecationWarning?

DeprecationWarning 的默認處理方式已經(jīng)被更改，這此警告默認只顯示一次，僅有當直接在 __main__ 模塊中運行的代碼觸發(fā)它們時(shí)才會(huì )再次顯示。 因此，單文件腳本開(kāi)發(fā)者以及 Python 交互模式使用者應該會(huì )再次開(kāi)始看到針對他們所使用 API 的已棄用警告，但被導入應用、庫和框架模塊所觸發(fā)的已棄用警告默認將繼續隱藏。

作為此項更改的結果，標準庫現在允許開(kāi)發(fā)者在三種不同的已棄用警告行為之間進(jìn)行選擇:

• FutureWarning: 默認情況下總是會(huì )顯示，建議用于應用程序最終用戶(hù)應該看到的警告信息（例如對于已棄用的應用程序配置的設置選項）。

• DeprecationWarning: 默認情況下僅在 __main__ 中以及當運行測試時(shí)會(huì )顯示，建議用于其他 Python 開(kāi)發(fā)者應該看到的警告信息，提示版本升級可能導致行為改變或者錯誤。

• PendingDeprecationWarning: 默認情況下僅在運行測試時(shí)會(huì )顯示，可用于提示未來(lái)版本升級將會(huì )改變警告類(lèi)別為 DeprecationWarning 或 FutureWarning 的情況。

在此之前 DeprecationWarning 和 PendingDeprecationWarning 都僅在運行測試時(shí)可見(jiàn)，這意味著(zhù)主要編寫(xiě)單文件腳本或使用 Python 交互模式的開(kāi)發(fā)者可能會(huì )因他們所用 API 突然出現的改變而感到驚訝。

PEP 560: 對 typing 模塊和泛型類(lèi)型的核心支持?

PEP 484 最初的設計方式使其不會(huì )向核心 CPython 解釋器引入 任何 更改。 現在類(lèi)型提示和 typing 模塊已被社區廣泛使用，因此這個(gè)限制已被取消。 這個(gè) PEP 引入了兩個(gè)特殊方法 __class_getitem__() 和 __mro_entries__，這些方法現在被 typing 中的大多數類(lèi)和特殊構造所使用。 結果就是與類(lèi)型相關(guān)的各類(lèi)操作的速度提升了 7 倍，泛型類(lèi)型可以在沒(méi)有元類(lèi)沖突的情況下被使用，而 typing 模塊中幾個(gè)長(cháng)期存在的錯誤也已被修正。

PEP 552: 基于哈希值的 .pyc 文件?

傳統上 Python 檢查字節碼緩存文件 (即 .pyc 文件) 是否最新的方式是通過(guò)對源碼元數據 (最后更改的時(shí)間戳和大?。┖蜕删彺鏁r(shí)保存在其文件頭中的源碼元數據進(jìn)行比較。 這種檢查方法雖然有效，但也存在缺點(diǎn)。 當文件系統的時(shí)間戳太粗糙時(shí)，Python 有可能錯過(guò)源碼更新，導致用戶(hù)感到困惑。 此外，在緩存文件中存在時(shí)間戳對于 構建可再現 并且基于內容的構建系統來(lái)說(shuō)是有問(wèn)題的。

PEP 552 擴展了 pyc 格式以允許使用源文件的哈希值而非源文件的時(shí)間戳來(lái)檢查有效性。 這種 .pyc 文件就稱(chēng)為“基于哈希值的”。 默認情況下，Python 仍然使用基于時(shí)間戳的有效性檢查，不會(huì )在運行時(shí)生成基于哈希值的 .pyc 文件。 基于哈希值的 .pyc 文件可以使用 py_compile 或 compileall 來(lái)生成。

基于哈希值的 .pyc 文件包含兩種變體：已選定和未選定。 Python 會(huì )在運行時(shí)針對相應源碼文件驗證已選定基于哈希值的 .pyc 文件，但對未選定基于哈希值的 pyc 文件則不會(huì )這樣做。 未選定基于哈希值的 .pyc 文件對于需要由 Python 外部的系統（例如構建系統）負責使 .pyc 文件保持最新的環(huán)境來(lái)說(shuō)是一種有用的性能優(yōu)化。

請參閱 已緩存字節碼的失效 了解更多信息。

PEP 545: Python 文檔翻譯?

PEP 545 描述了創(chuàng )建和維護 Python 文檔翻譯的整個(gè)過(guò)程。

新增了三個(gè)新的翻譯版本:

• 日語(yǔ): https://docs.python.org/ja/

• 法語(yǔ): https://docs.python.org/fr/

• 韓語(yǔ): https://docs.python.org/ko/

Python 開(kāi)發(fā)模式 (-X dev)?

新的 -X dev 命令行選項或新的 PYTHONDEVMODE 環(huán)境變量可被用來(lái)啟用 Python 開(kāi)發(fā)模式。 在開(kāi)發(fā)模式下，Python 將執行額外的如果默認啟用會(huì )導致開(kāi)銷(xiāo)過(guò)大的運行時(shí)檢查。 請參閱 Python 開(kāi)發(fā)模式 文檔查看完整說(shuō)明。

contextvars?

新的 contextvars 模塊和一組 新的 C API 引入了對 上下文變量 的支持。 上下文變量在概念上類(lèi)似于線(xiàn)程局部變量。 與 TLS 不同，上下文變量能正確地支持異步代碼。

asyncio 和 decimal 已得到更新以使用和支持開(kāi)箱即用的上下文變量。 特別是激活的 decimal 上下文現在將存儲在上下文變量中，它允許十進(jìn)制運算在異步代碼中使用正確的上下文。

dataclasses?

新的 dataclass() 裝飾器提供了一種聲明 數據類(lèi) 的方式。 數據類(lèi)使用變量標注來(lái)描述其屬性。 它的構造器和其他魔術(shù)方法例如 __repr__(), __eq__() 以及 __hash__() 會(huì )自動(dòng)地生成。

示例:

@dataclass
class Point:
    x: float
    y: float
    z: float = 0.0

p = Point(1.5, 2.5)
print(p)   # produces "Point(x=1.5, y=2.5, z=0.0)"

importlib.resources?

新的 importlib.resources 模塊提供了一些新的 API 和一個(gè)新的 ABC 用于訪(fǎng)問(wèn)、打開(kāi)和讀取包內的 資源。 資源基本上類(lèi)似于包內的文件，但它們不一定是物理文件系統中實(shí)際的文件。 模塊加載器可以提供 get_resource_reader() 函數，它會(huì )返回一個(gè) importlib.abc.ResourceReader 實(shí)例來(lái)支持這個(gè)新 API。 內置的文件路徑加載器和 zip 文件加載器都支持此特性。

由 Barry Warsaw 和 Brett Cannon 在 bpo-32248 中貢獻。

argparse?

新的 ArgumentParser.parse_intermixed_args() 方法允許混合選項與位置參數。 （由 paul.j3 在 bpo-14191 中提供。）

asyncio?

asyncio 模塊獲得了許多新的特性、可用性和 性能提升。 重要的改變包括:

• 新的 暫定 asyncio.run() 函數可被用于通過(guò)自動(dòng)創(chuàng )建和銷(xiāo)毀事件循環(huán)來(lái)基于同步代碼運行協(xié)程。 （由 Yury Selivanov 在 bpo-32314 中貢獻。）

• asyncio 增加支持 contextvars. loop.call_soon(), loop.call_soon_threadsafe(), loop.call_later(), loop.call_at() 并且 Future.add_done_callback() 具有新的可選僅關(guān)鍵字參數 context。 現在 Tasks 會(huì )自動(dòng)跟蹤其上下文。 詳情參見(jiàn) PEP 567。 （由 Yury Selivanov 在 bpo-32436 中貢獻。）

• 增加了新的 asyncio.create_task() 函數作為 asyncio.get_event_loop().create_task() 的快捷方式。 （由 Andrew Svetlov 在 bpo-32311 中貢獻。）

• 新的 loop.start_tls() 方法可用于升級現有的 TLS 連接。 （由 Yury Selivanov 在 bpo-23749 中貢獻。）

• 新的 loop.sock_recv_into() 方法允許直接從套接字讀取數據放入所提供的緩沖區，從而可以減少數據復制。 （由 Antoine Pitrou 在 bpo-31819 中貢獻。）

• 新的 asyncio.current_task() 函數可返回當前運行的 Task 實(shí)例，以及新的 asyncio.all_tasks() 函數可返回給定循環(huán)中所有現存 Task 實(shí)例的集合。 Task.current_task() 和 Task.all_tasks() 方法已棄用。 （由 Andrew Svetlov 在 bpo-32250 中貢獻。）

• 新的 暫定 BufferedProtocol 類(lèi)允許通過(guò)手動(dòng)控制接收緩沖區來(lái)實(shí)現流式協(xié)議。 （由 Yury Selivanov 在 bpo-32251 中貢獻。）

• 新的 asyncio.get_running_loop() 函數可返回當前運行的循環(huán)，如果沒(méi)有循環(huán)在運行則引發(fā) RuntimeError。 這與 asyncio.get_event_loop() 不同，后者在沒(méi)有循環(huán)在運行時(shí)將 創(chuàng )建 一個(gè)新的事件循環(huán)。 （由 Yury Selivanov 在 bpo-32269 中提供。）

• 新的 StreamWriter.wait_closed() 協(xié)程方法允許執行等待直到流寫(xiě)入器被關(guān)閉。 新的 StreamWriter.is_closing() 方法可用于確定寫(xiě)入器是否被關(guān)閉。 （由 Andrew Svetlov 在 bpo-32391 中貢獻。）

• 新的 loop.sock_sendfile() 協(xié)程方法允許在可能的情況下使用 os.sendfile 發(fā)送文件。 （由 Andrew Svetlov 在 bpo-32410 中貢獻。）

• 新的 Future.get_loop() 和 Task.get_loop() 方法會(huì )返回創(chuàng )建 task 或 future 對象的事件循環(huán)的實(shí)例。 Server.get_loop() 允許為 asyncio.Server 對象執行同樣操作。 （由 Yury Selivanov 在 bpo-32415 中，以及由 Srinivas Reddy Thatiparthy 在 bpo-32418 中貢獻。）

• 現在可以控制 asyncio.Server 的實(shí)例如何開(kāi)啟服務(wù)。 之前，服務(wù)在創(chuàng )建后將立即開(kāi)啟服務(wù)。 新的 start_serving 關(guān)鍵字參數已添加到 loop.create_server() 和 loop.create_unix_server()，并且 Server.start_serving(), 和 Server.serve_forever() 可被用來(lái)分離服務(wù)的實(shí)例化和服務(wù)的開(kāi)啟。 新的 Server.is_serving() 方法會(huì )在服務(wù)開(kāi)啟時(shí)返回 True。 現在 Server 對象已是異步上下文管理器:

  srv = await loop.create_server(...)
  
  async with srv:
      # some code
  
  # At this point, srv is closed and no longer accepts new connections.
  

  （由 Yury Selivanov 在 bpo-32662 中貢獻。）

• 由 loop.call_later() 所返回的回調對象已獲得新的 when() 方法，該方法會(huì )返回一個(gè)排入計劃日程的絕對時(shí)間戳。 （由 Andrew Svetlov 在 bpo-32741 中貢獻。）

• loop.create_datagram_endpoint() 方法已獲得對 Unix 套接字的支持。 （由 Quentin Dawans 在 bpo-31245 中貢獻。）

• asyncio.open_connection(), asyncio.start_server() functions, loop.create_connection(), loop.create_server(), loop.create_accepted_socket() 方法及其對應的 UNIX 套接字變體現在接受 ssl_handshake_timeout 關(guān)鍵字參數。 （由 Neil Aspinall 在 bpo-29970 中貢獻。）

• 新的 Handle.cancelled() 方法會(huì )在回調被取消時(shí)返回 True。 （由 Marat Sharafutdinov 在 bpo-31943 中貢獻。）

• asyncio 源已被轉換為使用 async/await 語(yǔ)法。 （由 Andrew Svetlov 在 bpo-32193 中貢獻。）

• 新的 ReadTransport.is_reading() 方法可用于確定傳輸的讀取狀態(tài)。 此外，對 ReadTransport.resume_reading() 和 ReadTransport.pause_reading() 的調用現在是冪等的。 （由 Yury Selivanov 在 bpo-32356 中貢獻。）

• 接受套接字路徑的循環(huán)方法現在支持傳入 路徑類(lèi)對象。 （由 Yury Selivanov 在 bpo-32066 中貢獻。）

• 在 asyncio 中，Linux 上的 TCP 套接字現在創(chuàng )建時(shí)默認帶有 TCP_NODELAY 旗標設置。 （由 Yury Selivanov 和 Victor Stinner 在 bpo-27456 中貢獻。）

• 在被取消任務(wù)中發(fā)生的異常不會(huì )再被記錄。 （由 Yury Selivanov 在 bpo-30508 中貢獻。）

• 新的 WindowsSelectorEventLoopPolicy 和 WindowsProactorEventLoopPolicy 類(lèi)。 （由 Yury Selivanov 在 bpo-33792 中貢獻。）

部分 asyncio API 改為 已棄用。

binascii?

b2a_uu() 函數現在接受可選的 backtick 關(guān)鍵字參數。 當其為真值時(shí)，零會(huì )以 '`' 而非空格來(lái)表示。 （由 Xiang Zhang 在 bpo-30103 中貢獻。）

calendar?

HTMLCalendar 類(lèi)具有新的類(lèi)屬性，可以簡(jiǎn)化所生成 HTML 日歷中 CSS 類(lèi)的自定義。 （由 Oz Tiram 在 bpo-30095 中貢獻。）

collections?

collections.namedtuple() 現在支持默認值。 （由 Raymond Hettinger 在 bpo-32320 中貢獻。）

compileall?

compileall.compile_dir() 增加了新的 invalidation_mode 形參，可用于啟用 基于哈希值的 .pyc 有效性檢測。 失效模式也可以在命令行中使用新的 --invalidation-mode 參數來(lái)指定。 （由 Benjamin Peterson 在 bpo-31650 中貢獻。）

concurrent.futures?

ProcessPoolExecutor 和 ThreadPoolExecutor 現在支持新的 初始化器 以及 initargs 構造器參數。 （由 Antoine Pitrou 在 bpo-21423 中貢獻。）

ProcessPoolExecutor 現在能通過(guò)新的 mp_context 參數來(lái)接受多進(jìn)程上下文。 （由 Thomas Moreau 在 bpo-31540 中貢獻。）

contextlib?

新的 nullcontext() 是一個(gè)比 ExitStack 更簡(jiǎn)單和快速的無(wú)操作上下文管理器。 （由 Jesse-Bakker 在 bpo-10049 中貢獻。）

增加了新的 asynccontextmanager(), AbstractAsyncContextManager 和 AsyncExitStack 以補充它們所對應的同步項。 （由 Jelle Zijlstra 在 bpo-29679 和 bpo-30241 中，以及由 Alexander Mohr 和 Ilya Kulakov 在 bpo-29302 中貢獻。）

cProfile?

cProfile 命令行現在接受 -m module_name 作為腳本路徑的替代。 （由 Sanyam Khurana 在 bpo-21862 中貢獻。）

crypt?

crypt 模塊現在支持 Blowfish 哈希方法。 （由 Serhiy Storchaka 在 bpo-31664 中貢獻。）

mksalt() 函數現在允許指定哈希操作的輪數。 （由 Serhiy Storchaka 在 bpo-31702 中貢獻。）

datetime?

新的 datetime.fromisoformat() 方法會(huì )基于由 datetime.isoformat() 所輸出的某一特定格式字符串構建 datetime 對象。 （由 Paul Ganssle 在 bpo-15873 中貢獻。）

tzinfo 類(lèi)現在支持小于一分鐘的偏移量。 （由 Alexander Belopolsky 在 bpo-5288 中貢獻。）

dbm?

dbm.dumb 現在支持讀取只讀文件，并且在其未改變時(shí)不再寫(xiě)入索引文件。

decimal?

decimal 模塊現在使用 上下文變量 來(lái)儲存十進(jìn)制值上下文。 （由 Yury Selivanov 在 bpo-32630 中貢獻。）

dis?

dis() 函數現在能夠反匯編嵌套的代碼對象（推導式、生成器表達式和嵌套函數的代碼，以及用于構建嵌套類(lèi)的代碼）。 反匯編遞歸的最大深度由新的 depth 形參來(lái)控制。 （由 Serhiy Storchaka 在 bpo-11822 中貢獻。）

distutils?

README.rst 現在包含在 distutils 的標準 README 列表之中，因而也包含在源碼發(fā)布之中。 （由 Ryan Gonzalez 在 bpo-11913 中貢獻。）

enum?

Enum 增加了新的 _ignore_ 類(lèi)特征屬性，該屬性允許列出不應當成為枚舉成員的特征屬性名稱(chēng)。 （由 Ethan Furman 在 bpo-31801 中貢獻。）

在 Python 3.8 中，嘗試在 Enum 類(lèi)中檢查非 Enum 對象將引發(fā) TypeError (例如 1 in Color)；類(lèi)似地，嘗試在 Flag 成員中檢查非 Flag 對象也將引發(fā) TypeError (例如 1 in Perm.RW)；目前，兩種操作均會(huì )返回 False 并且已棄用。 （由 Ethan Furman 在 bpo-33217 中貢獻。）

functools?

functools.singledispatch() 現在支持使用類(lèi)型標注來(lái)注冊實(shí)現。 （由 ?ukasz Langa 在 bpo-32227 中貢獻。）

gc?

新的 gc.freeze() 函數允許凍結由垃圾回收器所跟蹤的所有對象，并將它們從未來(lái)的集合中排除。 這可以在 POSIX fork() 調用之前使用以令 GC 友好地進(jìn)行寫(xiě)入時(shí)復制或加速收集。 新的 gc.unfreeze() 函數會(huì )反轉此操作。 此外，gc.get_freeze_count() 可被用于獲取凍結對象的數量。 （由 Li Zekun 在 bpo-31558 中貢獻。）

hmac?

hmac 現在具有經(jīng)優(yōu)化的一次性 digest() 函數，其速度比 HMAC() 要快三倍。 （由 Christian Heimes 在 bpo-32433 中貢獻。）

http.client?

HTTPConnection 和 HTTPSConnection 現在支持新的 blocksize 參數以提升上傳吞吐量。 （由 Nir Soffer 在 bpo-31945 中貢獻。）

http.server?

SimpleHTTPRequestHandler 現在支持 HTTP If-Modified-Since 標頭。 如果目標文件在該標點(diǎn)指定的時(shí)間之后未被修改則服務(wù)器會(huì )返回 304 響應狀態(tài)。 （由 Pierre Quentel 在 bpo-29654 中貢獻。）

SimpleHTTPRequestHandler 接受新的 directory 參數并增加了新的 --directory 命令行參數。 通過(guò)此形參，服務(wù)器可以對服務(wù)指定目錄，默認情況下它使用當前工作目錄。 （由 Stéphane Wirtel 和 Julien Palard 在 bpo-28707 中貢獻。）

新的 ThreadingHTTPServer 類(lèi)使用線(xiàn)程來(lái)處理使用 ThreadingMixin 的請求。 它會(huì )在 http.server 附帶 -m 運行時(shí)被使用。 （由 Julien Palard 在 bpo-31639 中貢獻。）

idlelib 與 IDLE?

多個(gè)對自動(dòng)補全的修正。 （由 Louie Lu 在 bpo-15786 中貢獻。）

Module Browser (在 File 菜單中，之前稱(chēng)為 Class Browser) 現在會(huì )在最高層級函數和類(lèi)之外顯示嵌套的函數和類(lèi)。 （由 Guilherme Polo, Cheryl Sabella 和 Terry Jan Reedy 在 bpo-1612262 中貢獻。）

Settings 對話(huà)框 (Options 中的 Configure IDLE) 已經(jīng)被部分重寫(xiě)以改進(jìn)外觀(guān)和功能。 （由 Cheryl Sabella 和 Terry Jan Reedy 在多個(gè)問(wèn)題項中貢獻。）

字體樣本現在包括一組非拉丁字符以便用戶(hù)能更好地查看所選特定字體的效果。 （由 Terry Jan Reedy 在 bpo-13802 中貢獻。） 樣本可以被修改以包括其他字符。 （由 Serhiy Storchaka 在 bpo-31860 中貢獻。）

之前以擴展形式實(shí)現的 IDLE 特性已作為正常特性重新實(shí)現。 它們的設置已從 Extensions 選項卡移至其他對話(huà)框選項卡。 （由 Charles Wohlganger 和 Terry Jan Reedy 在 bpo-27099 中實(shí)現。）

編輯器代碼上下文選項已經(jīng)過(guò)修改。 Box 會(huì )顯示所有上下文行直到最大行數。 點(diǎn)擊一個(gè)上下文行會(huì )使編輯器跳轉到該行。 自定義主題的上下文顏色已添加到 Settings 對話(huà)框的 Highlights 選項卡。 （由 Cheryl Sabella 和 Terry Jan Reedy 在 bpo-33642, bpo-33768 和 bpo-33679 中貢獻。）

在 Windows 上，會(huì )有新的 API 調用將 tk 對 DPI 的調整告知 Windows。 在 Windows 8.1+ 或 10 上，如果 Python 二進(jìn)制碼的 DPI 兼容屬性未改變，并且監視器分辨率大于 96 DPI，這應該會(huì )令文本和線(xiàn)條更清晰。 否則的話(huà)它應該不造成影響。 （由 Terry Jan Reedy 在 bpo-33656 中貢獻。）

在 3.7.1 中新增:

超過(guò) N 行（默認值為 50）的輸出將被折疊為一個(gè)按鈕。 N 可以在 Settings 對話(huà)框的 General 頁(yè)的 PyShell 部分中進(jìn)行修改。 數量較少但是超長(cháng)的行可以通過(guò)在輸出上右擊來(lái)折疊。 被折疊的輸出可通過(guò)雙擊按鈕來(lái)展開(kāi)，或是通過(guò)右擊按鈕來(lái)放入剪貼板或是單獨的窗口。 （由 Tal Einat 在 bpo-1529353 中貢獻。）

上述修改已被反向移植到 3.6 維護發(fā)行版中。

在 3.7.4 中新增:

在 Run 菜單中增加了 "Run Customized" 以使用自定義設置來(lái)運行模塊。 輸入的任何命令行參數都會(huì )被加入 sys.argv。 它們在下次自定義運行時(shí)會(huì )再次顯示在窗體中。 用戶(hù)也可以禁用通常的 Shell 主模塊重啟。 （由 Cheryl Sabella, Terry Jan Reedy 等人在 bpo-5680 和 bpo-37627 中貢獻。）

在 3.7.5 中新增:

在 IDLE 編輯器窗口中增加了可選的行序號。 窗口打開(kāi)時(shí)默認不帶行序號，除非在配置對話(huà)框的 General 選項卡中進(jìn)行設置。 已打開(kāi)窗口中的行序號可以在 Options 菜單中顯示和隱藏。 （由 Tal Einat 和 Saimadhav Heblikar 在 bpo-17535 中貢獻。）

importlib?

引入了 importlib.abc.ResourceReader ABC 以支持從包中加載資源。 另請參閱 importlib.resources。 （由 Barry Warsaw, Brett Cannon 在 bpo-32248 中貢獻。）

如果模塊缺少規格描述 importlib.reload() 現在會(huì )引發(fā) ModuleNotFoundError。 （由 Garvit Khatri 在 bpo-29851 中貢獻。）

如果指定的父模塊不是一個(gè)包 (即缺少 __path__ 屬性) importlib.find_spec() 現在會(huì )引發(fā) ModuleNotFoundError 而非 AttributeError。 （由 Milan Oberkirch 在 bpo-30436 中貢獻。）

新的 importlib.source_hash() 可被用來(lái)計算傳入源的哈希值。 基于哈希值的 .pyc 文件 會(huì )嵌入此函數所返回的值。

io?

新的 TextIOWrapper.reconfigure() 方法可用于根據新的設置重新配置文本流。 （由 Antoine Pitrou 在 bpo-30526 以及 INADA Naoki 在 bpo-15216 中貢獻。）

ipaddress?

methods of ipaddress.IPv6Network 和 ipaddress.IPv4Network 中新的 subnet_of() 以及 supernet_of() 方法可用于網(wǎng)絡(luò )包含測試。 （由 Michel Albert 和 Cheryl Sabella 在 bpo-20825 中貢獻。）

itertools?

itertools.islice() 現在接受 類(lèi)整數對象 作為 start, stop 和 slice 參數。 （由 Will Roberts 在 bpo-30537 中貢獻。）

locale?

locale.format_string() 中新的 monetary 參數可用于轉換所使用的千位分隔符和分組字符串。 （由 Garvit 在 bpo-10379 中貢獻。）

現在 locale.getpreferredencoding() 函數在 Android 上或是在 強制 UTF-8 模式 下總是返回 'UTF-8' 。

logging?

Logger 實(shí)例現在可以被 pickle。 （由 Vinay Sajip 在 bpo-30520 中貢獻。）

新的 StreamHandler.setStream() 方法可用于在句柄創(chuàng )建之后替換日志流。 （由 Vinay Sajip 在 bpo-30522 中創(chuàng )建。）

現在可以在傳遞給 logging.config.fileConfig() 的配置信息中對句柄構造器指定關(guān)鍵字參數。 （由 Preston Landers 在 bpo-31080 中貢獻。)

math?

新的 math.remainder() 函數實(shí)現了 IEEE 754 風(fēng)格的余數運算。 （由 Mark Dickinson 在 bpo-29962 中貢獻。）

mimetypes?

.bmp 的 MIME type 從 'image/x-ms-bmp' 改為 'image/bmp'。 （由 Nitish Chandra 在 bpo-22589 中貢獻。）

msilib?

新的 Database.Close() 方法可用于關(guān)閉 MSI 數據庫。 （由 Berker Peksag 在 bpo-20486 中貢獻。）

multiprocessing?

新的 Process.close() 方法會(huì )顯式地關(guān)閉進(jìn)程對象并釋放與其關(guān)聯(lián)的所有資源。 如果底層進(jìn)程仍在運行則將引發(fā) ValueError。 （由 Antoine Pitrou 在 bpo-30596 中貢獻。）

新的 Process.kill() 方法可用于在 Unix 上使用 SIGKILL 信號來(lái)終止進(jìn)程。 （由 Vitor Pereira 在 bpo-30794 中貢獻。）

由 Process 所創(chuàng )建的非守護線(xiàn)程現在會(huì )在進(jìn)程退出時(shí)被合并。 （由 Antoine Pitrou 在 bpo-18966 中貢獻。）

os?

os.fwalk() 現在接受 bytes 類(lèi)型的 path 參數。 （由 Serhiy Storchaka 在 bpo-28682 中貢獻。）

os.scandir() 已獲得對 文件描述器 的支持。 （由 Serhiy Storchaka 在 bpo-25996 中貢獻。）

新的 register_at_fork() 函數允許注冊 Python 回調以便在進(jìn)程分叉中執行。 （由 Antoine Pitrou 在 bpo-16500 中貢獻。）

增加了 os.preadv() (結合了 os.readv() 與 os.pread() 的功能) 以及 os.pwritev() 函數 (結合了 os.writev() 和 os.pwrite() 的功能)。 （由 Pablo Galindo 在 bpo-31368 中貢獻。）

os.makedirs() 的 mode 參數不再影響新創(chuàng )建的中間層級目錄的文件權限。 （由 Serhiy Storchaka 在 bpo-19930 中貢獻。）

os.dup2() 現在會(huì )返回新的文件描述器。 之前，返回的總是 None。 （由 Benjamin Peterson 在 bpo-32441 中貢獻。）

在 Solaris 及其派生系統上 os.stat() 所返回的結構現在會(huì )包含 st_fstype 屬性。 （由 Jesús Cea Avión 在 bpo-32659 中貢獻。）

pathlib?

在 POSIX 類(lèi)系統上新的 Path.is_mount() 方法現在可用于確定一個(gè)路徑是否為掛載點(diǎn)。 （由 Cooper Ry Lees 在 bpo-30897 中貢獻。）

pdb?

pdb.set_trace() 現在接受一個(gè)可選的限關(guān)鍵字參數 header。 如果給出，它會(huì )在調試開(kāi)始之前被打印到控制臺。 （由 Barry Warsaw 在 bpo-31389 中貢獻。）

pdb 命令行現在接受 -m module_name 作為對腳本文件的替代。 （由 Mario Corchero 在 bpo-32206 中貢獻。）

py_compile?

py_compile.compile() -- 及其擴展形式 compileall -- 現在會(huì )通過(guò)無(wú)條件地為基于哈希值的有效性驗證創(chuàng )建 .pyc 文件來(lái)支持 SOURCE_DATE_EPOCH 環(huán)境變量。 這樣可以確保當 .pyc 文件被主動(dòng)創(chuàng )建時(shí) 可重現的生成。 （由 Bernhard M. Wiedemann 在 bpo-29708 中貢獻。）

pydoc?

pydoc 服務(wù)器現在可以綁定到由新的 -n 命令行參數所指定的任意主機名。 （由 Feanil Patel 在 bpo-31128 中貢獻。）

queue?

新的 SimpleQueue 類(lèi)是一個(gè)無(wú)界的 FIFO 隊列。 （由 Antoine Pitrou 在 bpo-14976 中貢獻。）

re?

旗標 re.ASCII, re.LOCALE 和 re.UNICODE 可以在組的范圍內設置。 （由 Serhiy Storchaka 在 bpo-31690 中貢獻。）

re.split() 現在支持基于匹配一個(gè)空字符串的模式例如 r'\b', '^$' 或 (?=-) 進(jìn)行拆分。 （由 Serhiy Storchaka 在 bpo-25054 中貢獻。）

使用 re.LOCALE 旗標編譯的正則表達式不再依賴(lài)于編譯時(shí)的區域設置。 區域設置僅在已編譯正則表達式被使用時(shí)才被應用。 （由 Serhiy Storchaka 在 bpo-30215 中貢獻。）

現在如果一個(gè)正則表達式包含語(yǔ)義將在未來(lái)發(fā)生改變的字符集構造，則會(huì )引發(fā) FutureWarning，例如嵌套集與集合操作等。 （由 Serhiy Storchaka 在 bpo-30349 中貢獻。）

已編譯正則表達式和匹配對象現在可以使用 copy.copy() 和 copy.deepcopy() 進(jìn)行拷貝。 （由 Serhiy Storchaka 在 bpo-10076 中貢獻。）

signal?

signal.set_wakeup_fd() 函數新增的 warn_on_full_buffer 參數可以指定當喚醒緩沖區溢出時(shí) Python 是否要在 stderr 上打印警告信息。 （由 Nathaniel J. Smith 在 bpo-30050 中貢獻。）

socket?

新增的 socket.getblocking() 方法會(huì )在套接字處于阻塞模式時(shí)返回 True，否則返回 False。 （由 Yury Selivanov 在 bpo-32373 中貢獻。）

新的 socket.close() 函數可關(guān)閉所傳入的套接字文件描述符。 應該用此函數來(lái)代替 os.close() 以獲得更好的跨平臺兼容性。 （由 Christian Heimes 在 bpo-32454 中貢獻。）

socket 模塊現在會(huì )公開(kāi) socket.TCP_CONGESTION (Linux 2.6.13), socket.TCP_USER_TIMEOUT (Linux 2.6.37) 以及 socket.TCP_NOTSENT_LOWAT (Linux 3.12) 常量。 （由 Omar Sandoval 在 bpo-26273 以及 Nathaniel J. Smith 在 bpo-29728 中貢獻。）

已加入對 socket.AF_VSOCK 套接字的支持以允許在虛擬機及其宿主機之間進(jìn)行通訊。 （由 Cathy Avery 在 bpo-27584 中貢獻。）

套接字現在默認會(huì )根據文件描述符自動(dòng)檢測所屬族、類(lèi)型和協(xié)議。 （由 Christian Heimes 在 bpo-28134 中貢獻。）

socketserver?

socketserver.ThreadingMixIn.server_close() 現在會(huì )等待所有非守護線(xiàn)程完成。 socketserver.ForkingMixIn.server_close() 現在會(huì )等待所有子進(jìn)程完成。

為 socketserver.ForkingMixIn 和 socketserver.ThreadingMixIn 類(lèi)增加了新的 socketserver.ForkingMixIn.block_on_close 類(lèi)屬性。 該類(lèi)屬性值設為 False 以保持 3.7 之前的行為。

sqlite3?

現在當下層的 SQLite 庫版本為 3.6.11 及以上時(shí) sqlite3.Connection 會(huì )開(kāi)放 backup() 方法。 （由 Lele Gaifax 在 bpo-27645 中貢獻。）

sqlite3.connect() 的 database 參數現在接受任何 path-like object，而不是只接受字符串。 （由 Anders Lorentsen 在 bpo-31843 中貢獻。）

ssl?

ssl 模塊現在使用 OpenSSL 的內置 API 代替 match_hostname() 來(lái)檢查主機名或 IP 地址。 值的驗證會(huì )在 TLS 握手期間進(jìn)行。 任何證書(shū)驗證錯誤包括主機名檢查失敗現在將引發(fā) SSLCertVerificationError 并使用正確的 TLS Alert 消息中止握手過(guò)程。 這個(gè)新異常包含有額外的信息。 主機名驗證可通過(guò) SSLContext.hostname_checks_common_name 進(jìn)行自定義。 （由 Christian Heimes 在 bpo-31399 中貢獻。）

ssl 模塊不再以 SNI TLS 擴展發(fā)送 IP 地址。 （由 Christian Heimes 在 bpo-32185 中貢獻。）

match_hostname() 不再支持部分通配符例如 www*.example.org。 （由 Mandeep Singh 在 bpo-23033 以及 Christian Heimes 在 bpo-31399 中貢獻。）

ssl 模塊默認的加密套件選擇現在是使用黑名單方式而非硬編碼的白名單。 Python 不會(huì )再重新啟用已經(jīng)被 OpenSSL 安全更新所阻止的加密。 默認的加密套件選擇可以在編譯時(shí)進(jìn)行配置。 （由 Christian Heimes 在 bpo-31429 中貢獻。）

現在已支持包含國際化域名 (IDN) 的服務(wù)器證書(shū)驗證。 作為此更改的一部分，SSLSocket.server_hostname 屬性現在會(huì )以預期的 A 標簽形式 ("xn--pythn-mua.org") 而不是以 U 標簽形式 ("pyth?n.org") 存儲。 （由 Nathaniel J. Smith 與 Christian Heimes 在 bpo-28414 中貢獻。）

ssl 模塊對 TLS 1.3 和 OpenSSL 1.1.1 具有初步和實(shí)驗性的支持。 在 Python 3.7.0 發(fā)布的時(shí)刻，OpenSSL 1.1.1 仍在開(kāi)發(fā)中，而 TLS 1.3 尚未最終確定。 TLS 1.3 握手和協(xié)議行為與 TLS 1.2 及更早的版本略有差異，請參閱 TLS 1.3。 （由 Christian Heimes 在 bpo-32947, bpo-20995, bpo-29136, bpo-30622 以及 bpo-33618 中貢獻。）

SSLSocket 和 SSLObject 不再具有公共構造器。 直接實(shí)例化從未成為有文檔和受支持的特性。 實(shí)際必須通過(guò) SSLContext 的方法 wrap_socket() 和 wrap_bio() 來(lái)創(chuàng )建。 （由 Christian Heimes 在 bpo-32951 中貢獻。）

用于設置最小和最大 TLS 協(xié)議版本的 OpenSSL 1.1 API 現已可用，名稱(chēng)分別為 SSLContext.minimum_version 和 SSLContext.maximum_version。 受支持的協(xié)議由幾個(gè)新增旗標指定，例如 HAS_TLSv1_1。 （由 Christian Heimes 在 bpo-32609 中貢獻。）

string?

string.Template 現在允許你有選擇地分別修改帶大括號的占位符和不帶大括號的占位符所對應的正則表達式模式。 （由 Barry Warsaw 在 bpo-1198569 中貢獻。）

subprocess?

subprocess.run() 函數接受新的 capture_output 關(guān)鍵字參數。 當其為真值時(shí)，將會(huì )捕獲 stdout 和 stderr。 這相當于將 subprocess.PIPE 作為 stdout 和 stderr 參數傳入。 （由 Bo Bayles 在 bpo-32102 中貢獻。）

subprocess.run 函數和 subprocess.Popen 構造器現在接受 text 關(guān)鍵字參數作為 universal_newlines 的別名。 （由 Andrew Clegg 在 bpo-31756 中貢獻。）

在 Windows 中當重定向標準句柄時(shí) close_fds 的默認值由 False 改為 True。 現在可以在重定向標準句柄時(shí)將 close_fds 設為真值。 參閱 subprocess.Popen。 這意味著(zhù)現在 close_fds 在所有受支持的平臺上默認值均為 True。 （由 Segev Finer 在 bpo-19764 中貢獻。）

在 subprocess.call(), subprocess.run() 期間或在 Popen 上下文管理器中，subprocess 模塊現在能更優(yōu)雅地處理 KeyboardInterrupt。 它現在會(huì )等待一小段時(shí)間以便子進(jìn)程退出，然后再繼續處理 KeyboardInterrupt 異常。 （由 Gregory P. Smith 在 bpo-25942 中貢獻。）

sys?

新增 sys.breakpointhook() 鉤子函數，供內置的 breakpoint() 進(jìn)行調用。 （由 Barry Warsaw 在 bpo-31353 中貢獻。）

在 Android 中新增的 sys.getandroidapilevel() 會(huì )返回構建時(shí)的 Android API 版本。 （由 Victor Stinner 在 bpo-28740 中貢獻。）

新的 sys.get_coroutine_origin_tracking_depth() 函數會(huì )返回當前協(xié)程的由新的 sys.set_coroutine_origin_tracking_depth() 所設定的原始跟蹤深度。 asyncio 已轉換為使用這個(gè)新 API 代替已棄用的 sys.set_coroutine_wrapper()。 （由 Nathaniel J. Smith 在 bpo-32591 中貢獻。）

time?

PEP 564 向 time 模塊增加六個(gè)具有納秒級精度的新函數:

• time.clock_gettime_ns()

• time.clock_settime_ns()

• time.monotonic_ns()

• time.perf_counter_ns()

• time.process_time_ns()

• time.time_ns()

增加了新的時(shí)鐘標識符:

• time.CLOCK_BOOTTIME (Linux): 與 time.CLOCK_MONOTONIC 相似，不同點(diǎn)在于它還包括任何系統掛起的時(shí)間。

• time.CLOCK_PROF (FreeBSD, NetBSD 和 OpenBSD): 高精度的分進(jìn)程 CPU 計時(shí)器。

• time.CLOCK_UPTIME (FreeBSD, OpenBSD): 該時(shí)間的絕對值是系統運行且未掛起的時(shí)間，提供準確的正常運行時(shí)間度量。

新的 time.thread_time() 和 time.thread_time_ns() 函數可用于獲取每線(xiàn)程的 CPU 時(shí)間度量。 （由 Antoine Pitrou 在 bpo-32025 中貢獻。）

新的 time.pthread_getcpuclockid() 函數會(huì )返回特定線(xiàn)程中 CPU 時(shí)鐘的時(shí)鐘 ID。

tkinter?

新的 tkinter.ttk.Spinbox 類(lèi)現已可用。 （由 Alan Moore 在 bpo-32585 中貢獻。）

tracemalloc?

tracemalloc.Traceback 的行為更接近正規的回溯，會(huì )對所有幀按從最舊到最新來(lái)排序。 Traceback.format() 現在接受負的 limit，并會(huì )將結果截短至排在第 abs(limit) 位的舊幀。 如果要獲得舊的行為，請在 Traceback.format() 中使用新的 most_recent_first 參數。 （由 Jesse Bakker 在 bpo-32121 中貢獻。）

types?

新的 WrapperDescriptorType, MethodWrapperType, MethodDescriptorType 和 ClassMethodDescriptorType 類(lèi)現已可用。 （由 Manuel Krebber 和 Guido van Rossum 在 bpo-29377 以及 Serhiy Storchaka 在 bpo-32265 中貢獻。）

新的 types.resolve_bases() 函數會(huì )以 PEP 560 所規定的方式動(dòng)態(tài)解析 MRO 條目。 （由 Ivan Levkivskyi 在 bpo-32717 中貢獻。）

unicodedata?

內部的 unicodedata 數據庫已升級為使用 Unicode 11。 （由 Benjamin Peterson 貢獻。）

unittest?

新的 -k 命令行選項允許通過(guò)名稱(chēng)子字符串或類(lèi)似于 Unix shell 的模式來(lái)篩選測試項。 例如，python -m unittest -k foo 將運行 foo_tests.SomeTest.test_something, bar_tests.SomeTest.test_foo，但不會(huì )運行 bar_tests.FooTest.test_something。 （由 Jonas Haag 在 bpo-32071 中貢獻。）

unittest.mock?

現在 sentinel 屬性會(huì )在它們被 復制 或 封存 時(shí)保存其標識。 （由 Serhiy Storchaka 在 bpo-20804 中貢獻。）

新的 seal() 函數允許 Mock 對實(shí)例進(jìn)行密封，這將禁止進(jìn)一步創(chuàng )建屬性模擬。 密封會(huì )以遞歸方式應用于自身模擬的所有屬性。 （由 Mario Corchero 在 bpo-30541 中貢獻。）

urllib.parse?

urllib.parse.quote() 已經(jīng)從 RFC 2396 更新為 RFC 3986，將 ~ 添加到默認情況下從未引用的字符集。 （由 Christian Theune 和 Ratnadeep Debnath 在 bpo-16285 中貢獻。）

uu?

uu.encode() 函數現在接受可選的 backtick 關(guān)鍵字參數。 當其為真時(shí)，零會(huì )以 '`' 而非空格來(lái)表示。 （由 Xiang Zhang 在 bpo-30103 中貢獻。）

uuid?

新的 UUID.is_safe 屬性會(huì )從平臺中繼有關(guān)是否使用多進(jìn)程安全模式來(lái)生成所需 UUID 的信息。 （由 Barry Warsaw 在 bpo-22807 中貢獻。）

uuid.getnode() 現在更傾向于統一管理的 MAC 地址而不是本地管理的 MAC 地址。 這樣可以更好地保證從 uuid.uuid1() 返回的 UUID 的全局唯一性。 如果只有本地管理的 MAC 地址可用，則返回首個(gè)找到的此類(lèi)地址。 （由 Barry Warsaw 在 bpo-32107 中貢獻。）

warnings?

默認警告過(guò)濾器的初始化已進(jìn)行以下更改:

• 通過(guò)命令行選項（包括 -b 以及新的 CPython 專(zhuān)屬的 -X dev 選項）啟用的警告總是會(huì )通過(guò) sys.warnoptions 屬性被傳遞給警告機制。

• 通過(guò)命令行或環(huán)境變量啟用的警告過(guò)濾器現在具有以下優(yōu)先順序:

  • 用于 -b (或 -bb) 的 BytesWarning 過(guò)濾器

  • 通過(guò) -W 選項指定的任何過(guò)濾器

  • 通過(guò) PYTHONWARNINGS 環(huán)境變量指定的任何過(guò)濾器

  • 任何其他 CPython 專(zhuān)屬過(guò)濾器（例如 -X dev 模式中新增的 default 過(guò)濾器）

  • 由警告機制所定義的任何隱式過(guò)濾器

• 在 CPython 調試版本 中，現在默認情況下會(huì )顯示所有警告（隱式過(guò)濾器列表為空）

（由 Nick Coghlan 和 Victor Stinner 在 bpo-20361, bpo-32043 以及 bpo-32230 中貢獻。）

在單文件腳本和交互式提示符中，默認情況下會(huì )再次顯示已棄用警告。 詳情參見(jiàn) PEP 565: 在 __main__ 中顯示 DeprecationWarning。 （由 Nick Coghlan 在 bpo-31975 中貢獻。）

xml.etree?

find() 方法中的 ElementPath 描述詞現在可以將當前節點(diǎn)文本與 [. = "text"] 進(jìn)行比較，而不僅是子節點(diǎn)中的文本。 描述詞還允許添加空格以提高可讀性。 （由 Stefan Behnel 在 bpo-31648 中貢獻。）

xmlrpc.server?

SimpleXMLRPCDispatcher.register_function 現在可以被用作裝飾器。 （由 Xiang Zhang 在 bpo-7769 中貢獻。）

zipapp?

函數 create_archive() 現在接受可選的 filter 參數，以允許用戶(hù)選擇哪些文件應被加入歸檔包。 （由 Irmen de Jong 在 bpo-31072 中貢獻。）

函數 create_archive() 現在接受可選的 compressed 參數，以生成壓縮歸檔包。 另外也加入了命令行選項 --compress 以支持壓縮。 （由 Zhiming Wang 在 bpo-31638 中貢獻。）

zipfile?

ZipFile 現在接受新的 compresslevel 形參，以控制壓縮級別。 （由 Bo Bayles 在 bpo-21417 中貢獻。）

ZipFile 所創(chuàng )建的歸檔包中的子目錄現在會(huì )按字母表順序保存。 （由 Bernhard M. Wiedemann 在 bpo-30693 中貢獻。）

aifc?

aifc.openfp() 已棄用并將在 Python 3.9 中被移除。 請改用 aifc.open()。 （由 Brian Curtin 在 bpo-31985 中貢獻。）

asyncio?

對 asyncio.Lock 和其他 asyncio 同步原語(yǔ)的 await 實(shí)例的直接支持已棄用。 想要獲取并釋放同步資源必須使用異步上下文管理器。 （由 Andrew Svetlov 在 bpo-32253 中貢獻。）

asyncio.Task.current_task() 和 asyncio.Task.all_tasks() 方法已棄用。 （由 Andrew Svetlov 在 bpo-32250 中貢獻。）

collections?

在 Python 3.8 中，collections.abc 內的抽象基類(lèi)將不會(huì )再通過(guò)常規的 collections 模塊公開(kāi)。 這有助于更清晰地區別具體類(lèi)與抽象基類(lèi)。 （由 Serhiy Storchaka 在 bpo-25988 中貢獻。）

dbm?

dbm.dumb 現在支持讀取只讀文件，且當其未被更改時(shí)不會(huì )再寫(xiě)入索引文件。 現在如果索引文件丟失并在 'r' 與 'w' 模式下被重新創(chuàng )建，則會(huì )發(fā)出已棄用警告（在未來(lái)的 Python 發(fā)布版中將改為錯誤）。 （由 Serhiy Storchaka 在 bpo-28847 中貢獻。）

enum?

在 Python 3.8 中，嘗試在 Enum 類(lèi)中檢查非 Enum 對象將引發(fā) TypeError (例如 1 in Color)；類(lèi)似地，嘗試在 Flag 成員中檢查非 Flag 對象也將引發(fā) TypeError (例如 1 in Perm.RW)；目前，兩種操作均會(huì )返回 False。 （由 Ethan Furman 在 bpo-33217 中貢獻。）

gettext?

使用非整數值在 gettext 中選擇復數形式現在已棄用。 它從未正確地發(fā)揮作用。 （由 Serhiy Storchaka 在 bpo-28692 中貢獻。）

importlib?

下列方法 MetaPathFinder.find_module() (被 MetaPathFinder.find_spec() 替代) 和 PathEntryFinder.find_loader() (被 PathEntryFinder.find_spec() 替代) 都在 Python 3.4 中已棄用，現在會(huì )引發(fā) DeprecationWarning。 （由 Matthias Bussonnier 在 bpo-29576 中貢獻）

importlib.abc.ResourceLoader ABC 已棄用，推薦改用 importlib.abc.ResourceReader。

locale?

locale.format() 已棄用，請改用 locale.format_string()。 （由 Garvit 在 bpo-10379 中貢獻。）

macpath?

macpath 現在已棄用，將在 Python 3.8 中被移除。 （由 Chi Hsuan Yen 在 bpo-9850 中貢獻。）

threading?

dummy_threading 和 _dummy_thread 已棄用。 構建禁用線(xiàn)程的 Python 已不再可能。 請改用 threading。 （由 Antoine Pitrou 在 bpo-31370 中貢獻。）

socket?

socket.htons() 和 socket.ntohs() 中的靜默參數截斷已棄用。 在未來(lái)的 Python 版本中，如果傳入的參數長(cháng)度大于 16 比特位，將會(huì )引發(fā)異常。 （由 Oren Milman 在 bpo-28332 中貢獻。）

ssl?

ssl.wrap_socket() 已棄用。 請改用 ssl.SSLContext.wrap_socket()。 （由 Christian Heimes 在 bpo-28124 中貢獻。）

sunau?

sunau.openfp() 已棄用并將在 Python 3.9 中被移除。 請改用 sunau.open()。 （由 Brian Curtin 在 bpo-31985 中貢獻。）

sys?

已棄用 sys.set_coroutine_wrapper() 和 sys.get_coroutine_wrapper()。

未寫(xiě)入文檔的 sys.callstats() 函數已棄用并將在未來(lái)的 Python 版本中被移除。 （由 Victor Stinner 在 bpo-28799 中貢獻。）

wave?

wave.openfp() 已棄用并將在 Python 3.9 中被移除。 請改用 wave.open()。 （由 Brian Curtin 在 bpo-31985 中貢獻。）

Python 行為的更改?

• async 和 await 現在是保留關(guān)鍵字。 使用了這些名稱(chēng)作為標識符的代碼現在將引發(fā) SyntaxError。 （由 Jelle Zijlstra 在 bpo-30406 中貢獻。）

• PEP 479 在 Python 3.7 中對所有代碼啟用，在協(xié)程和生成器中直接或間接引發(fā)的 StopIteration 異常會(huì )被轉換為 RuntimeError 異常。 （由 Yury Selivanov 在 bpo-32670 中貢獻。）

• object.__aiter__() 方法不再能被聲明為異步的。 （由 Yury Selivanov 在 bpo-31709 中貢獻。）

• 由于一個(gè)疏忽，之前的 Python 版本會(huì )錯誤地接受以下語(yǔ)法:

  f(1 for x in [1],)
  
  class C(1 for x in [1]):
      pass
  

  現在 Python 3.7 會(huì )正確地引發(fā) SyntaxError，因為生成器表達式總是必須直接包含于一對括號之內， 且前后都不能有逗號，僅在調用時(shí)可以忽略重復的括號。 （由 Serhiy Storchaka 在 bpo-32012 和 bpo-32023 中貢獻。）

• 現在當使用 -m 開(kāi)關(guān)時(shí)，會(huì )將初始工作目錄添加到 sys.path，而不再是一個(gè)空字符串（即在每次導入時(shí)動(dòng)態(tài)地指明當前工作目錄）。 任何會(huì )檢測該空字符串，或是以其他方式依賴(lài)之前行為的的程序將需要進(jìn)行相應的更新（例如改為還要檢測 os.getcwd() 或 os.path.dirname(__main__.__file__)，具體做法首先要取決于為何要對代碼執行空字符串檢測）。

Python API 的變化?

• socketserver.ThreadingMixIn.server_close() 現在會(huì )等待所有非守護線(xiàn)程完成。 將新增的 socketserver.ThreadingMixIn.block_on_close 類(lèi)屬性設為 False 可獲得 3.7 之前版本的行為。 （由 Victor Stinner 在 bpo-31233 和 bpo-33540 中貢獻。）

• socketserver.ForkingMixIn.server_close() 現在會(huì )等等所有子進(jìn)程完成。 將新增的 socketserver.ForkingMixIn.block_on_close 類(lèi)屬性設為 False 可獲得 3.7 之前版本的行為。 （由 Victor Stinner 在 bpo-31151 和 bpo-33540 中貢獻。）

• 某些情況下 locale.localeconv() 函數現在會(huì )臨時(shí)將 LC_CTYPE 區域設置為 LC_NUMERIC 的值。 （由 Victor Stinner 在 bpo-31900 中貢獻。）

• 如果 path 為字符串 pkgutil.walk_packages() 現在會(huì )引發(fā) ValueError。 之前則是返回一個(gè)空列表。 （由 Sanyam Khurana 在 bpo-24744 中貢獻。）

• string.Formatter.format() 的格式字符串參數現在為 僅限位置 參數。 將其作為關(guān)鍵字參數傳入的方式自 Python 3.5 起已棄用。 （由 Serhiy Storchaka 在 bpo-29193 中貢獻。）

• 類(lèi) http.cookies.Morsel 的屬性 key, value 和 coded_value 現在均為只讀。 對其賦值的操作自 Python 3.5 起已棄用。 要設置它們的值請使用 set() 方法。 （由 Serhiy Storchaka 在 bpo-29192 中貢獻。）

• os.makedirs() 的 mode 參數不會(huì )再影響新建中間層級目錄的文件權限位。 要設置它們的文件權限位你可以在發(fā)起調用 makedirs() 之前設置 umask。 （由 Serhiy Storchaka 在 bpo-19930 中貢獻。）

• struct.Struct.format 的類(lèi)型現在是 str 而非 bytes。 （由 Victor Stinner 在 bpo-21071 中貢獻。）

• parse_multipart() 現在接受 encoding 和 errors 參數并返回與 FieldStorage 同樣的結果：對于非文件字段，與鍵相關(guān)聯(lián)的值是一個(gè)字符串列表，而非字節串。 （由 Pierre Quentel 在 bpo-29979 中貢獻。）

• 由于 socket 中的內部更改，在由舊版 Python 中的 socket.share 所創(chuàng )建的套接字上調用 socket.fromshare() 已不受支持。

• BaseException 的 repr 已更改為不包含末尾的逗號。 大多數異常都會(huì )受此更改影響。 （由 Serhiy Storchaka 在 bpo-30399 中貢獻。）

• datetime.timedelta 的 repr 已更改為在輸出中包含關(guān)鍵字參數。 （由 Utkarsh Upadhyay 在 bpo-30302 中貢獻。）

• 因為 shutil.rmtree() 現在是使用 os.scandir() 函數實(shí)現的，用戶(hù)指定的句柄 onerror 現在被調用時(shí)如果列目錄失敗會(huì )附帶第一個(gè)參數 os.scandir 而不是 os.listdir。

• 未來(lái)可能加入在正則表達式中對 Unicode 技術(shù)標準 #18 中嵌套集合與集合操作的支持。 這會(huì )改變現有語(yǔ)法。 為了推動(dòng)這項未來(lái)的改變，目前在有歧義的情況下會(huì )引發(fā) FutureWarning。 這包括以字面值 '[' 開(kāi)頭或包含字面值字符序列 '--', '&&', '~~' 以及 '||' 的集合。 要避免警告，請用反斜杠對其進(jìn)行轉義。 （由 Serhiy Storchaka 在 bpo-30349 中貢獻。）

• 基于可以匹配空字符串的 正則表達式 對字符串進(jìn)行拆分的結果已被更改。 例如基于 r'\s*' 的拆分現在不僅會(huì )像原先那樣拆分空格符，而且會(huì )拆分所有非空格字符之前和字符串結尾處的空字符串。 通過(guò)將模式修改為 r'\s+' 可以恢復原先的行為。 自 Python 3.5 開(kāi)始此類(lèi)模式將會(huì )引發(fā) FutureWarning。

  對于同時(shí)匹配空字符串和非空字符串的模式，在其他情況下搜索所有匹配的結果也可能會(huì )被更改。 例如在字符串 'a\n\n' 中，模式 r'(?m)^\s*?$' 將不僅會(huì )匹配位置 2 和 3 上的空字符串，還會(huì )匹配位置 2--3 上的字符串 '\n'。 想要只匹配空行，模式應當改寫(xiě)為 r'(?m)^[^\S\n]*$'。

  re.sub() 現在會(huì )替換與前一個(gè)的非空匹配相鄰的空匹配。 例如 re.sub('x*', '-', 'abxd') 現在會(huì )返回 '-a-b--d-' 而不是 '-a-b-d-' ('b' 和 'd' 之間的第一個(gè)減號是替換 'x'，而第二個(gè)減號則是替換 'x' 和 'd' 之間的空字符串)。

  （由 Serhiy Storchaka 在 bpo-25054 和 bpo-32308 中貢獻。）

• re.escape() 更改為只轉義正則表達式特殊字符，而不轉義 ASCII 字母、數字和 '_' 以外的所有字符。 （由 Serhiy Storchaka 在 bpo-29995 中貢獻。）

• tracemalloc.Traceback 幀現在是按從最舊到最新排序，以便與 traceback 更為一致。 （由 Jesse Bakker 在 bpo-32121 中貢獻。）

• 在支持 socket.SOCK_NONBLOCK 或 socket.SOCK_CLOEXEC 標志位的操作系統上，socket.type 不再應用它們。 因此，像 if sock.type == socket.SOCK_STREAM 之類(lèi)的檢測會(huì )在所有平臺上按預期的方式工作。 （由 Yury Selivanov 在 bpo-32331 中貢獻。）

• 在 Windows 上當重定向標準句柄時(shí)，subprocess.Popen 的 close_fds 參數的默認值從 False 更改為 True。 如果你以前依賴(lài)于在使用帶有標準 io 重定向的 subprocess.Popen 時(shí)所繼承的句柄，則必須傳入 close_fds=False 以保留原先的行為，或是使用 STARTUPINFO.lpAttributeList。

• importlib.machinery.PathFinder.invalidate_caches() -- 此方法隱式地影響 importlib.invalidate_caches() -- 現在會(huì )刪除 sys.path_importer_cache 中被設為 None 的條目。 （由 Brett Cannon 在 bpo-33169 中貢獻。）

• 在 asyncio 中，loop.sock_recv(), loop.sock_sendall(), loop.sock_accept(), loop.getaddrinfo(), loop.getnameinfo() 已被更改為正確的協(xié)程方法以與培訓五日文檔相匹配。 之前，這些方法會(huì )返回 asyncio.Future 實(shí)例。 （由 Yury Selivanov 在 bpo-32327 中貢獻。）

• asyncio.Server.sockets 現在會(huì )返回服務(wù)器套接字列表的副本，而不是直接地返回它。 （由 Yury Selivanov 在 bpo-32662 中貢獻。）

• Struct.format 現在是一個(gè) str 實(shí)例而非 bytes 實(shí)例。 （由 Victor Stinner 在 bpo-21071 中貢獻。）

• 現在可以通過(guò)將 required=True 傳給 ArgumentParser.add_subparsers() 使得 argparse 子解析器成為必需的。 （由 Anthony Sottile 在 bpo-26510 中貢獻。）

• ast.literal_eval() 現在更為嚴格。 任意地加減數字已不再被允許。 （由 Serhiy Storchaka 在 bpo-31778 中貢獻。）

• 當一個(gè)日期超出 0001-01-01 到 9999-12-31 范圍時(shí) Calendar.itermonthdates 現在將始終如一地引發(fā)異常，以便支持不能容忍此類(lèi)異常的應用程序，可以使用新增的 Calendar.itermonthdays3 和 Calendar.itermonthdays4。 這些新方法返回元組，并且其不受 datetime.date 所支持的范圍限制。 （由 Alexander Belopolsky 在 bpo-28292 中貢獻。）

• collections.ChainMap 現在會(huì )保留底層映射的順序。 （由 Raymond Hettinger 在 bpo-32792 中貢獻。）

• 如果在解釋器關(guān)閉期間被調用，concurrent.futures.ThreadPoolExecutor 和 concurrent.futures.ProcessPoolExecutor 的 submit() 方法現在會(huì )引發(fā) RuntimeError。 （由 Mark Nemec 在 bpo-33097 中貢獻。）

• configparser.ConfigParser 構造器現在使用 read_dict() 來(lái)處理默認值，以使其行為與解析器的其余部分保持致。 在默認字典中的非字符串鍵和值現在會(huì )被隱式地轉換為字符串。 （由 James Tocknell 在 bpo-23835 中貢獻。）

• 一些未寫(xiě)入文檔的內部導入已被移除。 一個(gè)例子是 os.errno 已不再可用；應改為直接使用 import errno。 請注意此類(lèi)未寫(xiě)入文檔的內部導入可能未經(jīng)通知地隨時(shí)被移除，甚至是在微版本號發(fā)行版中移除。

C API 的變化?

函數 PySlice_GetIndicesEx() 被認為對于大小可變的序列來(lái)說(shuō)并不安全。 如果切片索引不是 int 的實(shí)例，而是實(shí)現了 __index__() 方法的對象，則序列可以在其長(cháng)度被傳給 !PySlice_GetIndicesEx 之后調整大小。 這可能導致返回超出序列長(cháng)度的索引號。 為了避免可能的問(wèn)題，請使用新增的函數 PySlice_Unpack() 和 PySlice_AdjustIndices()。 （由 Serhiy Storchaka 在 bpo-27867 中貢獻。）

CPython 字節碼的改變?

新增了兩個(gè)操作碼: LOAD_METHOD 和 CALL_METHOD。 （由 Yury Selivanov 和 INADA Naoki 在 bpo-26110 中貢獻。）

STORE_ANNOTATION 操作碼已被移除。 （由 Mark Shannon 在 bpo-32550 中貢獻。）

Windows 專(zhuān)屬的改變?

The file used to override sys.path is now called <python-executable>._pth instead of 'sys.path'. See 查找模塊 for more information. (Contributed by Steve Dower in bpo-28137.)

其他 CPython 實(shí)現的改變?

為了準備在未來(lái)對公開(kāi)的 CPython 運行時(shí)初始化 API 進(jìn)行潛在更改（請參閱 PEP 432 獲取最初但略為過(guò)時(shí)的文稿），CPython 內部的啟動(dòng)和配置管理邏輯已經(jīng)過(guò)大幅重構。 雖然這些更新旨在對嵌入式應用程序和常規的 CPython CLI 用戶(hù)都完全透明，但它們在這里被提及是因為重構會(huì )改變解釋器啟動(dòng)期間許多操作的內部順序，因此可能提示出原先隱藏的缺陷，這可能存在于嵌入式應用程序中，或是在 CPython 自身內部。 （最初由 Nick Coghlan 和 Eric Snow 作為 bpo-22257 的一部分貢獻，并由 Nick, Eric 和 Victor Stinner 在一系列其他問(wèn)題報告中進(jìn)一步更新）。 已知會(huì )受到影響的一些細節：

• PySys_AddWarnOptionUnicode() 目前對嵌入式應用程序不可用，因為在調用 Py_Initialize 之前需要創(chuàng )建 Unicode 對象。 請改用 PySys_AddWarnOption()。

• 嵌入式應用程序通過(guò) PySys_AddWarnOption() 所添加的警告過(guò)濾器現在應該以更高的一致性?xún)?yōu)先于由解釋器所設置的默認過(guò)濾器

由于默認警告過(guò)濾器的配置方式發(fā)生了變化，將 Py_BytesWarningFlag 設置為大于一的值不再足以在發(fā)出 BytesWarning 消息的同時(shí)將其轉換為異常。 而是改為必須設置旗標（以便首先發(fā)出警告），以及添加顯式的 error::BytesWarning 警告過(guò)濾器來(lái)將其轉換為異常。

由于編譯器處理文檔字符串的方式發(fā)生了變化，一個(gè)僅由文檔字符串構成的函數體中隱式的 return None 現在被標記為在與文檔字符串相同的行，而不是在函數的標題行。

當前異常狀態(tài)已從幀對象移到協(xié)程對象。 這會(huì )簡(jiǎn)化解釋器并修正由于在進(jìn)入或退出生成器時(shí)具有交換異常狀態(tài)而導致的一些模糊錯誤。 （由 Mark Shannon 在 bpo-25612 中貢獻。）