منسوخ‌شده‌ها

در انتظار حذف در پایتون 3.16

• سیستم ایمپورت:

  • تنظیم __loader__ روی یک ماژول بدون تنظیم __spec__.loader منسوخ شده است. در پایتون 3.16، __loader__ دیگر توسط سیستم ایمپورت یا کتابخانه استاندارد تنظیم یا در نظر گرفته نخواهد شد.

• array:

  • کد قالب 'u' (wchar_t) در مستندات از پایتون 3.3 و در ران‌تایم از پایتون 3.13 منسوخ شده است. به جای آن، برای نویسه‌های یونیکد از کد قالب 'w' (Py_UCS4) استفاده کنید.

• asyncio:

  • asyncio.iscoroutinefunction() منسوخ شده است و در Python 3.16 حذف خواهد شد؛ به‌جای آن از inspect.iscoroutinefunction() استفاده کنید. (با مشارکت Jiahao Li و Kumar Aditya در gh-122875.)

  • سامانه سیاست‌های asyncio منسوخ شده است و در پایتون 3.16 حذف خواهد شد. به‌ویژه، کلاس‌ها و توابع زیر منسوخ شده‌اند:

    • asyncio.AbstractEventLoopPolicy

    • asyncio.DefaultEventLoopPolicy

    • asyncio.WindowsSelectorEventLoopPolicy

    • asyncio.WindowsProactorEventLoopPolicy

    • asyncio.get_event_loop_policy()

    • asyncio.set_event_loop_policy()

    کاربران باید برای استفاده از پیاده‌سازی حلقه رویداد مطلوب، از asyncio.run() یا asyncio.Runner به همراه loop_factory استفاده کنند.

    به عنوان مثال، برای استفاده از asyncio.SelectorEventLoop در ویندوز:

    import asyncio
    
    async def main():
        ...
    
    asyncio.run(main(), loop_factory=asyncio.SelectorEventLoop)
    

    (مشارکت‌شده توسط Kumar Aditya در gh-127949.)

• builtins:

  • وارون‌سازی بیتی روی نوع‌های بولی، یعنی ~True یا ~False، از پایتون 3.12 منسوخ شده است، زیرا نتایج غیرمنتظره و غیرشهودی تولید می‌کند (-2 و -1). برای نقیض منطقی یک مقدار بولی، به‌جای آن از not x استفاده کنید. در موارد نادر که به وارون‌سازی بیتی عدد صحیح زیرین نیاز دارید، آن را به‌طور صریح به int تبدیل کنید (~int(x)).

• functools:

  • فراخوانی پیاده‌سازی پایتونی functools.reduce() با آرگومان‌های کلیدواژه‌ای function یا sequence از پایتون 3.14 منسوخ شده است.

• logging:

  • پشتیبانی از هندلرهای سفارشی گزارش‌گیری با آرگومان strm منسوخ شده و برای حذف در پایتون 3.16 برنامه‌ریزی شده است. به جای آن، هندلرها را با آرگومان stream تعریف کنید. (مشارکت Mariusz Felisiak در gh-115032.)

• mimetypes:

  • پسوندهای معتبر برای mimetypes.MimeTypes.add_type() با '.' شروع می‌شوند یا خالی هستند. پسوندهای بدون نقطه منسوخ شده‌اند و در پایتون 3.16 استثنای ValueError ایجاد خواهند کرد. (با مشارکت هوگو ون کمناده در gh-75223.)

• shutil:

  • استثنای ExecError از پایتون 3.14 منسوخ شده است. از پایتون 3.4 به بعد، هیچ تابعی در shutil از آن استفاده نکرده است و اکنون نام مستعاری برای RuntimeError است.

• symtable:

  • متد Class.get_methods از پایتون 3.14 منسوخ شده است.

• sys:

  • تابع _enablelegacywindowsfsencoding() از پایتون 3.13 منسوخ شده است. به جای آن از متغیر محیطی PYTHONLEGACYWINDOWSFSENCODING استفاده کنید.

• sysconfig:

  • تابع sysconfig.expand_makefile_vars() از پایتون 3.14 منسوخ شده است. به جای آن، از آرگومان vars در sysconfig.get_paths() استفاده کنید.

• tarfile:

  • ویژگی مستندنشده و استفاده‌نشده‌ی TarFile.tarfile از پایتون 3.13 منسوخ شده است.

در انتظار حذف در پایتون 3.17

• datetime:

  • strptime() calls using a format string containing %e (day of month) without a year. This has been deprecated since Python 3.15. (Contributed by Stan Ulbrych in gh-70647.)

• collections.abc:

  • collections.abc.ByteString برای حذف در پایتون 3.17 برنامه‌ریزی شده است.

    از isinstance(obj, collections.abc.Buffer) استفاده کنید تا در زمان اجرا بررسی کنید که آیا obj پروتکل بافر را پیاده‌سازی می‌کند. برای استفاده در حاشیه‌نویسی نوع، یا از Buffer استفاده کنید یا از یک اجتماع (union) که به‌طور صریح نوع‌هایی را که کد شما از آن‌ها پشتیبانی می‌کند مشخص می‌کند (مثلاً bytes | bytearray | memoryview).

    ByteString در اصل قرار بود یک کلاس انتزاعی باشد که به‌عنوان ابرنوعی برای هر دو bytes و bytearray عمل کند. با این حال، از آنجا که این کلاس پایه انتزاعی هرگز هیچ متدی نداشت، دانستن اینکه شیئی نمونه‌ای از ByteString است، هرگز در واقع هیچ چیز مفیدی درباره‌ی آن شیء به شما نمی‌گفت. سایر نوع‌های رایج بافر مانند memoryview نیز هرگز به‌عنوان زیرنوع‌هایی از ByteString شناخته نمی‌شدند (نه در ران‌تایم و نه توسط بررسی‌گرهای نوع ایستا).

    برای جزئیات بیشتر به PEP 688 مراجعه کنید. (مشارکت‌شده توسط Shantanu Jain در gh-91896.)

• encodings:

  • Passing non-ascii encoding names to encodings.normalize_encoding() is deprecated and scheduled for removal in Python 3.17. (Contributed by Stan Ulbrych in gh-136702.)

• profile:

  • The profile module is deprecated and will be removed in Python 3.17. Use profiling.tracing instead, which provides a compatible API. See PEP 799 for details. (Contributed by Pablo Galindo and László Kiss Kollár in gh-138122.)

• webbrowser:

  • webbrowser.MacOSXOSAScript is deprecated in favour of webbrowser.MacOS. (gh-137586)

• typing:

  • پیش از پایتون 3.14، اجتماع‌های سبک قدیمی (old-style unions) با استفاده از کلاس خصوصی typing._UnionGenericAlias پیاده‌سازی می‌شدند. این کلاس دیگر برای پیاده‌سازی لازم نیست، اما برای سازگاری با نسخه‌های پیشین حفظ شده است و حذف آن برای پایتون 3.17 برنامه‌ریزی شده است. کاربران باید به‌جای اتکا به جزئیات پیاده‌سازی خصوصی، از ابزارهای کمکی درون‌نگری مستند مانند typing.get_origin() و typing.get_args() استفاده کنند.

  • typing.ByteString که از پایتون 3.9 منسوخ شده است، برای حذف در پایتون 3.17 برنامه‌ریزی شده است.

    از isinstance(obj, collections.abc.Buffer) استفاده کنید تا در زمان اجرا بررسی کنید که آیا obj پروتکل بافر را پیاده‌سازی می‌کند. برای استفاده در حاشیه‌نویسی نوع، یا از Buffer استفاده کنید یا از یک اجتماع (union) که به‌طور صریح نوع‌هایی را که کد شما از آن‌ها پشتیبانی می‌کند مشخص می‌کند (مثلاً bytes | bytearray | memoryview).

    ByteString در اصل قرار بود یک کلاس انتزاعی باشد که به‌عنوان ابرنوعی برای هر دو bytes و bytearray عمل کند. با این حال، از آنجا که این کلاس پایه انتزاعی هرگز هیچ متدی نداشت، دانستن اینکه شیئی نمونه‌ای از ByteString است، هرگز در واقع هیچ چیز مفیدی درباره‌ی آن شیء به شما نمی‌گفت. سایر نوع‌های رایج بافر مانند memoryview نیز هرگز به‌عنوان زیرنوع‌هایی از ByteString شناخته نمی‌شدند (نه در ران‌تایم و نه توسط بررسی‌گرهای نوع ایستا).

    برای جزئیات بیشتر به PEP 688 مراجعه کنید. (مشارکت‌شده توسط Shantanu Jain در gh-91896.)

• tkinter:

  • The tkinter.Variable methods trace_variable(), trace() (an alias of trace_variable()), trace_vdelete() and trace_vinfo(), deprecated since Python 3.14, are scheduled for removal in Python 3.17. Use trace_add(), trace_remove() and trace_info() instead. (Contributed by Serhiy Storchaka in gh-120220.)

در انتظار حذف در پایتون 3.18

• No longer accept a boolean value when a file descriptor is expected. (Contributed by Serhiy Storchaka in gh-82626.)

• decimal:

  • مشخص‌کننده قالب 'N' در Decimal که غیراستاندارد و مستندسازی‌نشده است و فقط در پیاده‌سازی C ماژول decimal پشتیبانی می‌شود، از پایتون 3.13 منسوخ شده است. (مشارکت‌شده توسط Serhiy Storchaka در gh-89902.)

• Deprecations defined by PEP 829:

  • import lines in name.pth files are silently ignored.

  (Contributed by Barry Warsaw in gh-148641.)

در انتظار حذف در پایتون 3.19

• ctypes:

  • تغییر ضمنی به چیدمان ساختار سازگار با MSVC با تنظیم _pack_ اما بدون تنظیم _layout_ روی پلتفرم‌های غیر ویندوزی.

• hashlib:

  • In hash function constructors such as new() or the direct hash-named constructors such as md5() and sha256(), their optional initial data parameter could also be passed a keyword argument named data= or string= in various hashlib implementations.

    Support for the string keyword argument name is now deprecated and slated for removal in Python 3.19.

    Before Python 3.13, the string keyword parameter was not correctly supported depending on the backend implementation of hash functions. Prefer passing the initial data as a positional argument for maximum backwards compatibility.

• http.cookies:

  • http.cookies.Morsel.js_output() is deprecated and will be removed in Python 3.19.

  • http.cookies.BaseCookie.js_output() is deprecated and will be removed in Python 3.19.

• imaplib:

  • Altering IMAP4.file is now deprecated and slated for removal in Python 3.19. This property is now unused and changing its value does not automatically close the current file.

    Before Python 3.14, this property was used to implement the corresponding read() and readline() methods for IMAP4 but this is no longer the case since then.

Pending removal in Python 3.20

• Calling the __new__() method of struct.Struct without the format argument is deprecated and will be removed in Python 3.20. Calling __init__() method on initialized Struct objects is deprecated and will be removed in Python 3.20.

  (Contributed by Sergey B Kirpichev and Serhiy Storchaka in gh-143715.)

• The __version__, version and VERSION attributes have been deprecated in these standard library modules and will be removed in Python 3.20. Use sys.version_info instead.

  • argparse

  • csv

  • ctypes

  • ctypes.macholib

  • decimal (use decimal.SPEC_VERSION instead)

  • http.server

  • imaplib

  • ipaddress

  • json

  • logging (__date__ also deprecated)

  • optparse

  • pickle

  • platform

  • re

  • socketserver

  • tabnanny

  • tarfile

  • tkinter.font

  • tkinter.ttk

  • wsgiref.simple_server

  • xml.etree.ElementTree

  • xml.sax.expatreader

  • xml.sax.handler

  • zlib

  (Contributed by Hugo van Kemenade and Stan Ulbrych in gh-76007.)

• Deprecations defined by PEP 829:

  • Warnings are produced for import lines found in name.pth files.

  • name.pth files are no longer decoded in the locale encoding by default. They MUST be encoded in utf-8-sig.

  (Contributed by Barry Warsaw in gh-148641.)

• ast:

  • Creating instances of abstract AST nodes (such as ast.AST or ast.expr) is deprecated and will raise an error in Python 3.20.

• typing:

  • It is deprecated to call isinstance() and issubclass() checks on protocol classes that were not explicitly decorated with runtime_checkable() but that inherit from a runtime-checkable protocol class. This will raise a TypeError in Python 3.20.

    (Contributed by Bartosz Sławecki in gh-132604.)

در انتظار حذف در نسخه‌های آینده

APIهای زیر در آینده حذف خواهند شد، اگرچه در حال حاضر تاریخی برای حذف آن‌ها برنامه‌ریزی نشده است.

• argparse:

  • تودرتو کردن گروه‌های آرگومان و تودرتو کردن گروه‌های انحصاری متقابل منسوخ شده‌اند.

  • گذراندن آرگومان کلیدواژه‌ای مستندنشده‌ی prefix_chars به add_argument_group() اکنون منسوخ شده است.

  • مبدل نوع argparse.FileType منسوخ شده است.

• builtins:

  • تولیدگرها: امضای throw(type, exc, tb) و athrow(type, exc, tb) منسوخ شده است؛ به جای آن از throw(exc) و athrow(exc) استفاده کنید — امضای تک‌آرگومانی.

  • در حال حاضر پایتون مقادیر لفظی عددی را می‌پذیرد که بلافاصله کلیدواژه‌ای پس از آن‌ها می‌آید، برای مثال 0in x، 1or x، 0if 1else 2. این اجازه می‌دهد عبارت‌های گیج‌کننده و مبهمی مانند [0x1for x in y] نوشته شوند (که می‌توان آن را به صورت [0x1 for x in y] یا [0x1f or x in y] تفسیر کرد). اگر مقدار لفظی عددی بلافاصله با یکی از کلیدواژه‌های and، else، for، if، in، is و or دنبال شود، یک هشدار سینتکس اکسپورت می‌شود. در یک نسخه‌ی آینده این مورد به یک خطای سینتکس تبدیل خواهد شد. (gh-87999)

  • پشتیبانی از بازگرداندن نوعی غیر از int توسط متد‌های __index__() و __int__(): این متدها ملزم خواهند شد که نمونه‌ای از یک زیرکلاس محضِ int را بازگردانند.

  • پشتیبانی از متد __float__() که زیرکلاس اکیدی از float را برمی‌گرداند: این متدها ملزم خواهند شد که نمونه‌ای از float را بازگردانند.

  • پشتیبانی از متد __complex__() که زیرکلاس اکیدِ complex را برمی‌گرداند: این متدها ملزم خواهند شد که نمونه‌ای از complex را برگردانند.

  • گذراندن یک عدد مختلط به‌عنوان آرگومان real یا imag در سازنده‌ی complex() اکنون منسوخ شده است؛ این عدد باید فقط به‌صورت یک آرگومان جایگاهی واحد ارسال شود. (مشارکت Serhiy Storchaka در gh-109218.)

• calendar: ثابت‌های calendar.January و calendar.February منسوخ شده‌اند و با calendar.JANUARY و calendar.FEBRUARY جایگزین شده‌اند. (مشارکت‌شده توسط Prince Roshan در gh-103636.)

• codecs: به‌جای codecs.open() از open() استفاده کنید. (gh-133038)

• codeobject.co_lnotab: use the codeobject.co_lines() method instead.

• datetime:

  • utcnow(): از datetime.datetime.now(tz=datetime.UTC) استفاده کنید.

  • utcfromtimestamp(): از datetime.datetime.fromtimestamp(timestamp, tz=datetime.UTC) استفاده کنید.

• gettext: مقدار جمع باید یک عدد صحیح باشد.

• importlib:

  • پارامتر debug_override در cache_from_source() منسوخ شده است: به جای آن از پارامتر optimization استفاده کنید.

• importlib.metadata:

  • رابط تاپلیِ EntryPoints.

  • None ضمنی در مقادیر بازگشتی.

• logging: متد warn() از پایتون 3.3 به بعد منسوخ شده است؛ به جای آن از warning() استفاده کنید.

• mailbox: استفاده از ورودی StringIO و حالت متنی منسوخ شده است؛ به‌جای آن از BytesIO و حالت دودویی استفاده کنید.

• os: Calling os.register_at_fork() in a multi-threaded process.

• os.path: os.path.commonprefix() is deprecated, use os.path.commonpath() for path prefixes. The os.path.commonprefix() function is being deprecated due to having a misleading name and module. The function is not safe to use for path prefixes despite being included in a module about path manipulation, meaning it is easy to accidentally introduce path traversal vulnerabilities into Python programs by using this function.

• pydoc.ErrorDuringImport: مقدار تاپل برای پارامتر exc_info منسوخ شده است؛ از یک نمونه استثنا استفاده کنید.

• re: اکنون قواعد سخت‌گیرانه‌تری برای ارجاع‌های عددی گروه و نام گروه‌ها در عبارت‌های باقاعده اعمال می‌شود. اکنون فقط دنباله‌ای از ارقام اسکی به‌عنوان ارجاع عددی پذیرفته می‌شود. نام گروه در الگوهای بایتی و رشته‌های جایگزین اکنون فقط می‌تواند شامل حروف و ارقام اسکی و زیرخط باشد. (مشارکت‌شده توسط Serhiy Storchaka در gh-91760.)

• shutil: پارامتر onerror در rmtree() در پایتون 3.12 منسوخ شده است؛ به‌جای آن از پارامتر onexc استفاده کنید.

• گزینه‌ها و پروتکل‌های ssl:

  • ssl.SSLContext بدون آرگومان پروتکل، منسوخ شده است.

  • ssl.SSLContext: متدهای set_npn_protocols() و selected_npn_protocol() منسوخ شده‌اند: به‌جای آن‌ها از ALPN استفاده کنید.

  • گزینه‌های ssl.OP_NO_SSL*

  • گزینه‌های 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

• متدهای threading:

  • threading.Condition.notifyAll(): از notify_all() استفاده کنید.

  • threading.Event.isSet(): از is_set() استفاده کنید.

  • threading.Thread.isDaemon()، threading.Thread.setDaemon(): از ویژگی threading.Thread.daemon استفاده کنید.

  • threading.Thread.getName()، threading.Thread.setName(): از ویژگی threading.Thread.name استفاده کنید.

  • threading.currentThread(): از threading.current_thread() استفاده کنید.

  • threading.activeCount(): از threading.active_count() استفاده کنید.

• typing.Text (gh-92332).

• کلاس داخلی typing._UnionGenericAlias دیگر برای پیاده‌سازی typing.Union استفاده نمی‌شود. برای حفظ سازگاری با کاربرانی که از این کلاس خصوصی استفاده می‌کنند، یک لایه‌ی سازگاری (shim) تا دست‌کم Python 3.17 ارائه خواهد شد. (مشارکت‌شده توسط Jelle Zijlstra در gh-105499.)

• unittest.IsolatedAsyncioTestCase: برگرداندن مقداری غیر از None از یک مورد آزمون منسوخ شده است.

• توابع منسوخ urllib.parse: به‌جای آن‌ها urlparse()

  • splitattr()

  • splithost()

  • splitnport()

  • splitpasswd()

  • splitport()

  • splitquery()

  • splittag()

  • splittype()

  • splituser()

  • splitvalue()

  • to_bytes()

• wsgiref: SimpleHandler.stdout.write() نباید نوشتن جزئی (partial write) انجام دهد.

• xml.etree.ElementTree: آزمودن مقدار درستی یک Element منسوخ شده است. در نسخه‌ای در آینده، همیشه True بازگردانده خواهد شد. به جای آن، آزمون‌های صریح len(elem) یا elem is not None را ترجیح دهید.

• sys._clear_type_cache() منسوخ شده است: به جای آن از sys._clear_internal_caches() استفاده کنید.

Soft deprecations

There are no plans to remove soft deprecated APIs.

• re.match() and re.Pattern.match() are now soft deprecated in favor of the new re.prefixmatch() and re.Pattern.prefixmatch() APIs, which have been added as alternate, more explicit names. These are intended to be used to alleviate confusion around what match means by following the Zen of Python's "Explicit is better than implicit" mantra. Most other language regular expression libraries use an API named match to mean what Python has always called search.

  We do not plan to remove the older match() name, as it has been used in code for over 30 years. Code supporting older versions of Python should continue to use match(), while new code should prefer prefixmatch(). See prefixmatch() vs. match().

  (Contributed by Gregory P. Smith in gh-86519 and Hugo van Kemenade in gh-148100.)

• Using 'F' and 'D' format type codes of the struct module now are soft deprecated in favor of two-letter forms 'Zf' and 'Zd'. (Contributed by Sergey B Kirpichev in gh-121249.)

منسوخ‌شده‌های C API

در انتظار حذف در پایتون 3.15

• The PyImport_ImportModuleNoBlock(): Use PyImport_ImportModule() instead.

• PyWeakref_GetObject() and PyWeakref_GET_OBJECT(): Use PyWeakref_GetRef() instead. The pythoncapi-compat project can be used to get PyWeakref_GetRef() on Python 3.12 and older.

• PyUnicode_AsDecodedObject(): به جای آن از PyCodec_Decode() استفاده کنید.

• PyUnicode_AsDecodedUnicode(): به‌جای آن از PyCodec_Decode() استفاده کنید؛ توجه داشته باشید که برخی کدک‌ها (برای مثال، "base64") ممکن است نوعی غیر از str مانند bytes برگردانند.

• PyUnicode_AsEncodedObject(): به‌جای آن از PyCodec_Encode() استفاده کنید.

• PyUnicode_AsEncodedUnicode(): به‌جای آن از PyCodec_Encode() استفاده کنید؛ توجه داشته باشید که برخی کدک‌ها (برای مثال، "base64") ممکن است نوعی غیر از bytes، مانند str برگردانند.

• توابع مقداردهی اولیه پایتون، منسوخ‌شده در پایتون 3.13:

  • Py_GetPath(): Use PyConfig_Get("module_search_paths") (sys.path) instead.

  • Py_GetPrefix(): Use PyConfig_Get("base_prefix") (sys.base_prefix) instead. Use PyConfig_Get("prefix") (sys.prefix) if virtual environments need to be handled.

  • Py_GetExecPrefix(): Use PyConfig_Get("base_exec_prefix") (sys.base_exec_prefix) instead. Use PyConfig_Get("exec_prefix") (sys.exec_prefix) if virtual environments need to be handled.

  • Py_GetProgramFullPath(): Use PyConfig_Get("executable") (sys.executable) instead.

  • Py_GetProgramName(): Use PyConfig_Get("executable") (sys.executable) instead.

  • Py_GetPythonHome(): Use PyConfig_Get("home") or the PYTHONHOME environment variable instead.

  می‌توان از پروژه‌ی pythoncapi-compat برای به دست آوردن PyConfig_Get() در پایتون 3.13 و نسخه‌های قدیمی‌تر استفاده کرد.

• توابعی برای پیکربندی راه‌اندازی پایتون، که در پایتون 3.11 منسوخ شده‌اند:

  • PySys_SetArgvEx(): به جای آن، PyConfig.argv را تنظیم کنید.

  • PySys_SetArgv(): به جای آن PyConfig.argv را تنظیم کنید.

  • Py_SetProgramName(): به‌جای آن PyConfig.program_name را تنظیم کنید.

  • Py_SetPythonHome(): به جای آن PyConfig.home را تنظیم کنید.

  • PySys_ResetWarnOptions(): Clear sys.warnoptions and warnings.filters instead.

  به‌جای آن، باید از API Py_InitializeFromConfig() به همراه PyConfig استفاده شود.

• متغیرهای پیکربندی سراسری:

  • Py_DebugFlag: به‌جای آن از PyConfig.parser_debug یا PyConfig_Get("parser_debug") استفاده کنید.

  • Py_VerboseFlag: به جای آن از PyConfig.verbose یا PyConfig_Get("verbose") استفاده کنید.

  • Py_QuietFlag: به‌جای آن از PyConfig.quiet یا PyConfig_Get("quiet") استفاده کنید.

  • Py_InteractiveFlag: به جای آن از PyConfig.interactive یا PyConfig_Get("interactive") استفاده کنید.

  • Py_InspectFlag: به‌جای آن از PyConfig.inspect یا PyConfig_Get("inspect") استفاده کنید.

  • Py_OptimizeFlag: به جای آن از PyConfig.optimization_level یا PyConfig_Get("optimization_level") استفاده کنید.

  • Py_NoSiteFlag: به‌جای آن از PyConfig.site_import یا PyConfig_Get("site_import") استفاده کنید.

  • Py_BytesWarningFlag: به‌جای آن از PyConfig.bytes_warning یا PyConfig_Get("bytes_warning") استفاده کنید.

  • Py_FrozenFlag: به‌جای آن از PyConfig.pathconfig_warnings یا PyConfig_Get("pathconfig_warnings") استفاده کنید.

  • Py_IgnoreEnvironmentFlag: به‌جای آن از PyConfig.use_environment یا PyConfig_Get("use_environment") استفاده کنید.

  • Py_DontWriteBytecodeFlag: به‌جای آن از PyConfig.write_bytecode یا PyConfig_Get("write_bytecode") استفاده کنید.

  • Py_NoUserSiteDirectory: به‌جای آن از PyConfig.user_site_directory یا PyConfig_Get("user_site_directory") استفاده کنید.

  • Py_UnbufferedStdioFlag: به جای آن از PyConfig.buffered_stdio یا PyConfig_Get("buffered_stdio") استفاده کنید.

  • Py_HashRandomizationFlag: به‌جای آن از PyConfig.use_hash_seed و PyConfig.hash_seed یا PyConfig_Get("hash_seed") استفاده کنید.

  • Py_IsolatedFlag: به جای آن از PyConfig.isolated یا PyConfig_Get("isolated") استفاده کنید.

  • Py_LegacyWindowsFSEncodingFlag: به جای آن از PyPreConfig.legacy_windows_fs_encoding یا PyConfig_Get("legacy_windows_fs_encoding") استفاده کنید.

  • Py_LegacyWindowsStdioFlag: به‌جای آن از PyConfig.legacy_windows_stdio یا PyConfig_Get("legacy_windows_stdio") استفاده کنید.

  • Py_FileSystemDefaultEncoding، Py_HasFileSystemDefaultEncoding: به‌جای آن‌ها از PyConfig.filesystem_encoding یا PyConfig_Get("filesystem_encoding") استفاده کنید.

  • Py_FileSystemDefaultEncodeErrors: به جای آن از PyConfig.filesystem_errors یا PyConfig_Get("filesystem_errors") استفاده کنید.

  • Py_UTF8Mode: به جای آن از PyPreConfig.utf8_mode یا PyConfig_Get("utf8_mode") استفاده کنید. (به Py_PreInitialize() مراجعه کنید)

  برای تنظیم این گزینه‌ها باید از API Py_InitializeFromConfig() به همراه PyConfig استفاده شود. یا می‌توان از PyConfig_Get() برای دریافت این گزینه‌ها در زمان اجرا استفاده کرد.

در انتظار حذف در پایتون 3.16

• The bundled copy of libmpdec.

در انتظار حذف در پایتون 3.18

• توابع خصوصی زیر منسوخ شده‌اند و حذف آن‌ها در پایتون 3.18 برنامه‌ریزی شده است:

  • _PyBytes_Join(): از PyBytes_Join() استفاده کنید.

  • _PyDict_GetItemStringWithError(): از PyDict_GetItemStringRef() استفاده کنید.

  • _PyDict_Pop(): از PyDict_Pop() استفاده کنید.

  • _PyLong_Sign(): از PyLong_GetSign() استفاده کنید.

  • _PyLong_FromDigits() و _PyLong_New(): از PyLongWriter_Create() استفاده کنید.

  • _PyThreadState_UncheckedGet(): از PyThreadState_GetUnchecked() استفاده کنید.

  • _PyUnicode_AsString(): از PyUnicode_AsUTF8() استفاده کنید.

  • _PyUnicodeWriter_Init(): _PyUnicodeWriter_Init(&writer) را با writer = PyUnicodeWriter_Create(0) جایگزین کنید.

  • _PyUnicodeWriter_Finish(): عبارت _PyUnicodeWriter_Finish(&writer) را با PyUnicodeWriter_Finish(writer) جایگزین کنید.

  • _PyUnicodeWriter_Dealloc(): _PyUnicodeWriter_Dealloc(&writer) را با PyUnicodeWriter_Discard(writer) جایگزین کنید.

  • _PyUnicodeWriter_WriteChar(): _PyUnicodeWriter_WriteChar(&writer, ch) را با PyUnicodeWriter_WriteChar(writer, ch) جایگزین کنید.

  • _PyUnicodeWriter_WriteStr(): _PyUnicodeWriter_WriteStr(&writer, str) را با PyUnicodeWriter_WriteStr(writer, str) جایگزین کنید.

  • _PyUnicodeWriter_WriteSubstring(): عبارت _PyUnicodeWriter_WriteSubstring(&writer, str, start, end) را با PyUnicodeWriter_WriteSubstring(writer, str, start, end) جایگزین کنید.

  • _PyUnicodeWriter_WriteASCIIString(): _PyUnicodeWriter_WriteASCIIString(&writer, str) را با PyUnicodeWriter_WriteASCII(writer, str) جایگزین کنید.

  • _PyUnicodeWriter_WriteLatin1String(): _PyUnicodeWriter_WriteLatin1String(&writer, str) را با PyUnicodeWriter_WriteUTF8(writer, str) جایگزین کنید.

  • _PyUnicodeWriter_Prepare(): (بدون جایگزین).

  • _PyUnicodeWriter_PrepareKind(): (بدون جایگزین).

  • _Py_HashPointer(): از Py_HashPointer() استفاده کنید.

  • _Py_fopen_obj(): از Py_fopen() استفاده کنید.

  می‌توان از پروژه‌ی pythoncapi-compat برای به دست آوردن این توابع عمومی جدید در پایتون 3.13 و نسخه‌های قدیمی‌تر استفاده کرد. (مشارکت‌شده توسط Victor Stinner در gh-128863.)

در انتظار حذف در پایتون 3.19

• PEP 456 embedders support for the string hashing scheme definition.

Pending removal in Python 3.20

• _PyObject_CallMethodId(), _PyObject_GetAttrId() and _PyUnicode_FromId() are deprecated since 3.15 and will be removed in 3.20. Instead, use PyUnicode_InternFromString() and cache the result in the module state, then call PyObject_CallMethod() or PyObject_GetAttr(). (Contributed by Victor Stinner in gh-141049.)

• The cval field in PyComplexObject (gh-128813). Use PyComplex_AsCComplex() and PyComplex_FromCComplex() to convert a Python complex number to/from the C Py_complex representation.

• Macros Py_MATH_PIl and Py_MATH_El.

در انتظار حذف در نسخه‌های آینده

API‌های زیر منسوخ شده‌اند و حذف خواهند شد، اگرچه در حال حاضر هیچ تاریخی برای حذف آن‌ها تعیین نشده است.

• Py_TPFLAGS_HAVE_FINALIZE: از پایتون 3.8 به بعد مورد نیاز نیست.

• PyErr_Fetch(): به‌جای آن از PyErr_GetRaisedException() استفاده کنید.

• PyErr_NormalizeException(): به جای آن از PyErr_GetRaisedException() استفاده کنید.

• PyErr_Restore(): به‌جای آن از PyErr_SetRaisedException() استفاده کنید.

• PyModule_GetFilename(): به‌جای آن از PyModule_GetFilenameObject() استفاده کنید.

• PyOS_AfterFork(): به‌جای آن از PyOS_AfterFork_Child() استفاده کنید.

• PySlice_GetIndicesEx(): به‌جای آن از PySlice_Unpack() و PySlice_AdjustIndices() استفاده کنید.

• PyUnicode_READY(): از پایتون 3.12 به بعد نیازی به آن نیست

• PyErr_Display(): به‌جای آن از PyErr_DisplayException() استفاده کنید.

• _PyErr_ChainExceptions(): به‌جای آن از _PyErr_ChainExceptions1() استفاده کنید.

• عضو PyBytesObject.ob_shash: به جای آن PyObject_Hash() را فراخوانی کنید.

• API ذخیره‌سازی محلی نخ (TLS):

  • PyThread_create_key(): به‌جای آن از PyThread_tss_alloc() استفاده کنید.

  • PyThread_delete_key(): به‌جای آن از PyThread_tss_free() استفاده کنید.

  • PyThread_set_key_value(): به‌جای آن از PyThread_tss_set() استفاده کنید.

  • PyThread_get_key_value(): به‌جای آن از PyThread_tss_get() استفاده کنید.

  • PyThread_delete_key_value(): به جای آن از PyThread_tss_delete() استفاده کنید.

  • PyThread_ReInitTLS(): از پایتون 3.7 به بعد لازم نیست.