Khấu hao

Đang chờ xóa trong Python 3.15

• Hệ thống nhập khẩu:

  • Việc đặt __cached__ trên mô-đun trong khi không đặt được __spec__.cached không được dùng nữa. Trong Python 3.15, __cached__ sẽ không còn được hệ thống nhập hoặc thư viện chuẩn xem xét nữa. (gh-97879)

  • Việc đặt __package__ trên mô-đun trong khi không đặt được __spec__.parent không được dùng nữa. Trong Python 3.15, __package__ sẽ không còn được hệ thống nhập hoặc thư viện chuẩn xem xét nữa. (gh-97879)

• ctypes:

  • Hàm ctypes.SetPointerType() không có giấy tờ đã không được dùng nữa kể từ Python 3.13.

• http.server:

  • CGIHTTPRequestHandler lỗi thời và hiếm khi được sử dụng đã không được dùng nữa kể từ Python 3.13. Không có sự thay thế trực tiếp tồn tại. Anything tốt hơn CGI trong việc kết nối máy chủ web với trình xử lý yêu cầu.

  • Cờ --cgi cho giao diện dòng lệnh python -m http.server đã không được dùng nữa kể từ Python 3.13.

• importlib:

  • Phương pháp load_module(): thay vào đó hãy sử dụng exec_module().

• locale:

  • Hàm getdefaultlocale() đã không được dùng nữa kể từ Python 3.11. Việc loại bỏ nó ban đầu được lên kế hoạch cho Python 3.13 (gh-90817), nhưng đã bị hoãn lại đối với Python 3.15. Thay vào đó hãy sử dụng getlocale(), setlocale() và getencoding(). (Được đóng góp bởi Hugo van Kemenade trong gh-111187.)

• pathlib:

  • PurePath.is_reserved() đã không được dùng nữa kể từ Python 3.13. Sử dụng os.path.isreserved() để phát hiện các đường dẫn dành riêng trên Windows.

• platform:

  • java_ver() đã không được dùng nữa kể từ Python 3.13. Chức năng này chỉ hữu ích khi hỗ trợ Jython, có API khó hiểu và phần lớn chưa được kiểm tra.

• sysconfig:

  • Đối số check_home của sysconfig.is_python_build() đã không được dùng nữa kể từ Python 3.12.

• threading:

  • RLock() sẽ không có đối số trong Python 3.15. Việc truyền bất kỳ đối số nào đã không còn được dùng nữa kể từ Python 3.14, vì phiên bản Python không cho phép bất kỳ đối số nào, nhưng phiên bản C cho phép bất kỳ số lượng đối số vị trí hoặc từ khóa nào, bỏ qua mọi đối số.

• types:

  • types.CodeType: Việc truy cập co_lnotab không còn được dùng nữa trong PEP 626 kể từ phiên bản 3.10 và dự kiến ​​sẽ bị xóa trong phiên bản 3.12, nhưng nó chỉ nhận được một DeprecationWarning thích hợp trong phiên bản 3.12. Có thể được gỡ bỏ trong 3.15. (Được đóng góp bởi Nikita Sobolev trong gh-101866.)

• typing:

  • Cú pháp đối số từ khóa không có giấy tờ để tạo các lớp NamedTuple (ví dụ: Point = NamedTuple("Point", x=int, y=int)) đã không được dùng nữa kể từ Python 3.13. Thay vào đó hãy sử dụng cú pháp dựa trên lớp hoặc cú pháp chức năng.

  • Khi sử dụng cú pháp chức năng của TypedDicts, việc không truyền giá trị cho tham số fields (TD = TypedDict("TD")) hoặc truyền None (TD = TypedDict("TD", None)) đã không được dùng nữa kể từ Python 3.13. Sử dụng class TD(TypedDict): pass hoặc TD = TypedDict("TD", {}) để tạo TypedDict với trường bằng 0.

  • Chức năng trang trí typing.no_type_check_decorator() đã không được dùng nữa kể từ Python 3.13. Sau tám năm sử dụng mô-đun typing, nó vẫn chưa được hỗ trợ bởi bất kỳ trình kiểm tra loại chính nào.

• wave:

  • Các phương thức getmark(), setmark() và getmarkers() của các lớp Wave_read và Wave_write đã không còn được dùng nữa kể từ Python 3.13.

• zipimport:

  • load_module() đã không được dùng nữa kể từ Python 3.10. Thay vào đó hãy sử dụng exec_module(). (Được đóng góp bởi Jiahao Li trong gh-125746.)

Đang chờ xóa trong Python 3.16

• Hệ thống nhập khẩu:

  • Việc đặt __loader__ trên mô-đun trong khi không đặt được __spec__.loader không được dùng nữa. Trong Python 3.16, __loader__ sẽ không còn được thiết lập hoặc xem xét bởi hệ thống nhập hoặc thư viện chuẩn.

• array:

  • Mã định dạng 'u' (wchar_t) không còn được dùng trong tài liệu kể từ Python 3.3 và trong thời gian chạy kể từ Python 3.13. Thay vào đó, hãy sử dụng mã định dạng 'w' (Py_UCS4) cho các ký tự Unicode.

• asyncio:

  • asyncio.iscoroutinefunction() không được dùng nữa và sẽ bị xóa trong Python 3.16; thay vào đó hãy sử dụng inspect.iscoroutinefunction(). (Được đóng góp bởi Jiahao Li và Kumar Aditya trong gh-122875.)

  • Hệ thống chính sách asyncio không được dùng nữa và sẽ bị xóa trong Python 3.16. Cụ thể, các lớp và hàm sau không được dùng nữa:

    • asyncio.AbstractEventLoopPolicy

    • asyncio.DefaultEventLoopPolicy

    • asyncio.WindowsSelectorEventLoopPolicy

    • asyncio.WindowsProactorEventLoopPolicy

    • asyncio.get_event_loop_policy()

    • asyncio.set_event_loop_policy()

    Người dùng nên sử dụng asyncio.run() hoặc asyncio.Runner với loop_factory để sử dụng cách triển khai vòng lặp sự kiện mong muốn.

    Ví dụ: để sử dụng asyncio.SelectorEventLoop trên Windows:

    nhập asyncio
    
    async def main():
        ...
    
    asyncio.run(main(), loop_factory=asyncio.SelectorEventLoop)
    

    (Được đóng góp bởi Kumar Aditya trong gh-127949.)

• builtins:

  • Đảo ngược bit trên các loại boolean, ~True hoặc ~False đã không được dùng nữa kể từ Python 3.12, vì nó tạo ra kết quả đáng ngạc nhiên và không trực quan (-2 và -1). Thay vào đó, hãy sử dụng not x để phủ định logic của Boolean. Trong trường hợp hiếm hoi mà bạn cần đảo ngược bitwise của số nguyên cơ bản, hãy chuyển đổi rõ ràng sang int (~int(x)).

• functools:

  • Việc gọi triển khai Python của functools.reduce() bằng function hoặc sequence làm đối số từ khóa đã không được dùng nữa kể từ Python 3.14.

• logging:

  Hỗ trợ trình xử lý ghi nhật ký tùy chỉnh với đối số strm không được dùng nữa và được lên lịch xóa trong Python 3.16. Thay vào đó, hãy xác định trình xử lý bằng đối số stream. (Được đóng góp bởi Mariusz Felisiak trong gh-115032.)

• mimetypes:

  • Tiện ích mở rộng hợp lệ bắt đầu bằng dấu '.' hoặc trống cho mimetypes.MimeTypes.add_type(). Các tiện ích mở rộng không có dấu chấm không được dùng nữa và sẽ tăng ValueError trong Python 3.16. (Được đóng góp bởi Hugo van Kemenade trong gh-75223.)

• shutil:

  • Ngoại lệ ExecError đã không được dùng nữa kể từ Python 3.14. Nó chưa được sử dụng bởi bất kỳ chức năng nào trong shutil kể từ Python 3.4 và hiện là bí danh của RuntimeError.

• symtable:

  • Phương thức Class.get_methods đã không được dùng nữa kể từ Python 3.14.

• sys:

  • Hàm _enablelegacywindowsfsencoding() đã không được dùng nữa kể từ Python 3.13. Thay vào đó hãy sử dụng biến môi trường PYTHONLEGACYWINDOWSFSENCODING.

• sysconfig:

  • Hàm sysconfig.expand_makefile_vars() đã không được dùng nữa kể từ Python 3.14. Thay vào đó, hãy sử dụng đối số vars của sysconfig.get_paths().

• tarfile:

  • Thuộc tính TarFile.tarfile không có giấy tờ và không được sử dụng đã không được dùng nữa kể từ Python 3.13.

Đang chờ xóa trong Python 3.17

• collections.abc:

  • collections.abc.ByteString được lên kế hoạch xóa trong Python 3.17.

    Sử dụng isinstance(obj, collections.abc.Buffer) để kiểm tra xem obj có triển khai buffer protocol khi chạy hay không. Để sử dụng trong chú thích loại, hãy sử dụng Buffer hoặc liên kết chỉ định rõ ràng các loại mà mã của bạn hỗ trợ (ví dụ: bytes | bytearray | memoryview).

    ByteString ban đầu được dự định là một lớp trừu tượng sẽ đóng vai trò là siêu kiểu của cả bytes và bytearray. Tuy nhiên, vì ABC chưa bao giờ có bất kỳ phương thức nào nên việc biết rằng một đối tượng là một thể hiện của ByteString chưa bao giờ thực sự cho bạn biết bất kỳ điều gì hữu ích về đối tượng đó. Các loại bộ đệm phổ biến khác như memoryview cũng không bao giờ được hiểu là kiểu con của ByteString (trong thời gian chạy hoặc bằng trình kiểm tra kiểu tĩnh).

    Xem PEP 688 để biết thêm chi tiết. (Được đóng góp bởi Shantanu Jain trong gh-91896.)

• typing:

  • Trước Python 3.14, các hợp nhất kiểu cũ đã được triển khai bằng lớp riêng typing._UnionGenericAlias. Lớp này không còn cần thiết cho việc triển khai nhưng nó đã được giữ lại để tương thích ngược, với kế hoạch loại bỏ đối với Python 3.17. Người dùng nên sử dụng các công cụ trợ giúp xem xét nội tâm được ghi lại như typing.get_origin() và typing.get_args() thay vì dựa vào các chi tiết triển khai riêng tư.

  • typing.ByteString, không được dùng nữa kể từ Python 3.9, được lên lịch xóa trong Python 3.17.

    Sử dụng isinstance(obj, collections.abc.Buffer) để kiểm tra xem obj có triển khai buffer protocol khi chạy hay không. Để sử dụng trong chú thích loại, hãy sử dụng Buffer hoặc liên kết chỉ định rõ ràng các loại mà mã của bạn hỗ trợ (ví dụ: bytes | bytearray | memoryview).

    ByteString ban đầu được dự định là một lớp trừu tượng sẽ đóng vai trò là siêu kiểu của cả bytes và bytearray. Tuy nhiên, vì ABC chưa bao giờ có bất kỳ phương thức nào nên việc biết rằng một đối tượng là một thể hiện của ByteString chưa bao giờ thực sự cho bạn biết bất kỳ điều gì hữu ích về đối tượng đó. Các loại bộ đệm phổ biến khác như memoryview cũng không bao giờ được hiểu là kiểu con của ByteString (trong thời gian chạy hoặc bằng trình kiểm tra kiểu tĩnh).

    Xem PEP 688 để biết thêm chi tiết. (Được đóng góp bởi Shantanu Jain trong gh-91896.)

Đang chờ xóa trong Python 3.18

• decimal:

  • Công cụ xác định định dạng Decimal không chuẩn và không có giấy tờ 'N', chỉ được hỗ trợ trong quá trình triển khai C của mô-đun decimal, đã không được dùng nữa kể từ Python 3.13. (Được đóng góp bởi Serhiy Storchaka trong gh-89902.)

Đang chờ xóa trong Python 3.19

• ctypes:

  • Hoàn toàn chuyển sang bố cục cấu trúc tương thích với MSVC bằng cách đặt _pack_ chứ không phải _layout_ trên nền tảng không phải Windows.

Đang chờ xóa trong các phiên bản sau

Các API sau sẽ bị xóa trong tương lai, mặc dù hiện tại chưa có ngày dự kiến ​​xóa chúng.

• argparse:

  • Việc lồng các nhóm đối số và lồng các nhóm loại trừ lẫn nhau không được dùng nữa.

  • Việc chuyển đối số từ khóa không có giấy tờ prefix_chars sang add_argument_group() hiện không được dùng nữa.

  • Bộ chuyển đổi loại argparse.FileType không được dùng nữa.

• builtins:

  • Trình tạo: chữ ký throw(type, exc, tb) và athrow(type, exc, tb) không được dùng nữa: thay vào đó hãy sử dụng throw(exc) và athrow(exc), chữ ký đối số duy nhất.

  • Hiện tại Python chấp nhận các ký tự số ngay sau các từ khóa, ví dụ 0in x, 1or x, 0if 1else 2. Nó cho phép các biểu thức khó hiểu và mơ hồ như [0x1for x in y] (có thể hiểu là [0x1 for x in y] hoặc [0x1f or x in y]). Cảnh báo cú pháp sẽ được đưa ra nếu ngay sau chữ số là một trong các từ khóa and, else, for, if, in, is và or. Trong bản phát hành sau này, nó sẽ được thay đổi thành lỗi cú pháp. (gh-87999)

  • Hỗ trợ phương thức __index__() và __int__() trả về kiểu không phải int: các phương thức này sẽ được yêu cầu trả về một phiên bản của lớp con nghiêm ngặt của int.

  • Hỗ trợ phương thức __float__() trả về một lớp con nghiêm ngặt của float: những phương thức này sẽ được yêu cầu để trả về một phiên bản của float.

  • Hỗ trợ phương thức __complex__() trả về một lớp con nghiêm ngặt của complex: những phương thức này sẽ được yêu cầu để trả về một phiên bản của complex.

  • Việc truyền số phức dưới dạng đối số real hoặc imag trong hàm tạo complex() hiện không được dùng nữa; nó chỉ nên được thông qua dưới dạng một đối số vị trí duy nhất. (Được đóng góp bởi Serhiy Storchaka trong gh-109218.)

• calendar: Các hằng số calendar.January và calendar.February không được dùng nữa và được thay thế bằng calendar.JANUARY và calendar.FEBRUARY. (Được đóng góp bởi Hoàng tử Roshan trong gh-103636.)

• codecs: sử dụng open() thay vì codecs.open(). (gh-133038)

• codeobject.co_lnotab: thay vào đó hãy sử dụng phương pháp codeobject.co_lines().

• datetime:

  • utcnow(): sử dụng datetime.datetime.now(tz=datetime.UTC).

  • utcfromtimestamp(): sử dụng datetime.datetime.fromtimestamp(timestamp, tz=datetime.UTC).

• gettext: Giá trị số nhiều phải là số nguyên.

• importlib:

  • Tham số cache_from_source() debug_override không được dùng nữa: thay vào đó hãy sử dụng tham số optimization.

• importlib.metadata:

  • giao diện bộ dữ liệu EntryPoints.

  • None ngầm định trên các giá trị trả về.

• logging: phương thức warn() không được dùng nữa kể từ Python 3.3, thay vào đó hãy sử dụng warning().

• mailbox: Việc sử dụng chế độ văn bản và đầu vào StringIO không được dùng nữa, thay vào đó hãy sử dụng BytesIO và chế độ nhị phân.

• os: Gọi os.register_at_fork() trong quy trình đa luồng.

• pydoc.ErrorDuringImport: Giá trị bộ dữ liệu cho tham số exc_info không được dùng nữa, hãy sử dụng một phiên bản ngoại lệ.

• re: Các quy tắc nghiêm ngặt hơn hiện được áp dụng cho tham chiếu nhóm số và tên nhóm trong biểu thức chính quy. Hiện chỉ có chuỗi chữ số ASCII được chấp nhận làm tham chiếu số. Tên nhóm trong mẫu byte và chuỗi thay thế hiện chỉ có thể chứa các chữ cái, chữ số và dấu gạch dưới ASCII. (Được đóng góp bởi Serhiy Storchaka trong gh-91760.)

• mô-đun sre_compile, sre_constants và sre_parse.

• shutil: Tham số onerror của rmtree() không được dùng nữa trong Python 3.12; thay vào đó hãy sử dụng tham số onexc.

• Các tùy chọn và giao thức ssl:

  • ssl.SSLContext không có đối số giao thức sẽ không được dùng nữa.

  • ssl.SSLContext: set_npn_protocols() và selected_npn_protocol() không được dùng nữa: thay vào đó hãy sử dụng ALPN.

  • tùy chọn ssl.OP_NO_SSL*

  • tùy chọn ssl.OP_NO_TLS*

  • ssl.PROTOCOL_SSLv3

  • ssl.PROTOCOL_TLS

  • ssl.PROTOCOL_TLSv1

  • ssl.PROTOCOL_TLSv1_1

  • ssl.PROTOCOL_TLSv1_2

  • ssl.TLSVersion.SSLv3

  • ssl.TLSVersion.TLSv1

  • ssl.TLSVersion.TLSv1_1

• phương pháp threading:

  • threading.Condition.notifyAll(): sử dụng notify_all().

  • threading.Event.isSet(): sử dụng is_set().

  • threading.Thread.isDaemon(), threading.Thread.setDaemon(): sử dụng thuộc tính threading.Thread.daemon.

  • threading.Thread.getName(), threading.Thread.setName(): sử dụng thuộc tính threading.Thread.name.

  • threading.currentThread(): sử dụng threading.current_thread().

  • threading.activeCount(): sử dụng threading.active_count().

• typing.Text (gh-92332).

• Lớp nội bộ typing._UnionGenericAlias không còn được sử dụng để triển khai typing.Union nữa. Để duy trì khả năng tương thích với người dùng sử dụng lớp riêng tư này, một miếng chêm tương thích sẽ được cung cấp cho đến ít nhất là Python 3.17. (Được đóng góp bởi Jelle Zijlstra trong gh-105499.)

• unittest.IsolatedAsyncioTestCase: không được dùng để trả về giá trị không phải là None từ trường hợp thử nghiệm.

• urllib.parse các hàm không được dùng nữa: thay vào đó là urlparse()

  • splitattr()

  • splithost()

  • splitnport()

  • splitpasswd()

  • splitport()

  • splitquery()

  • splittag()

  • splittype()

  • splituser()

  • splitvalue()

  • to_bytes()

• wsgiref: SimpleHandler.stdout.write() không nên ghi một phần.

• xml.etree.ElementTree: Việc kiểm tra giá trị thực của Element không được dùng nữa. Trong bản phát hành sau này, nó sẽ luôn trả về True. Thay vào đó, hãy ưu tiên các bài kiểm tra len(elem) hoặc elem is not None rõ ràng.

• sys._clear_type_cache() không được dùng nữa: thay vào đó hãy sử dụng sys._clear_internal_caches().

C API ngừng sử dụng

Đang chờ xóa trong Python 3.15

• Zz000zz: Thay vào đó hãy sử dụng PyImport_ImportModule().

• PyWeakref_GetObject() và PyWeakref_GET_OBJECT(): Thay vào đó hãy sử dụng PyWeakref_GetRef(). pythoncapi-compat project có thể được sử dụng để nhận PyWeakref_GetRef() trên Python 3.12 trở lên.

• loại Py_UNICODE và macro Py_UNICODE_WIDE: Thay vào đó hãy sử dụng wchar_t.

• PyUnicode_AsDecodedObject(): Thay vào đó hãy sử dụng PyCodec_Decode().

• PyUnicode_AsDecodedUnicode(): Thay vào đó hãy sử dụng PyCodec_Decode(); Lưu ý rằng một số codec (ví dụ: "base64") có thể trả về loại khác str, chẳng hạn như bytes.

• PyUnicode_AsEncodedObject(): Thay vào đó hãy sử dụng PyCodec_Encode().

• PyUnicode_AsEncodedUnicode(): Thay vào đó hãy sử dụng PyCodec_Encode(); Lưu ý rằng một số codec (ví dụ: "base64") có thể trả về loại khác bytes, chẳng hạn như str.

• Các hàm khởi tạo Python, không được dùng nữa trong Python 3.13:

  • Py_GetPath(): Thay vào đó hãy sử dụng PyConfig_Get("module_search_paths") (sys.path).

  • Py_GetPrefix(): Thay vào đó hãy sử dụng PyConfig_Get("base_prefix") (sys.base_prefix). Sử dụng PyConfig_Get("prefix") (sys.prefix) nếu cần xử lý virtual environments.

  • Py_GetExecPrefix(): Thay vào đó hãy sử dụng PyConfig_Get("base_exec_prefix") (sys.base_exec_prefix). Sử dụng PyConfig_Get("exec_prefix") (sys.exec_prefix) nếu cần xử lý virtual environments.

  • Py_GetProgramFullPath(): Thay vào đó hãy sử dụng PyConfig_Get("executable") (sys.executable).

  • Py_GetProgramName(): Thay vào đó hãy sử dụng PyConfig_Get("executable") (sys.executable).

  • Py_GetPythonHome(): Thay vào đó hãy sử dụng PyConfig_Get("home") hoặc biến môi trường PYTHONHOME.

  pythoncapi-compat project có thể được sử dụng để nhận PyConfig_Get() trên Python 3.13 trở lên.

• Các hàm định cấu hình khởi tạo Python, không được dùng nữa trong Python 3.11:

  • PySys_SetArgvEx(): Thay vào đó hãy đặt PyConfig.argv.

  • PySys_SetArgv(): Thay vào đó hãy đặt PyConfig.argv.

  • Py_SetProgramName(): Thay vào đó hãy đặt PyConfig.program_name.

  • Py_SetPythonHome(): Thay vào đó hãy đặt PyConfig.home.

  • PySys_ResetWarnOptions(): Thay vào đó hãy xóa sys.warnoptions và warnings.filters.

  Thay vào đó, Py_InitializeFromConfig() API nên được sử dụng với PyConfig.

• Biến cấu hình toàn cầu:

  • Py_DebugFlag: Thay vào đó hãy sử dụng PyConfig.parser_debug hoặc PyConfig_Get("parser_debug").

  • Py_VerboseFlag: Thay vào đó hãy sử dụng PyConfig.verbose hoặc PyConfig_Get("verbose").

  • Py_QuietFlag: Thay vào đó hãy sử dụng PyConfig.quiet hoặc PyConfig_Get("quiet").

  • Py_InteractiveFlag: Thay vào đó hãy sử dụng PyConfig.interactive hoặc PyConfig_Get("interactive").

  • Py_InspectFlag: Thay vào đó hãy sử dụng PyConfig.inspect hoặc PyConfig_Get("inspect").

  • Py_OptimizeFlag: Thay vào đó hãy sử dụng PyConfig.optimization_level hoặc PyConfig_Get("optimization_level").

  • Py_NoSiteFlag: Thay vào đó hãy sử dụng PyConfig.site_import hoặc PyConfig_Get("site_import").

  • Py_BytesWarningFlag: Thay vào đó hãy sử dụng PyConfig.bytes_warning hoặc PyConfig_Get("bytes_warning").

  • Py_FrozenFlag: Thay vào đó hãy sử dụng PyConfig.pathconfig_warnings hoặc PyConfig_Get("pathconfig_warnings").

  • Py_IgnoreEnvironmentFlag: Thay vào đó hãy sử dụng PyConfig.use_environment hoặc PyConfig_Get("use_environment").

  • Py_DontWriteBytecodeFlag: Thay vào đó hãy sử dụng PyConfig.write_bytecode hoặc PyConfig_Get("write_bytecode").

  • Py_NoUserSiteDirectory: Thay vào đó hãy sử dụng PyConfig.user_site_directory hoặc PyConfig_Get("user_site_directory").

  • Py_UnbufferedStdioFlag: Thay vào đó hãy sử dụng PyConfig.buffered_stdio hoặc PyConfig_Get("buffered_stdio").

  • Py_HashRandomizationFlag: Thay vào đó hãy sử dụng PyConfig.use_hash_seed và PyConfig.hash_seed hoặc PyConfig_Get("hash_seed").

  • Py_IsolatedFlag: Thay vào đó hãy sử dụng PyConfig.isolated hoặc PyConfig_Get("isolated").

  • Py_LegacyWindowsFSEncodingFlag: Thay vào đó hãy sử dụng PyPreConfig.legacy_windows_fs_encoding hoặc PyConfig_Get("legacy_windows_fs_encoding").

  • Py_LegacyWindowsStdioFlag: Thay vào đó hãy sử dụng PyConfig.legacy_windows_stdio hoặc PyConfig_Get("legacy_windows_stdio").

  • Py_FileSystemDefaultEncoding, Py_HasFileSystemDefaultEncoding: Thay vào đó hãy sử dụng PyConfig.filesystem_encoding hoặc PyConfig_Get("filesystem_encoding").

  • Py_FileSystemDefaultEncodeErrors: Thay vào đó hãy sử dụng PyConfig.filesystem_errors hoặc PyConfig_Get("filesystem_errors").

  • Py_UTF8Mode: Thay vào đó hãy sử dụng PyPreConfig.utf8_mode hoặc PyConfig_Get("utf8_mode"). (xem Py_PreInitialize())

  Nên sử dụng Py_InitializeFromConfig() API cùng với PyConfig để đặt các tùy chọn này. Hoặc PyConfig_Get() có thể được sử dụng để có được các tùy chọn này khi chạy.

Đang chờ xóa trong Python 3.18

• Các hàm riêng tư sau đây không được dùng nữa và được lên kế hoạch xóa trong Python 3.18:

  • _PyBytes_Join(): sử dụng PyBytes_Join().

  • _PyDict_GetItemStringWithError(): sử dụng PyDict_GetItemStringRef().

  • _PyDict_Pop(): sử dụng PyDict_Pop().

  • _PyLong_Sign(): sử dụng PyLong_GetSign().

  • _PyLong_FromDigits() và _PyLong_New(): sử dụng PyLongWriter_Create().

  • _PyThreadState_UncheckedGet(): sử dụng PyThreadState_GetUnchecked().

  • _PyUnicode_AsString(): sử dụng PyUnicode_AsUTF8().

  • _PyUnicodeWriter_Init(): thay thế _PyUnicodeWriter_Init(&writer) bằng writer = PyUnicodeWriter_Create(0).

  • _PyUnicodeWriter_Finish(): thay thế _PyUnicodeWriter_Finish(&writer) bằng PyUnicodeWriter_Finish(writer).

  • _PyUnicodeWriter_Dealloc(): thay thế _PyUnicodeWriter_Dealloc(&writer) bằng PyUnicodeWriter_Discard(writer).

  • _PyUnicodeWriter_WriteChar(): thay thế _PyUnicodeWriter_WriteChar(&writer, ch) bằng PyUnicodeWriter_WriteChar(writer, ch).

  • _PyUnicodeWriter_WriteStr(): thay thế _PyUnicodeWriter_WriteStr(&writer, str) bằng PyUnicodeWriter_WriteStr(writer, str).

  • _PyUnicodeWriter_WriteSubstring(): thay thế _PyUnicodeWriter_WriteSubstring(&writer, str, start, end) bằng PyUnicodeWriter_WriteSubstring(writer, str, start, end).

  • _PyUnicodeWriter_WriteASCIIString(): thay thế _PyUnicodeWriter_WriteASCIIString(&writer, str) bằng PyUnicodeWriter_WriteASCII(writer, str).

  • _PyUnicodeWriter_WriteLatin1String(): thay thế _PyUnicodeWriter_WriteLatin1String(&writer, str) bằng PyUnicodeWriter_WriteUTF8(writer, str).

  • _PyUnicodeWriter_Prepare(): (không thay thế).

  • _PyUnicodeWriter_PrepareKind(): (không thay thế).

  • _Py_HashPointer(): sử dụng Py_HashPointer().

  • _Py_fopen_obj(): sử dụng Py_fopen().

  pythoncapi-compat project có thể được sử dụng để nhận các hàm công khai mới này trên Python 3.13 trở lên. (Được đóng góp bởi Victor Stinner trong gh-128863.)

Đang chờ xóa trong các phiên bản sau

Các API sau không còn được dùng nữa và sẽ bị xóa, mặc dù hiện tại chưa có ngày dự kiến ​​xóa chúng.

• Py_TPFLAGS_HAVE_FINALIZE: Không cần thiết kể từ Python 3.8.

• PyErr_Fetch(): Thay vào đó hãy sử dụng PyErr_GetRaisedException().

• PyErr_NormalizeException(): Thay vào đó hãy sử dụng PyErr_GetRaisedException().

• PyErr_Restore(): Thay vào đó hãy sử dụng PyErr_SetRaisedException().

• PyModule_GetFilename(): Thay vào đó hãy sử dụng PyModule_GetFilenameObject().

• PyOS_AfterFork(): Thay vào đó hãy sử dụng PyOS_AfterFork_Child().

• PySlice_GetIndicesEx(): Thay vào đó hãy sử dụng PySlice_Unpack() và PySlice_AdjustIndices().

• PyUnicode_READY(): Không cần thiết kể từ Python 3.12

• PyErr_Display(): Thay vào đó hãy sử dụng PyErr_DisplayException().

• _PyErr_ChainExceptions(): Thay vào đó hãy sử dụng _PyErr_ChainExceptions1().

• Thành viên PyBytesObject.ob_shash: thay vào đó hãy gọi PyObject_Hash().

• Chủ đề Lưu trữ cục bộ (TLS) API:

  • PyThread_create_key(): Thay vào đó hãy sử dụng PyThread_tss_alloc().

  • PyThread_delete_key(): Thay vào đó hãy sử dụng PyThread_tss_free().

  • PyThread_set_key_value(): Thay vào đó hãy sử dụng PyThread_tss_set().

  • PyThread_get_key_value(): Thay vào đó hãy sử dụng PyThread_tss_get().

  • PyThread_delete_key_value(): Thay vào đó hãy sử dụng PyThread_tss_delete().

  • PyThread_ReInitTLS(): Không cần thiết kể từ Python 3.7.